WP Get Post Image

Description

This plugin provides the template tag wp_get_post_image(). Use it to call dynamically created images uploaded via the WordPress media uploader.

NOTE: This plugin is intended for use by WordPress developers and theme builders only.

Usage

<?php wp_get_post_image($args); ?>

Default Usage

<?php $args = array(
    'width' => null,
    'height' => null,
    'css' => '',
    'parent_id' => '',
    'post_id' => '',
    'filename' => '',
    'return_html' => true       
); ?>

By default, the function returns:

• The last uploaded image wrapped in an image tag (<img />).
• A proportionately sized image with a width no greater than 200px.
• The CSS class wp-image-*ID* and no other classes.
• If you add thickbox via css, the appropriate anchor <a> tag will be added for Thickbox compatibility.

Parameters

• width (integer) – Width of image.

• height (integer) – Height of image.

• parent_id (integer) – The ID of the post_parent for the attachment. Specifying the parent_id returns the first image attached to the parent post according to menu_order.

• post_id (integer) – The ID of the attachment.

• filename (string) – The filename that corresponds to the post_name of the attachment.

• return_html (boolean) – true returns the image wrapped in an XHTML image tag. false returns the image’s URL.

Example

<?php 
// use this example wherever you have access to $post->ID, e.g. the WordPress loop
if(function_exists('wp_get_post_image'))
    echo wp_get_post_image('width=450&css=alignleft&parent_id='.$post->ID);  
?>

Installation

Install the plugin as follows:

1. Upload the folder wp-get-post-image to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Place <?php echo wp_get_post_image(); ?> in your templates

FAQ

No questions yet.

Reviews

Contributors & Developers

Changelog

0.2 (2010-01-26)

• Adjusted $image->basepath to reference get_bloginfo('wpurl') instead of get_bloginfo('url'). This makes the plugin work when WordPress is installed in one directory while the blog displays in another. (HT: Mike Cohen)

0.1 (2009-11-23)

• first version