Il y a quelques temps, C. Bavota a publié une révision du thème « Magazine Basic » incluant une fonction d’enregistrement en Ajax. Dans l’attente de réactions suite à sa publication sur WordPress, il a obtenu des informations sur la façon d’intégrer Ajax en utilisant le module admin-ajax.php au lieu du code qu’il avait utilisé. Toutes les fonctions principales en Ajax de WordPress s’appuient sur admin-ajax.php, et sa mise en œuvre pour des scripts personnalisés est extrêmement simple.

Regardons les éléments dont vous aurez besoin pour que cela fonctionne. Dans l’exemple ci-dessous, nous allons coder une petite fonction de mailing-list qui notifiera l’administrateur par courriel lors d’une nouvelle inscription.

Voyons le formulaire :

Voici le jQuery :

Permettez-moi de vous expliquer chaque composant.

Quand un utilisateur clique sur « S’abonner » (Envoyer), nous devons vérifier que le champ e-mail n’est pas vide. S’il est vide, nous en informerons le visiteur en lui indiquant « Merci d’indiquer votre adresse email. » et nous arrêtons le processus en incluant l’instruction « return false; ».

Ensuite, nous ferons une simple validation pour s’assurer que l’adresse e-mail contient au moins une arrobe (@) et un point. Si ce n’est pas le cas, nous renverrons un message d’erreur suivi de « return false; ».

Une fois ces contrôles élémentaires effectués et passés avec succès, nous pouvons traiter le formulaire. C’est maintenant qu’admin-ajax.php entre en jeu. Lors l’utilisation d’admin-ajax.php, vous devez ajouter une action WordPress (add_action) incluant une fonction de rappel (callback function) pour que ça fonctionne. Notre fonction de rappel sera join_mailinglist. Notre fonction PHP rendra l’ensemble fonctionnel en tâche de fond. Mais avant, nous allons créer une variable pour stocker l’action et l’adresse email du nouvel abonné.

Maintenant, nous allons cacher le bouton d’envoi et présenter un graphique animé pour indiquer qu’une tâche de fond s’exécute. Puis nous utiliserons la fonction .post de jQuery pour envoyer ces informations au module admin-ajax.php. Une fois la fonction terminée et la réponse transmise, l’animation va disparaître, le bouton « S’abonner » sera de retour avec un message de succès, ou un message d’erreur.

Avec le formulaire et le jQuery, vous aurez besoin encore d’un peu de PHP.
Le module admin-ajax.php requiert deux ancrages d’action (add_action).

La première action ne fonctionnera que pour les utilisateurs connectés. La seconde le sera pour les autres. Les visiteurs n’ont pas à être connectés pour notre besoin, et dans notre cas l’action devrait ressembler à ceci :

Voici la fonction join_mailinglist_callback, qui devra être ajoutée à votre functions.php :

Une fois tout en place, vous obtiendrez un formulaire fonctionnant comme ci-dessous.

_{En réalité, aucune lettre d’information ne vous sera adressée suite à votre inscription sur ce formulaire de démonstration (les adresses fournies peuvent être fictives, elles ne seront pas enregistrées).}

_{Translated and adapted from « Using Ajax with WordPress » article by C. Bavota (with his kind authorization).}

Coté Blog (WordPress)

- Dans les extensions (WordPress) Ajoutez le plugin PiwigoPress et activez-le.

- Apparence > Widgets
Faites glisser le Widget dans le sidebar voulu…
Paramétrez le Widget (Titre et nom du répertoire de votre galerie Piwigo).

Coté galerie:
- Avoir des images publiques non confidentielles assez récentes.

En gros, c’est tout.