Page

Le champ de type page permet de sélectionner une page existante dans WordPress. Ce champ est idéal pour créer des liens vers des pages internes, configurer des pages de destination, ou tout autre cas d'utilisation nécessitant une sélection de page.

Utilisation de base

exemple-basique.yaml

page_contact:
    label: "Page de contact"
    type: "page"
    description: "Sélectionnez la page de contact principale"

Paramètres

Paramètre obligatoire

type Requis

• Type : string
• Valeur : "page"
• Description : Spécifie qu'il s'agit d'un champ de sélection de page

Paramètres optionnels

Exemple avancé

exemple-complet.yaml

# Section des pages importantes
important_pages:
    label: "Pages importantes"
    type: "section"
    fields:
        # Page d'accueil personnalisée
        custom_home:
            label: "Page d'accueil"
            type: "page"
            description: "Sélectionnez la page à utiliser comme page d'accueil"

Récupération de la valeur

La valeur retournée par le champ est l'ID de la page sélectionnée. Vous pouvez la récupérer via le service customize d'Elementum :

app/Controllers/MyController.php

#[Template("front_page")]
public function frontPage(){
    // Récupération de l'ID de la page sélectionnée
    $pageId = $this->customize()->getSection('important_pages')->custom_home;

    // Utilisation avec les fonctions WordPress
    if ($pageId) {
        // Créer un lien vers la page
        $pageLink = get_permalink($pageId);

        // Récupérer l'objet WP_Post complet si nécessaire
        $pageObject = get_post($pageId);
    }

    return $this->render("front-page.html.twig", compact('pageLink', 'pageObject'));
}

remarque

Les ID des champs sont automatiquement convertis en snake_case. Par exemple, un champ avec l'ID page-contact sera accessible via page_contact.

Bonnes pratiques

• Documentez l'utilisation prévue de chaque sélection de page

Notes importantes

• Le champ retourne toujours l'ID de la page.
• Si la page sélectionnée est supprimée, le champ retournera un ID invalide.