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.

Panneau de contrôle :

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 Statistiques
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 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...

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 Parrainage : Attribue ou non des points lorsqu'un utilisateur inviter une personne à s'enregistrer sur le site (envoi d'email).
  3. Règle Invitation avec confirmation : Attribue ou non des points au parrain lorsqu'un utilisateur s'enregistre sur le site suite à une invitation.
  4. Règle Envoyer un article : Attribue ou non des points à l'utilisateur lorsque celui-ci soumet un article.
  5. Règle Soumettre un lien web : Attribue ou non des points à l'utilisateur lorsque celui-ci soumet un lien web.
  6. 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.
  7. Règle Lecteur à auteur : Assigne des points à l'auteur quand l'un de ses articles est lu par un utilisateur.
  8. Règle Répondre au sondage : Attribue ou non des points à l'utilisateur lorsque celui-ci participe à un sondage.
  9. 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.
  10. Règle Points au parrain : Les utilisateurs parrains gagnent des points de bonus en pourcentage sur tous les points gagnés par leurs filleuls.
  11. Règle Points de bonus : Assigne des points de bonus à certains utilisateurs sélectionnés (Administration -> AlphaUserPoints -> menu Statistiques -> barre outils Bonus).
  12. Règle Exclusion d'utilisateurs référants : Exclus certains référants pour l'attribution de points (utile pour les administrateurs).
  13. Règle Notification email : Envoi un email à l'utilisateur dès qu'il gagne des points.
  14. 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).

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

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 menu à créer parmi les trois. 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
Ediert le fichier nommé helper.php dans le répertoire du composant (frontend) et paramétrez la constante _ALPHAUSERPOINTS_WARNING_CONGRATULATION :

0 = désactivé
1 = activé

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".