=== Plugin Name ===
Contributors: marcus.kober
Donate link: http://www.amazon.de/registry/wishlist/16KTW9ZG027C8
Tags: image, featured image, thumbnails, media
Requires at least: 2.9.2
Tested up to: 3.3.2
Stable tag: 0.3 License: GPLv2 or later
Enables multiple featured images for posts and pages.
== Description ==
= Multiple featured images =
This plugin allows you to add additional featured images to a post or page. = Features =
1. Add as many featured images as you need
1. Fully customizable output - so it's multilingual
= History =
For one of my customers I had to assign two featured images to pages. One featured image was used as the
header image and the other as a small button for the submenu. The images had to be different too (so I couldn't simply use different images sizes) and so I wrote this little plugin.
= You = Feel free to ask if you have problems with this plugin. Feature requests are welcome too! And please correct my bad english if it bugs you. ;)
== Installation ==
1. Unzip and upload the `multiple-featured-images` directory to the plugin directory (`/wp-content/plugins/`)
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Registration of a new featured image:
if( class_exists( 'kdMultipleFeaturedImages' ) ) {
$args = array(
'id' => 'featured-image-2',
'post_type' => 'post', // Set this to post or page
'labels' => array(
'name' => 'Featured image 2',
'set' => 'Set featured image 2',
'remove' => 'Remove featured image 2',
'use' => 'Use as featured image 2',
)
);
new kdMultipleFeaturedImages( $args );
}
1. Display the featured image in your theme (e.g. in header.php or single.php):
if( class_exists( 'kdMultipleFeaturedImages' ) ) {
kd_mfi_the_featured_image( 'featured-image-2', 'post' );
}
== Frequently Asked Questions ==
= How do I register multiple new featured images? =
You can call new kdMultipleFeaturedImages( $args ); multiple times with different arguments in $args.
For expample:
$args1 = array(
'id' => 'featured-image-2',
'post_type' => 'post', // Set this to post or page
'labels' => array(
'name' => 'Featured image 2',
'set' => 'Set featured image 2',
'remove' => 'Remove featured image 2',
'use' => 'Use as featured image 2',
)
);
$args2 = array(
'id' => 'featured-image-3',
'post_type' => 'post', // Set this to post or page
'labels' => array(
'name' => 'Featured image 3',
'set' => 'Set featured image 3',
'remove' => 'Remove featured image 3',
'use' => 'Use as featured image 3',
)
);
new kdMultipleFeaturedImages( $args1 );
new kdMultipleFeaturedImages( $args2 );
= How do I use a different size of the featured image? =
Simply add the size to the function call:
kd_mfi_the_featured_image( 'featured-image-2', 'post', 'full' );
You can choose every size that WordPress knows.
= How can I get the ID of the featured image? =
With this function call you can get the ID:
kd_mfi_get_featured_image_id( 'featured-image-2', 'post' );
*Note:* Since a featured image has only one individual id, there is no option 'size' in this function call.
= How can I get the URL of the featured image? =
With this function call you can get the URL:
kd_mfi_get_featured_image_url( 'featured-image-2', 'post', 'full' );
= Which functions do exist? =
1. If you need the ID only, use this function:
kd_mfi_get_featured_image_id( $image_id, $post_type, $post_id );
$post_id is optional, if you leave it out, the ID of the calling post or page is used.
1. To get the URL of the image:
kd_mfi_get_featured_image_url( $image_id, $post_type, $size, $post_id );
$post_id is optional (see above); $size is option and defaults to 'full'.
1. To get the featured image in HTML as a string:
kd_mfi_get_the_featured_image( $image_id, $post_type, $size, $post_id );
Again, $size and $post_id are optional.
1. To display the featured image directly:
kd_mfi_the_featured_image( $image_id, $post_type, $size, $post_id ) {
Again, $size and $post_id are optional.
== Screenshots ==
1. Admin meta box with secondary featured image.
2. Media upload iFrame with 'Use as featured image 2' link.
== Changelog ==
= 0.3 =
* Bug fix: no output of url when a size is given
= 0.2 =
* Code completely rewritten
= 0.1 =
* Initial release.
== Upgrade Notice ==
= 0.2 = Code completely rewritten. Plugin is faster now.
= 0.1 =
Initial release