<Gallery>

Gigatrees has built in support for a photo gallery. The sample user configuration file ( config\sample.xml ) includes a sample gallery configuration. To configure the gallery, media images must have first been added using the <MediaFile> option. Collections, albums and layouts must then be configured. Collections are identified by tags, are given a title and allow for assigning default thumbnails to be used in the collection's groups. Albums are also given a title and a default thumbnail. The layouts allow for grouping collections into albums. Collections are allowed to overlap albums.

Gallery - Layout
Gallery - Layout
Gallery - Album
Gallery - Album
Gallery - Album - Collection
Gallery - Album - Collection
Gallery - Album - Collection - Group
Gallery - Album - Collection - Group
Gallery - Album - Collection - Group - Image
Gallery - Album - Collection - Group - Image

Example

<Gallery>
  <LockGallery>                     false       </LockGallery>
  <GalleryPageSize>                 44          </GalleryPageSize>
  <GalleryThumbnailSize>            100         </GalleryThumbnailSize>
  <GalleryRecentOffset>             30          </GalleryRecentOffset>
  <GalleryMinYearIncluded>          1900        </GalleryMinYearIncluded>
  <GalleryMaxYearIncluded>          2000        </GalleryMaxYearIncluded>
  <HideUnusedGalleryCollectionTags> false       </HideUnusedGalleryCollectionTags>
  <GalleryCollections> 
    <Collection> <Tag> bob   </Tag> <Title> Bob Builder   </Title> <Thumbs> G1, G2, G3 </Thumbs> </Collection>
    <Collection> <Tag> alice </Tag> <Title> Alice Builder </Title> <Thumbs> GA, GB, GC </Thumbs> </Collection>
  </GalleryCollections> 
 
  <GalleryAlbums> 
    <Album> <Title> Bob & Alice </Title> <Thumb> G1 </Thumb> </Album> 
    <Album> <Title> Alice       </Title> <Thumb> GC </Thumb> </Album> 
  </GalleryAlbums> 

  <GalleryLayouts> 
    <Layout> <Album> Bob & Alice </Album>  <Collections> bob, alice </Collections> </Layout> 
    <Layout> <Album> Alice       </Album>  <Collections> alice      </Collections> </Layout> 
  </GalleryLayouts> 
</Gallery>

Standalone Photo Gallery

To create a standalone photo gallery, you will need to leave the <GedcomFile> field blank, and disable <Blog> pages. If blog pages are not disabled, Gigatrees will assume you want to build a standalone blog with an included gallery.

  <Main>
    <GedcomFile>       </GedcomFile>
  </Main>
  
  <Pages>
    <Blog>       false </Blog>
  </Pages>  

Options

<LockGallery>
[ false ]
You may lock the gallery independantly from the rest of the website. When locked and when the <Database> is enabled, the gallery will require the visitor to sign in using their user credentials.
<GalleryPageSize>
[ 44 ]
This number of photos to be displayed on a gallery page. Gallery pages will include pagination when the total number of photos to be displayed exceeds the size provided here.
<GalleryThumbnailSize>
[ 100 ]
This size in pixels to display your square thumbnail images as.
<GalleryRecentOffset>
[ 30 ]
The number of days to mark photos as recent. The value is subtracted from a photo's modified date.
<GalleryMinYearIncluded>
[ 0 ]
Limit the range of photos to include in the gallery.
<GalleryMaxYearIncluded>
[ 3000 ]
Limit the range of photos to include in the gallery.
<HideUnusedGalleryCollectionTags>
[ false ]
When enabled, collections tags that are unused due to other options that limit the size of the gallery, will be hiden from the gallery.
<GalleryCollections>
This tag indicates the start of the gallery collections.
<Collection>
This tag indicates the start of a new gallery collection.
<Tag>
[ ]
The collection tag name
<Title>
[ ]
The collection tag title
<Thumbs>
[ ]
The collection's default thumbnails. The is a comma-seperated list.
<GalleryAlbums>
This tag indicates the start of the gallery albums.
<Album>
This tag indicates the start of a new gallery album.
<Title>
[ ]
The album's title
<Thumb>
[ ]
The album's default thumbnail
<GalleryLayouts>
This tag indicates the start of a the gallery layouts.
<Layout>
This tag indicates the start of a new gallery layout.
<Album>
[ ]
The layout's album title
<Collections>
[ ]
The layout's collections. This is a comma-seperated list.
Comments