Title: Unique Headers Author: Ryan Hellyer Published: 25 ژوئن 2012 Last modified: 1 می 2026 --- جستجوی افزونه‌ها ![](https://ps.w.org/unique-headers/assets/banner-772x250.png?rev=1049672) ![](https://s.w.org/plugins/geopattern-icon/unique-headers_c1b4ac.svg) # Unique Headers توسط [Ryan Hellyer](https://profiles.wordpress.org/ryanhellyer/) [دانلود](https://downloads.wordpress.org/plugin/unique-headers.2.0.1.zip) * [جزئیات](https://fa.wordpress.org/plugins/unique-headers/#description) * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/unique-headers/#reviews) * [نصب](https://fa.wordpress.org/plugins/unique-headers/#installation) * [توسعه](https://fa.wordpress.org/plugins/unique-headers/#developers) [پشتیبانی](https://wordpress.org/support/plugin/unique-headers/) ## توضیحات #### Features The [Unique Headers Plugin](https://geek.hellyer.kiwi/products/unique-headers/) adds a custom header image box to the post/page edit screen. You can use this to upload a unique header image for that post, or use another image from your WordPress media library. When you view that page on the front-end of your site, the default header image for your site will be replaced by the unique header you selected. This functionality also works with categories and tags. #### Requirements You must use a theme which utilizes the built-in custom header functionality of WordPress. If your theme implement it’s own header functionality, then this plugin will not work with it. #### Paid WordPress development If you would like to pay for assistance, additional features to be added to the plugin or are just looking for general WordPress development services, please contact me via [my contact form](https://ryan.hellyer.kiwi/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: 1. Install PHP dependencies: `composer install` 2. Install JavaScript dependencies: `npm install` 3. 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](http://onmytodd.org) – Assistance with implementing support for tags. * [Mariano J. Ponce](http://westoresolutions.com/) – Spanish translation. * [Tobias Klotz](http://www.graphicana.de/) – Deutsch (German) language translation. * [Nadia Tokerud](http://nakri.co.uk/) – Proof-reading of Norsk Bokmål( Norwegian) translation. * [Bjørn Johansen](http://bjornjohansen.no/) – Proof-reading of Norwegian Bokmål translation. * [Karl Olofsson](https://www.facebook.com/kaljam/) – Proof- reading of Swedish translation. * [Jenny Beaumont](http://www.jennybeaumont.com/) – French translation. ## عکس‌های صفحه * [[ * The new meta box as added to the posts/pages screen * [[ * The custom header image uploader for adding new header images * [[ * The new meta box for categories and tags. ## نصب After you’ve downloaded and extracted the files: 1. Upload the complete ‘unique-headers’ folder to the ‘/wp-content/plugins/’ directory OR install via the plugin installer 2. Activate the plugin through the ‘Plugins’ menu in WordPress 3. And yer done! Now you will see a new custom header image uploader whilst editing posts, pages, tags or categories on your site. Visit the [Unique Headers Plugin](https://geek.hellyer.kiwi/products/unique-headers/) for more information. ## سوالات متداول ### I set a category header image, but why are my individual posts not showing that header image? 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](https://geek.hellyer.kiwi/plugins/unique-headers-single-posts/). ### Your plugin doesn’t work Actually, it does work 😉 The problem is likely with your theme. Some themes have“ custom headers”, but don’t use the built-in WordPress custom header system and will not work with the Unique Headers plugin because of this. It is not possible to predict how other custom header systems work, and so those can not be supported by this plugin. To test if this is the problem, simply switch to one of the default themes which come with WordPress and see if the plugin works with those, if it does, then your theme is at fault. ### My theme doesn’t work with your plugin, how do I fix it? This is a complex question and not something I can teach in a short FAQ. I recommend hiring a professional WordPress developer for assistance, or asking the developer of your theme to add support for the built-in WordPress custom header system. ### Does it work with custom post-types? Yes, as of version 1.5, support for publicly viewable custom post-types was added by default. ### Does it work with taxonomies? Yes, as of version 1.5 of the Unique Headers plugin, support for all publicly viewable custom taxonomies was added by default. ### Where’s the plugin settings page? There isn’t one. ### Other plugins work out the width and height of the header and serve the correct sized header. Why doesn’t your plugin do that? I prefer to allow you to set the width and height yourself by opening a correct sized image. This allows you to provide over-resolution images to cater for “retina screen” and zoomed in users. Plus, it allows you to control the compression and image quality yourself. Neither route is better in my opinion. If you require this functionality, please let me know though, as if most people prefer the other route, then I may change how the plugin works. I suspect most people won’t care either way though. ### Does it work in older versions of WordPress? Mostly, but I only actively support the latest version of WordPress. Support for older versions is purely by accident. ### I need custom functionality. Can we pay you to build it for us? Yes. Just send me a message via [my contact form](https://ryan.hellyer.kiwi/contact/) with precise information about what you require. ## نقد و بررسی‌ها ![](https://secure.gravatar.com/avatar/c6def519a1e1f7b86e22c346431c2edce9e4346d9bcacc22e49aba979e766020? s=60&d=retro&r=g) ### 󠀁[Simply Awesome](https://wordpress.org/support/topic/simply-awesome-339/)󠁿 [italliance](https://profiles.wordpress.org/italliance/) 6 می 2024 Super easy to use. Thank you for developing this. ![](https://secure.gravatar.com/avatar/3150b47c2b98cb72c32b16059a3d4cfbee2d313c9f85930a2bec31aecb1c44a6? s=60&d=retro&r=g) ### 󠀁[works perfectly](https://wordpress.org/support/topic/works-perfectly-2702/)󠁿 [SSVapes](https://profiles.wordpress.org/username12/) 26 اکتبر 2023 1 پاسخ works perfectly. the shortcodes could be better ![](https://secure.gravatar.com/avatar/514e318216d1cee070a4b29429fe5797161a9b644ec024da1dc063fc678f63ba? s=60&d=retro&r=g) ### 󠀁[Great job!](https://wordpress.org/support/topic/great-job-1247/)󠁿 [laserulm](https://profiles.wordpress.org/laserulm/) 5 دسامبر 2022 thx ![](https://secure.gravatar.com/avatar/e3f70cfb4490b7adefece06ff05fe299053f99cc77a3f1deddd9c4644752222b? s=60&d=retro&r=g) ### 󠀁[This plugin changed my life](https://wordpress.org/support/topic/this-plugin-changed-my-life-6/)󠁿 [Jeffrey Whitmore](https://profiles.wordpress.org/machinelf/) 22 اکتبر 2022 3 پاسخ Why isn’t it part of default? It took me a month to make a bunch of header images and put them in all my old posts. It was awesome! No sarcasm. This made my posts so much better. ![](https://secure.gravatar.com/avatar/7cf11fc6f55ac74cb7992831fb71335a3c532fee6dde746e1ce2b572f5d492c7? s=60&d=retro&r=g) ### 󠀁[Should be a standard function of wordpress](https://wordpress.org/support/topic/should-be-a-standard-function-of-wordpress/)󠁿 [singingfalls](https://profiles.wordpress.org/singingfalls/) 15 ژانویه 2022 2 پاسخ Easy to use. A real asset to site customization. My gratitude for it’s production. ![](https://secure.gravatar.com/avatar/d4395120caffb8dc6f9eedfe7f6149f76a933a07b3496f520f0f80b4b8b69a95? s=60&d=retro&r=g) ### 󠀁[Does the job, but not easy to use.](https://wordpress.org/support/topic/does-the-job-but-not-easy-to-use/)󠁿 [fureniku](https://profiles.wordpress.org/fureniku/) 10 ژوئن 2021 The plugin does technically do its job of allowing a unique header per page. However, it offers absolutely no guidelines on how your base image should be in terms of size or aspect ratio, and no cropping or positioning tools, leaving you to trial and error to try and get an image that actually shows up correctly with your theme. It’s very frustrating and time consuming, but does look good once finished. [ خواندن تمامی 160 نقد و بررسی‌ ](https://wordpress.org/support/plugin/unique-headers/reviews/) ## توسعه دهندگان و همکاران “Unique Headers” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند. مشارکت کنندگان * [ Ryan Hellyer ](https://profiles.wordpress.org/ryanhellyer/) “Unique Headers” به 7 زبان ترجمه شده است. با تشکر از [مترجمین](https://translate.wordpress.org/projects/wp-plugins/unique-headers/contributors) برای همکاری و کمک‌هایشان. [ترجمه “Unique Headers” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/unique-headers) ### علاقه‌ مند به توسعه هستید؟ [Browse the code](https://plugins.trac.wordpress.org/browser/unique-headers/), check out the [SVN repository](https://plugins.svn.wordpress.org/unique-headers/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/unique-headers/) by [RSS](https://plugins.trac.wordpress.org/log/unique-headers/?limit=100&mode=stop_on_copy&format=rss). ## گزارش تغییرات #### 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) * Initial release. ## اطلاعات * نگارش **2.0.1** * Last updated **5 روز پیش** * نصب‌های فعال **20,000+** * نگارش وردپرس ** 4.3 یا بالاتر ** * Tested up to **7.0** * زبان‌ها * [Dutch](https://nl.wordpress.org/plugins/unique-headers/)، [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/unique-headers/)، [English (Canada)](https://en-ca.wordpress.org/plugins/unique-headers/)، [English (US)](https://wordpress.org/plugins/unique-headers/)، [French (France)](https://fr.wordpress.org/plugins/unique-headers/)، [German](https://de.wordpress.org/plugins/unique-headers/)، [Hindi](https://hi.wordpress.org/plugins/unique-headers/)، و [Swedish](https://sv.wordpress.org/plugins/unique-headers/). * [به زبان خودتان ترجمه کنید](https://translate.wordpress.org/projects/wp-plugins/unique-headers) * Tags * [custom header](https://fa.wordpress.org/plugins/tags/custom-header/)[header](https://fa.wordpress.org/plugins/tags/header/) [headers](https://fa.wordpress.org/plugins/tags/headers/)[images](https://fa.wordpress.org/plugins/tags/images/) [page](https://fa.wordpress.org/plugins/tags/page/) * [نمایش پیشرفته](https://fa.wordpress.org/plugins/unique-headers/advanced/) ## امتیازها 4.9 از 5 ستاره. * [ امتیاز 155 5-ستاره ](https://wordpress.org/support/plugin/unique-headers/reviews/?filter=5) * [ امتیاز 3 4-ستاره ](https://wordpress.org/support/plugin/unique-headers/reviews/?filter=4) * [ امتیاز 1 3-ستاره ](https://wordpress.org/support/plugin/unique-headers/reviews/?filter=3) * [ امتیاز 0 2-ستاره ](https://wordpress.org/support/plugin/unique-headers/reviews/?filter=2) * [ امتیاز 1 1-ستاره ](https://wordpress.org/support/plugin/unique-headers/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/unique-headers/reviews/#new-post) [مشاهده همه بررسی‌ها](https://wordpress.org/support/plugin/unique-headers/reviews/) ## مشارکت کنندگان * [ Ryan Hellyer ](https://profiles.wordpress.org/ryanhellyer/) ## پشتیبانی چیزی برای گفتن دارید؟ نیاز به کمک دارید؟ [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/unique-headers/) ## کمک مالی آیا تمایل دارید از پیشرفت این افزونه حمایت کنید؟ [ کمک مالی به این افزونه ](https://geek.hellyer.kiwi/donate/)