WP Display Header

Posted on February 2, 2012 by Konstantin Obenland

Read in:
Deutsch

This plugin lets you specify a header image for each post individually from your default headers and custom headers.

Description

It adds a meta box in the post edit screens with the header selection. 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

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

Installation

Download WP Display Header.
Unzip the folder into the /wp-content/plugins/ directory
Activate the plugin through the ‘Plugins’ menu in WordPress

Screenshots

WordPress meta box — The meta box in the main column

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.

Changelog

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 (thanks 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 (Thanks to Pietro Rossi)

1.1

Tested for WordPress 3.1.1
Adopted WP Save Custom Header multisite capability
Made HTML W3C valid

1.0

Initial Release

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.

52 thoughts on “WP Display Header”

Michael Hughes on February 7, 2012 at 4:49 am said:

This is wonderful, but what if I only want a header on ONE page? Can you update this plugin to allow a user to select no header image? Thanks!
- Konstantin Obenland on February 7, 2012 at 9:39 am said:
  
  Hello Michael,
  
  you could remove the default header image under Appearance > Header and set a specific header for that one page. Please let me know if that didn’t work out for you.
  
  Thank you for your feedback!
  - Krol on March 4, 2012 at 10:22 pm said:
    
    This works. But only if you didn’t choose header image using this plug-in already. I didn’t find an option to disable it after that. Or revert to default theme header image state (which could be disabled).
    
    But anyway, thank you for your work!
Schalk on March 6, 2012 at 10:08 am said:

Hi
Using your plugin with Woo Theme’s Simplicity theme, I get an error message when trying to activate:

Plugin could not be activated because it triggered a fatal error.
Your current theme does not support Custom Headers

is there a way to fix it?

Thanx
- Konstantin Obenland on March 6, 2012 at 12:45 pm said:
  
  Hi Schalk,
  
  yes, you could use a Theme that supports the Custom Header functionality.
  You recognize a Theme that does, by the ‘Header’ page in the ‘Appearance’ menu.
  
  Let me know if you need further assistance.
John on March 28, 2012 at 4:04 am said:

Hi, I was wondering if there was a way using the current Twenty Eleven theme for wordpress to allow a header to show up on an archive page and have a specific header for various archive sections, such as individual author page headers (page just being the archive for that author) or tagged pages,

for example, http://www.yourwordpresssite.com/archives/author/johndoe or http://www.yourwordpresssite.com/archives/category/misc or
http://www.yourwordpresssite.com/archives/tag/misc

it seems that if I make a change to the archive header it changes to all archives regardless of whether they are author, category or tags or separated out such as author/johndoe or author/janedoe.

Any thoughts would be welcome,
Thanks
- Konstantin Obenland on March 28, 2012 at 9:05 am said:
  
  Hi John,
  
  I am currently working on an update which adds that functionality. Would you be interested to beta-test it and give me feedback about issues you run into?
  
  Thanks,
  Konstantin
  - John on April 1, 2012 at 5:02 pm said:
    
    Sure, be happy to help.
Caleb on April 11, 2012 at 5:55 am said:

Being able to associate a specific banner with a page is a great feature. Thank you!

Clicking on the different banners, however, always leads to the home page.

Is there a way to associate a different URL with each banner?

If so, how do I accomplish that?
- Konstantin Obenland on April 11, 2012 at 7:33 am said:
  
  This would be something out of the scope for plugins, unfortunately. What you can do though, is to create a Child Theme and change the anchor manually in the Child Theme’s implementation of the feature.
  
  Konstantin
Mari on May 8, 2012 at 1:49 am said:

I have the custom headers working on each page except the home pg. This theme does not have a home pg. How do I fix this?
- Konstantin Obenland on May 8, 2012 at 3:59 pm said:
  
  By choosing a header in the Appearance > Header menu for you site?
  - Mari on May 8, 2012 at 4:49 pm said:
    
    Did that. The website settings under “Reading” is set for the home page to be the Latest Posts… could that effect it? Right now I deactivated the plugin so a header is on each page. When I activate it, the headers show on all the pages but the home. Thanks for your help. Love this plugin.
Burçin Ugur on May 25, 2012 at 7:21 pm said:

Very nice work. I d like to ask something. I cant see all pictures in header list that ı uploaded before. Can you please tell me what to do ?

Thank you
- Konstantin Obenland on May 26, 2012 at 10:41 am said:
  
  Hi Burçin,
  
  thanks for your feedback!
  
  Unfortunately I can’t. The Plugin pulls all headers that your Theme registered and that you uploaded in the Header admin screen.
  Did you add the missing header images any other way?
  
  Konstantin
  - Burçin Ugur on May 26, 2012 at 1:04 pm said:
    
    Yes that’s way to see headers after spending 2 hours for discovering.Your plugin works like a charm. I dlike to ask you one more question if you have any information. Is there anyway to post in a specific category without shown in home page. As an ex. I post something ,it appears on my main page but I d like it to be seen only in category that I created.
    
    Thanks again for nice plugin .
    - Konstantin Obenland on May 28, 2012 at 3:01 pm said:
      
      Hm, this would probably be suited best for the WordPress Forums. They can definitely help you with this.
Harman on June 13, 2012 at 9:10 am said:

Thank you for a wonderful plug-in! It fills a big void in the standard WP toolkit. I’m using WP Display Header on my website, and I have one question.

I’ve uploaded two custom header images (let’s call them A and B), and all pages use one or the other. My site has a static front page, with the blog being on another page. The image I set in WP Display Header as the blog page header, however, won’t stick. It’s using header A, even though I’ve set it to use header B.

I have solved this by changing the standard header preferences in the regular WP settings. If I set THAT to header B, it shows op on the blog page. Is it correct that the general WP headers settings will always override your plug-in’s settings for the blog page?

It’s all working for me now, but I was just curious about this.

As an aside, if you’re considering translating the plug-in into Dutch, I’d be happy to help. I cannot code or program, but if you give me the texts you need in a Word file, I’ll gladly translate them for you. 🙂
- Konstantin Obenland on June 14, 2012 at 7:56 am said:
  
  Yes, general Header settings will override specific one on the blog page. This is Core behavior though, that I didn’t change, I thought it made kind of sense.
  
  I’m very excited that you would consider taking the time to contribute with a translation! There is this awesome plugin Codestyling Localization, which brings a translation interface into your WordPress Admin. There you can add languages (for all installed Themes and Plugins BTW) and translate away.
  I’m sure many Dutch users would also be exited to have a localized version running on their installs!
  
  Thanks, Konstantin
work on July 1, 2012 at 1:56 pm said:

I entered the <img src="” width=”” height=”” alt=”” /> line in my header.php file, but it still says that my theme doesn’t support custom headers. How come?
- Konstantin Obenland on July 1, 2012 at 2:09 pm said:
  
  You still need to register theme support for this feature in functions.php. See Twenty Eleven’s implementation for reference.
work on July 1, 2012 at 4:09 pm said:

I found out the plugin couldn’t be activated because I didn’t have add_theme_support( ‘custom-header’ ); in functions.php (it was blank).
Pingback: My First Patch « Konstantin on WordPress
Mark Michael on August 31, 2012 at 11:08 pm said:

How do I get a new header image to show up as a Header image that the app will recognize? I added file to my media, but it does not show up as a selection for a specific page???
- Konstantin Obenland on August 31, 2012 at 11:10 pm said:
  
  By either uploading it in Settings > Header, or choosing it in Settings > Header through the “Choose an image from your media library: Choose Image” button.
Alex on October 1, 2012 at 1:45 pm said:

Hi, I’d like to translate the theme to spanish, What I have to do?, download Codestyling Localization plugin?

Best Regards
- Konstantin Obenland on October 8, 2012 at 5:47 pm said:
  
  Hi Alex,
  
  that’s awesome, thank you!
  Yes, Codestyling Localization is a great tool to help you with the translation.
  I’m looking forward to the results! 🙂
fullflyght on October 14, 2012 at 9:01 pm said:

Thanks Konst! We love your plugin Header.
Full FLyght – Los Angeles.
- Konstantin Obenland on October 14, 2012 at 10:02 pm said:
  
  Thanks! 🙂
gaspas on October 18, 2012 at 5:38 am said:

Nice plugin, congratz Obenland, here are the translation to pt_PT, http://gaspar.com.pt/etc/wp-display-header-pt_PT.zip.

But now i’am digging in your code trying to undertsand I doesn’t work for custom types.
Probably I’ll have to change a little ur code.

Gaspar
- gaspas on October 18, 2012 at 5:51 am said:
  
  eh eh, forget that “dont work”, it’s works well in custom. Cheers
- gaspas on October 18, 2012 at 6:12 am said:
  
  One question, do u think it’s easy to:
  
  if no header to this post and have post_parent get post parent header
  
  I’am not expert in code, but i see that is somewhere in ur get_active_post_header()
demoree on November 1, 2012 at 1:06 pm said:

Thank you so much for this plugin. I have my blog set to a static page. How can i get a header to show up on the blog index page(that is different from the default header)? I tried going to the blog page and setting a header through featured image (my blog supports custom headers) but it didn’t work. My theme is custom but based on toolbox. Thank you so much!
- Konstantin Obenland on November 2, 2012 at 9:24 pm said:
  
  Hi there, thank you for your feedback!
  The header shown on the blog index page will always be the default header. If you are comfortable with PHP, you can override that logic with a filter.
Daryl on November 13, 2012 at 9:46 am said:

Do you have plans to update this plug in for WordPress 3.4.2.? If so, do you have an eta on delivery?

Thanks.
- Konstantin Obenland on November 13, 2012 at 9:49 am said:
  
  Hi Daryl,
  
  Is it broken in 3.4.2?
  
  I’m currently looking at updating it for 3.5, so probably early December.
Helene on February 11, 2013 at 4:47 pm said:

Love the plugin. I can get the headers I want on each specific page which is great – but I want a to randomly display only one of 3 headers on the home page which is static (the home page headers are different size) Any chance of getting this update or helping me add this to what I have currently? Thanks so much!
- Konstantin Obenland on April 29, 2013 at 9:38 pm said:
  
  I’m sorry Helene, but I think that would be out of scope for the plugin.
Rob on February 20, 2013 at 1:19 pm said:

Your plug works great. I’m currently using the twenty twelve theme and would like to not have an image on my static homepage to allow room for a slider. No image is set but I get an empty box that I cannot figure how to get rid of. Any help would be appreciated.
- Konstantin Obenland on February 21, 2013 at 5:26 pm said:
  
  I’m sorry Rob, but due to the volume of support requests I have to ask you to post to the support forums where a volunteer might be able to help you with customizations.
Vikki on April 21, 2013 at 5:02 pm said:

My headers disappear in IE8, is there a remedy?
- Konstantin Obenland on April 27, 2013 at 3:42 am said:
  
  This appears to be an issue with the theme you are using.
  The plugin has no effect on how the image is displayed, it only alters the source of the image.
Lorne on May 13, 2013 at 11:25 am said:

Great plugin! Is it possible to display a header based on incoming search terms? For example, if the site visitor arrived from Google via a keyword search including “apple” or “orange”, can that info be used to display the appropriate header image?
- Konstantin Obenland on May 13, 2013 at 1:09 pm said:
  
  Thanks!
  I’m sure it is, just use the provided filter hooks and add your own callback function to make that determination! 😉
Lorne on May 14, 2013 at 6:33 am said:

Thanks for the quick reply! Can you explain that in a little more detail?
Jane on June 8, 2013 at 11:33 am said:

My header appears too small. How can I fix that?
Thanks
- Konstantin Obenland on July 8, 2013 at 8:03 am said:
  
  This sounds like a theme issue to me. WP Display Header does not alter any frontend styles, it only changes the image URL to work with.
Rubber Duck Does Photography on June 13, 2013 at 12:23 pm said:

Hi I have a problem when the page is viewed with the plug-in it adds 0.000000 in the middle of the image src call so giving a broken image. Can you help?
- Rubber Duck Does Photography on June 13, 2013 at 1:07 pm said:
  
  On further investigation it only seems to want to work with the default headers and not any that you upload
  - Konstantin Obenland on July 8, 2013 at 8:04 am said:
    
    I’m sorry I could not reproduce that. It sounds to me like there is something wrong with the uploaded images or the uploader itself.
akismet-4ac281a6030da5885f223fcc3b5e8f20 on July 5, 2013 at 1:54 am said:

Thank you for the neat plugin that solved my problem. It is just a little messy, when adding many pages with own headers, to have to leave the page to upload the header, come back, select it. Could you add the possibility to upload a new header directly in the page editor ?
- Konstantin Obenland on July 8, 2013 at 7:50 am said:
  
  This sounds like something that would make sense to add. I’m fairly busy these days, so I’m not sure when I get around to it though.
Konstantin Obenland on July 8, 2013 at 7:54 am said:

Howdy,

I decided to close comments here and link to the plugin’s support forum instead. I hope this will give everyone a better chance to receive an answer to their question in a reasonable time as I’m not always able to react to comments right away.

Thanks!