Description
This plugin has been actively maintained since 2012 and is used on over 20,000 websites worldwide.
Fonctionnalités
L’extension Unique Headers ajoute une boîte d’image d’en-tête personnalisée à la page de modification d’une publication/page. Vous pouvez l’utiliser pour téléverser une image d’en-tête unique pour la publication/page ou utiliser une image de la médiathèque WordPress. Lorsque vous affichez cette page sur le site en ligne, l’image d’en-tête par défaut de votre site sera remplacée par l’image que vous avez choisi.
Cette fonctionnalité fonctionne également avec les catégories et les étiquettes.
Prérequis
Vous devez utiliser un thème qui utilise la fonction d’en-tête personnalisée intégrée de WordPress. Si votre thème implémente sa propre fonctionnalité d’en-tête, cette extension ne fonctionnera pas avec.
Développement WordPress payant
Si vous souhaitez payer pour une assistance, des fonctionnalités supplémentaires à ajouter à l’extension ou si vous recherchez simplement des services de développement WordPress, veuillez me contacter via mon formulaire de contact.
Development
This section is only relevant for developers building the plugin from source (e.g. cloning from GitHub). If you installed via WordPress.org, the plugin is ready to use — no build steps required.
The plugin uses Composer for PHP autoloading and dependencies, npm for JavaScript tooling, and TypeScript for admin JavaScript.
To set up a development environment:
- Install PHP dependencies:
composer install - Install JavaScript dependencies:
npm install - Compile TypeScript to JavaScript:
npm run build
To run tests and analysis:
- PHPCS (PSR-12 coding standards):
composer phpcs - Auto-fix PHPCS violations:
composer phpcbf - PHP-CS-Fixer (dry-run):
composer cs - PHP-CS-Fixer (auto-fix):
composer cs:fix - PHPStan static analysis:
composer phpstan - PHPUnit unit tests:
composer test - TypeScript type checking:
npm run typecheck
TypeScript source files are in src/ts/. The compiled output is written to assets/admin.js and is what WordPress loads on the admin side.
Credits
Thanks to the following for help with the development of this plugin:
* redactuk – Assistance with debugging.
* crabsallover – Assitance with debugging.
* Todd – Assistance with implementing support for tags.
* Mariano J. Ponce – Spanish translation.
* Tobias Klotz – Deutsch (German) language translation.
* Nadia Tokerud – Proof-reading of Norsk Bokmål (Norwegian) translation.
* Bjørn Johansen – Proof-reading of Norwegian Bokmål translation.
* Karl Olofsson – Proof-reading of Swedish translation.
* Jenny Beaumont – French translation.
Captures d’écrans
Installation
Après avoir téléchargé et décompressé les fichiers :
- Télécharger le dossier « unique-headers » dans le répertoire « /wp-content/plugins/ » OU installer l’extension via la page des extensions de WP.
- Activez l’extension via le menu « Extensions » de WordPress
- Et c’est terminé !
Vous verrez maintenant un nouveau téléverseur d’image d’en-tête personnalisé lors de la modification des publications, des pages, des étiquettes ou des catégories sur votre site.
Visitez la page de l’extension Unique Headers pour plus d’informations.
FAQ
-
J’ai défini une image d’en-tête de catégorie, pourquoi mes publications individuelles n’affichent pas cette image d’en-tête ?
-
Setting a category (or other taxonomy) header image, only causes that header image to show on the category page itself. It does not make the header image show on the single posts of that category.
To add this functionality, please install the Unique Headers single posts extension plugin.
-
Votre extension ne fonctionne pas
-
En fait, ça marche 😉 Le problème vient probablement de votre thème. Certains thèmes ont des « en-têtes personnalisés », mais n’utilisent pas le système d’en-tête personnalisé de WordPress et ne fonctionneront pas avec notre extension. Il n’est pas possible de prédire comment fonctionnent les autres systèmes d’en-tête personnalisés, et ceux-ci ne peuvent donc pas être pris en charge par l’extension. Pour tester si c’est le problème, passez simplement à l’un des thèmes par défaut fournis avec WordPress et voyez si l’extension fonctionne avec ceux-ci, si c’est le cas, alors votre thème est fautif.
-
Mon thème ne fonctionne pas avec votre extension, comment puis-je le réparer ?
-
C’est une question complexe et je ne peux pas y répondre dans une courte FAQ. Je recommande de faire appel à un développeur/développeuse WordPress professionnel pour obtenir de l’aide ou de demander au développeur/développeuse de votre thème d’ajouter la prise en charge du système d’en-tête personnalisé de WordPress.
-
Est-ce que l’extension fonctionne avec les types de publication ?
-
Oui, à partir de la version 1.5, la prise en charge des types de publication personnalisés visibles publiquement a été ajoutée par défaut.
-
Est-ce que l’extension fonctionne avec les taxonomies ?
-
Yes, as of version 1.5 of the Unique Headers plugin, support for all publicly viewable custom taxonomies was added by default.
-
Où est la page des réglages de l’extension ?
-
Il n’y en a pas.
-
D’autres extensions calculent la largeur et la hauteur de l’en-tête et proposent l’en-tête en taille correcte. Pourquoi votre extension ne le fait-elle pas ?
-
Je préfère vous permettre de définir vous-même la largeur et la hauteur en ouvrant une image de taille correcte. Cela vous permet de fournir des images en sur-résolution pour répondre à « l’écran rétina » et aux grands écrans. De plus, il vous permet de contrôler vous-même la compression et la qualité de l’image. Aucune des deux voies n’est la meilleure à mon avis. Si vous avez besoin de cette fonctionnalité, veuillez me le faire savoir, car si la plupart des gens préfèrent l’autre façon, je peux changer le fonctionnement de l’extension. Les gens ne s’en soucieront pas généralement.
-
Est-ce que l’extension fonctionne dans les anciennes versions de WordPress ?
-
Mostly, but I only actively support the latest version of WordPress. Support for older versions is purely by accident.
-
J’ai besoin d’une fonctionnalité personnalisée. Pouvons-nous vous payer pour le construire pour nous ?
-
Yes. Just send me a message via my contact form with precise information about what you require.
Avis
Contributeurs/contributrices & développeurs/développeuses
« Unique Headers » est un logiciel libre. Les personnes suivantes ont contribué à cette extension.
Contributeurs“Unique Headers” a été traduit dans 7 locales. Remerciez l’équipe de traduction pour ses contributions.
Traduisez « Unique Headers » dans votre langue.
Le développement vous intéresse ?
Parcourir le code, consulter le SVN dépôt, ou s’inscrire au journal de développement par RSS.
Journal des modifications
2.1.3 (2026-05-10)
- Resolved issue where custom header images would not display on WooCommerce product category pages due to taxonomy caching at plugin init time
- Restored ability to upload video headers in the customizer
2.1.2 (2026-05-08)
- Fix: Removed strict string type declarations from postHeaderImageFilter and taxonomyHeaderImageFilter to prevent TypeError when WordPress Customizer passes an array through the theme_mod_header_image filter
2.1.1 (2026-05-07)
- Fixing version number
- Shortening readme description to meet WordPress.org requirements
2.1 (2026-05-07)
- Fixed PSR-4 container namespacing bug
2.0.1 (2026-05-01)
- CI: restricted PHP version matrix to 8.4 and 8.5
- CI: fixed lock file resolution issue for different PHP versions
- Docs: added plugin longevity note (since 2012, 20,000+ sites)
- Docs: reorganized README sections for better user experience
2.0 (2026-05-01)
- Major architectural overhaul: migrated to PSR-4 autoloading with Composer and Inpsyde Modularity
- Replaced legacy classes with AdminModule, DisplayModule, and AttachmentHelper service
- Rewrote admin JavaScript as ES6 class without jQuery
- Migrated admin JavaScript to TypeScript with esbuild build pipeline
- Added shared view partial for image meta box
- Added PHP_CodeSniffer (PSR-12), PHPStan (level 6), PHP-CS-Fixer, and PHPUnit tooling
- Added unit tests with WordPress function stubs
- Added GitHub Actions CI workflow (PHP 8.2-8.5)
- Security: added capability checks to savePost and storeTaxonomyData
- Security: changed attachment ID sanitization from sanitize_text_field to absint
- Performance: scoped admin asset enqueues to post and term edit screens only
- Performance: consolidated taxonomy attachment lookup into shared helper
- Bug fix: prevented Shortcode UI plugin crash by setting wpActiveEditor dummy
- Bug fix: corrected broken URL check in admin.js media uploader
1.9.4 (2026-04-29)
- Version number bump
1.9.3 (2023-10-26)
- Fixed a bug in the DotOrg_Plugin_Review() class. The switch to === broke the no debug check, so this has been fixed.
1.9.2 (2023-10-26)
- Fixed a bug in the nonce system for taxonomy terms.
1.9.1 (2023-10-26)
- Temporarily preventing the DotOrg_Plugin_Review() class from loading due to a bug report relating to it. It will be re-added later.
1.9 (2023-10-20)
- Updated WordPress coding standards support
1.8.3 (2023-09-14)
- Confirmed support for newer WordPress versions
- Added Composer support
1.8.2 (2022-10-14)
- Bug fix for when array value doesn’t exist
1.8.1 (2022-01-16)
- Bug fix for offset value error
1.8 (2021-04-11)
- Bug fix for « WP_Scripts::localize was called » notice
1.7.12 (2021-04-06)
- Bug fix for when no object set in Unique_Headers_Taxonomy_Header_Images::modify_header_image_data()
1.7.11 (2020-03-08)
- Version bump to force dot org update
1.7.10 (2017-12-07)
- Correctly checking for presence of object before setting width and height
1.7.9 (2017-07-16)
- Checking for presence of object before setting width and height
1.7.8 (2017-03-28)
- Fixing filter bug
1.7.7 (2017-03-28)
- Fixing filter bug
1.7.6 (2017-03-28)
- Fixing bug in taxonomy setup
1.7.5 (2017-03-27)
- Fixing bug in taxonomy setup
1.7.4 (2017-03-27)
- Fixing bug in taxonomy setup
1.7.3 (2017-03-25)
- Bug fix for srcset with taxonomies
- Changed to class autoloader
- Moved instantiation class to it’s own file
- Added extendible core class
1.7.2 (2017-03-25)
- Bug fix for custom taxonomies
1.7.1 (2017-03-25)
- Bug fix to make srcset work correctly on regular header images
1.7 (2017-03-25)
- Added support for srcset.
- Confirmed support for TwentySixteen theme.
1.6.1 (2016-10-26)
- Added checks in file to see if WordPress is loaded.
- Hooking class instantiation in later, due to taxonomies sometimes not being loaded in time.
1.6 (2016-10-26)
- Removed admin notice from everywhere but the plugins page.
1.5.3 (2016-06-19)
- Fixing flawed bug fix from version 1.5.2.
1.5.2 (2016-06-19)
- Fixing bug reported by multiple users, which caused PHP errors on some setups.
1.5.1 (2016-04-15)
- Overhauled outdated FAQ section of readme.
1.5 (2016-03-22)
- Introduced unlimited taxonomy support.
- When using a blog page set to a static page URL, the image from the static pages custom header will be used.
- Adding support for all publicly viewable post-types.
- Adding support for all publicly viewable taxonomies.
1.4.8 (2016-03-20)
- Fixing a bug triggered by WordPress assigning non-URL’s as the URL.
1.4.7 (2015-12-13)
- Setting a more sane plugin review time.
1.4.6 (2015-10-31)
- Fixing bug with handling taxonomies. Added plugin review notice back, but without the non-existent MONTH_IN_SECONDS constant.
1.4.5 (2015-10-29)
- Removing plugin review notice due to unsolvable errors.
1.4.4 (2015-10-28)
- Adding plugin review class back, with correct time stamp set.
1.4.3 (2015-10-28)
- Temporarily removing plugin review class until bugs are fixed.
1.4.2 (2015-10-27)
- Adding a plugin review class.
1.4.1 (2015-10-26)
- Instantiating the plugin later (allows for adding additional post-types in themes).
1.4 (2015-08-21)
- Adding backwards compatibility to maintain header images provided by the Taxonomy metadata plugin.
1.3.12 (2015-03-24)
- Added French language translation.
1.3.11 (2015-02-19)
- Moved instantiation and localization code into a class.
1.3.10 (2015-02-18)
- Added Deutsch (German) language translation.
1.3.9 (2015-01-04)
- Fixing error which caused header images to disappear on upgrading (data was still available just not accessed correctly).
1.3.8 (2014-12-21)
- Modification translation system to work with changes on WordPress.org.
1.3.7 (2014-12-20)
- Addition of Spanish translation.
1.3.1 (2014-12-19)
- Adjustment to match post meta key to other plugins, for compatibilty reasons.
1.3 (2014-11-03)
- Total rewrite to use custom built in system for media uploads. Also adapted taxonomies to use ID’s and added support for extra post-types and taxonomies.
1.2 (2014-07-13)
- Converted to use the class from the Multiple Featured Images plugin.
1.1 (2014-04-19)
- Added support for tags.
1.0.4 (2013-02-14)
- Added support for displaying a category specific image on the single post pages.
1.0.3 (2012-12-09)
- Correction for $new_url for categories.
1.0.2 (2012-12-02)
- Bug fix to allow default header to display when no category specified.
1.0.1 (2012-11-07)
- Bug fixes for post/page thumbnails.
1.0 (2012-08-22)
- Version initiale




