wet_thumbfilter: Textpattern thumbnail gallery

14. Dezember 2005

wet_thumbfilter is a plugin for Textpattern which displays the thumbnails for articles’ images meeting various filter criteria, with an optional link to the articles.


<txp:wet_thumbfilter />

Required attributes


Optional attributes

attribute description default
category Category filter, comma separated list Empty
section Section filter, comma separated list Empty
offset A positive integer number. The n-th article with an assigned image meeting the filter criteria will be used to determine the first returned thumbnail. 0
sortby Article field to sort by. Use either “posted” , “LastMod” or other article properties. posted
limit Limits the amount of articles containing thumbnails. Set to “” (empty) to return all thumbnails matching the criteria. 1
first Use only the first image for each article, even if there’s an image list containing more images. Empty.
time Filters articles by posting date. Possible values: past, future, any. past
sortdir Sorting direction. Use either “asc” for ascending order, “desc” for descending order or “rand()” for random order. desc
class class attribute which will be applied to the to the wraptag. If wraptag is empty, this attribute will be applied to the <img> tag. wet_thumbfilter
align align attribute which will be applied to the <img> tag. Empty
link Link to article. Set to “0” to disable the thumbnail’s link to the article. 1
style style attribute which will be applied to the <img> tag. Empty
wraptag (X)HTML tag used to enclose the list. See Textbook for further reference. Empty
break This string will be used to separate list items. See Textbook for further reference. Empty
label This string will be prepended to the list. See Textbook for further reference. Empty
labeltag (X)HTML tag used to enclose the label. See Textbook for further reference. Empty

Sample use

tag function
<txp:wet_thumbfilter category="events" /> displays the most recent thumbnail belonging to an article in the “events” category.
<txp:wet_thumbfilter category="events" sortby="LastMod" offset="1" /> displays the thumbnail which is associated with an article out of the “events” category. Articles are sorted by the date of last modification. The article at offset 1 (i.e. the second) is chosen.
<txp:wet_thumbfilter category="events,fairs" limit="3" wraptag="ul" break="li" label="Recent pics" labeltag="h3" /> displays the three most recent thumbnails from articles out of the “events” or “fairs” category. The thumbnails are embedded into an unordered list and labelled by a h3.

A gallery of all articles thumbnails can be rendered by just one line plus a dash of CSS styling for the individual img tags:

<txp:wet_thumbfilter limit="" section="gallery"
wraptag="ul" break="li" class="mygallery" />

You’d rather have div soup? Here we go:

<txp:wet_thumbfilter limit="" section="gallery"
wraptag="div" break="div" class="mygallery" />

Short of cash? Why not put some AdSense between two rows of images?

<txp:wet_thumbfilter section="gallery" limit="4" />
<txp:output_form form="adsense" />
<txp:wet_thumbfilter section="gallery" limit="" offset="4" />

Alternatively, repeating this tag a number of times while increasing the offset attribute will allow full control of the used HTML markup:

<ul class="gallery">
<li><txp:wet_thumbfilter category="events" offset="0" /></li>
<li><txp:wet_thumbfilter category="events" offset="1" /></li>
<li><txp:wet_thumbfilter category="events" offset="2" /></li>

This snippet can be part of another article, a page template, or a misc form as well.

Theory abounds, so let’s see a live sample. This thumbnail gallery is rendered from this site’s content, linking to the three most recent articles categorized as “textpattern”.

  • Textpattern 4.0.6 Release Candidate veröffentlicht

<txp:wet_thumbfilter category="textpattern"
  limit="3" wraptag="ul" break="li" />


This plugin is released under the Gnu General Public Licence.


Get it here: wet_thumbfilter.txt.

Resources and Relateds

Express your suggestions, report bugs and discuss enhancements in this thread in the Textpattern forum.

Change log

Date Version Notes
2005-12-14 0.1 Initial release
2005-12-15 0.2 Add link capability, restrict selection to either live or sticky articles
2005-12-22 0.3 Add limit attribute and various output modifier attributes for that list mode
2006-01-01 0.4 Supports comma separated lists of multiple sections, categories and article images
2006-09-22 0.5 Added first attribute
2006-11-05 0.6 Added time attribute. Requires Textpattern 4.0.4+.


  1. Hallo Robert,

    nettes Plugin! Soweit ich verstanden habe, wird nur 1 thumbnail ausgeworfen. Oder? Wäre da nicht ein limit Attribut noch hilfreich, damit man z. b. die ersten 4 Thumbs ausfiltern kann? Oder habe ich etwas falsch verstanden bei dem Plugin?

    bg alex

  2. Ein limit-Attribut ist nicht nötig, die Lösung für die Ausgabe von mehr als einem Thumbnail ist im Forum-Thread beschrieben.

  3. Due to irresistible demand exerted by the German Embassadress of Textpattern: Version 0.3 adds various attributes supporting lists.

  4. Thank you. Great work!
    Fröhliche Weihnachten
    alex :)