Comment ajouter AdSense à WordPress sans extension (thèmes classiques et thèmes à blocs)
L'essentiel
- L'action wp_head se déclenche à l'intérieur de l'élément head : une petite fonction accrochée à ce hook affiche le code AdSense sur chaque page publique.
- Les thèmes à blocs déclenchent aussi wp_head : WordPress affiche les modèles de blocs via template-canvas.php, qui appelle wp_head() dans le head.
- Le filtre the_content permet d'insérer un bloc d'annonces après un paragraphe choisi ; WordPress recommande de vérifier in_the_loop() et is_main_query() lors du filtrage du contenu.
- Dans un thème à blocs, un bloc HTML personnalisé placé dans une partie de modèle (en-tête, modèle d'article) peut contenir le code d'un bloc d'annonces manuel.
- Le fichier ads.txt doit être accessible à la racine du domaine : il faut le téléverser dans le dossier qui sert la page d'accueil.

Pour ajouter AdSense à WordPress sans extension, accrochez à wp_head une fonction qui affiche le code AdSense, ajoutez les blocs manuels avec le filtre the_content ou un bloc HTML personnalisé dans une partie de modèle, puis téléversez ads.txt à la racine du site. Cette méthode fonctionne avec les thèmes classiques et les thèmes à blocs, résiste aux mises à jour si vous utilisez un thème enfant, et conserve le code publicitaire exactement tel que Google le fournit.
Pourquoi se passer d’une extension ?
Les extensions sont pratiques, mais chacune ajoute des pages de réglages, des scripts et un risque lors des mises à jour. Pour AdSense, la tâche est modeste : une balise dans le head, éventuellement quelques blocs d’annonces et un fichier texte. Le faire en code permet aussi de maîtriser précisément ce qui est affiché, ce qui compte puisque la règle sur la modification du code de Google limite les changements autorisés sur le code publicitaire.
Valeurs fictives utilisées ci-dessous : identifiant d’éditeur ca-pub-0000000000000000, bloc 1234567890.
Où placer le code pour qu’il survive aux mises à jour ?
functions.phpd’un thème enfant : le choix habituel. Les modifications d’un thème parent sont écrasées à la mise à jour.- Une extension à chargement obligatoire que vous écrivez (
wp-content/mu-plugins/adsense.php) : indépendante du thème, chargée automatiquement, et sans extension tierce. - Pas le fichier
header.phpdu thème parent, ni un bloc de l’éditeur d’articles pour le code du head.
Étape 1 : ajouter le code AdSense avec wp_head
Le hook wp_head « affiche des scripts ou des données dans la balise head côté public » et se déclenche via wp_head() à l’intérieur de <head>. Google demande de placer le code AdSense entre <head> et </head> sur chaque page (Where to place AdSense code in your HTML).
<?php
// functions.php (child theme) or wp-content/mu-plugins/adsense.php
add_action( 'wp_head', function () {
if ( current_user_can( 'edit_posts' ) ) {
return; // no ads for editors and admins while they work
}
?>
<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
crossorigin="anonymous"></script>
<?php
} );
Pourquoi afficher la balise plutôt que d’utiliser wp_enqueue_script() ? La mise en file d’attente est la méthode WordPress pour vos propres scripts et prend en charge 'strategy' => 'async' depuis WordPress 6.3, mais elle ajoute par défaut un paramètre de requête ver et demande un filtre supplémentaire pour ajouter crossorigin. Afficher l’extrait exact évite de modifier l’URL fournie par Google.
wp_head fonctionne-t-il avec les thèmes à blocs ?
Oui. Les thèmes à blocs n’ont pas de header.php, mais WordPress les affiche via template-canvas.php, dont le code source contient <?php wp_head(); ?> dans <head> (template-canvas.php dans le noyau de WordPress). Le hook ci-dessus fonctionne donc de la même façon avec Twenty Twenty-Five et les autres thèmes à blocs.
À ce stade, les annonces automatiques fonctionnent : activez-les pour le site dans AdSense. Le reste de ce guide traite des blocs manuels.
Étape 2 : insérer un bloc d’annonces après un paragraphe
Le filtre the_content s’exécute sur le contenu d’un article avant son affichage. La documentation de WordPress recommande de vérifier is_main_query() et in_the_loop() afin de ne modifier que le contenu principal, et non les widgets ou les extraits.
<?php
add_filter( 'the_content', function ( $content ) {
if ( ! is_singular( 'post' ) || ! in_the_loop() || ! is_main_query() ) {
return $content;
}
if ( current_user_can( 'edit_posts' ) ) {
return $content;
}
if ( get_post_meta( get_the_ID(), 'no_ads', true ) ) {
return $content; // per-post opt-out
}
$ad = '<div class="ad-slot ad-slot--in-content">
<ins class="adsbygoogle"
style="display:block"
data-ad-client="ca-pub-0000000000000000"
data-ad-slot="1234567890"
data-ad-format="auto"
data-full-width-responsive="true"></ins>
<script>
(adsbygoogle = window.adsbygoogle || []).push({});
</script>
</div>';
$after = 2; // insert after the 2nd paragraph
$paragraphs = explode( '</p>', $content );
if ( count( $paragraphs ) <= $after + 1 ) {
return $content; // too short: skip the ad
}
$last = count( $paragraphs ) - 1;
foreach ( $paragraphs as $i => $p ) {
if ( $i < $last ) {
$paragraphs[ $i ] .= '</p>'; // restore the tag removed by explode()
}
if ( $i + 1 === $after ) {
$paragraphs[ $i ] .= $ad;
}
}
return implode( '', $paragraphs );
} );
Remarques :
- Le test de longueur évite de placer une annonce à la toute fin d’un contenu mince.
explode()supprime chaque</p>; la boucle le rétablit pour chaque morceau sauf le dernier, qui contient ce qui suit le dernier paragraphe.- Le champ personnalisé
no_adsdonne aux rédacteurs un interrupteur par article : ajoutez à un article un champ personnalisé nomméno_adsavec n’importe quelle valeur non vide (par exemple pour un sujet d’actualité sensible ou un article sponsorisé soumis à ses propres règles) et le filtre n’y touche pas.get_post_meta()avectrueen troisième argument renvoie une valeur unique, et une chaîne vide si le champ n’existe pas. - Découper sur
</p>est simple et prévisible. Si vos articles utilisent beaucoup de blocs imbriqués, l’approcherender_blockci-dessous est plus précise. - Réservez la hauteur de l’emplacement avec du CSS (
.ad-slot { min-height: 280px; }dans la feuille de style du thème enfant) pour limiter les décalages de mise en page. Voir éviter le CLS causé par les annonces.
Étape 3 : blocs d’annonces dans les thèmes à blocs
Les thèmes à blocs offrent deux options propres.
Option A : un bloc HTML personnalisé dans une partie de modèle
Les parties de modèle sont des sections réutilisables comme l’en-tête, le pied de page ou la barre latérale, stockées dans le dossier /parts du thème et incluses avec le bloc Partie de modèle (« Template Part ») (manuel Template Parts). Dans l’éditeur de site :
- Ouvrez Apparence, puis Éditeur, puis le modèle ou la partie de modèle voulu (par exemple « Single Posts » ou « Sidebar »).
- Ajoutez un bloc HTML personnalisé à l’endroit où l’annonce doit apparaître.
- Collez le code du bloc d’annonces exactement tel que généré par AdSense.
- Enregistrez le modèle ou la partie de modèle.
Option B : le filtre render_block
render_block filtre le HTML de chaque bloc et reçoit le nom du bloc. Vous pouvez ajouter une annonce après un bloc précis, par exemple après la première image d’un article :
<?php
add_filter( 'render_block', function ( $block_content, $block ) {
static $done = false;
if ( $done || ! is_singular( 'post' ) || is_admin() ) {
return $block_content;
}
if ( 'core/image' !== $block['blockName'] ) {
return $block_content;
}
$done = true;
return $block_content . '<div class="ad-slot"><ins class="adsbygoogle" style="display:block" data-ad-client="ca-pub-0000000000000000" data-ad-slot="1234567890" data-ad-format="auto" data-full-width-responsive="true"></ins><script>(adsbygoogle = window.adsbygoogle || []).push({});</script></div>';
}, 10, 2 );
Le drapeau static $done limite l’insertion à une seule par requête.
Étape 4 : téléverser ads.txt
Le fichier ads.txt doit être servi à l’adresse https://votre-domaine/ads.txt. Sur la plupart des installations, il s’agit du dossier qui contient wp-config.php et index.php. Téléversez un fichier texte brut :
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
Si WordPress est installé dans un sous-dossier, ou si une extension SEO sert un ads.txt virtuel, lisez ads.txt sur WordPress sans extension pour connaître les conflits à surveiller.
Étape 5 : vérifier
- Déconnectez-vous (ou ouvrez une fenêtre de navigation privée), car le code ci-dessus ignore les rédacteurs connectés.
- Affichez le code source de la page et cherchez
adsbygoogle.js. Il doit apparaître une seule fois, dans<head>. - Vérifiez sur un article la présence de l’élément
<ins class="adsbygoogle"après le deuxième paragraphe. - Videz tout cache de page (extension, hébergeur ou CDN) si le nouveau HTML n’apparaît pas.
- Ouvrez
/ads.txtet confirmez qu’il s’agit de texte brut.
Ne cliquez pas sur vos propres annonces pour vérifier qu’elles fonctionnent. Le guide sur les clics sur ses propres annonces et les tests présente des méthodes de test sûres.
Dépannage
| Symptôme | Cause probable | Solution |
|---|---|---|
| Script absent du code source de la page | Code dans le mauvais fichier, cache de page, ou vous êtes connecté | Vérifier que le fichier est chargé, vider le cache, se déconnecter |
| Script présent deux fois | Une option du thème ou une ancienne extension ajoute aussi AdSense | En retirer un ; garder un seul extrait dans le head |
| Bloc d’annonces affiché dans des widgets ou des extraits | Filtre the_content sans les vérifications de boucle |
Conserver in_the_loop() et is_main_query() |
| Annonces vides, la console affiche “No slot size for availableWidth=0” | Le conteneur de l’annonce n’a pas de largeur (flottant, masqué, réduit à rien) | Donner une largeur au conteneur ; éviter les parents masqués |
| Annonces chargées très tard | Une extension de performance retarde ou fusionne le JavaScript tiers | Exclure adsbygoogle.js et les scripts de push en ligne des fonctions de report et de fusion |
Qu’en est-il des annonces automatiques et des blocs manuels réunis ?
Les deux approches ci-dessus coexistent avec les annonces automatiques. Google indique que les annonces automatiques détectent les annonces déjà présentes sur la page ; le guide Auto ads ou blocs d’annonces manuels explique comment garder la maîtrise avec les limites de densité publicitaire et les exclusions. Pour les types de blocs adaptés aux articles et aux archives, voir les annonces In-article, In-feed et Multiplex.
Questions fréquentes
Où placer le code : functions.php ou header.php ?
Utilisez une fonction accrochée à wp_head dans le fichier functions.php d'un thème enfant (ou dans une petite extension à chargement obligatoire que vous maîtrisez). Modifier header.php ne fonctionne que pour les thèmes classiques et la modification disparaît à la mise à jour du thème. Les thèmes à blocs n'ont pas de header.php, mais WordPress déclenche quand même wp_head : le hook convient donc aux deux types de thèmes.
Est-ce compatible avec les thèmes à blocs comme Twenty Twenty-Five ?
Oui. Les thèmes à blocs sont affichés par le fichier template-canvas.php de WordPress, qui appelle wp_head() dans l'élément head. Une fonction accrochée à wp_head affiche donc le code AdSense exactement comme avec un thème classique. Pour les blocs d'annonces manuels, utilisez un bloc HTML personnalisé dans une partie de modèle ou le filtre render_block.
Pourquoi mes annonces ne s'affichent-elles pas après l'ajout du code ?
Cherchez le script AdSense dans le code source de la page : s'il manque, le hook ne s'est pas exécuté ou un cache sert un ancien HTML. S'il est présent, vérifiez que le site est approuvé, que les annonces automatiques ou le bloc sont actifs, et qu'une extension de performance ne retarde pas ou ne fusionne pas le script adsbygoogle. Google indique que les nouveaux réglages des annonces automatiques peuvent mettre jusqu'à une heure à apparaître.
Faut-il masquer les annonces aux administrateurs connectés ?
C'est facultatif, mais prudent. Entourer la sortie d'un test comme current_user_can('edit_posts') empêche le chargement des annonces pendant la rédaction et la prévisualisation. Vos propres impressions restent ainsi hors des rapports et la tentation de cliquer disparaît. Ne cliquez jamais sur vos propres annonces pour les tester.
Sources
- wp_head · WordPress Developer Resources
- the_content · WordPress Developer Resources
- Template Parts · WordPress Theme Handbook
- render_block · WordPress Developer Resources
- Where to place AdSense code in your HTML · Google AdSense Help
Guides liés
- Ajouter ads.txt à WordPress sans extension (et éviter les conflits avec les fichiers ads.txt virtuels)
Ajouter ads.txt à WordPress en envoyant un fichier à la racine web : où la trouver, pourquoi c'est préférable aux fichiers virtuels, et régler les conflits.
- Auto ads ou blocs d'annonces manuels : lequel choisir, et comment les combiner
Annonces automatiques ou blocs manuels ? Comparez maîtrise, formats, exclusions de pages et de zones, et la façon dont AdSense combine les deux sur une page.
- Annonces In-article, In-feed et Multiplex : où placer chaque format natif AdSense et comment insérer le code
Où placer les formats natifs d'AdSense et comment coder les annonces In-article entre les paragraphes, In-feed dans les listes et Multiplex après les articles.
- Cliquer sur ses propres annonces AdSense : pourquoi c'est interdit et comment tester les annonces sans risque
Cliquer sur ses propres annonces AdSense est interdit, quelle qu'en soit la raison. Comment tester sans cliquer et que faire après une erreur.
- Comment éviter le décalage de mise en page (CLS) dû aux annonces AdSense en réservant l'espace des emplacements
Empêcher AdSense de décaler la mise en page : réserver l'espace avec min-height ou des tailles CSS fixes, gérer les emplacements vides et les annonces auto.