Using parametersEach function can be used with numerous parameters to manage display or how or where thumbnails are saved. You do not have to use them unless you want different settings from the default options you have choosen in the option screen.
Each parameter should be input with its value separated with '=' and separated from the other parameters with '&'.
Example:
<?php get_recent_thumbs('WIDTH=100&HEIGHT=80&ROUNDED=1&LIMIT=12'); ?>
Display parameters- WIDTH: resize width. Overides default if greater than 0.
- HEIGHT: resize height. Overides default if greater than 0.
- HCROP: horizontal crop. Crops if greater than 0.
- VCROP: vertical crop. Crops if greater than 0.
- KEEPRATIO: if set to 1, image ratio is kept. Overides default if it exists.
- ROUNDED: creates thumbnails with rounded corners. Overides default if it exists.
- MAX (0|1): resizes only if the original image is larger than targeted sizes. Works only if keepratio is set to 1. Overide default if exists.
Addtitional display parameters- TEXTBOX: write a text in the bottom = 1. Default is 0.
- TEXT: text to be written if TEXTBOX is set to 1.
- SHOWTITLE: display title, author or date below the thumbnail. Parameters: T, A, D.
- TITLE: choose wether content (C), excerpt (E) or title (T) is used in title tag of the thumbnail. Default is 'T'.
- MYCLASSHREF: output class name in html <a class="myclasshref" href=...>
- MYCLASSIMG: output class name in html <img class="myclassimg" href=...>
- LB_EFFECT: use highslide to display image or link.
- CAPTION: display or not the caption for pictures.
- NOFORM: skip all tab and return in the code (\n and \t).
- OBJECT: returns an object or an array of objects instead of a display string.
- ID: post ID
- image_url: image url
- media_url: media url
- categories: coma separated list of category IDs attached to the post
- title: post title
- date: post date
- permalink: post permalink
- author: author name and link
- link: url to which the image is attached (used if link=u)
- thumb_url: thumbnail url
- thumb_html: display html string (this is what would be returned without the parameter)
Savings parameters- ALTAPPEND: text to append to create thumbnail name. Overide default if exists.
- APPEND: forces append or prepend of thumbnail prefix.
- MIME (jpg/png): force type of thumbnail.
- BASENAME: force generation of thumbnail and use generic name. Default is 0. Used in the random function.
- SUBFOLDER: name of the subfolder to save thumbnails in. Only one level, no wrapping '/'.
- DIRNAME (0/n): includes image directory in thumbnail name (convenient for digital camera images). n specifies the number directory levels to include in the name (2 would fit wordPress save directory standards (yyyy/mm).
Template parameters- USECATNAME: choose if category default image should be used or not. Override default if exists.
- SHOWPOST: force Highslide to expand on post if set to 1. Default is 0 (expand on image or post). Deprecated in favor of LINK.
- LINK: force Highslide to expand on post if set to p, on url if set to u. Default is i, image (expand on image or post).
- NODEF: doesn't display thumbnail if not image in post.
the_recent_thumbs specific parameters- LIMIT: number of posts to display
- OFFSET: skip posts by the given number. Default is 0.
- CATEGORY: categories to get posts from, or categories to exclude from search.
- MEDIA (0|1|2|3): select the type of element to display.
- 0 = image only.
- 1 = wordTube media only.
- 2 = Youtube only.
- 3 = wordTube and Youtube only.
- If MEDIA is used, SHOWTITLE=E will return blank.
the_random_thumb specific parameters- LIMIT: number of posts to display.
- CATEGORY: categories to get random from.
excerpt parameters- WORDS: number of words in the excerpt.
- LENGTH: number of characters in the excerpt.
- LINK (0|1): display or not the permalink at the end of the excerpt.
- MORETEXT: text to display with the link.
- MORETAG: tag to wrap the link with.
- SHOWDOTS: add "..." at the end of the excerpt or not.
- NOMORE (0|1): if 0, returns the whole post up to the first more tag or the excerpt. If 1, always returns the excerpt.
- NOSEMIO: skip all semiologic links in excerpt.
|