• View
• Edit
• History
• Attach
• Print
• Backlinks

ThumbList-Talk-archive

Back to Cookbook.Thumb list

Creeping featurism

Thank you all for your ideas and suggestions on how to improve the thumb list recipe, that I received here or by e-mail. I am considering every one for inclusion.

However, my intention was (and still is) to write an easy, fast and simple script that lists attached images, without complicating things. Consider it an extension of the (:attachlist:) directive. More features means more code, more server load, more bugs, more documentation to write, more user support (because it is too complicated and difficult). Sometimes less is more. See the article Creeping featurism, our script is now much more complex than I intended. From 8 kB, the script is now more than 11!

Some of the proposed features require opening external pages to extract variables or comments. This can be really slow on a shared hosting, because PmWiki has to check Group and page permissions and read the external page for every thumbnail -- if you have 40-50 per page, this may even not work (Supercache cannot help because it will never be up-to-date).

Note that with the "Image templates" you can include other pages, or extract variables, or set a comments feature, for the currently displayed picture, using the variables {$UpFilePage}, {$UpDir}, etc. There are fine recipes that can do this. You can have very flexible configurations, just need to plan them well (then post them here to help others).

About extracting metadata from the pictures, or worse, modifying it, currently much of these things are not really stable and interoperable: the usable scripts able to do this are almost 1 megabyte of code, or require PHP 5.1. Besides, extracting metadata will make things slower. One can implement a recipe that will try to read such metadata on one individual image at a time, but it will be a different script. It can then collaborate with ThumbList, for example in an Image template, something like: (:exif {$UpFile}:) or (:imageinfo {$UpFile} exif=0 iptc=1:).

Also note that there are other fine gallery scripts that can do titles, captions, individual comments, pagelists, categorisations, unlimited subdirectories and more, you can give them a try. You can also take the thumblist script and add some functions, and then you can support a "ThumbListPro" with all other features.

To resume: our script should be working, easy, simple and fast, but talk to me, because I am considering all propositions. If your nice idea can be done simply and easily, I will add it.

Thanks, and a Happy New Year! (Already said that, but) Wishing you for 2007 to take lots of nice pictures and to display them in many nice galleries! --Petko January 02, 2007, at 05:32 PM

Survey comments (optional)

Comment

• Very nice and clean recipe

Displaying the full image inside a wiki page

I like this very much. One request: It would be nice if there was an option for some back link to appear on the full image view. Or perhaps provide an option for the new page to use the current skin, or a custom header or footer with content supplied by a wiki page. You might take a look at Hagan's ThumbnailLinkToImage to see how he handled the issue.

Gallery without thumbnails, real pictures resized down in the browser

Nice and easy to use. Thanks. I have tried several gallery recipes but none of them is as easy as this (I even didn't manage to get WikiGallery working at all)

I'd like to use my local PmWiki with my pictures. So there's no use to resize the pictures smaller. But somewhere there is a limitation because Thumblink don't work with big images. Could someone advice me in this. I use Puppy -linux and Xampp.

But thanks for this recipe: it's great !

Teukka

Width parameter, Image templates, Alt and external directories

Thanks, very nice recipe. However, there are few things I'd like to request/ask:

• When creating one picture, the thumb is limited by height. However, ideally the width should be the first choice since a html page is limited in width and not in height (Usually).
  • Done, in version 2006-12-28. You can use width=100 now. --Petko December 28, 2006, at 06:59 AM
• When showing the picture inside the wiki, the page is dynamic. Ie, a user cannot add comments on this page.
  • This was a wanted feature, the "light" and "simple" part, but in version 2006-12-28 there is a page variable {$UpFilePage} that may enable you to do comments or other stuff, see the section "Displaying the original pictures inside a wiki page". --Petko December 28, 2006, at 06:59 AM
• The alt name is showing the full path. This changes the table structure if the picture is not shown. In my php file I changed the following:
  $output .= "$td1$a1<img border='0' src='$thumbname' alt='$thumbname' title=\"$title\" class='thumbs' width='$imgw' height='$imgh'/>$a2$td2";
  to
  $output .= "$td1$a1<img border='0' src='$thumbname' alt='$title' title=\"$title\" class='thumbs' width='$imgw' height='$imgh'/>$a2$td2";
  • Done, in version 2006-12-28. Thanks. --Petko December 28, 2006, at 06:59 AM
• It would also be nice to be able to load the pictures in a folder as well as a group (the reason being that i can simply ftp my local folder to the server (within the group upload page) and simply point to it. But thanks anyway for the great work already done.

Reda

Image trails, custom page variables

Custom width page variable

Lightbox integration

It is a very nice and handy recipe indeed. Sadly i have already built my image galleries with ImageSets.

One addition i implemented there was the use of Lightbox v2 ( http://www.huddletogether.com/projects/lightbox2/ ). All you have to do is include the .js files and add a "rel='lightbox[galleryname]'" to the hrefs. I was very pleased with the result. I'm sure it will also work for this recipe.

* Thanks for the lightbox link, looks quite nice!! Reda

Very small change to the recipe. Very big increase in usability (IMHO). And in browsers with JavaScript turned off it simply defaults to linking to the original picture.

Bug fixes

[[{$FullName}?action=browse|$[Back to Gallery]]]

Pico

Lightbox - better integration

Ok, now in setting up Lightbox, for the lines that you add to your config.php (or Group.Page.php file), I had to change the references from "/pub/lb/..." to "$FarmPubDirUrl/lb" to get them recognized on my farm configuration. (You could use $PubDirUrl, but $FarmPubDirUrl defaults to $PubDirUrl).

Even on a simple non-farm configuration, hardcoding the reference to "/pub/lb" seems like it wouldn't work for anyone that installs PmWiki in a subdirectory (/pmwiki/pub/lb), at least not with clean urls (I say that because when I tried moving the code and files from my farm to my field, the hardcoded reference did not find the files).

Pico December 30, 2006, at 02:24 PM

Individual image captions and external page comment variables

nice script. It would be nice to be able to add a caption to each image (like the optional attribute that can be added in the config file).

• Also, it would be nice to be able to refer to a variable on a different page, like the number of comments for a specific thumb (e.g. {Pics.picturenamejpg-comments$FoxPostCount}. Thanks

Extracting IPTC/EXIF metadata

Very nice recipe, I know You want to keep it simple and easy but I have to ask, is there any way to get it reading IPTC -captions? Not to edit them just to show somehow. Thanks for this!

PeeJii

Thank you Hagan for your comments and for your code. I was testing the exif_read_data function like from the PHP manual, but I'll probably use some lines of your qdig-metadata.php. I still believe that metadata extraction is times slower and more "expensive" than just "getimagesize()", so if we implement it for the thumbnail galleries, it will be optional, probably in an external script. About the image captions or comments, I feel that it is much easier and more usable to have and edit these texts in the wiki rather than inside the picture itself, or in an uploaded file -- because you can change your mind, and because you may put another caption to the same picture from a different page/context. So, I was thinking that more appropriate for small captions or descriptions may be not an automatic, extracted data like for the title tooltip now, but something like the MediaWiki markup, like:

(:thumbgallery [options]:)
picOOOO1.jpg | caption or description
picOOO55.jpg | caption or description
(:thumbgalleryend:)

If people think this is worthy, I'll see how it can be added. --Petko January 03, 2007, at 01:43 PM

Thanks, on my to-do list. --Petko January 04, 2007, at 06:59 AM

Random Thumbnail

Variable to test

If the thumblist does not return anything because there are no pictures, is there anything I can test for true or false to hide/show also some related text? Thanks.

New development version

Download - see and test.
I am working on the script and did a lot of changes. It seems to work but still haven't documented it. (:thumbgallery(end):), single image captions, warning messages, GD0-1-2 test (very simple), EXIF (very basic). I am considering though splitting the project in two, a thumblist-light version (simpler as originally intended) and this one. --Petko January 04, 2007, at 09:46 PM

Just installed this - deleted all the thumbs and it created them all in one go!. Works wonderfully well, my compliments on your hard work and great product, I recommend it to anyone. - Simon

New version ready to be tested

Hi, I rewrote the documentation page to give the basic usage first, and the advanced usage below, so that new users will hopefully not be scared by the added complexity. The new script version from today fixes some bugs and adds some new advanced features (read the Release Notes). Please test it. Your comments are welcome. --Petko January 09, 2007, at 04:59 PM

Captions and Order

(:thumbgallery:)
| Caption | Tooltip title
| | Another tooltip title
|
| Another caption | previous picture had no caption
(:thumbgalleryend:)

1. I also wanted to have an attribute "order=" but this would require the script to open, read and store in RAM all metadata from all files in the upload directory, then to sort them. This will be very slow. Now the files are just checked if they are pictures, and only the selected (if you have start=, limit=, or name=) are really opened for the metadata, that is faster. I wouldn't change the algorythm at this point.
2. If you upload another file, the order may change, that's why it is better to write the file name and caption on the same line.
3. The (:thumbgallery:) markup allows you to select only the pictures you wish and to order them the way you wish: pic3.jpg, then pic1.jpg
4. The (:thumblist:) markup performs a natural number sorting, so you may batch-rename your files to the order you wish (try with IrfanView).

That's why, currently, the script is as it is. Thanks. --Petko January 09, 2007, at 05:27 PM

Just to drop a note

Just to drop a note to say thanks Petko. This is what I manage to cook up with the basic version of thumbnail. --hua January 13th, 2007

Bug report and CSS suggestion

Excellent script! And please keep it simple and clean. I hate recipe scritps that do everything for everybody. Do one thing and do that well.

Unfortunately I have a bug to report:

• When Supercache=1 the trails {$Prev/NextLink} are not showing when the photo is displayd in the ImageTemplate. Turning Supercahce off restores everything back to "normal."

The css you give for the .thumptable is useless as long as you set the styles in the thumblist.php script. The inline styles from the script override the styles set in the css.

I have commented out theline

  $h = (@$Width)? '' : " height='$Px4'"; 

and changed the line:

  $td1 = "<td class='thumbtd' align='center' valign='top'$h 
    width='$Px4'><div class='img' style='padding:$pad $pad'>"; 

to

  $td1 = "<td class='thumbtd' ><div class='img' >";

I use these two line css to get a marvelous gallery page

  .thumbtable	{	margin-top:20px; margin-bottom:40px; }
  .thumbtd	{	padding-bottom:40px; padding-right:25px; } 

Keep up the good works, Han, jan 19, 2007

ThumbList warning: Only 0 files found but you set start=1.

I'm sorry but I have run out of ideas to get this to work. I have tried everything on this page and the documentation page so far but I still only get this error:
ThumbList warning: Only 0 files found but you set start=1.
I can see the files after I upload them through the upload page but I never get any thumbnails. I have a dozen other recipes running on this site and I have "corrected two of them myself even though i am not a css author or PHP writer so I do know all the basics.

Any help is appreciated.

Thanks,

BillReveile January 30, 2007, at 12:32 AM

Compliance with regular attachment behavior

Since the recipe deals with image uploaded as page attachments, this could be nice to have the markup acting as the attachement prefix, ie when I specify (:thumb not_already_uploaded_image.jpg:), I would love to have the markup rendered as an upload link (as Attach:not_already_uploaded_image.jpg would have done), instead of an error message. Same consideration applies to other markup forms.

I don't want to sell my soup here, but you may have a look at LinkedResourceExtras ;).

Dfaure February 01, 2007, at 11:34 AM

Image trail

There is an issue with your gallery: you cannot have filenames with spaces and hope to display them via an Attach: link in your template. This is a PmWiki limitation of the Attach: markup. You should rename the files that contain spaces. --Petko February 26, 2007, at 03:52 PM

Actually a very handy hint from Uploads gets around this, viz

[[#blank | Attach:image name with spaces.jpeg"Sea lion"]]

I tried to use [[{*$NextLink} | Attach:{*$UpDirUpFile}"{*$UpFile}"]] in my image template to cater for the possibility of spaces in photo file names, but the $NextLink variable doesn't work the way you might expect.

Minor issues with version 2007-02-26

This is a great recipe, thank you! I had some issues.

• When (:thumbgallery Group.Page name="photo?.jpg" cols=3:) was used, and photo1.jpg... photo6.jpg were already in the uploads directoty, the gallery just didn't get displayed, unless (:thumbgallery...:) was preceded by a plain (:thumblist:) but even then, sometimes it didn't work.
• When I switched to per-page uploads I could use a simpler (:thumbgallery name="photo?.jpg" cols=3:) and then the gallery did get displayed. I could even use tlmode=1 with no problems.
• With per-page uploads thumbgallery warns about not being able to open the group default page's upload dir, uploads/Group.Group. This is unnecessary.
• In the script file does line 39 SDVA($HandleAuth, array('purgethumbs' => 'edit')); provides a hook for local config to change authorization level to something other than edit? I need that.
• Line 369 $MessagesFmt[] = "Caching gallery$t $n for $currentpage<br />\n"; has $t which is not initialized anywhere

SteP

     $DefaultPasswords['zap'] = '@zapentry';
     $HandleAuth['purgethumbs'] = 'zap';

    :TheGroup:SomeGroup
    :ThePage:SomePage
    :Gallery:{$:TheGroup}.{$:ThePage}
    (:thumbgallery {$:Gallery} ...:)

Thumbgallery and Attach

This is a bit of a problem. Normally thumbgallery shows upload links for pictures in its list that have not yet been uploaded. However, when the upload scheme is Group.Name and there are no uploaded pictures (or uploads/Group.Name doesn't exists), thumbgallery shows no upload links at all. This is inconvenient, as one is forced to add Attach links to the page, and as soon as the first picture is uploaded, the names of the missing pictures show up twice, once in thumblist and once in the added Attach link. SteP March 18, 2007, at 09:29 AM

Printing from template

Is it possible to define a template that includes a link to print the current image with the print skin? SteP April 30, 2007, at 01:17 PM

Multiple Image Upload

On my site, I have about 40 pictures to upload to my gallery. Is there a way I can upload multiple files at once? I wish you could just select multiple files on the attach page. Would that be possible? Thanks a bunch! --diafygi May 2, 2007, at 05:00 PM

Multiple ThumbGalleries

I am using two thumbgallery instances on a page, each using the 'usetemplate' tag. When I click on the images in the second gallery, the 'nextlink' links don't work correctly.[2]

That worked, thanks very much for such a useful recipe. Thanks for the compliment, I rely heavily on your recipe, so the site owes a lot to you. - P.B

Supercache and conditionals

Using Cookbook.MultiLanguage the following source

(:cell:)
(:if userlang de:)
(:thumbgallery cols=2 align=center usetemplate=1 supercache=1:)
p1.jpg | de
p2.jpg | de
(:thumbgalleryend:)
(:if userlang en:)
(:thumbgallery cols=2 align=center usetemplate=1 supercache=1:)
p1.jpg | en
p2.jpg | en
(:thumbgalleryend:)
(:fi:)

Valid CSS

I just wanted to let ya'll know that text-align:middle; is not valid CSS. This change needs to be made:

from:
  table.thumbtable td.thumbtd div.img { border: 1px solid #dddddd; text-align:middle;}

to:
  table.thumbtable td.thumbtd div.img { border: 1px solid #dddddd; text-align:center;}

I don't really feel qualified to change the front page, so I just wanted to let everyone know.
-Diafygi 2007/07/12

Improper Display on IE7

For those of us not using *real* operating environments :-), a user reports a problem with IE7 not displaying all the thumbnails if the thumbs are particularly large. The same user reports flawless operation under Firefox 2.

If I set (:thumblist px=240 target=_blank:) in a group with a bunch of 2800x1600 or so images in it, Firefox shows all the thumbs in a scrolled window. IE7, however, seems to only display the 4 or so thumbs that appear in the first page, omitting the scrollbar on the side, such that you only see 4 images. Odd, IE6 works great just like FF2 for this.

Is there some javascript or something that is occurring that might be causing IE7 to choke? Can anyone else independently verify?

Thanks --RussFink

 body, html, #wikibody, #wikimid, #wikitext { height:100%; }
 object { overflow:hidden; }

Thank you very much! I had added local.css months ago to combat a problem with my earlier attempts at a gallery, which was to include a Picasa-generated page. Someone on the Pmwiki users list gave me some CSS to run. Disabling the local.css to get Thumbnails to work conflicts with the changes to get Picasa's page to load sensibly, but since Thumblist works much better anyway, I'm throwing out Picasa. Take care, RussFink

Geotagging

(Reda - 05/07/2007). Geotagging would be a nice feature to have. I.e. It would be nice to see a small image thumb when clicking on a marker on googlemaps. Clicking on the image would show the full picture. Possibly it can be achieved by using the thumblist and GoogleMapAPI cookbooks. Thumblist could be expanded to generate a text file (in same folder) with image location, thumb location, lat and long (from Exif info) for each picture in a folder... The GoogleMapAPI cookbook then would only need to read the text file and generate a gma-point for each line with lat-long and image thumb location... I'm asking a lot, I know... but seems nice. Any comments? Can it be done?

Captions

The new caption feature is great^[5]. Two suggestions please

• a page variable usable on the image template page that supplies the caption for the image if it was defined on the gallery page
• allow markup in captions, eg bold, italics, links, wiki styles

Ampersand in file names

• I have noticed a little issue^[6] where the thumbgallery picks up the file descriptor from the directory OK, but doesn't seem to recognise or match the same file name in the caption list - there is an ampersand in the file name.

Specify Alternate Link

Is there a way to specify an alternate link for each image (Ex: linkfmt=SomeGroup.SomeName)? This would be particularly useful when sampling images on a different page, allowing users to jump to the source page rather than the image.

Multiple source pages, wildcards

Can I say (:thumblist TTC.Activities TTC.Activities-Gallery :) or (:thumblist TTC.Activities* :). Thanks very much

Sort by upload date

I don't know if Thumblist already does this. But I would gladly add this feature to the latest version by request. Else check out thumblist_sort.php. --Aidin Abedi

Lightbox in v.2

Hi Petko

I'm new to pmwiki and Thumblist, but I am liking the recipe a lot. I was trying to use lightbox but it doesn't seem to work. I followed the directions on the pages but no luck. I'm not using template trails or anything so I'm not sure what it could be. Not much info here for troubleshooting I'm afraid.

bilu

I have the gallery at http://vnblukas.net/index.php/Main/NewHouse. Hope that's enough information to work with. There is improvement since my last message as the images superimpose, but the next and back arrows don't appear. I appreciate your response. -bilu @ 10:45 PM on December 12, 2007. THX

THANKS! I misunderstood where I was supposed to put rel=lightbox[?G]. I originally put it in config.php. Works great now. -bilu @ 7:26 AM on December 13, 2007.

Thumblist on OSX 10.5 Leopard

Petko, Since I installed Apple's OSX 10.5 Leopard, the php is installed (by default) without the GD libs. I try to use your exellent recipe with Imagemagic. That doesn't work.

1. I get the message :GD lib not found.
2. Commenting our the relevant lines in the script at least makes the script go further, bur resizing is NOT done.
3. I know imageMagic is working on my server as it works with Quadig.

So something else is (not?) happening. Han, december 12 2007, 19.24 CET

InlineCaptionCSS

Is $ThumbList['InlineCaptionCSS'] = 1; supported in ThumbList²?

Linking the image back to the page

Hi Petko,

I am using Thumblist2 (latest version) with PmWiki. It is an excellent recipe and immensely useful. Thank you! Would it be possible to have the image link back to the page? In other words, once the image has loaded, can clicking on it again take me back to the original page? Is that possible? Is this outside the scope of your recipe?

Another question: I am continously running into people uploading large images that load with vertical and horizontal scroll bars. Is there a way that through this recipe, the original image is loaded relative to the screen resolution??

Again, I truly appreciate your recipe and all the help! skumar? January 02, 2008, at 02:48 PM

Case-sensitive Extensions Problem

Hello - I'm having a problem on my site with images that end in upper-case ".JPG" .

I'm using the thumbgallery tag to match name="*.JPG". It finds the files just fine. However, when I click on any of the thumbs of those files ending in .JPG, instead of showing the full file, it presents me with a link to let me upload the image.

I tried another test pointing to files that had lowercase ".jpg" mixed in with upper case ".JPG". While the uppercase versions give me a link instead of an image, the lowercase images take me to the full sized image as expected.

Can you look at it when you get a chance? Here is my test page. The first and last image are .jpg and "work," the middle two are ".JPG" and don't work:

http://www.finalscoretrivia.com/Main/Sandbox

Here is my code for the thumb gallery:

(:thumbgallery 
  MDPhotos.MDPhotos 
  name="TB16_*0441.JPG|*DeltaForce28*|*princ*" 
  width=375 usetemplate=1 supercache=1 cols=2 tlmode=1:)

AppCol_DeltaForce28.jpg| test1 |
TB16_c1.JPG |  | 
beerprincess.jpg |  | 

(:thumbgalleryend:)

Thanks! --RussFink

• Rename the files to lowercase extensions, or just upload them through the PmWiki upload form. This is a PmWiki standard behavior: the "Attach:" link in the ImageTemplate (or in any wiki page) does not work with uppercase extensions. PmWiki always expects files to have lowercase extensions, and when you upload such a file, PmWiki renames it, and when you link to it, PmWiki searches for the lowercase one. See also PITS.00315. Thumblist does not modify this PmWiki Attach: function, even if it will try to process uppercase files too. Note that filenames with spaces will not work too.
• You can also use in the ImageTemplate the code (:thumb "{*$UpDirUpFile}" width=800:) instead of Attach:{*$UpDirUpFile}. But renaming the files to what PmWiki expects is recommended: Thumblist should only be expected to work when the files are visible to PmWiki through both the (:attachlist:) and Attach: links. --Petko December 10, 2007, at 12:52 AM

Thumbnails from pages in a category

Hi Petko

Is there a way, how i can make the thumbnail link to the page where it is atattched, and not the whole group? I know its possible for one image alone by specifying the link, but how can it be done when there are more pages in a category and each thumbnail should link to the page of the category its attached and not the whole group?

and is it possible to only show the thumbnails of pages that are specified to a category, when there are more categories in a group?

thx

Supercache is broken in version 2008-02-08

It seems that the usage of the Keep() function is messing up the supercache function of ThumbList2. Obviously Keep() replaces the markup that is to be kept with some cryptic number code and reinserts it at the end. Too bad that this cryptic number code gets cached within the supercache. Then upon reloading the cached thumb list, the PmWiki engine doesn't know anymore what the code meant in the first place. How could it, anyway?

The solution obviously is to uncommented the commented out line in the ThumbReturn() function and to ban all usage of Keep() from the FmtThumbList() function. Here is the patch: supercache-fix.patch.txtΔ

This bug was exceptionally hard to find since the supercached page worked when the cache was being created in the first place but not when it was being loaded from the cache. Also I didn't know the Keep() function which is only implicitly documented on dubious pages and not explicitly on the functions page. See CustomMarkup under "Define a custom markup to produce a specific HTML or Javascript sequence" or search for "keep(". --Fritz Webering? March 09, 2008, at 06:04 PM

Thanks for finding this bug. I fixed it differently, as the Keep()s are needed when there is markup in captions. Before the cache is stored, it is now converted to HTML including all "cryptic" (actually escaped) entries. Thanks again. --Petko March 10, 2008, at 04:16 PM

I believe it is now fixed with version 83D (using MarkupRestore instead of MarkupToHTML). Please test the new version and confirm if supercache is working as you expect. Thanks. --Petko March 13, 2008, at 10:19 AM

Thanks for this report: at all my installations this problem didn't appear, and the reason was that I had manually defined three variables as I've had problems with their automatic detection by PmWiki:

 $UploadUrlFmt = "/uploads";
 $FarmPubDirUrl = $PubDirUrl = "/pub";

However, Thumblist2 should work with a default PmWiki installation, so I'll look closer to fix this problem. It appears that the newest requested feature with markup in captions has caused much more problems than it solved... Thanks, --Petko March 22, 2008, at 11:18 AM

Please test the new version 83M (just released). It should finally work. Thanks for your help improving the recipe. --Petko March 22, 2008, at 03:43 PM

The version 83P is quite efficient. Could you possibly tell me what fancy JavaScript and HTML are you using in your snippets: it should be possible to manage it. Also note that usually you would want to enclose JavaScript in comments to hide the code from older browsers:
<script><!--
some_code(); //--></script> and this one should be properly escaped too with 83M-83P. If you feel that this is out of the scope of this manual here, please e-mail me directly. --Petko March 25, 2008, at 02:16 PM

Single random thumb

Any reason why we can't have a randon single thumb, viz

Please use (:thumblist count=1 order=random:). [9]. You need to order/shuffle a full thumblist, not a single thumb, but you can display one thumb from this list. --Petko June 30, 2008, at 07:52 PM

OK^[10], makes sense, thanks, you are so fast !