[ class tree: plugins ] [ index: plugins ] [ all elements ]

Procedural File: paged_thumbs_nav.php

Source Location: /zp-extensions/paged_thumbs_nav.php

Page Details

Prints a paged thumbnail navigation to be used on a theme's image.php, independent of the album.php's thumbs loop The function contains some predefined CSS ids you can use for styling.

Author:  Malte Müller (acrylian)
Classes
Class Description
pagedthumbsOptions Plugin option handling class
pagedThumbsNav
Functions
printPagedThumbsNav  [line 469]

Prints a paged thumbnail navigation to be used on a theme's image.php, independent of the album.php's thumbs loop

NOTE: With version 1.0.2 $size is no longer an option for this plugin. This plugin now uses the new maxspace function if cropping set to false.

The function contains some predefined CSS ids you can use for styling. NOTE: In 1.0.3 a extra div around the thumbnails has been added: <div id="pagedthumbsimages">. The function prints the following HTML:

<div id="pagedthumbsnav">

<div id="pagedthumbsnav-prev"> <a href="">Previous thumbnail list</a> </div> (if the link is inactive id="pagedthumbsnav-prevdisabled", you can hide it via CSS if needed)

<div id="pagedthumbsimages"> <a href=""><img></a> (...) (the active thumb has class="pagedthumbsnav-active") </div>

<div id="pagedthumbsnav-next"> <a href="">Next thumbnail list</a> (if the link is inactive id="pagedthumbsnav-nextdisabled", you can hide it via CSS if needed) </div>

<p id="pagethumbsnav-counter>Images 1 - 10 of 20 (1/3)</p> (optional) <ul id="pagedthumbsnav-pagelist"> (optional) <li><a href=""></a></li> (active page link has css class "pagedthumbsnav-pagelistactive" attached) </ul>

</div>

You can of course build your own order of the elements as this plugin is with version 1.2.7 based on a class. Make a custom theme function and change the order of the functions calls within. Alternatively you can use also use the "get" class methods to build something completely customized.

Parameters:
int   $imagesperpage:  How many thumbs you want to display per list page
bool   $counter:  If you want to show the counter of the type "Images 1 - 10 of 20 (1/3)"
string   $prev:  The previous thumb list link text
string   $next:  The next thumb list link text
int   $width:  The thumbnail crop width, if set to NULL the general admin setting is used. If cropping is FALSE this is the maxwidth of the thumb
int   $height:  The thumbnail crop height, if set to NULL the general admin setting is used. If cropping is FALSE this is the maxwheight of the thumb
bool   $crop:  Enter 'true' or 'false' to override the admin plugin option setting, enter NULL to use the admin plugin option (default)
bool   $placeholders:  Enter 'true' or 'false' if you want to use placeholder for layout reasons if teh the number of thumbs does not match $imagesperpage. Recommended only for cropped thumbs. This is printed as an empty <span></span> whose width and height are set via inline css. The remaining needs to be style via the css file and can be addressed via "#pagedthumbsimages span".
bool   $showpagelist:  Enter 'true' or 'false' if you want to a list of the pages available. Can be styled via "#pagedthumbsnav-pagelist".
bool   $showprevnext:  If you want to show the prev and next links with the pagelist
int   $navlen:  How many page links should be shown (not that there will be dotted ransition links like this: 1 2 3 4 ... 30).
   $pagelistprevnext: 
   $pagelistlength: 


void printPagedThumbsNav( [int $imagesperpage = ''], [bool $counter = false], [string $prev = ''], [string $next = ''], [int $width = NULL], [int $height = NULL], [bool $crop = NULL], [bool $placeholders = NULL], [bool $showpagelist = false], [ $pagelistprevnext = false], [ $pagelistlength = 6], bool $showprevnext, int $navlen  )

[ Top ]


Documentation generated on Tue, 20 Dec 2011 16:07:54 +0100 by phpDocumentor 1.4.3