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