Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/effi10/effi-title-id/archive/refs/heads/main.zipUn plugin WordPress qui ajoute automatiquement des attributs ID aux balises de titre (h2-h6) dans vos publications et pages.
Description
Ce plugin génère automatiquement des identifiants uniques pour tous les titres de niveau 2 à 6 (h2, h3, h4, h5, h6) présents dans le contenu de vos publications et pages WordPress. Les IDs générés préservent les caractères accentués et sont optimisés pour une utilisation en français.
Fonctionnalités
- ✅ Génération automatique d'IDs pour les balises h2 à h6
- ✅ Préservation des accents (français, espagnol, etc.)
- ✅ Nettoyage intelligent des caractères spéciaux
- ✅ Respect des IDs existants (ne modifie pas les titres ayant déjà un ID)
- ✅ Compatibilité UTF-8 complète
- ✅ Activation uniquement sur les pages singulières (articles, pages)
Installation
Méthode 1 : Installation manuelle
- Téléchargez le fichier
effi-title-id.zip - Connectez-vous à votre administration WordPress
- Allez dans Extensions > Ajouter
- Cliquez sur Téléverser une extension
- Sélectionnez le fichier zip et cliquez sur Installer maintenant
- Activez le plugin
Méthode 2 : Installation via FTP
- Décompressez le fichier
effi-title-id.zip - Uploadez le dossier dans
/wp-content/plugins/ - Activez le plugin depuis l'administration WordPress
Utilisation
Le plugin fonctionne automatiquement une fois activé. Aucune configuration n'est nécessaire.
Avant le plugin
<h2>L'eau chaude (méthode efficace)</h2>
<h3>Création d'un système électrique</h3>
Après le plugin
<h2 id="l-eau-chaude-methode-efficace">L'eau chaude (méthode efficace)</h2>
<h3 id="creation-d-un-systeme-electrique">Création d'un système électrique</h3>
Règles de génération des IDs
Le plugin applique les transformations suivantes pour créer des IDs valides :
- Conversion en minuscules tout en préservant les accents
- Suppression des caractères spéciaux :
',",`,(,),{,},[,],;,,,.,:,!,?,\,/ - Remplacement des espaces par des tirets
- - Suppression des caractères non-alphanumériques (sauf lettres accentuées, chiffres, tirets et underscores)
- Suppression des tirets en début/fin
- Consolidation des tirets multiples en un seul tiret
Exemples de transformation
| Titre original | ID généré |
|---|---|
L'eau chaude |
l-eau-chaude |
Système électrique (220V) |
systeme-electrique-220v |
Créer un café délicieux ! |
creer-un-cafe-delicieux |
Étude : résultats & conclusions |
etude-resultats-conclusions |
Compatibilité
- WordPress : 4.0 et supérieur
- PHP : 7.0 et supérieur
- Encodage : UTF-8
- Langues : Optimisé pour le français, compatible avec toutes les langues utilisant des caractères accentués
Sécurité
- Utilisation de
esc_attr()pour sécuriser les IDs générés - Vérification de l'existence de
ABSPATHpour empêcher l'accès direct - Validation et nettoyage sécurisé des données d'entrée
- Préservation des IDs existants pour éviter les conflits
Questions fréquentes
Le plugin modifie-t-il mes titres existants ?
Non, le plugin respecte les titres qui ont déjà un attribut id. Il n'ajoute un ID que si celui-ci n'existe pas déjà.
Que se passe-t-il si un titre ne contient que des caractères spéciaux ?
Si après nettoyage le titre ne contient plus aucun caractère valide, aucun ID ne sera ajouté à ce titre.
Le plugin fonctionne-t-il sur les pages d'archive ?
Non, le plugin est conçu pour fonctionner uniquement sur les pages singulières (articles et pages individuelles), pas sur les pages d'archive, la page d'accueil ou les listes d'articles.
Les accents sont-ils préservés ?
Oui, c'est l'une des fonctionnalités principales de ce plugin. Les caractères accentués (é, è, à, ç, etc.) sont préservés dans les IDs générés.
Développement
Structure du code
custom_sanitize_id_with_accents(): Fonction principale de génération des IDsauto_add_heading_ids_with_accents(): Fonction de traitement du contenu- Utilisation du hook
the_contentpour traiter automatiquement le contenu
Contribuer
Pour contribuer au développement de ce plugin :
- Forkez le projet
- Créez une branche pour votre fonctionnalité
- Commitez vos changements
- Poussez vers la branche
- Ouvrez une Pull Request
Changelog
Version 1.3
- Version actuelle du plugin
- Préservation des accents
- Nettoyage optimisé des caractères spéciaux
- Gestion des espaces multiples
Auteur
Cédric GIRARD
Site web : https://www.effi10.com
Support
Pour toute question ou support, visitez effi10.com ou contactez l'auteur.
Licence
Ce plugin est distribué sous licence GPL v2 ou ultérieure.