WordPress.org

Plugin Directory

Unique Headers

Adds the ability to use unique custom header images on individual pages, posts or categories or tags.

I can't change the image on my categories/tags, what's wrong?

You need to install the Taxonomy Metadata plugin. WordPress does not support the taxonomy meta data which this plugin needs to use to store the custom header image URL. As soon as you install that plugin, the category/tag image functionality should begin working.

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.

This is because WordPress does not provide a place for us to store data connected to a taxonomy such as a category or post tag. The Taxonomy Metadata plugin works around this problem by implement taxonomy meta. Future versions of WordPress are likely to include taxonomy meta baked in, and when this happens, the Unique Headers plugin will be updated to use that new functionality.

Does it work with custom post-types?

Not out of the box, but you can modify the following code to add support to suit your own requirements. You can can add this code to either your theme or to a custom plugin. You will need to modify the post-type to suit your own requirements. Some knowledge of PHP coding is necessary for this step.

<?php

/*
 * Add support for a post-type called "some-post-type"
 *
 * @param   array   $post_types   The currently supported post-types
 * @return  array   $post_types   The modified list of supported post-types
 */
function unique_headers_add_post_type( $post_types ) {
    $post_types[] = 'some-post-type';

    return $post_types;
}
add_filter( 'unique_headers_post_types', 'unique_headers_add_post_type' );

?>

Does it work with taxonomies?

As with custom post-types, not out of the box. You can however modify the following code to add support to suit your own requirements. You can can add this code to either your theme or to a custom plugin. You will need to modify the taxonomy to suit your own requirements. Some knowledge of PHP coding is necessary for this step.

<?php

/*
 * Add support for a taxonomy called "some-taxonomy"
 *
 * @param   array   $taxonomies   The currently supported taxonomies
 * @return  array   $taxonomies   The modified list of supported taxonomies
 */
function unique_headers_add_taxonomy( $taxonomies ) {
    $taxonomies[] = 'some-taxonomy';
    return $taxonomies;
}
add_filter( 'unique_headers_taxonomies', 'unique_headers_add_taxonomy' );

?>

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?

Probably, 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?

No, I'm too busy. Having said that, if you are willing to pay me a small fortune then I could probably be persuaded. I'm also open to suggestions for improvements, so feel free to send me ideas and if you are lucky, it may be added for free :)

Requires: 4.1 or higher
Compatible up to: 4.3
Last Updated: 2015-3-24
Active Installs: 8,000+

Ratings

5 out of 5 stars

Support

3 of 3 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 100,1,1
100,1,1 100,2,2
100,1,1
0,1,0
100,1,1
100,2,2
100,1,1
100,1,1 100,1,1
100,1,1