Toutes les données de champs personnalisés ne doivent pas figurer sur un article. Certaines données sont véritablement à l’échelle du site :
Sans pages d’options, vous stockeriez ces données dans les options WordPress (get_option('company_name')), ce qui signifie des chaînes brutes sans interface admin et sans sécurité de type. Avec les pages d’options, vous obtenez une interface de champ personnalisé appropriée et des valeurs typées.
Dans Field Forge, enregistrez une page d’options avec un appel de fonction dans le functions.php de votre thème ou dans un plugin :
“php if (function_exists('fieldforge_add_options_page')) { fieldforge_add_options_page([ 'page_title' => 'Paramètres du site', 'menu_title' => 'Paramètres du site', 'menu_slug' => 'site-settings', 'capability' => 'manage_options', 'icon_url' => 'dashicons-admin-generic', 'position' => 80, ]); } “
Un nouvel élément de menu apparaît dans l’admin WordPress. Lorsque vous cliquez dessus, vous voyez un écran d’édition où Field Forge rend les champs personnalisés assignés à cette page d’options via des règles de localisation.
Vous pouvez enregistrer des sous-pages sous un parent pour organiser des paramètres connexes :
“`php fieldforge_add_options_sub_page([ ‘page_title’ => ‘Paramètres de l’en-tête’, ‘menu_title’ => ‘En-tête’, ‘parent_slug’ => ‘site-settings’, ]);
fieldforge_add_options_sub_page([ ‘page_title’ => ‘Paramètres du pied de page’, ‘menu_title’ => ‘Pied de page’, ‘parent_slug’ => ‘site-settings’, ]); “`
Les sous-pages apparaissent imbriquées sous “Paramètres du site” dans le menu admin.
Après avoir enregistré une page d’options, créez un groupe de champs dans le constructeur visuel de Field Forge et définissez les règles de localisation :
“ Règles de localisation : La page d'options est égale à "site-settings" “
Tous les champs de ce groupe apparaissent sur la page d’options Paramètres du site. Créez autant de groupes de champs que vous le souhaitez par page d’options, en les divisant logiquement (par exemple, “Informations sur l’entreprise”, “Profils sociaux”, “Contenu du pied de page”).
Accédez aux valeurs de la page d’options avec la même fonction get_field() que vous utilisez pour les métadonnées d’article, mais passez 'options' comme deuxième argument :
“`php // Syntaxe compatible ACF $company_name = get_field(‘company_name’, ‘options’); $company_phone = get_field(‘phone’, ‘options’); $facebook_url = get_field(‘facebook_url’, ‘options’);
// Les pseudo-IDs ‘options’ et ‘option’ fonctionnent $logo = get_field(‘site_logo’, ‘option’); // Même résultat “`
Dans les modèles :
“php
“
La même syntaxe fonctionne sur les sites ACF, SCF et Field Forge. La portabilité du code entre les trois plugins est intentionnelle — si vous devez un jour revenir en arrière ou avancer entre eux, votre thème ne se casse pas.
Les valeurs de la page d’options sont stockées dans une table dédiée : wp_fieldforge_options. Séparées des valeurs de champs d’article, séparées de la table native wp_options de WordPress.
Pourquoi une table séparée :
wp_options n’affectent pas les données d’options de Field ForgeVous pouvez enregistrer autant de pages d’options que votre site en a besoin :
“`php // Branding à l’échelle du site fieldforge_add_options_page([ ‘page_title’ => ‘Paramètres de la marque’, ‘menu_slug’ => ‘brand-settings’, ]);
// Configuration marketing fieldforge_add_options_page([ ‘page_title’ => ‘Marketing’, ‘menu_slug’ => ‘marketing’, ]);
// Développeur / avancé fieldforge_add_options_page([ ‘page_title’ => ‘Paramètres du développeur’, ‘menu_slug’ => ‘dev-settings’, ‘capability’ => ‘manage_options’, // uniquement pour les admins ]); “`
Chaque page d’options a ses propres groupes de champs, ses propres exigences de capacité et son propre placement de menu.
Les pages d’options ACF sont importées automatiquement par l’outil de migration ACF de Field Forge. Après l’importation :
functions.php)get_field('name', 'options') continue de fonctionner via la couche de compatibilité ACFLa plupart des sites terminent la migration des pages d’options sans aucun changement de modèle.
Voir le guide de migration complet →
Les valeurs de la page d’options sont exposées sur l’API REST de Field Forge :
“ GET /wp-json/fieldforge/v1/options/{page-slug} “
Retourne un objet avec toutes les valeurs de champ pour la page d’options spécifiée. Parfait pour les sites WordPress sans tête qui ont besoin de paramètres globaux du site dans un frontend JavaScript.
Pour les utilisateurs de WPGraphQL, les pages d’options sont également auto-enregistrées en tant que types GraphQL lorsque le plugin WPGraphQL est actif.
Obtenez Field Forge — à partir de 35 $/an →
Les pages d’options sont incluses dans chaque plan payant.