StarPush est un outil simple et efficace.
En une simple balise à copier-coller, vous pourrez ajouter
StarPush sur votre site
permettant à vos utilisateurs de noter vos articles, produits, vidéos, etc.
StarPush se fixe à l'endroit où vous l'insérez sans rien altérer de
votre design.
Ce module s'adapte à n'importe quel hébergement, vous n'avez besoin ni de base de données
ni même de PHP. Les données sont stockées directement sur le serveur de StarPush et triée
en fonction du nom de domaine qui l'utilise.
Compatibles avec tous les navigateurs.
(dispose également d'une version sans JavaScript 100% compatible)
Intégrer via class.starpush.php
Nous avons développé une class PHP qui vous permet d'intégrer
facilement le script StarPush sur votre site web.
Télécharger class.starpush.php (compatible PHP 4 et PHP 5)
Télécharger class.starpush.php pour PHP 5
Exemple d'utilisation de la class :
<?php
require_once('class.starpush.php');
// Entrez ci-dessus le chemin du fichier téléchargé
$star=new starpush('identifiantN');
$star->out();
?>
Ce simple code de base va générer un script StarPush à l'endroit où est exécuté la méthode
out() dont l'identifiant sera identifiantN
Liste des méthodes de la class :
id ( [ $identifiant = 'none' ] )
->id() permet de modifier l'identifiant du code StarPush. Cette méthode
vous permet de générer plusieurs code indépendant à partir d'un même objet (et donc ayant les même
propriétés
L'identifiant doit contenir entre 1 et 255 caractères alphanumérique.
$star=new starpush('id1');
$star->images($image1,$image2);
$star->out(); // Génération du code id1
$star->id('id2');
$star->out(); // Génération du code id2
// Les deux codes utiliseront les même images mais seront indépendants
images ( $url1 [, $url2 = false [, $url3 = false [, $url4 = false ] ] ] )
->images() permet de définir les images à utiliser. Le troisième paramètre
n'est utilie que si vous souhaitez insérer un script Mini StarPush ou "J'aime" et seul
le script "Plus ou Moins" nécessite 4 images.
Les URLs doivent être complètes, exemple :
$image1='http://starpush.selfbuild.fr/images/etoile.png';
$image2='http://starpush.selfbuild.fr/images/etoilej.png';
$star=new starpush('identifiantN');
$star->images($image1,$image2);
nojs ( [ $nojs = true ] )
->nojs() permet d'activer (true) ou de désactiver (false) le code alternatif
pour les utilisateurs non équipés de JavaScript. (Actif par défaut)
$star=new starpush('identifiantN');
$star->nojs(false);
compression ( [ $compression = true ] )
->nojs() permet d'activer (true) ou de désactiver (false) la compression
du code HTML. (Actif par défaut)
$star=new starpush('identifiantN');
$star->compression(false);
infos ( [ $tolerant = false ] )
->infos() renvoie un array associatif contenant des informations sur le script
(nombres de votes, note minimale, etc.). Si le paramètre $tolerant vaut false, la méthode vérifiera que
l'identifiant des données reçues correspond bien à l'identifiant de l'objet. S'il vaut true, cette vérification
ne sera pas effectuée et les informations seront transmises directement. (false par défaut.)
Pour connaître la liste complète des informations récupérable, rendez-vous à
l'
Exemple : Récupérer les infos en PHP.
$star=new starpush('identifiantN');
print_r($star->infos());
out ( [ $parametres = '' [, $echo = true ] ] )
->out() crée et affiche le code HTML (les balises de script et version alternative
sans JavaScript si celle-ci est activée). Si le paramètre $echo vaut true (par défaut), le contenu est directement
affiché avec la fonction echo(). Sinon, le contenu est retourner sous forme de chaîne de caractères.
Le parametre $parametres doit être une liste de mots séparés par des virgules (exemple "mini,nostyle,margin").
Les mots possibles sont :
- left : aligne le script à gauche
- right : aligne le script à droite (par défaut)
- none : n'aligne pas le script (s'affiche à la suite)
- nostyle : enlève le style (bordure et marge)
- nohalf : toutes les notes sont arrondies à l'entier près
- margin : rajoute une marge de 2 pixels entre chaque image
- mini : version sans texte en une seule ligne
- jaime : version "J'aime" (sans texte, un seul bouton)
- pm : version "Plus ou Moins" (deux boutons)
$star=new starpush('identifiantN');
$star->out('left,nostyle,margin');