FORMATION WORDPRESS · MODULE 05/08 · 10 HEURES
Vous débutez totalement ? Commencez par la section « Mode débutant » de chaque atelier : elle explique où cliquer, quoi faire et comment vérifier votre résultat. Le code vient après les manipulations simples. Voir aussi le guide de prise en main →
Le thème présente le site ; le plugin porte ses données métier. Cette semaine, vous créez l’extension de l’agence pour gérer des réalisations, services et secteurs, puis apprenez à sécuriser les réglages.
Plugin ZIP activable ; types de contenus Réalisations/Services ; taxonomie Secteurs ; réglage administrable et sécurisé ; données conservées après changement de thème.
PARCOURS GUIDÉ
Cliquez sur une étape pour découvrir sa mission. Le bouton « Aller à cette étape dans le cours » ouvre directement sa procédure détaillée. Le switch en colonne de droite enregistre votre avancement.
Construire le premier plugin Un plugin se place dans wp-content/plugins/nom-du-plugin/ . WordPress identifie son fichier principal grâce à un en-tête PHP. Exemple agency-portfolio-manager.php…
Action : lire la procédure, la reproduire, puis activer le switch après contrôle du résultat.
Ajouter Services et la taxonomie Secteurs La taxonomie relie des contenus à des termes administrables. Un CPT possède son propre écran ; show_in_rest facilite l’utilisation de Gutenberg et de…
Action : lire la procédure, la reproduire, puis activer le switch après contrôle du résultat.
Un réglage administrable via Settings API L’API Settings gère l’enregistrement et la validation des options. Les réglages et les contrôles de droit doivent être côté serveur. Exemple compact…
Action : lire la procédure, la reproduire, puis activer le switch après contrôle du résultat.
Sécuriser les formulaires et les sorties Une donnée reçue depuis un formulaire n’est jamais réputée sûre. Validez/sanitisez à l’entrée, vérifiez les droits et échappez au moment de l’affichage.…
Action : lire la procédure, la reproduire, puis activer le switch après contrôle du résultat.
Tester installation, désactivation et compatibilité Une vraie livraison plugin prévoit au minimum activation/désactivation, conservation des contenus, permissions et absence d’erreur fatale.…
Action : lire la procédure, la reproduire, puis activer le switch après contrôle du résultat.
COURS APPROFONDI & ATELIERS
Ces exemples sont volontairement progressifs. Les extraits de code s’exécutent dans des fichiers PHP d’un thème/plugin WordPress, pas directement dans le texte d’une page LiveCanvas.
Un plugin ajoute une fonctionnalité au site sans dépendre du thème. Nous allons créer un plugin d’exercice minimal, puis l’activer comme une extension ordinaire.
wp-content/plugins/agency-lab-plugin/agency-lab-plugin.php ; WordPress → Extensions.
<?php
/**
* Plugin Name: Agency Lab Plugin
* Description: Extension métier d'exercice.
* Version: 0.1.0
*/
if (!defined('ABSPATH')) exit;
add_action('init', function () {
// Le point de démarrage des fonctionnalités.
});
L’extension apparaît dans la liste et peut être activée/désactivée sans supprimer les articles.
Si le plugin est invisible, vérifiez le fichier PHP principal, son emplacement et l’en-tête Plugin Name.
Plugin : module de fonctionnalité indépendant du design du thème.
Un plugin se place dans wp-content/plugins/nom-du-plugin/. WordPress identifie son fichier principal grâce à un en-tête PHP.
<?php
/**
* Plugin Name: Atelier Portfolio Manager
* Version: 1.0.0
* Requires PHP: 8.1
*/
defined( 'ABSPATH' ) || exit;
add_action( 'init', function (): void {
register_post_type( 'agency_project', [
'label' => 'Réalisations',
'public' => true,
'show_in_rest' => true,
'supports' => [ 'title', 'editor', 'thumbnail' ],
'has_archive' => true,
'rewrite' => [ 'slug' => 'realisations' ],
] );
} );
/realisations/ et régénérez les permaliens dans l’admin si besoin.À éviter : créer les CPT essentiels dans
functions.php: ils cessent d’être enregistrés si le client change de thème.
Le résultat est-il reproductible ? Gardez une preuve (capture ou extrait de code), puis validez l’interrupteur « Étape 01 » dans votre suivi.
Un Custom Post Type permet de gérer des contenus spécifiques comme « Réalisations » ou « Services » au lieu de les confondre avec les articles du blog.
Plugin → agency-lab-plugin.php ; WordPress → Réalisations ; Réglages → Permaliens.
add_action('init', function () {
register_post_type('agency_project', [
'label' => 'Réalisations', 'public' => true, 'has_archive' => true,
'show_in_rest' => true,
'supports' => ['title', 'editor', 'thumbnail']
]);
});
Une rubrique Réalisations est disponible dans WordPress et ses entrées ont des pages consultables.
Si la liste fonctionne dans l’admin mais l’URL affiche 404, contrôlez has_archive/public/rewrite puis réenregistrez les permaliens.
CPT : type de contenu personnalisé. show_in_rest : rend le type accessible aux interfaces WordPress compatibles.
La taxonomie relie des contenus à des termes administrables. Un CPT possède son propre écran ; show_in_rest facilite l’utilisation de Gutenberg et de l’API.
register_post_type( 'agency_service', [
'label' => 'Services',
'public' => true,
'show_in_rest' => true,
'supports' => [ 'title', 'editor', 'thumbnail' ],
'rewrite' => [ 'slug' => 'services-agence' ],
] );
register_taxonomy( 'agency_sector', [ 'agency_project' ], [
'label' => 'Secteurs',
'public' => true,
'show_in_rest' => true,
'hierarchical' => true,
] );
Les contenus métiers ne disparaissent pas de la base lors d’un changement de thème.
Le résultat est-il reproductible ? Gardez une preuve (capture ou extrait de code), puis validez l’interrupteur « Étape 02 » dans votre suivi.
Une taxonomie classe les réalisations ; une métadonnée ajoute une information spécifique à une réalisation, par exemple une ville ou un numéro de projet.
Plugin → register_taxonomy/register_post_meta ; WordPress → Réalisations.
add_action('init', function () {
register_taxonomy('agency_sector', ['agency_project'], [
'label'=>'Secteurs', 'public'=>true, 'hierarchical'=>true,
'show_in_rest'=>true
]);
});
Chaque réalisation possède un secteur et un champ de données métier cohérent.
Ne mettez pas des données confidentielles dans une métadonnée REST publique ; réfléchissez au rôle et à la visibilité avant publication.
Taxonomie : système de classification. Métadonnée : champ additionnel lié à un contenu.
L’API Settings gère l’enregistrement et la validation des options. Les réglages et les contrôles de droit doivent être côté serveur.
add_action( 'admin_init', function (): void {
register_setting( 'atelier_options', 'atelier_cards_count', [
'type' => 'integer',
'sanitize_callback' => function ( $value ) {
return max( 1, min( 24, absint( $value ) ) );
},
'default' => 6,
] );
} );
add_options_page().method="post" action="options.php" avec settings_fields( 'atelier_options' ).get_option( 'atelier_cards_count', 6 ).Le paramètre est borné entre 1 et 24 et reste enregistré après rechargement.
Le résultat est-il reproductible ? Gardez une preuve (capture ou extrait de code), puis validez l’interrupteur « Étape 03 » dans votre suivi.
La Settings API permet d’enregistrer des préférences du plugin. C’est un domaine différent du contenu des Pages : les réglages concernent le fonctionnement du site.
Plugin → Hooks admin_menu et admin_init ; WordPress → Réglages → Options du plugin.
function agency_cards_sanitize($value) {
return max(1, min(24, absint($value)));
}
Un administrateur peut sauver une valeur valide, un utilisateur non autorisé ne peut pas la modifier.
Un nonce réduit les risques CSRF mais ne remplace jamais current_user_can() ; vérifiez toujours les capacités.
Settings API : mécanisme WordPress d’enregistrement des options. Capability : permission d’un compte.
Une donnée reçue depuis un formulaire n’est jamais réputée sûre. Validez/sanitisez à l’entrée, vérifiez les droits et échappez au moment de l’affichage.
if ( ! current_user_can( 'manage_options' ) ) {
wp_die( 'Accès interdit', '', [ 'response' => 403 ] );
}
check_admin_referer( 'atelier_save' );
$titre = isset( $_POST['titre'] )
? sanitize_text_field( wp_unslash( $_POST['titre'] ) )
: '';
echo esc_html( $titre );
wp_nonce_field( 'atelier_save' ).À retenir : pour le formulaire Contact public, utilisez une extension fiable ou développez un endpoint sécurisé complet (validation, nonce adapté, anti-spam, confidentialité, e-mail et contrôles serveur).
Le résultat est-il reproductible ? Gardez une preuve (capture ou extrait de code), puis validez l’interrupteur « Étape 04 » dans votre suivi.
Une extension professionnelle conserve les données métier même quand on change de thème ou qu’on la désactive temporairement.
WordPress → Extensions ; Apparence → Thèmes ; Réalisations.
Exemple concret : Livrable : plugin ZIP, captures des menus CPT et tableau de tests après réactivation.
Le même contenu est encore présent après désactivation/réactivation et changement de thème.
Ne supprimez pas les tables/contenus dans le Hook de désactivation. La suppression définitive doit être une opération séparée et explicite.
Désactivation : arrêt de l’exécution, distinct de la désinstallation et de la suppression des données.
Une vraie livraison plugin prévoit au minimum activation/désactivation, conservation des contenus, permissions et absence d’erreur fatale.
Journal de tests PASS/FAIL, capture des CPT, ZIP versionné, explication des contrôles de permissions.
Le résultat est-il reproductible ? Gardez une preuve (capture ou extrait de code), puis validez l’interrupteur « Étape 05 » dans votre suivi.
SOURCES & SUPPORTS
Documentation officielle : Consulter la référence WordPress ↗. Vidéos : ajoutez des tutoriels enregistrés et vérifiés dans LiveCanvas ; aucune vidéo factice n’est présentée comme un cours existant.
FIN DU MODULE · ÉVALUATION
Répondez aux cinq questions. Après correction, découvrez votre note sur 20, le nombre d’erreurs et l’explication de chaque réponse. Quatre réponses correctes sur cinq sont nécessaires pour valider le nouveau quiz.