This page in: English - Deutsch - Español - Français - Italiano - Lietuvių - Nederlands - Norsk - Polski - Русский - Svenska - Tiếng Việt - عربي - 日本語 简体中文
Flickr
The Flickr module will allow you to integrate your photo albums at flickr.com into you CMS Made Simple based website. The module is very flexible and the output is templates based and can thus easily be modified to suit your needs. Author's website
The module is described below (more info available in the built-in help), but don't forget to checkout the new development site on the CMS Forge.
- Installation
- Download the latest release (see below).
- Unzip the file into your modules directory.
- Goto the modules page in the CMSMS administration console and install the Flickr module.
- Goto the Flickr module configuration page (under Extensions) and enter your flickr.com API key. If you don't have one you can obtain one here.
- If you have mod_rewrite enabled in config.php then you need to insert the following two lines in your .htaccess file. The lines should be inserted right after "RewriteEngine On" and before the rule that handles the normal pages . Note that you need to replace "gallery" in the RewriteCond line with the page alias of the page you are using the module in.
RewriteCond %{REQUEST_URI} /gallery/.+ [NC]
RewriteRule ^([^/]+)(/([0-9]+))?(/([0-9]+))?(.*)$/index.php?page=$1&set_id=$3&pic_id=$5$6 [QSA,NC,L]
- You are now ready to use the module in your pages. See below for more information.
- Documentation'
As this is just a tag module, it is inserted into your page or template by using the cms_module tag. An example using only the required parameters would be:
{cms_module module="Flickr" username="Your flickr.com username"}
Additionally you can add a number of optional parameters:
- (Required) username - This parameter specifies your flickr.com username. Note that the username is also called "Screen name" in flickr.com terminology.
- (Optional) photos_per_page - Use this parameter to limit the number of thumbnails shown on each page for a photo set. Default is 20, set to a high number to disable.
- (Optional) setlist_template - If you want to use another template than setlist.tpl to display a list of photo sets, then use this tag. Note that you must include the .tpl extension.
- (Optional) set_template - If you want to use another template than set.tpl to display a photo set, then use this tag. Note that you must include the .tpl extension.
- (Optional) photo_template - If you want to use another template than photo.tpl to display a single photo, then use this tag. Note that you must include the .tpl extension.
- (Optional) title - Title which is used on the frontpage of the gallery (ie. the page with a list of sets). The title is only displayed on this page.
- (Optional) intro - Text which is displayed under the title on the frontpage of the gallery (ie. the page with a list of sets). The text is only displayed on this page.
The following parameters are a bit special since they alter the output of of the module completely. If you set the breadcrumbs parameter to 1 then the module will return a breadcrumbs-like path to the current photo but nothing else. Intended use it that the module is inserted twice on a single page, once for generating the breadcrumbs and once for generating the gallery.
- (Optional) breadcrumbs - (0/1) Enable breadcrumbs mode. Default is 0.
- (Optional) breadcrumbs_delimiter - Text to seperate entries in the list (default ">>").
- (Optional) breadcrumbs_initial - (0/1) If set to 1 start the breadcrumbs with a delimiter (default 0).
- (Optional) breadcrumbs_root - Page alias of a page you want to always appear as the first page in the list. Can be used to make a page (e.g. the front page) appear to be the root of everything even though it is not.
This page in:
English -
Deutsch -
Español -
Français -
Italiano -
Lietuvių -
Nederlands -
Norsk -
Polski -
Česky -
Русский -
Svenska -
Tiếng Việt -
عربي -
日本語
简体中文
