=== 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/ Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=C2RBCTVPU9QKJ&lc=DE&item_name=splash%2ede&item_number=WordPress%20Plugin%3a%20Gallery%20Widget&cn=Mitteilung%20an%20den%20Entwickler&no_shipping=1¤cy_code=EUR&bn=PP%2dDonationsBF%3abtn_donate_SM%2egif%3aNonHostedGuest Tags: gallery, widget, image, attachment, media, sidebar, picture, random, latest License: GPL v3, see LICENSE Requires at least: 2.5 Tested up to: 2.8.0 Stable tag: 1.1.2 Simple widget to show the latest/random images of the WordPress media gallery as a Widget, using a shortcode or directly with a php-function. == Description == > If you use WordPress 2.8, you should check the widget/options of the widget after the update to 1.1.0 Gallery Widget is a simple plugin that let you show the latest/random images of the wordpress media gallery inside a widget, directly in your templates (it is possible to choose some categories to be included/excluded) or in posts/pages using a shortcode (see faq on how to use them). 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). For Support, please use the [forum](http://board.splash.de/forumdisplay.php?f=102). == 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 ` getAttachedImages(maximages, [latest|random], [old|direct], css-class, relation); ?> ` or ` getAttachedImagesByCategories(maximages, [latest|random], categories commaseparated, [include|exclude], [old|direct|article], css-class, relation, singleimage[yes|no]); ?> ` 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 and 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. = Images of a specific category aren't shown, whats the problem? = If you use Windows Live Writer the images aren't attached to a post, means they do not have an id in the parent field and therefor the plugin isn't able to get these images (images aren't assigned to a category directly, only posts have a category). = How do i use the shortcodes? = Latest 5 images linking to the attachment page (default option): `[getGWImages]` You could use the following parameters: `- max=int - order='latest|random' - linktype='direct|page' - linkclass='css class' - linkrel='relation for the link'` i.e. 3 random images with a link to the images: `[getGWImages max=3 order=random]` If you would like to use the category include/exclude options you have to use this shortcode: `[getGWImages2]` The following parameters are possible: `- max=int - order='latest|random' - categories='comma separated list of category id's' - option='include|exclude' - linktype='direct|page' - linkclass='css class' - linkrel='relation for the link' - singleimage='yes|no'` = 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: ` getAttachedImages(maximages, [latest|random], [old|direct], css-class, link-relation); ?> ` for instance, 5 random images: ` getAttachedImages(5, 'random'); ?> ` latest 7 images of the categories 1, 2 and 5, only 1 image per post/link to article (css: wGallery, relation: lightbox): ` getAttachedImagesByCategories(7, 'latest', '1,2,5', 'include', 'article', 'wGallery', 'lightbox', 'yes'); ?> ` Attention: If you wan't to use the galleryWidget-object in a function (like the sidebar), you have to include the global variable $galleryWidget (add `global $galleryWidget;` before if()) = Shortcode-Example using CSS = To show 9 random images: - In your article just post the following (in html, not wysiwyg-mode) `
[ getGWImages max=9 order=random linkclass='testClass' ]
` - Add the following to the style.css of your theme `/* TestClass */ .testClass { overflow: hidden !important; padding: 10px 5px !important; } .testClass ul { float: left !important; } .testClass li { list-style-type: none !important; display: inline !important; padding: 5px !important; float: left !important; margin: 5px !important; width: 150px !important; /* size of the thumbnail */ height: 150px !important; /* size of the thumbnail */ } .testClass li a img, .testClass li a:visited img { border: solid 1px #fff !important; } .testClass li a:hover img { border: solid 1px #000 !important; }` For more examples and other questions, take a look at the [support forum](http://board.splash.de/forumdisplay.php?f=102). == Changelog == = 1.1.2 = * [NEW] russian translation by [Fat Cow](http://www.fatcow.com/) * everyone is invited to send me a translated language pack, thx = 1.1.1 = * [FIX] description of widget * [FIX] gettext domain * [NEW] german translation * [more information](http://blog.splash.de/2009/06/28/gallery-widget-1-1-1-ubersetzung-kleinere-fixes/) = 1.1.0 = * [NEW] multiple copies of the same widget (WP 2.8 only) * [more information](http://blog.splash.de/2009/06/19/gallery-widget-1-1-0-mehrere-kopien-des-widget/) = 1.0.0 = * [TASK] prepare V1.0.0 - code cleanup * [more information](http://blog.splash.de/2009/05/08/gallery-widget-100-stable-release) = 0.7.2 = * [FIX] don't show images of scheduled posts using the exclude option (#15) * [more information](http://blog.splash.de/2009/04/19/gallery-widget-072-bilder-vorgemerkter-beitrage/) = 0.7.1 = * [NEW] shortcode example, using css (see FAQ) * [NEW] updateinfobox/notice system * [more information](http://blog.splash.de/2009/04/05/gallery-widget-071-updateinfoboxcss-beispiel) = 0.7.0 = * [NEW] shortcodes to use the php-functions in articles/pages * [more information](http://blog.splash.de/2009/03/05/gallery-widget-070-shortcode) = 0.6.1 = * [FIX] don't print debug message as html comment = 0.6.0 = * [NEW] OOP rewrite (with wrapper functions for the old function calls) * [more information](http://blog.splash.de/2009/02/14/gallery-widget-060-oop-rewrite/) = 0.5.17 = * [FIX] include option will work now again... * [more information](http://blog.splash.de/2009/02/08/gallery-widget-0517-bugix-only/) = 0.5.16 = * [FIX] use the table prefix * [more information](http://blog.splash.de/2009/01/30/gallery-widget-0516-bugfix-table-prefix/) = 0.5.15 = * [FIX] supress the error message, if no posts found for include/exclude... * [more information](http://blog.splash.de/2009/01/18/gallery-widget-0515-bugfix/) = 0.5.14 = * [NEW] New option: show only 1 image per post * [more information](http://blog.splash.de/2008/12/31/gallery-widget-0514-nur-ein-bild-pro-beitrag/) = 0.5.13 = * [FIX] SQL-performance improvement on include/exclude-option * [more information](http://blog.splash.de/2008/12/29/gallery-widget-0513-optimierung/) = 0.5.12 = * [FIX] Can add CSS-class @widget control menu * [FIX] Include/exclude categories * [NEW] Option: add a link relation * [more information](http://blog.splash.de/2008/12/14/gallery-widget-0512-bugfixlink-relation/) = 0.5.11 = * [FIX] Missing mime_type added (for the custom sql query used by "category-option" include/exclude) * [more information](http://blog.splash.de/2008/09/08/gallery-widget-0511-bugfix-release/) = 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) * [more information](http://blog.splash.de/2008/08/29/gallery-widget-0510-link-zum-artikel-anstatt-zum-bild/) = 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 * [more information](http://blog.splash.de/2008/08/03/gallery-widget-059-wordpress-plugin/) = 0.5.8 = * [FIX] MySQL 5.0.51/GROUP BY-Problem * take a look at the warning * [more information](http://blog.splash.de/2008/06/22/gallery-widget-058/) = 0.5.7 = * [FIX] On option "all categories" a debuginfo was shown * [more information](http://blog.splash.de/2008/06/13/galler-widget-057-bugfix-release/) = 0.5.6 = * [NEW] New Option, now you can decide if the Widget is shown on all pages or the frontpage only * [more information](http://blog.splash.de/2008/06/11/gallery-widget-056/) = 0.5.5 = * [NEW] Option to include or exclude categories of posts (see FAQ) * [more information](http://blog.splash.de/2008/06/04/gallery-widget-055/) = 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 * [more information](http://blog.splash.de/2008/05/18/gallery-widget-053/)