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

Class: Gallery

Source Location: /class-gallery.php

Class Gallery

Property Summary
mixed   $albumdir  
mixed   $albums  
mixed   $lastalbumsort  
mixed   $options  
mixed   $theme  
mixed   $themes  

[ Top ]
Method Summary
Gallery   Gallery()   Creates an instance of a gallery
void   clearCache()   Cleans out the cache folder
bool   garbageCollect()   For every album in the gallery, look for its file. Delete from the database if the file does not exist. Do the same for images. Clean up comments that have been left orphaned.
Album   getAlbum()   Returns the a specific album in the array indicated by index.
string   getAlbumDir()   Returns the main albums directory
array   getAlbums()   Get Albums will create our $albums array with a fully populated set of Album names in the correct order.
string   getCurrentTheme()   Returns the foldername of the current theme.
string   getGallerySortKey()   Returns the DB field corresponding to the sort type desired
int   getNumAlbums()   Returns the total number of TOPLEVEL albums in the gallery (does not include sub-albums)
array   getNumComments()   Returns the count of comments
int   getNumImages()   Returns the number of images from a database SELECT count(*) Ideally one should call garbageCollect() before to make sure the database is current.
array   getThemes()   Populates the theme array and returns it. The theme array contains information about all the currently available themes.
array   loadAlbumNames()   Load all of the albums names that are found in the Albums directory on disk.
void   setCurrentTheme()   Sets the current theme
int   sizeOfCache()   Returns the size in bytes of the cache folder. WARNING: VERY SLOW.
int   sizeOfImages()   Returns the size in bytes of the albums folder. WARNING: VERY SLOW.

[ Top ]
Properties
mixed   $albumdir = NULL [line 9]

[ Top ]
mixed   $albums = NULL [line 10]

[ Top ]
mixed   $lastalbumsort = NULL [line 14]

[ Top ]
mixed   $options = NULL [line 11]

[ Top ]
mixed   $theme [line 12]

[ Top ]
mixed   $themes [line 13]

[ Top ]
Methods
Constructor Gallery  [line 21]

  Gallery Gallery( )

Creates an instance of a gallery



[ Top ]
clearCache  [line 613]

  void clearCache( [string $cachefolder = NULL]  )

Cleans out the cache folder

Parameters:
string   $cachefolder:  the sub-folder to clean


[ Top ]
garbageCollect  [line 297]

  bool garbageCollect( [bool $cascade = true], [bool $complete = false], [int $restart = '']  )

For every album in the gallery, look for its file. Delete from the database if the file does not exist. Do the same for images. Clean up comments that have been left orphaned.

Returns true if the operation was interrupted because it was taking too long

Parameters:
bool   $cascade:  garbage collect every image and album in the gallery.
bool   $complete:  garbage collect every image and album in the *database* - completely cleans the database.
int   $restart:  Image ID to restart scan from


[ Top ]
getAlbum  [line 144]

  Album getAlbum( int $index  )

Returns the a specific album in the array indicated by index.

Takes care of bounds checking, no need to check input.

Parameters:
int   $index:  the index of the album sought


[ Top ]
getAlbumDir  [line 42]

  string getAlbumDir( )

Returns the main albums directory



[ Top ]
getAlbums  [line 80]

  array getAlbums( [int $page = 0], [string $sorttype = null], [string $direction = null]  )

Get Albums will create our $albums array with a fully populated set of Album names in the correct order.

Returns an array of albums (a pages worth if $page is not zero)

Parameters:
int   $page:  An option parameter that can be used to return a slice of the array.
string   $sorttype:  the kind of sort desired
string   $direction:  set to a direction to override the default option


[ Top ]
getCurrentTheme  [line 212]

  string getCurrentTheme( )

Returns the foldername of the current theme.

if no theme is set, returns "default".



[ Top ]
getGallerySortKey  [line 50]

  string getGallerySortKey( [string $sorttype = null]  )

Returns the DB field corresponding to the sort type desired

Parameters:
string   $sorttype:  the desired sort


[ Top ]
getNumAlbums  [line 160]

  int getNumAlbums( [bool $db = false], [bool $publishedOnly = false]  )

Returns the total number of TOPLEVEL albums in the gallery (does not include sub-albums)

Parameters:
bool   $db:  whether or not to use the database (includes ALL detected albums) or the directories
bool   $publishedOnly:  set to true to exclude unpublished albums


[ Top ]
getNumComments  [line 277]

  array getNumComments( [bool $moderated = false]  )

Returns the count of comments

Parameters:
bool   $moderated:  set true if you want to see moderated comments


[ Top ]
getNumImages  [line 239]

  int getNumImages( [ $publishedOnly = false]  )

Returns the number of images from a database SELECT count(*) Ideally one should call garbageCollect() before to make sure the database is current.

Parameters:
   $publishedOnly: 


[ Top ]
getThemes  [line 182]

  array getThemes( )

Populates the theme array and returns it. The theme array contains information about all the currently available themes.



[ Top ]
loadAlbumNames  [line 112]

  array loadAlbumNames( )

Load all of the albums names that are found in the Albums directory on disk.

Returns an array containing this list.



[ Top ]
setCurrentTheme  [line 228]

  void setCurrentTheme( string $theme  )

Sets the current theme

Parameters:
string   $theme:  the name of the current theme


[ Top ]
sizeOfCache  [line 584]

  int sizeOfCache( )

Returns the size in bytes of the cache folder. WARNING: VERY SLOW.



[ Top ]
sizeOfImages  [line 598]

  int sizeOfImages( )

Returns the size in bytes of the albums folder. WARNING: VERY SLOW.



[ Top ]

Documentation generated on Tue, 30 Sep 2008 20:23:14 +0200 by phpDocumentor 1.4.1