# En-tête d’extension

> Bloc de commentaire placé en haut du fichier principal d'une extension WordPress, qui déclare son nom, sa version et ses autres métadonnées lues par le cœur.

- Auteur : Clément Hadrot
- Publié le : 2026-09-25
- Mis à jour le : 2026-09-25
- URL : https://wpmoderne.dev.wordpress-developpement.fr/lexique/en-tete-extension/

Pour que l'écran « Extensions » de l'administration affiche un nom, une description et un numéro de version, WordPress n'analyse pas le code de l'extension : il se contente de lire un commentaire structuré placé tout en haut du fichier principal.

## Structure attendue

Chaque ligne suit le format `Clé: Valeur`, à l'intérieur d'un commentaire PHP classique :

```
<?php
/**
 * Plugin Name: Mon Extension
 * Plugin URI: https://exemple.fr/mon-extension
 * Description: Ajoute une fonctionnalité utile.
 * Version: 1.4.2
 * Requires at least: 6.4
 * Requires PHP: 8.0
 * Author: Studio Exemple
 * Text Domain: mon-extension
 */
```

Seule la clé `Plugin Name` est strictement obligatoire pour que WordPress reconnaisse le fichier comme une extension valide, mais renseigner `Requires at least` et `Requires PHP` permet au cœur de bloquer une activation sur un environnement incompatible.

## Bon à savoir

- Ce commentaire doit se trouver dans les 8 premiers kilo-octets du fichier, sans quoi WordPress ne le détecte pas.
- Le fichier contenant cet en-tête définit également ce que WordPress considère comme le fichier principal, utilisé par exemple par `plugin_dir_url( __FILE__ )` ou `register_activation_hook( __FILE__, ... )`.
- La clé `Network`, réglée sur `true`, indique qu'une extension ne peut être activée qu'au niveau du réseau entier sur une installation multisite, plutôt que site par site.
- Un numéro de `Version` incohérent avec celui réellement publié empêche WordPress de proposer correctement une mise à jour, même si les fichiers sur le répertoire officiel ont bien changé.