title: renderHeader
icon: code

renderHeader

Cette fonction rend l'en-tête de la page, incluant le titre, la description, les liens de l'en-tête, la barre de recherche et le sélecteur de plage de dates.

function renderHeader(array $args = [], string ...$children)

Paramètres :
- array $args : Les arguments pour configurer l'en-tête, y compris 'title', 'description', 'header_links', 'start-date', et 'end-date'.
- string ...$children : Contenu additionnel à afficher dans l'en-tête.
Retour : Aucun. Cette fonction affiche directement le HTML.

Exemples d'utilisation

Exemple 1 : Utilisation avec les arguments par défaut

renderHeader();

Exemple 2 : Utilisation avec des arguments personnalisés

$args = [
    'title' => 'Page Title',
    'description' => 'Page Description',
    'header_links' => [
        'Home' => '/home',
        'About' => '/about'
    ]
];
renderHeader($args);

Détails des arguments

Les arguments par défaut sont définis comme suit :

title : Titre de la page ou nom du site.
description : Description du site.
header_links : Liens de l'en-tête. Par défaut, les cinq premières pages sans underscore dans leur slug.
start-date : Date de début pour le sélecteur de plage de dates. Par défaut, le début de l'année courante.
end-date : Date de fin pour le sélecteur de plage de dates. Par défaut, la fin de l'année courante.

Exemple d'utilisation avec des enfants

$content = '<div>Contenu additionnel</div>';
renderHeader([], $content);

Cette fonction génère le HTML suivant pour l'en-tête de la page, incluant le titre, la description, les liens de l'en-tête, la barre de recherche et le sélecteur de plage de dates.

Explications détaillées

La fonction utilise wp_parse_args pour fusionner les arguments fournis avec les valeurs par défaut.
Les dates de début et de fin sont formatées en utilisant la méthode toStr de la classe SaferThemeDateHelpers.
Le HTML de l'en-tête inclut le titre du site, la barre de recherche, et le sélecteur de plage de dates.
Pour les écrans plus petits, un bouton permet d'afficher un menu déroulant pour le sélecteur de plage de dates.