=== Gallery Widget ===
Contributors: Oliver Schaal
Website link: http://blog.splash.de/
Author URI: http://blog.splash.de/
Plugin URI: http://blog.splash.de/plugins/gallery-widget/
Tags: gallery, widget, image, attachment, media, upload, sidebar, picture, random, latest
License: GPL v3, see LICENSE
Requires at least: 2.5
Tested up to: 2.7.0
Stable tag: 0.5.13

Simple widget to show the latest/random images of the wordpress media gallery (Wordpress 2.5++)

== Description ==

Gallery Widget is a simple plugin that let you show the latest/random images of the wordpress media gallery inside
a widget or directly in your templates (it is possible to choose some categories to be included/excluded).

For more information on how to use this plugin see [splash ;)](http://blog.splash.de/plugins/)

Please report bugs and/or feature-request to our ticket-system: [TicketSystem/Wiki](http://trac.splash.de/gallerywidget).

== Installation ==

1. Upload the 'gallery_widget' folder to the '/wp-content/plugins/' directory
2. Activate the plugin through the 'Plugins' menu in the WordPress admin
3. Go to Design->Widgets, activate the "Gallery Widget", adjust the title and max number of images to your needs
or
3. use the php-functions
`<? echo get_attached_images(maximages, [latest|random], [old|direct], css-class); ?>`
or
`<? echo get_attached_images_by_categories(maximages, [latest|random], categories commaseparated, [include|exclude], [old|direct], css-class); ?>`
in your template.

Warning: Cause of the way the attachments are fetched using the standard option (all), even images of not yet
published posts are shown. If this is a problem for you, you should use the option (include or exclude), although it
is less optimized.


== Frequently Asked Questions ==

= How can i adjust the look of the Widget? =

Just use the CSS-Class "wGallery" to alter the ul- or li-tags.

= How can i get only the images of one/some categories? =

Use the category-option include or exclude and enter the id's separated by comma
in the options of the widget.
Using include or exlcude causes more sql-queries, is slower than the base function.
You should only use it if you're blog doesn't have to much traffic and/or your
host can handle it :)

= Why doesn't the images link to the parent article? =

This option actually only works with "category-option" set to include or exclude.

= Is it possible to show the images at any position in the theme (not only as widget)? =

Yes, you can use the following code to include the images:

`<?php if ( function_exists(get_attached_images) ) : ?>
<?php echo get_attached_images(maximages, [latest|random], [old|direct], css-class); ?>
<?php endif; ?>`

for instance 5 random images:
`<?php if ( function_exists(get_attached_images) ) : ?>
<?php echo get_attached_images(5, 'random'); ?>
<?php endif; ?>`

== Changelog ==

0.5.13
- [FIX] SQL-performance improvement on include/exclude-option
0.5.12
- [FIX] Can add CSS-class @widget control menu
- [FIX] Include/exclude categories
- [NEW] Option: add a link relation
0.5.11
- [FIX] Missing mime_type added (for the custom sql query used by "category-option" include/exclude)
0.5.10
- [NEW] Option to link to the (parent) articles instead of the images (actually only works with "category-option" set to include or exclude)
0.5.9
- [NEW] Option: Link to images directly or to the summary page (with the ability to comment on images)
- [NEW] Option: Add a CSS-class to the link
0.5.8
- [FIX] MySQL 5.0.51/GROUP BY-Problem
- take a look at the warning
0.5.7
- [FIX] On option "all categories" a debuginfo was shown
0.5.6
- [NEW] New Option, now you can decide if the Widget is shown on all pages or the frontpage only
0.5.5
- [NEW] Option to include or exclude categories of posts (see FAQ)
0.5.4
- [NEW] "selecting" post-categories to be used to get attachments
0.5.3
- [NEW] It is now possible to get "latest" or "random" Images