smd_gallery: super-flexible gallery generator

Bloke · 2008-03-12 02:57:52

If you’ve tried all the easy galleries (wet_for_each_image, upm_image, smd_slimbox, rss_thumbpop, aro_slideshow, etc) or crave something a little more esoteric or complicated, this might just be the plugin for you.

It uses a souped-up database engine from smd_slimbox combined with the power of wet_for_each_image and a few things besides so you can pluck stuff from the database (or, still untested, from directories) and use a form to render the output to fit your devious needs.

Can emulate slimbox, lightbox, thickbox, litebox, moonbox, fancyzoom, thumbpop, tooltips, slideshow, yahde yahde, and more as they are invented. Detailed instructions and examples are in the plugin help, and there is more info on the beta page.

Download smd_gallery | requires smd_lib

Possible feature enhancements

In no particular order:

Random image option (sorry masa, it’s more involved than I thought because it’s stepping thru the images one by one I can’t just pluck one out randomly until it’s been through them all)
Combine the normal and collate modes, offering an optional 3rd form dedicated to collation if required
Find a way to ‘split’ the output; currently, if you want parts of the output in two places it requires two calls
~~Conditional output (perhaps enhancements to smd_if will help)~~ Mostly achieved with v0.4

These are by no means guaranteed and may never see the light of day. But if anyone has any brainy nuggets to offer, feel free to speak up.

As ever, please leave feedback here: good, bad or indifferent, and enjoy pushing this one to the max.

Revision history
————————

All available versions and changes are listed here. Each entry indexes the relevant post(s) in the threads to learn about the features.

14 Feb 08 | 0.1 | Initial beta release
19 Feb 08 | 0.2 | Added {galleryid} (thanks rloaderro) and some skeleton docs
11 Mar 08 | 0.3 | Official public release. Fixed silly empty field bug; added {counter}, {index} and the totals (all thanks jakob)
15 Mar 08 | 0.31 | Fixed a couple of undefined indexes and added {category_title} (thanks jstubbs)
17 Mar 08 | 0.32 | Fixed another undefined index and removed bogus smd_split (both thanks secundar)
21 Mar 08 | 0.33 | Did v0.31 properly, including table prefix (thanks nardo)
01 Apr 08 | 0.34 | Fixed SQL parenthesis bug ; added emptyclass and {maximages} (thanks the_ghost)
08 Apr 08 | 0.4 | Changed thumb to allow thumb/fullsize swapping ; Added thumbchange, thumbchangewraptag, thumbchangeclass, {thumbindex}, {thumbcounter} and the {changed:*} replacement tags (thanks fuls)
26 May 08 | 0.41 | Fixed Directory separator (thanks cuda) ; added raw page URLs to the nav replacement array and made the nav array available in the standard replacements array (thanks visualpeople)
27 May 08 | 0.42 | Separated thumb and paging blocks and added pagepos (thanks duchamp) ; fixed tiny bug in navnextpageurl / navprevpageurl
10 Jun 08 | 0.43 | Fixed sort=“fixed” when using limit (thanks robin746) ; added per-group onchange wrapping and allowed fixed sorting of categories (thanks jstubbs) ; deprecated thumbchange* and renamed as onchange* ; fixed $idx counter problem
10 Jun 08 | 0.44 | Second attempt at per-gallery onchange grouping (thanks for your patience jstubbs)
14 Jul 08 | 0.45 | Fixed no output if not using categories (thanks robin746)
16 Nov 08 | 0.46 | Added collatedelim (thanks curiouz) and fixed the duplicate id bug (thanks nardo)
13 Feb 09 | 0.5 | Requires smd_lib ; added MLP support (thanks net-carver) ; added support for displaying uncategorised images (thanks xzamen) ; ‘?’ vars expanded to link / image / file / <txp:variable /> and URL variable ; new attributes: escape, html_id, format, gmt, lang (thanks maniqui), strictfields ; improved {object} support and added objectform (thanks tye / rvturnage) ; {title} == {caption} at last! ; removed thumbchange* attributes ; improved support for table extensions (via the columns attribute: thanks RedFox) ; added smd_every syntax to onchange (thanks jakob) ; fixed offset bug (thanks feragnoli)
01 Mar 09 | 0.51 | Added countform and countpos ; fixed a few PHP warnings
16 Nov 09 | 0.52 | TXP 4.2.0 thumb size support ; added new filtering attributes ; fixed sort=fixed warning and the long-overdue quote escaping (both thanks maniqui)
01 Jan 10 | 0.53 | Added onchange form capability (thanks MattD)
01 Feb 10 | 0.54 | Multiple images are now not displayed if multiple categories exist with the same name and different title
01 Mar 10 | 0.55 | Added name attribute
10 Mar 10 | 0.6 | Simplified query to eliminate errors with uncategorised images being omitted from the results; allowed countform ranges ; added grouplimit
03 Apr 10 | 0.61 | Added breakclass (thanks the_ghost)
06 Apr 10 | 0.62 | Fixed {onchange:category_title} and {grouptagend} (thanks jan)

Last edited by Bloke (2010-04-06 18:03:05)

masa · 2008-03-12 05:49:11

Bloke wrote:

Random image option (sorry masa, it’s more involved than I thought because it’s stepping thru the images one by one I can’t just pluck one out randomly until it’s been through them all)

No worries, it has so many other, interesting options.
I’m working around it by simply using the article image as the placeholder:
<txp:article_image html_id="fullsize" thumbnail="0" />

Not random, but easy enough.

You did an excellent job on the documentation and thanks for the detailed samples! :-)

Last edited by masa (2008-03-12 06:04:43)

jstubbs · 2008-03-15 09:25:45

Bloke, looks like a great plugin. As expected :-) How would you go about creating a multi-gallery on one page? For example, work, travel and animals galleries, separated on a page. Trying to understand the best way to achieve this with the minimum code.

Bloke · 2008-03-15 10:23:05

jstubbs wrote:

How would you go about creating a multi-gallery on one page? For example, work, travel and animals galleries, separated on a page…. with the minimum code.

Depending if you want to lightbox stuff the form will become a tad more complex, but for a simple list of all thumbs in those categories the minimum code is probably:

Tag:

<txp:smd_gallery category="work, travel, animals" wraptag="div" class="thumbs" form="multigal" />

Form multigal:

<txp:if_different>
<h3>{category}</h3>
</txp:if_different>

<span class="animage">
 {object}
</span>

Style:

.animage {
  width:100px;
  height:100px;
  padding:10px;
}

How’s that for starters? The only thing I’ve spotted is that the category is the ‘internal’ name not the ‘display’ title. If that’s a problem I could probably find a way of extracting the title too and making it available.

Last edited by Bloke (2008-03-15 10:23:18)

jstubbs · 2008-03-15 10:38:27

Thanks Stef I will try that out a little later today. I think I might try the Fancy Zoom on this gallery. One small thing you may have noticed (or not) – I installed the plugin and set it to active. On the same site, I have smd_slimbox activated.

Visiting the gallery page, I noticed a PHP error. Seems both plugins can’t be active at the same time.

Bloke · 2008-03-15 11:39:06

jstubbs wrote:

Visiting the gallery page, I noticed a PHP error. Seems both plugins can’t be active at the same time.

Odd, I have smd_slimbox, smd_lib, smd_random_banner and smd_gallery on my test site and they co-exist fine. Which versions of the plugins are you using (I assume it’s a 4.0.6 TextPattern too)?

However, I did spot a few silly undefined index warnings on one of my v4.0.5 installs that don’t show up under v4.0.6 (which I developed on), so thanks for highlighting them. It’s totally bizarre because they’re fundamental errors and should show up on both systems but they don’t.

Regardless, I’ve fixed those and also added {category_title} as a replacement tag to show the image category Title instead of its Name.

Try v0.31 [ compressed version ] and see if that fixes it.

jstubbs · 2008-03-15 11:48:59

Error message is the following:


Fatal error: Cannot redeclare smd_addqsvar() (previously declared in /users/home/jstubbs/domains/mydomain.com/web/public/textpattern/lib/txplib_misc.php(574) : eval()'d code:669) in /users/home/jstubbs/domains/mydomain.com/web/public/textpattern/lib/txplib_misc.php(469) : eval()'d code on line 16

Yes, using 4.06. smd_slimbox is 0.22, smd_lib is 0.2.

I’ll install 0.31 of smd_gallery and let you know if the error disappears.

jstubbs · 2008-03-15 11:51:32

Installed 0.31 – same error message. Note that I only installed and activated the plugin – nothing else.

Bloke · 2008-03-15 12:19:40

jstubbs wrote:

Fatal error: Cannot redeclare smd_addqsvar()

Well that’s most odd; it claims it’s clashing with an identically-named function in smd_lib. They do indeed contain the same functions (I duplicated them because I wanted smd_gallery to work without smd_lib for the time being until I decide what to do with it) but I’ve enclosed the version I use in smd_gallery with a check to see if it’s already declared. It should silently ignore it and use the one from smd_lib in that case.

A puzzler for sure. Since you have smd_lib installed and activated you can temporarily get round it by removing the two functions at the end of smd_gallery (from if (!function_exists("smd_removeQSVar")) { onwards). But I’d really like to know why your setup is ignoring the “if !function_exists”. I wonder if it’s a strange PHP version issue.

EDIT: or I wonder if it’s the order the plugins are loaded? Perhaps if smd_gallery is loaded before smd_lib, the check will go “that’s fine, smd_addqsvar doesn’t exist, I’ll go ahead and declare it”. Then a few seconds later smd_lib itself comes along which doesn’t have the check in it and tries to redeclare it. Hmmm. Can any devs or more knowledgeable beings confirm this behaviour and offer any work-arounds (aside from the obvious one of adding the function_exists check around both sets of declarations which I will do anyway)? Do plugins get loaded in ‘id’ order?

smd_slimbox is 0.22, smd_lib is 0.2.

Though it probably won’t make any difference to this specific problem, why are you running such old versions? Does the new one do something you don’t like? If so, let me know and I’ll try to address it for you. Current versions are 0.212 for slimbox and 0.31 for smd_lib.

Last edited by Bloke (2008-03-15 12:28:59)

jstubbs · 2008-03-15 12:28:06

Stef, on this site the idea is to replace smd_slimbox with the new smd_gallery – so its not necessary for the two to live together. I am hosted on Joyent if that helps – its probably something with the PHP.ini file.

Older versions of smd_slimbox – I can’t keep up with your upgrades :-) I thought I had the latest version!

I am currently testing _gallery with the Fancy Zoom script. Is it best to use the example #1 in the plugin help for a lightbox/fancy zoom gallery?

<a rel="lightbox-{category}" href="{url}" alt="{alt}"
     title="A picture of {title}" height="{height}" width="{width}">
 <txp:thumbnail id="{id}" />
</a>

I mean – is there anything in particular that SHOULD be in the form?

Bloke · 2008-03-15 12:44:23

jstubbs wrote:

Stef, on this site the idea is to replace smd_slimbox with the new smd_gallery – so its not necessary for the two to live together.

OK, but if you have any other smd_ plugins that require smd_lib then it may be a problem – see my edit above for another random thought I had on the issue. Perhaps deleting smd_gallery and re-installing it will give it a higher ID in the database and thus they’ll load in the correct order (stab in the dark here). Or maybe it’s the order the calls to the smd_ plugins are on the page? Maybe if slimbox occurs first the problem goes away?

I am currently testing _gallery with the Fancy Zoom script. Is it best to use the example #1 in the plugin help for a lightbox/fancy zoom gallery?

According to the FancyZoom docs that should be enough. You don’t appear to need to ‘tag’ the images with any special class in order for the script to work (which is very odd — what if there are linked images on the page you don’t want FancyZoom to touch? Perhaps I missed something in the docs). So that example#1 code should work fine. It may even be overkill, e.g. you might not even need the rel part.

jstubbs · 2008-03-15 13:06:56

Stef, on this site there are no other smd_ plugins, only the gallery plugin. I turned the smd_lib and smd_slimbox off, and all works fine.

I have now got the gallery working, with this form (using Fancy Zoom):

<txp:if_different>
<h3>{category_title}</h3>
</txp:if_different>
<a href="{url}" title="{title}" <img src="{thumburl}" alt="{alt}" /></a>

Here is the URL for a quick peek. Looks good to me so far – thanks for the excellent plugin!

Last edited by jstubbs (2008-03-15 13:08:05)

Textpattern CMS

Textpattern CMS support forum

#1 2008-03-12 02:57:52

smd_gallery: super-flexible gallery generator

#2 2008-03-12 05:49:11

Re: smd_gallery: super-flexible gallery generator

#3 2008-03-15 09:25:45

Re: smd_gallery: super-flexible gallery generator

#4 2008-03-15 10:23:05

Re: smd_gallery: super-flexible gallery generator

#5 2008-03-15 10:38:27

Re: smd_gallery: super-flexible gallery generator

#6 2008-03-15 11:39:06

Re: smd_gallery: super-flexible gallery generator

#7 2008-03-15 11:48:59

Re: smd_gallery: super-flexible gallery generator

#8 2008-03-15 11:51:32

Re: smd_gallery: super-flexible gallery generator

#9 2008-03-15 12:19:40

Re: smd_gallery: super-flexible gallery generator

#10 2008-03-15 12:28:06

Re: smd_gallery: super-flexible gallery generator

#11 2008-03-15 12:44:23

Re: smd_gallery: super-flexible gallery generator

#12 2008-03-15 13:06:56

Re: smd_gallery: super-flexible gallery generator

Board footer