AlphaUserPoints - Aide

Présentation: AlphaUserPoints est un composant qui permet de distribuer des points aux utilisateurs enregistrés selon certaines de ses actions. AlphaUserPoints possède son propre composant d'invitation/recommendation qui peut être utilisé également par les utilisateurs non-enregistrés.

Licence: AlphaUserPoints est réalisé sous licence GNU/GPL License.

Installation : Installer le composant via l'interface d'administration de Joomla. Lors de l'installation, les plugins systèmes s'installent et sont publiés automatiquement. Si toutefois le répertoire Plugins n'a pas les droits en écriture, une erreur survient et averti l'utilisateur. Le composant devra être réinstallé après modification des droits sur le répertoire Plugins.

Mise à jour: Toutes les règles customisées sont conservées ainsi que les points des utilisateurs. Pas besoin de désinstaller la version précédente. Installer directement la dernière version par dessus la précédente, puis allez au panneau d'administration d'AlphaUserPoints, vérifier et enregistrer la configuration générale s'il y a des nouveaux paramètres.
Si vous souhaitez désinstaller la version précédente avant, il suffit de désinstaller et installer la dernière version, puis allez au panneau d'admin, vérifier et enregistrer la configuration générale. Aller au gestionnaire de menus et modifier chaque menu lié à AlphaUserPoints et appliquer les paramètres.

Panneau de contrôle général de Joomla :

Lors de l'installation d'AlphaUserPoints, une icône est ajoutée dans le panneau de contrôle de joomla (mod_aupadmin). Cette icône vous permet de lancer rapidement AlphaUserPoints mais affiche aussi un avertissement si il existe des points en attente d'approbation.

Panneau de contrôle :

Bouton/menu Configuration
Ce menu permet de paramétrer des options de base pour l'utilisation du composant.

Bouton/menu Règles
Ce menu permet d'accéder à la liste des règles permettant d'attribuer des points selon certaines actions de l'utilisateur enregistré. Les descriptions des règles vous donneront les informations sur leur rôle et les conditions d'attribution des points. Pour installer de nouvelles règles inter-agissant avec des composants tiers, se reporter à la rubrique Pour aller plus loin.

Bouton/menu Utilisateurs
Ce menu affiche l'ensemble des membres enregistrés du site avec leurs identifiants AlphaUserPoint respectifs, le total de points actuel pour chacun des membres ainsi qu'un lien pour le détails de chaque action ayant rapportée des points.

Bouton/menu Plugins
Ce menu permet d'ajouter des nouvelles règles inter-agissant avec des composants tiers. Pour plus de renseignements sur ce menu, se reporter à la rubrique Pour aller plus loin.

Bouton/menu Synchro utilisateurs
Ce menu permet, après la premiere installation, de synchroniser l'ensembre des membres déjà enregistrés sur le site afin de leurs attribuer un identifiant AlphaUSerPoints. Avant de synchroniser les utilisateurs, veuillez lire la rubrique Mise en route.

Bouton/menu Recalculer
Ce menu permet de lance un recalcul du nombre total de points pour tous les membres suite à suppression d'action ou modification de points par un administrateur. Attention: ceci recalcul tous les utilisateurs selon les actions menées. Si vous avez modifié manuellement un compte, vous perdrez ces modifications.

Bouton/menu Remise à zéro
Ce menu remet tous les compteurs de points à zéro pour l'ensemble des membres enregistrés. Important: impossibilité de revenir en arrière, toutes les actions seront effacées.

Bouton/menu Points maxi
Ce menu fixe une limite maximum de points pouvant être attribués à tous les membres enregistrés du site. 0 ou vide pour ne pas fixer de limite.

Bouton/menu Purger points expirés
Ce menu permet de purger les actions possédant une date limite de validité. Cette action entraîne un recalcul immédiat de tous les points.

Bouton/menu Codes coupon
Ce menu permet de créer des codes pour des coupons donnant droit à des points supplémentaires. Générateur de codes intégré.

Button / menu Tirage au sort
Ce menu permet de créer des tirages au sort, loterie ou promotions... pour vos utilisateurs. 1 à 3 gagnants à chaque tirage.

Button / menu Niveau/Rang
Ce menu permet de créer des rangs ainsi que des médailles pour vos utilisateurs. Les deux types peuvent être combinés.

Bouton/menu Statistiques
Ce menu affiche le top 10 des points gagnés et le top 10 des points dépensés par vos utilisateurs. Possibilité de filtrer de date à date.

Bouton/menu Export membres actifs (CSV)
Ce menu lance un export au format CSV des cinquantes premier membres les plus actifs (ayant le plus de points) du site.

Bouton/Menu Export emails (CSV)
Ce menu lance un export au format CSV de toutes les adresses email stockées dans la table détails du composant suite à une action du type invitation/recommendation, recommender un article etc...

Button / Menu Activités combinées
Ce menu permet de condenser l'ensemble des activités en une seule activité antérieurement à une date donnée. Améliore les performances de la base de données si votre site génère une grand activité de la part des utilisateurs.

Bouton/menu A propos de
Informations sur le composant.

Bouton/menu Comment créer un plugin
Ce menu affiche un fichier d'aide expliquant comment intégrer l'API AlphaUserPoints dans un composant tier et comment générer un fichier XML d'installationde la nouvelle règle concernant ce composant tier.

Bouton/menu Aide
Affiche ce fichier.

Mise en route :

Paramétrage des règles pré-existantes
Via l'interface d'administration de Joomla!, cliquez sur le menu composants puis sur le menu AlphaUserPoints. Cliquez ensuite sur le sous-menu règles ou bien cliquez sur le bouton règles si vous êtes déjà dans le panneau de contrôle du composant AlphaUserPoints.

Lorsque vous lancer le composant pour la première fois, un message d'information apparaît dans le panneau de contrôle du composant. Ce message vous informe que vous devez dans un premier temps synchroniser les utilisateurs/membres enregistrés de votre site avec AlphaUserPoints. Toutefois, si vous souhaitez attribuer des points à chaque enregistrement d'un nouvel utilisateur, et pour ne pas pénaliser les anciens membres, vous devez paramétrer la règle concernant les nouveaux membres avant d'effectuer la synchronisation. Editez cette règle et attribuez un nombre de points pour tout nouveau membre. Sauvegarder cette règle. Vous êtes à même maintenant de synchroniser tous les membres. Ceux-ci seront crédité des points. Dès qu'un nouveau membre s'inscrira, il sera crédité du nombre de points spécifiés dans la règle.
Paramétrez et activez les autres règles selon vos besoins. Les descriptions des règles vous donneront les informations sur leur rôle et les conditions d'attribution des points.
Note : la règle concernant les nouveaux utilisateurs ne peut pas être désactivée. Vous pouvez uniquement mettre à zéro le nombre de points attribués à cette règle si vous ne souhaiter pas attribuer de point sur cette action.

  1. Règle Nouvel utilisateur : Attribue ou non des points pour tout nouvel utilisateur enregistré sur le site.
  2. Règle Connexion journalière: Attribue des points pour une connexion journalière. (fidélise vos visiteurs).
  3. Règle Parrainage : Attribue ou non des points lorsqu'un utilisateur invite une personne à s'enregistrer sur le site (envoi d'email).
  4. Règle Invitation avec confirmation : Attribue ou non des points au parrain lorsqu'un utilisateur s'enregistre sur le site suite à une invitation.
  5. Règle Envoyer un article : Attribue ou non des points à l'utilisateur lorsque celui-ci soumet un article.
  6. Règle Soumettre un lien web : Attribue ou non des points à l'utilisateur lorsque celui-ci soumet un lien web.
  7. Règle Inviter un ami à lire un article : Attribue des points lorsqu'un membre invite un ami à lire un article (gagne de points lorsque l'article est lu) . Utilisation de la fonction native envoyer à un ami inclue dans Joomla.
  8. Règle Lecteur à auteur : Assigne des points à l'auteur quand l'un de ses articles est lu par un utilisateur.
  9. Règle Lire un article: Assigne des points lorsque l'utilisateur enregistré lit un article. Vous pouvez assigner un montant de points négatif pour transformer cette règle en Payer pour lire. Les points sont attribués ou retirés uniquement lors de la première lecture.
  10. Règle Voter un article: Assigne des points lorsque l'utilisateur enregistré vote pour un article avec le système de vote de Joomla.
  11. Rule Click sur bannière: Assigne des points lorsque l'utilisateur enregistré clique sur une bannière du composant com_banners (Seul le premier click est comptabilisé pour l'obtention de points).
  12. Règle Répondre au sondage : Attribue ou non des points à l'utilisateur lorsque celui-ci participe à un sondage.
  13. Règle Cession de points : Autorise les utilisateurs à céder tout ou partie de leurs points à d'autres utilisateurs. Nécessite de créer un menu lié au compoant pour le frontend.
  14. Règle Points au parrain : Les utilisateurs parrains gagnent des points de bonus en pourcentage sur tous les points gagnés par leurs filleuls.
  15. Règle Points de bonus : Assigne des points de bonus à certains utilisateurs sélectionnés (Administration -> AlphaUserPoints -> menu Statistiques -> barre outils Bonus).
  16. Règle Devenir auteur: Spécifier le nombre de points nécessaires pour autoriser un utilisateur enrgistré à changer de niveau et devenir auteur.
  17. Règle Devenir rédacteur : Spécifier le nombre de points nécessaires pour autoriser un auteur à changer de niveau et devenir rédacteur.
  18. Règle Devenir éditeur : Spécifier le nombre de points nécessaires pour autoriser un éditeur à changer de niveau et devenir éditeur.
  19. Règle Exclusion d'utilisateurs référants : Exclus certains référants pour l'attribution de points (utile pour les administrateurs).
  20. Règle Notification email : Envoi un email à l'utilisateur dès qu'il gagne des points.
  21. Règle Notification au gagnant : Envoi un email à l'utilisateur dès que celui-ci a atteint le maximum de points requis (nécessite de paraméter un maximum de points).
  22. Règle Acheter des points avec Paypal : Autorise les utilisateurs à acheter des points sur votre site avec Paypal. Requis: Paramétrer le menu.
  23. Règle Codes pour des coupon de points: Autorise les utilisateurs à entrer un code dans le module approprié pour obtenir des points déterminés par l'administrateur. Vous devez installer le module mod_alphauserpoints_couponcode.
  24. Règle Tirage au sort: Cette règle permet l'utilisation du système de tirage au sort.
  25. Règle Custom: Assigne ou retire un nombre de points customisables pour un ou des utilisateurs spécifiques (Administration -> menu Utilisateurs -> détails -> barre outils -> Bouton Custom points)
  26. Règle Joyeux anniversaire: Assigne des points une fois par an quand la date d'anniversaire de l'utilisateur est atteinte. Note: l'utilisateur doit se logger ce jour là pour obtenir les points.
  27. Règle Contenu : Assigne ou retire des points sur n'importe quelle affichage de contenu (com_content ou n'importe quel autre composant chargeant le "content plugin onPrepareContent" de Joomla!). Ajouter juste le tag {AUP::CONTENT=XXX} dans votre contenu ou XXX représente le nombre de points, vous pouvez entrer une valeur positive ou négative.
  28. Règle Upload avatar : Assigne des points lors d'un upload d'avatar ou photo dans le profil de l'utilisateur. Fonctionne uniquement avec le système natif d'avatar inclus dans AlphaUserPoints.
  29. Règle Profil complet : Assigne des points lorsque le profil de l'utilisateur est complété à 100%. 10% lors de l'inscription sur le site, 50% avec un avatar, 100% avec la date de naissance, le genre, le lieu de résidence et les infos d'éducation et de travail. Si le profil régresse en dessous de 100%, les points seront retirés automatiquement.
  30. Règle Membre inactif : Retire des points pour les membres inactifs après une période pré-établie.
  31. Règle Activités combinées: Permet à l'administrateur du site de combiner l'ensemble des activités en une seule activité antérieurement à une date donnée. Améliore les performances de la base de données si votre site génère une grand activité journalière de la part des utilisateurs.
  32. Rule Donner des points à l'auteur: Le lecteur donne des points à l'auteur pour pouvoir lire son article avec possibilité de customiser le montant des points. Ajouter le tag {AUP::CONTENTAUTHOR=XXX} dans votre article ou XXX est le nombre de points. Ce nombre est toujours positif. Le montant des points sera retirer du compte du lecteur et les points seront attribués à l'auteur de l'article.

Il existe aussi 2 règles auto-détectées si le composant Kunena forum est isntallé sur le site. Une règle pour assigner des points lors de la création d'un nouveau topic and une règle pour l'assignation de points sur une réponse à un topic. Il y a lieu d'activer cette intégration dans le paramétrage du composant Kunena forum.

Création des menus
AlphaUserPoints comporte 8 options de création de menu en frontend.

ReCaptcha
Pour l'utilisation de ReCaptcha (anti-spam), vous devez au préalable obtenir des clés pour son utilisation sur le site http://recaptcha.net/api/getkey.

Pour créer un menu, sélectionnez le composant AlphaUserPoints dans l'interface de création de menus de Joomla! puis choisissez le type de menu à créer. Entrez un nom pour ce menu puis paramétrer le si besoin. Pour plus d'information sur la création de menu sous Joomla!, reportez vous à l'aide de Joomla!.

Désactiver les messages utilisateur en frontend
Utilisez le menu Configuration puis activez ou désactivez les messages de congratulations ou de retrait de points en frontend de votre site.

Autoriser les visiteurs à voir le profil des membres
Vous pouvez activer ou désactiver l'option afin que les visiteurs voient ou ne voient pas le profil des membres inscrits.

Changer le préfixe de l'identifiant
Vous pouvez modifier le préfixe de l'identifiant AlphaUserPoints en éditant les paramètres du menu Configuration. Vous pouvez entrer un préfixe particulier pour les utilisateurs qui s'enregistrent d'eux-même sur votre site et un autre pour les utilisateurs "parrainés". 7 caractères maximum.

Modifier le type d'identifiant
Vous pouvez modifier le préfixe de l'identifiant AlphaUserPoints en éditant les paramètres du menu Configuration. Vous pouvez choisir entre le username de l'utilisateur ou bien une séquence aléatoire.

Limiter le nombre de points par jour:
Vous pouvez limiter le nombre de points acquis par jour par vos utlisateurs en éditant les paramètres du menu Configuration.

Système de tirage au sort:
Première étape : Si vous souhaitez offrir à vos utilisateurs enregistrés la possibilité de participer à des tirages au sort vous devez d'abord activer la règle "Tirage au sort" puis ajouter un tirage au sort à l'aide du bouton "Tirage au sort" dans le panneau de contrôle d'AlphaUserPoints et paramétrez ensuite ce tirage. Vous pouvez choisir d'offrir des points, des coupons code aux gagnants des tirages ou bien un email avec un lien pour un téléchargement par exemple.
Deuxième étape (optionnelle): Si vous avez un tirage qui requiert une inscription de la part de vos utilisateurs enregistrés, il suffit d'insérer le tag suivant dans un article: {AUP::RAFFLE=ID} où ID est l'ID de votre tirage au sort. Ce tag fait apparaître un bouton pour l'inscription de vos utilisateurs. L'article, lui, peut décrire le tirage au sort, le jeu ou la promotion relatif à ce tirage.
Maintenant, dans la partie administration du composant, rubrique Tirage au sort, vous avez le nombre total de participants inscrits pour ce tirage. Si vous cliquez sur ce nombre, vous obtenez la liste complète des participants inscrits au format csv.
Si l'inscription multiple est autorisée alors un membre enregistré pourra alors s'inscrire plusieurs fois à un tirage, ceci augmentant ses chances de gagner tel qu'à un tirage de loterie avec des billets.

Niveaux/Rangs et médailles
Les deux peuvent être utilisés ensemble ou individuellement. Grades ou des médailles peuvent être accordées automatiquement quand un utilisateur atteind un certain nombre de points (spécifiez le nombre de points dans le rang/médaille) ou peut être attribuée manuellement à un utilisateur (laissez le nombre de points à zéro). Dans tous les cas, le rang ou la médaille peut être modifié manuellement par l'administrateur directement dans le détail de l'utilisateur. Si vous attribuez un rang qui est normalement destinée à être attribué automatiquement à un certain niveau de points, il ne sera pas pris en compte. Il est recommandé de ne pas mélanger les deux types de classement (automatique ou manuelle).

Lorsque vous attribuez une médaille à un utilisateur, vous pouvez ajouter une description ou une raison pour l'attribution de cette médaille. Si vous laissez le champ vide, la description par défaut de la médaille est attribuée. Les grades et les médailles par défaut créés pendant l'installation du composant peuvent être supprimés sans problème si vous ne les utilisez pas. S'il n'y a pas de rang/médaille, les colonnes pour afficher les icônes ou le nombre de médailles ne seront pas affichées dans la gestion des utilisateurs.

Afficher le total de points pour l'utilisateur connecté dans un article :
Utilisez le tag {AUP::SHOWPOINTS} dans le contenu de votre article à l'endroit désiré pour afficher le total en cours de l'utilisateur connecté.

Vérification de version
Vous pouvez afficher / cacher le contrôle de version dans le menu Configuration générale du composant.

Pour allez plus loin :

Installation de plugins tiers
Pour ajouter de nouvelles règles provenant ou inter-agissant avec des composants tiers, cliquez sur le menu Plugins ou sur le bouton du panneau de contrôle du composant, puis sélectionnez le fichier .zip ou .xml contenant la nouvelle règle. Uploadez ce fichier. Si le fichier est uploadé correctement, une nouvelle règle sera ajouter à la liste existante. Paramétrez cette nouvelle règle et activez là selon vos besoins. Le fait de cliquez sur Nouveau dans la liste des règles permet également d'ajouter un plugin via la même fonction.

Si vous souhaitez avoir plus de renseignement sur la façon de créer un plugin, reportez-vous sur l'aide "Comment créer un plugin".