Documentation / Développeurs

Crochets

Chaque filtre de GeneratePerf, ce qu'il modifie et sa valeur par défaut, avec un exemple prêt à l'emploi dans le thème enfant.

Chaque crochet ci-dessous est listé, commenté et accompagné d’un exemple, dans inc/functions-custom.php du thème enfant GeneratePerf : décommentez celui qu’il vous faut et adaptez-le. L’écran des réglages les affiche aussi dans chaque onglet, sous Crochets disponibles.

Sommaire

Filtre Ce qu’il modifie Par défaut
generateperf_toc_max_title_level Niveau de titre le plus profond listé dans le sommaire (2 à 6) 4

Contenus relatifs

Filtre Ce qu’il modifie Par défaut
generateperf_related_articles_inside_content_limit Nombre maximal d’articles relatifs insérés dans le texte ; moins sur un article court (au moins trois paragraphes entre deux) 6
generateperf_related_articles_after_content_limit Nombre d’articles relatifs après le contenu 6
generateperf_related_articles_sidebar_limit Nombre d’articles relatifs dans la barre latérale 6
generateperf_related_articles_before_footer_limit Nombre d’articles relatifs avant le pied de page 6
generateperf_related_posts_taxonomies Taxonomies utilisées pour trouver les articles relatifs : tableau taxonomie => termes de l’article courant étiquettes et catégories
generateperf_intext_related_posts_template HTML d’un article relatif inséré dans le texte ; reçoit le HTML par défaut, l’article relatif et l’article courant un lien avec libellé et titre

Partage social et auteurs

Filtre Ce qu’il modifie Par défaut
generateperf_social_share_details HTML affiché sous le titre du composant de partage vide
generateperf_add_user_social_link Réseaux sociaux des profils et de la boîte auteur : clé => [ name, prefix, icon ] ; l’icône doit se trouver dans images/icons/ du thème enfant réseaux intégrés
generateperf_trim_author_description Nombre de mots gardés dans la description de la boîte auteur false (texte complet)

Mise en page et images

Filtre Ce qu’il modifie Par défaut
generateperf_active_fonts Polices chargées par GeneratePerf (feuille de style, préchargement du fichier variable, éditeur de blocs) : piles du catalogue (Poppins, Poppins-fallback, sans-serif) ou noms de famille (Poppins) ; un tableau vide n’en charge aucune polices de la typographie de GeneratePress et des Global Styles de GenerateBlocks
generateperf_layout_custom_border_radius Arrondi des boutons, champs et cartes (variable CSS --border-radius) Mise en page → Rayon des bordures
generateperf_max_image_size Plus grande taille gardée pour les images téléversées, en pixels ; les tailles WordPress au-delà ne sont pas générées 1200

Performance

Filtre Ce qu’il modifie Par défaut
generateperf_css_concatenation Feuilles de style gardées en fichiers pour un outil de concaténation : true ramène à 0 la limite de mise en ligne de WordPress (styles_inline_size_limit), false garde la limite de WordPress, et les petites feuilles (polices, GeneratePerf, GeneratePress, GP Premium, GenerateBlocks Pro, thème enfant, WP Armour) sont alors imprimées dans la page au lieu de la bloquer ; reçoit la valeur détectée et l’identifiant de l’outil true seulement si un réglage de concaténation des CSS est actif : WP Rocket avant 3.15, Autoptimize, LiteSpeed Cache, SiteGround Speed Optimizer, W3 Total Cache, WP-Optimize, Breeze, WP Fastest Cache, Jetpack Boost

robots.txt

Filtre Ce qu’il modifie Par défaut
generateperf_list_block_agents Robots bloqués (Disallow: /) ; appliqué en dernier, il l’emporte sur le réglage Robots d’IA les robots d’IA du niveau choisi dans SEO → Robots d’IA
generateperf_ai_bots Robots d’IA de chaque catégorie : [ 'training' => [...], 'inference' => [...] ] liste tenue à jour à chaque version
generateperf_content_signal Valeur de la directive Content-Signal (préférence d’usage déclarée dans le groupe User-agent: *) ; reçoit la valeur et le niveau, une chaîne vide la retire search=yes, ai-input=yes, ai-train=no (entraînement seulement), search=yes, ai-input=no, ai-train=no (entraînement et inférence), aucune (aucun)
generateperf_list_bot_agents Robots au rythme d’exploration limité (Crawl-delay: 180) outils SEO et robots agressifs

Le réglage Robots d’IA (onglet SEO) fixe le niveau : aucun, entraînement seulement (défaut des nouvelles installations) ou entraînement et inférence. Les robots d’entraînement (GPTBot, ClaudeBot, CCBot, Google-Extended, Applebot-Extended, Meta-ExternalAgent, Amazonbot…) collectent les pages pour entraîner des modèles ; les robots d’inférence (OAI-SearchBot, ChatGPT-User, Claude-SearchBot, PerplexityBot…) les lisent pour citer le site dans une réponse. Les sites installés avant la 3.1.4 gardent le niveau « aucun ». Avec Yoast SEO actif, les règles sont écrites dans le bloc de Yoast du robots.txt ; sinon, GeneratePerf les ajoute lui-même.

Exemple

// inc/functions-custom.php du thème enfant : seulement les h2 et h3 dans le sommaire
add_filter( 'generateperf_toc_max_title_level', function () {
    return 3;
} );