Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
PHP
branch: master
Failed to load latest commit information.
css Updated utility class, documentation and CSS
lang Bump German translation (WPDH)
obenland-wp-plugins.php Adds an option to have no header on a page.
readme.txt Adds an option to have no header on a page.
screenshot-1.png Updated sceenshots
screenshot-2.png Updated sceenshots
uninstall.php
wp-display-header.php Adds an option to have no header on a page.

readme.txt

=== 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: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=MWUA92KA2TL6Q
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](http://wordpress.org/extend/plugins/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
Something went wrong with that request. Please try again.