Plugin Wordpress "Adelya Connector"

• Nom du plugin : Adelya Connector
• Développé par : Answeb
• Version : 1.1.0
• Requis : WordPress 6.8.1 ou supérieur, PHP 8.0 ou supérieur

Description

Le plugin Adelya Connector permet de connecter votre site WordPress au système de fidélité Adelya. Il remplace l'authentification WordPress standard par l'authentification Adelya et offre à vos utilisateurs un accès direct à leurs informations de fidélité (points, crédits, historique d'achats, coupons).

Installation

Installation manuelle (développement)

1. Télécharger ou cloner le plugin dans /wp-content/plugins/
2. Se connecter à l'administration WordPress
3. Aller dans Extensions > Extensions installées
4. Localiser "Connecteur Adelya" et cliquer sur Activer
5. Accéder aux réglages via Réglages > Adelya

Installation via fichier ZIP

1. Télécharger le fichier .zip depuis les releases GitHub
2. Se connecter à l'administration WordPress
3. Aller dans Extensions > Ajouter une extension
4. Cliquer sur Téléverser une extension
5. Sélectionner le fichier .zip et cliquer sur Installer maintenant
6. Cliquer sur Activer l'extension
7. Accéder aux réglages via Réglages > Adelya

Installation via le répertoire WordPress (si publié)

1. Se connecter à l'administration WordPress
2. Aller dans Extensions > Ajouter une extension
3. Rechercher "Adelya Connector"
4. Cliquer sur Installer maintenant puis Activer
5. Accéder aux réglages via Réglages > Adelya

Capture d'écran

Configuration du plugin

Après l'activation du plugin, rendez-vous dans Réglages > Adelya pour configurer la connexion à l'API Adelya.

Paramètres requis

1. Base API URL : L'URL de base de l'API Adelya fournie par votre fournisseur
2. Login : Votre identifiant de connexion à l'API
3. Password : Votre mot de passe de connexion à l'API
4. Current apikey : Votre clé API (générée après authentification)

Test de connexion

Une fois les paramètres saisis, cliquez sur Test connection pour vérifier que la connexion à l'API fonctionne correctement. Un message vous indiquera le nombre d'utilisateurs actifs si la connexion est réussie.

Paramètres optionnels

• History rollback : Permet de définir la période d'historique à récupérer (format strtotime : -3 month, -1 year, etc.)
  • Par défaut : -3 month
  • ⚠️ Ce paramètre ne sera actif qu'après expiration du cache (environ 5 minutes)

Fonctionnalités

1. Authentification via Adelya

Le plugin remplace le système d'authentification WordPress standard par l'authentification Adelya :

• Les utilisateurs se connectent avec leur numéro de carte de fidélité
• L'authentification est validée via l'API Adelya
• Les utilisateurs sont automatiquement créés dans WordPress lors de leur première connexion
• Un rôle spécifique adelya est attribué aux utilisateurs

2. Gestion des comptes utilisateurs

• Création automatique : Les nouveaux utilisateurs Adelya sont créés automatiquement dans WordPress
• Synchronisation des données : Les informations (nom, prénom, email, mobile) sont synchronisées depuis Adelya
• Mot de passe perdu : Le processus de récupération de mot de passe est intégré avec Adelya
• Changement de mot de passe : Les changements sont propagés à Adelya

3. Métadonnées utilisateur synchronisées

Les informations de fidélité suivantes sont stockées et mises à jour pour chaque utilisateur :

• adelya_id : Identifiant unique Adelya
• adelya_mobile : Numéro de téléphone mobile
• adelya_nbPoint : Nombre de points de fidélité cumulés (repart à 0 après 100 points)
• adelya_cumulPoint : Cumul total de points
• adelya_nbCredit : Montant en euros disponible (100 points = 2 nbCredits, affichés comme 2€)
• adelya_cumulCredit : Cumul total de crédit
• adelya_dateRenew : Date de renouvellement
• adelya_fidProgramCode : Code du programme de fidélité (PRO, CAP, AMBASS)
• nbVisits : Nombre de visites

4. Shortcodes disponibles

Le plugin fournit plusieurs shortcodes pour afficher les informations de fidélité :

Shortcodes simples

• [adelya_fidelity_points] : Affiche le nombre de points de fidélité de l'utilisateur
• [adelya_fidelity_credit] : Affiche le montant de crédit disponible (formaté avec 2 décimales)
• [adelya_fidelity_program] : Affiche le code du programme de fidélité ("", PRO, CAP, AMBASS)

Shortcode historique

[adelya_fidelity_history] : Affiche l'historique des achats, points et coupons

Options disponibles :

• start : Date de début de l'historique au format strtotime (ex: -3 month, -1 year)

  [adelya_fidelity_history start="-3 month"]
  

• columns : Colonnes à afficher parmi ca, points, coupons (séparées par des virgules)

  [adelya_fidelity_history columns="ca,points,coupons"]
  

• color : Couleur Bootstrap à utiliser pour le thème (ex: dark, primary, success)

  [adelya_fidelity_history color="dark"]
  

• currency : Code devise pour afficher les montants (défaut: EUR)

  [adelya_fidelity_history currency="EUR"]
  

Exemple complet :

[adelya_fidelity_history start="-6 month" columns="ca,points,coupons" color="dark" currency="EUR"]

5. Historique et cache

• L'historique comprend :
  • Historique des achats (CA) : Chiffre d'affaires par transaction
  • Historique des points : Points gagnés par achat
  • Historique des coupons : Coupons disponibles et leurs dates de validité
• Les données d'historique sont mises en cache pendant 1 heure pour optimiser les performances

6. API Adelya

Le plugin communique avec l'API Adelya pour :

• Authentifier les utilisateurs
• Récupérer les informations de fidélité
• Synchroniser les mots de passe
• Récupérer l'historique des transactions, points et coupons
• Tester la connexion à l'API

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License, version 3, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

A copy of the license is included in the root of the plugin’s directory. The file is named LICENSE.

Crédits

Answeb - Développement du plugin

Ce plugin a été développé par Answeb, agence spécialisée dans le développement web et les solutions e-commerce. Answeb accompagne les entreprises dans leur transformation digitale en créant des solutions sur-mesure adaptées à leurs besoins spécifiques.

Expertise Answeb :

• Développement WordPress & WooCommerce, Prestashop
• Intégrations ERP et solutions métier
• Connecteurs et API personnalisés
• Solutions e-commerce avancées

Pour toute question technique ou demande d'évolution du plugin, vous pouvez contacter l'équipe Answeb via notre site web.

Adelya - Système de fidélité

Adelya est un système de gestion de programmes de fidélité permettant aux entreprises de gérer leurs membres, leurs points de fidélité, leurs crédits et leurs avantages. Ce plugin WordPress facilite l'intégration de ce système dans votre site e-commerce ou vitrine.