Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.Sign up
GitHub is where the world builds software
Millions of developers and companies build, ship, and maintain their software on GitHub — the largest and most advanced development platform in the world.
=== 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