Recette : Configuration des paramètres globaux du site avec des pages d’options

Les pages d’options sont des écrans d’administration dédiés à la gestion des données qui ne sont pas liées à un seul article ou à une seule page — informations de contact de l’entreprise, liens vers les réseaux sociaux, texte de pied de page, bascules globales, et plus encore. Cette recette vous guide à travers la configuration complète.

Étape 1 : Décider comment la page d’options sera enregistrée

Field Forge prend en charge trois chemins d’enregistrement — choisissez celui qui convient le mieux au flux de travail :

1. Interface Admin (recommandé, sans code) — allez à Field Forge > Options Pages, cliquez sur Ajouter une nouvelle page d’options, remplissez le titre de la page, le slug du menu, la capacité, la page parente, l’icône, la position. Enregistrez. L’élément de menu apparaît immédiatement dans la barre latérale d’administration de WordPress. Vous pouvez modifier, supprimer temporairement ou restaurer la page depuis la même liste. La ligne de la page se trouve dans la table wp_fieldforge_options_pages.
2. Auto-enregistrer à partir d’un groupe de champs (option la plus simple en une étape) — donnez au groupe de champs une règle de localisation de page d’options et Field Forge crée automatiquement un élément de menu avec le titre du groupe comme étiquette de menu. Pas de code, pas d’enregistrement de page séparé. La page est en lecture seule dans la liste des pages d’options — changez le titre du groupe de champs pour renommer l’élément de menu.
3. Enregistrer explicitement via PHP (lorsque l’enregistrement doit être inclus avec le thème) — insérez un extrait dans le functions.php de votre thème :

add_action('init', function () {
    if (function_exists('fieldforge_add_options_page')) {
        fieldforge_add_options_page([
            'page_title' => 'Site Settings',
            'menu_title' => 'Site Settings',
            'menu_slug'  => 'site-settings',  // matches the location rule below
            'icon_url'   => 'dashicons-admin-settings',
            'capability' => 'manage_options',
            'position'   => 80,
        ]);
    }
});

Le shim acf_add_options_page() est également disponible pour le code de thème migré depuis ACF Pro.

Étape 2 : Ajouter des groupes de champs

Créez un ou plusieurs groupes de champs qui ciblent la page d’options.

1. Allez à Field Forge > Nouveau groupe de champs, intitulez-le Informations sur l’entreprise
2. Ajoutez un champ d’onglet étiqueté Général
3. Ajoutez ces champs :

1. Ajoutez un autre champ d’onglet étiqueté Réseaux sociaux
2. Ajoutez ces champs :

1. Ajoutez un autre champ d’onglet étiqueté Pied de page
2. Ajoutez ces champs :

1. Définissez les règles de localisation : La page d’options est égale à Paramètres du site
2. Enregistrez le groupe de champs

Étape 3 : Flux de travail du gestionnaire de contenu

1. Cliquez sur Paramètres du site dans la barre latérale d’administration
2. Vous voyez trois onglets : Général, Réseaux sociaux et Pied de page
3. Remplissez le nom de l’entreprise, téléchargez le logo et entrez les coordonnées dans l’onglet Général
4. Passez à Réseaux sociaux et collez vos URL de profils sociaux
5. Passez à Pied de page et personnalisez le texte de copyright et les paramètres de la newsletter
6. Cliquez sur Enregistrer les modifications (le bouton est en haut ou en bas de la page)

Les modifications s’appliquent immédiatement à l’ensemble du site. Chaque page du site qui utilise ces valeurs sera mise à jour automatiquement.

Étape 4 : Utiliser les données d’options dans les modèles

Votre développeur accède aux données d’options en utilisant le paramètre 'options' :

• get_field('company_name', 'options') dans l’en-tête
• get_field('social_facebook', 'options') pour les icônes sociales
• get_field('copyright_text', 'options') dans le pied de page

Organisation avec des sous-pages

Pour des sites complexes, créez des sous-pages sous la page d’options principale :

• Paramètres du site (parent)

– Réseaux sociaux — tous les liens vers les profils sociaux

– Apparence — couleurs, polices, préférences de mise en page

– Intégrations — ID Google Analytics, code du widget de chat, scripts tiers

Chaque sous-page obtient son propre groupe de champs. Cela maintient chaque écran de paramètres concentré et facile à naviguer.

Conseils pour les pages d’options

• Utilisez des onglets au sein des groupes de champs pour organiser des champs connexes sans créer de sous-pages séparées pour chaque catégorie
• Définissez des valeurs par défaut sur les champs afin que le site ait l’air correct même avant que les paramètres soient remplis
• Ajoutez des champs de message avec des instructions comme “Téléchargez un logo PNG transparent de 300×100 pixels pour de meilleurs résultats”
• Utilisez la logique conditionnelle pour masquer les champs secondaires jusqu’à ce qu’ils soient pertinents — par exemple, activez la logique conditionnelle sur le champ Titre de la newsletter et définissez la règle “Afficher l’inscription à la newsletter égale Oui” afin que le titre n’apparaisse que lorsque le commutateur est activé. Onze opérateurs sont disponibles (égal, contient, regex, vide, comparaisons numériques), et les règles enchaînées se propagent automatiquement.
• Restez simple — ne mettez ici que les données qui doivent vraiment être globales. Les données par page appartiennent à des groupes de champs réguliers attachés à des articles ou des pages spécifiques.

—