=== Deviant Thumbs ===
Contributors: scribu
Donate link: http://scribu.net/wordpress
Tags: deviantart, thumbs, images
Requires at least: 2.8
Tested up to: 3.0
Stable tag: 1.8.6

Display deviantART thumbnails on your blog.

== Description ==

Display linked thumbnails from deviantART on your WordPress blog.

**Features:**

* **Scrollable carousel**: your thumbs can be displayed in a dA style carousel
* **Inline deviations**: the code *:thumb98765:* inside a post becomes a thumbnail, just like on dA
* **Multiple widget support** 
* **Flexible template tags**

Links: [Plugin News](http://scribu.net/wordpress/deviant-thumbs) | [Author's Site](http://scribu.net)

== Installation ==

Either use the plugin installer built into WP, or:

1. Unzip and upload the `deviant-thumbs` directory to the `/wp-content/plugins/` directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.

= Widget Usage =

1. Add one or more Deviant Thumbs widgets to your sidebar.
1. Set the desired settings for each widget.
1. Enjoy

= Template tags =

These are meant to be used outside The Loop.

**deviant_thumbs()**

`<?php if (function_exists('deviant_thumbs')): ?>
  <ul class="deviant-thumbs">
    <?php deviant_thumbs($query = 'your query', $args = 'rand=false&count=10'); ?>
  </ul>
<?php endif; ?>`

*Parameters:*

* **$query** is a search string used on [deviantART](http://browse.deviantart.com/). Example: *by:scribu in:photography*
* **$args** is a string of options for displaying the carousel:
* <ul>
<li>*count* is the number of thumbs to display (The maximum is 24). Default: 6</li>
<li>*rand* is a flag to randomise thumbs or not. (Can be *true* or *false*). Default: true</li>
<li>*cache* is the number of hours after which the thumb list has to be updated. Default: 6</li>
<li>*before* is a string inserted before each thumb. Default: `<li>`</li>
<li>*after* is a string inserted after each thumb. Default: `</li>`</li>
</ul>

**deviant_thumbs_carousel**

`<?php if (function_exists('deviant_thumbs_carousel')): ?>
    <?php deviant_thumbs_carousel($query = 'your query', $args = 'count=10&rand=false&id=my_carousel'); ?>
<?php endif; ?>`

*Parameters:*

* **$query** is a search string used on [deviantART](http://browse.deviantart.com/).
* **$args** is a string of options for displaying the carousel:
* <ul>
<li>*count* is the total number of thumbs. Default: 6</li>
<li>*show* is the number of visible thumbs. Default: 3</li>
<li>*rand* is an option to show thumbs in a random order (Can be *true* or *false*). Default: true</li>
<li>*cache* is the number of hours after which the thumb list has to be updated. Default: 6</li>
<li>*speed* is the speed of the sliding effect (Can be *fast*, *normal* or *slow*). Default: fast</li>
</ul>

== Frequently Asked Questions ==

= "Parse error: syntax error, unexpected T_CLASS..." Help! =

Make sure your new host is running PHP 5. Add this line to wp-config.php:

`var_dump(PHP_VERSION);`

= How can I choose which thumbs to display? =

You enter a search string (the thumbs are found using the search engine from deviantArt). You can read more about [search options](http://help.deviantart.com/577/) there.

**Quick tips:**

* *-in:scraps* excludes scraps
* *boost:popular* gets the most popular thumbs, instead of the newest

= How can I modifify the carousel skin? =

You can edit `deviant-thumbs/inc/carousel/carousel.css`.

= Why isn't the cache working? =

Probably because your wp-uploads folder isn't writable. You will have to chmod it to 757. If you don't know how, read [Changing File Permissions](http://codex.wordpress.org/Changing_File_Permissions).

== Screenshots ==

1. The Deviant Thumbs Carousel

== Changelog ==

= 1.8.6 =
* fix error when retrieving thumb list

= 1.8.5 =
* WP 2.8 compatibility

= 1.8 =
* multi-widget support
* [more info](http://scribu.net/wordpress/deviant-thumbs/dt-1-8.html)

= 1.7 =
* home-made carousel
* [more info](http://scribu.net/wordpress/deviant-thumbs/dt-1-7.html)

= 1.6 =
* inline thumbs
* [more info](http://scribu.net/wordpress/deviant-thumbs/dt-1-6.html)

= 1.5 =
* switched to jCarousel Lite

= 1.4 =
* deviantART v6 skin

= 1.3 =
* jCarousel

= 1.2 =
* use any query
* file-based caching

= 1.1 =
* random thumbs

= 1.0 =
* initial release