getgallery — get the next available slot in the named gallery
use Wacs;
use Wacs::WacsStd;
scalar getgallery( | ...); |
| parameter | description |
|---|---|
| which | Specifies which area to substitute in - can be either scategory (middle level) or sdirectory (lower level). |
| stype | stype of the set concerned: typically I for image set, V for video. |
| sarea | Top level area in which to search for the next available gallery slot |
| scategory | The middle level directory entry (can be either simply specified or the
subject of the substitution). This should include the variable pattern
given in substitute below, as in gallery#NEXT#. |
| sdirectory | The lower level directory entry (if needed, otherwise blank). |
| substitute | The string to be substituted with the value determined by the
routine. Typically this will be something like #NEXT#.
|
| dbhandle | The Perl DBI handle to the current database |
The getgallery function returns the appropriate
string for the next available slot in the gallery in the specified section.
It can return either an scategory or sdirectory variable as requested via
the which parameter. It is used to work out the placement of new sets
within a gallery structure. What the next usable gallery is is determined
by reference to the layout attribute
setspergallery in the configuration file or the default value
(usually 20) if not specified. Please see the configuration manual for
more details on this configuration attribute.