Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


=== WP Display Header ===
Contributors: kobenland
Tags: admin, custom header, header, header image, custom header image, display header, display dynamic header, custom, dynamic, fast, header, image, images, page, plugin, posts
Donate link:
Requires at least: 3.2
Tested up to: 3.6
Stable tag: 2.1.0

Select a specific header or random header image for each content item or archive page.

== Description ==

This plugin lets you specify a header image for each post, page, custom post type or archive page individually, from your default headers and custom headers.

It adds a meta box in the post edit screens with the header selection and a settings field in the edit profile and each taxonomy edit screen.
If no specific header is specified for a post it will fall back to the default selection.
There is no change of template files necessary as this plugin hooks in the existing WordPress API to unfold its magic.

= Translations =
I will be more than happy to update the plugin with new locales, as soon as I receive them!
Currently available in:

* English
* Deutsch
* Italiano

Thanks to Erik T. for the idea to this plugin!

== Installation ==

1. Download WP Display Header.
2. Unzip the folder into the `/wp-content/plugins/` directory
3. Activate the plugin through the 'Plugins' menu in WordPress

== Frequently Asked Questions ==

= What do I need in the `header.php` file to make the plugin work seamlessly? =
To make it work in your `header.php` file all you need is a `header_image()` call like so:

`<img src="<?php header_image(); ?>" width="<?php echo HEADER_IMAGE_WIDTH; ?>" height="<?php echo HEADER_IMAGE_HEIGHT; ?>" alt="" />`

See TwentyEleven's `header.php` for reference.

= Plugin Filter Hooks =

**wpdh_show_default_header** (*bool*)
> Whether to show the default header (true) or to look for a specifically selected header for the current request.

**wpdh_get_header_posts** (*array*)
> All attachments with the meta key `_header_image`. An array with the query vars.

**wpdh_get_headers** (*array*)
> The array with all registered headers.

**wpdh_get_active_post_header** (*string*)
> The url to the currently active header image.

== Screenshots ==

1. The meta box in the main column.
2. The meta box in the side column.

== Changelog ==

= 2.1.0 =
* Added an option to not display a header at all.
* Updated utility class.
* Tested for WordPress 3.6.

= 2.0.1 =
* Fixed a bug, where the fallback to the default header did not work. Props carloscorrela.

= 2.0.0 =
* **IMPORTANT**: Version 2.0.0 breaks compatibility with WordPress versions **prior** to 3.2!
* Added the header selection field to Taxonomy and Author Edit screens.
* Fixed a minor bug for themes that have no header images registered.

= 1.5.3 =
* Improved user experience when current theme does not support custom headers, on activation of the plugin.
* Deprecated settings functions for WP Save Custom Header in preparation for overhaul in v2.0.0.
* Updated utility class.

= 1.5.2 =
* Fixed a bug, where a selected header wouldn't override the default selection on posts pages.

= 1.5.1 =
* Specific headers can now be reverted by selecting the default header.

= 1.5 =
* Adjusted meta box layout to WordPress core.
* Transfered CSS in external file.
* Updated FAQ section. Props Brian.
* Tested for WordPress 3.3.1.

= 1.4 =
* Added support for WordPress 3.2 core header uploads.

= 1.3 =
* Tested for WordPress 3.2-beta
* Fixed a minor bug where a PHP warning was issued in the edit-post-screen, when there are no header images registered.

= 1.2.1 =
* WordPress Plugin Repository update bug.

= 1.2 =
* Tested for WordPress 3.1.2.
* Now a custom folder name can be specified. See: Settings > Media.
* Added Italian translation. Props Pietro Rossi.

= 1.1 =
* Tested for WordPress 3.1.1
* Adopted [WP Save Custom Header]( "This plugin lets you save and reuse your uploaded header images.") multisite capability.
* Made HTML W3C valid.

= 1.0 =
* Initial Release.

== Upgrade Notice == 
Maintenance update


No releases published


No packages published


You can’t perform that action at this time.