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 |
| 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;
} );