Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source MagazineAOE Media

1.2. Users manual

How to install the extension

  1. Create a sysfolder for the topics, the photographics, and the albums,

  2. Create a page for the plugin with code LIST,

  3. Create a page for the plugin with code SINGLE, for this one you must add a new template, if you want a popup without your site template. This method is only if you use the display on a popup (see constant editor). The simplest is to add template with the following script :

page = PAGE

page.typeNum = 0

page.10 < styles.content.get

Don't forget to add “content(default)” on “Include static” section.

  1. Create a page for the plugin with code SEARCH,

  2. Create a page for the plugin with code ALBUM,

  3. Create a page for the plugin with code TOPICLIST,

  4. Create a page for the plugin with code ALBUMLIST,

  5. Create a page for the plugin with code RANDOM,

  6. For each of these pages, add the photographic library plugin with the right code selected on listbox “Type of display”

    Illustration 1Look for this picture to add extension with wizard for a new content element

    The sysfolder which contain your photographic has to be set as Startingpoint for the code LIST and SEARCH and possibly for the code ALBUM.

The field “Topic id (for LIST) or Album id (for ALBUM) allow to select a specific topic or a specific album to display it

The field layout allow to choose between 4 presentations for ALBUM, LIST or SINGLE

Codes description :

CODE

Use CE

Description

Startingpoint

ALBUM

Template file, "Single" pid, Maximum size, Number of photos, Enlarging link

Display the name of album(s) and the photos of album(s) on the page. If there is a startingpoint, use album(s) on it, else use album(s) on current page.

YES or NO

LIST

Template file, "Single" pid, Maximum size, Number of photos, Enlarging link

Display the list of all the photos of a startingpoint with a link on each to see the detail.

YES

SEARCH

Template file, "Single" pid, Maximum size, Number of photos, Enlarging link, Album search, Topic search

Display search engine with search on word, topic and/or album. Display the result on the same page on a list like the page with code LIST.

YES

SINGLE

Template file, Maximum single size, Single title backgroundcolor, Default copyright, Horizontal margin, Vertical margin, Pop-up width, Pop-up height

Display the detail of a photo in a popup window .

NO

TOPICLIST

Template file, "List" pid, Topic name wrap

Display the list of all photo topics which are not hidden or deleted with a link to the LIST page to show  all the photos of a selected topic.

YES

ALBUMLIST

Template file, "List" pid, Album name wrap

Display the list of all albums which are not hidden or deleted with a link to the LIST pages to show all the photos of a selected album.

YES

RANDOM

Number of line,Number of column

Display a table of random image with no link to see the enlarge photographic

YES

Remarks :

  1. The default code is the code LIST,

  2. Page with ALBUM, TOPICLIST or ALBUMLIST code diplays all albums or topic of the current page (if no starting point) or albums or topic of the starting point,

  3. Layouts allow different page-setting and different displayed fields, see on template to change them,

  4. Pages recursivity is dealt with,

  5. In an album, photographs are displayed in order they were selected,

  6. The field “Topic id (for LIST) or Album id (for ALBUM)” associated with code LIST allow to display photographs for a specific topic,

  7. The field “Topic id (for LIST) or Album id (for ALBUM)” associated with code ALBUM allow to display photographs for a specific album.

How to manage photos items and albums objects

The records of the photographic library (topics and photographs) can be managed in the same way like all other records. All records have to be created in the sysfolder.

The records “album” can be created on a sysfolder or directly on the page in which it be displayed.