WordPress: Maitriser les Options, créer des Pages de Réglage

création d'une interface pour gérer les options

1ère méthode, on fait tout dans le même fichier

construction d'un formulaire 'libre'

création manuelle du nonce

Validation du formulaire, vérification du nonce.

créer des champs pour afficher, dans le formulaire, les options qui sont sauvegardées,

Récupérer les options sauvegardées existantes.

Utiliser la notation de tableau dans l'attribut name des champs <input>

récupérer les valeurs envoyées par le formulaire pour mettre à jour les options.

2ème méthode avec le hook admin_post_{action} (recommandé par WordPress)

l'attribut action du formulaire pointe sur admin-post.php

ajout d'un champ spécifique 'action' et création du hook personnalisé correspondant.

Réutilisation du code de validation dans la fonction associée au hook personnalisé.

Redirection vers la page initiale après validation et enregistrement des résultats

Afficher un message de succès.

Créer des constantes, charger un fichier CSS

Utiliser $current_screen pour contrôler le chargement sélectif d'un fichier dans une page spécifique du tableau de bord (gain de performances)

Appliquer quelques styles à notre formulaire

Ajouter une case à cocher et vérifier la valeur transmise

Enregistrer l'état de la case à cocher et gérer son affichage dans le formulaire avec la fonction checked() de WordPress

Insérer une image, répartir le code dans plusieurs fichiers pour une meilleure organisation et une plus grande modularité.

Créer les valeurs d'options par défaut à l'activation et effacer les options à la désactivation

Utiliser les valeurs de nos options pour afficher (ou pas) des éléments dans le site web.

Les bases de la Settings API, création d'un nouveau plugin

Création du menu avec add_menu_page() et création du formulaire pointant sur le fichier options.php

Utilisation des fonctions register_setting() et settings_fields().

Explication des champs créés par la fonction settings_fields()

Créer des sections avec add_settings_section(), afficher les sections avec do_settings_section()

Créer des champs avec add_settings_field(), créer le markup HTML pour afficher le champ <input>

Avec un graphique nous allons synthétiser le rapport entre les différentes fonctions de la Settings API

Amélioration du code pour éviter les appels multiples à la même fonction

Nous allons ajouter une deuxième section reliée à une nouvelle option dans la même page de réglages du tableau de bord

Création de la deuxième section (suite)

Création de la deuxième section (suite et fin)

Mise en place du code HTML spécifique pour afficher les onglets et gestion de la classe CSS de l'onglet actif

Nous allons changer les paramètres des settings pour dispatcher les groupes  dans leurs onglets respectifs.

Créer une fonction générique réutilisable, à laquelle on peut passer des paramètres, pour afficher les champs <input> sans répéter le même code indéfiniment.

Récupérer les paramètres du champ et les passer à la fonction générique pour le champ <input> texte

Récupérer les valeurs envoyées à la fonction pour créer le markup HTML

Modifier les settings field pour utiliser la fonction générique

Création du markup, vérification de la mise à jour de l'option pour la case à cocher

Présentation du principe des boutons radio en HTML et création du setting

Création de la fonction et passage d'un tableau supplémentaire pour les valeurs de la série de boutons radio

Création des balises HTML pour les boutons radio dans la fonction générique, vérification et tests

Présentation du principe des listes select en HTML et création du setting

Finalisation de la fonction et test de la liste déroulante

Création d'un nouveau setting_field et ajout du chargement d'un script Javascript spécifique à la page

mise en place d'un écouteur sur un bouton pour ouvrir le gestionnaire de Médias de WordPress

Retour sur les subtilités à prendre en compte lorsque l'on désactive le plugin et lorsqu'on le réactive, en ce qui concerne les valeurs par défaut des options

Installation d'un plugin de développement qui nous affiche le HTML et les styles utilisés dans l'interface de l'administration de WordPress

Insérer un setting field dans une page de l'administration en utilisant une section existante de WordPress

Dupliquer le rôle editor et lui ajouter la permission 'manage-options' afin qu'il puisse accéder aux options que nous avons créées

Brider le nouveau rôle créé afin de l’empêcher d'accéder à des pages sensibles du panneau de configuration

Refactoring: pour une meilleure organisation, on va déplacer l'option "âge du capitaine" dans son propre fichier

Fonctions de validation, création du corps de la fonction

Nettoyage des chaînes saisies dans les formulaires, restriction des caractères autorisés dans un champ grâce à une expression régulière

Dans cet atelier nous allons réaliser une entête (header, ou banner) que vous pourrez afficher n'importe où dans votre site WordPress. Le contenu de cet entête (image, overlay de couleur, texte) sera géré au niveau du tableau de bord, dans un groupe de settings situé dans un onglet spécifique.

Nous allons créer un  nouvel onglet dans notre page d'option actuelle afin d'héberger les nouveaux réglages et nous entamerons une réflexion sur la numérotation de nos options et fichiers.