Image Galleries User Documentation

Image Gallery User

The Menu

When Image Galleries are enabled and you have the right permissions, site visitors can see an Image Gallery menu can be clicked to open. From here you will be able to create galleries and upload images to the galleries.

Collapsed and Expanded Menu:
Image Image

There are usually three options in the menu — Galleries, Rankings and Upload Images — and the options may change depending on your permissions. In our example, you can see an additional option "System Galleries". In this section, let's examine each option in detail.

At first, before galleries are created or images uploaded to them, the Galleries center panel appears as in this illustration. Notice the "create new gallery" link.


Clicking the "create new gallery" link displays a form to create a new gallery, with fields to fill-in, as you can see here:


The fields are explained in the following table:
Field Description
Name Short name for the gallery. Appears in listings.
Description A description of the contents of the gallery.
Gallery is visible to non-admin users If not checked, then the gallery will be visible only to users with the tiki_p_admin_galleries permission set.
Geographic if checked then images can have a longitude and latitude and be displayed using the maps feature.
Max Rows per page Used for formatting gallery appearance, this is the maximum number of rows of thumbnails, per page, that will be displayed to visitors.
Images per row Used for formatting gallery appearance, this is the maximum number of thumbnails per row.
Thumbnails size X Width for Thumbnails, in pixels.
Thumbnails size Y Height for Thumbnails, in pixels.
Available scales Scales available, according to your web hosts' image formatting software. May display 'No scales available'.
Add scaled images size X x Y If available, you can add a scaled image of size X pixels by Y pixels.
Categorize Use categories to group your Gallery with other Tiki objects. Here you can show and hide the category list, choose a pre-created category, check "Categorize" to add the gallery to a category, or, Admin your categories.
Other users can upload images to this gallery If checked, users will be allowed to upload images to your gallery, but they won't be able to delete images or change the gallery.

Create a gallery for testing by filling in the form, and clicking Save at the bottom of the form. Once Tiki creates the gallery, it will be listed like so:


If you want to browse the gallery, click its name. On each line in the listing, depending on your permissions set you can see the "Actions" you can take on each gallery:


If you hover your mouse above each of the Actions icons, you can infer that they link to a set of tools including:

  • Edit: edit the gallery information using the same form you used to create the gallery. Here, you can change gallery information, your categories or the size of existing thumbnail images.
  • Delete: remove the entire gallery and its images. Use this with care, as it is a permanent operation.
  • Upload: upload images to the gallery.
  • List: browse the gallery's images as a list.
  • Perms: configure permissions for the gallery (if you are an admin).
  • Make Map: Generate a layer to be used with the maps feature (only availabl e for geographic galleries).

Let's examine some of these items in more detail:

Upload Image

The Upload Action allows you to upload images to the listed gallery, and displays a form as follows:


this picture is from an old tikiwiki version - Please feel free to update to a new one

After selecting a gallery you create, or a public gallery created by another user, you can either enter the URL of your image or select it from your local hard disk. Use only one method for each image, as results can be unpredictable if you upload the same image using both methods.

Tiki auto-generates thumbnails for uploaded images, but if you don't like the way they look, or if you do not want a simple thumbnail of the entire image, you can also upload your own thumbnails along with the image.

Batch upload means that if you upload a zip file, the file will be automatically unzip and the individual images will be uploaded. The compressed format accepted are .zip (WinZip, PKZIP, Windows Compressed Folder). (see phpconcept.php /pclZip for more details)
Remove any files from the folder that are not images (thumbs.db, etc...)

If the image is successfully uploaded, you will see its and its thumbnail displayed, as in this graphic:


Success! The image was uploaded and stored into the Tiki database or into a folder on your server. Note the image, the thumbnail, and information about how to browse the image or include it in an HTML page or a Wiki page. Keep these links in mind for use in your Wiki pages or Blog posts.

Note: If Tiki's thumbnail is the same size as the image, there are several possible explanations:

  • The image is a GIF. Tiki cannot resize GIFs do to copyright limitations regarding their format.
  • Your web server's PHP installation does not have the GD or ImageMagick graphics manipulation packages installed.
  • Your web server's PHP installation's GD or ImageMagick packages are too old.

Browse or List Galleries

Clicking on the gallery name link allows you to browse a listing of thumbnails for the images in the gallery. Clicking on the "List" action displays a non-graphical, quick-loading list representation of the gallery with one image per line. The list looks like this:


In List View, click "Browse Gallery" to toggle back to its Thumbnail View. In the following graphic, you will notice a horizontal menu with links to Edit the gallery, rebuild thumbnails, upload images, or toggle back to List View. Above the image list or thumbnails, there are links to sort by name, date, hits, user or size. For example, clicking Name sorts in alphabetical order, from A to Z, and clicking Name again sorts in reverse alphabetical order, from Z to A. Try sorting for all the options, once you have several images uploaded.


For each image, a thumbnail is displayed showing the image title, its size and the number of hits (a hit is computed each time the image is browsed). Under each thumbnail, you will find icons for Delete, Edit and Popup which act on that image.

Click the thumbnail to browse the image actual-size. Here, you will find image information, an option to move the image to another gallery (if you have permission), and link information to allow you to display the image in an HTML page or a Wiki page, an article or a Blog. You will also see links to the Next and Previous images in the gallery to browse all the gallery images if you like.


Individual permissions for image galleries

From the gallery listing screen, if you have the right permissions you can use the "Perms" action to set up individual permissions for an image gallery:


When you assign a individual permission for a gallery, you can override Tiki's global permissions system, so that only the users that have the permissions you have set for the gallery can view, edit or upload. This feature can be used to configure, for example, private galleries, paid galleries or galleries where only a special group of users can upload images.

If enabled from the admin screen, Tiki can capture images referenced from other sites or URLs, storing them in its database, or in a folder on your webserver. Tiki displays those images in a special gallery called the "System Gallery". If you are an admin, you can browse the System Gallery, and remove images from it.

Tips & Tricks

One idea for a creative use of a Tiki Image Gallery is to upload buttons or icons that you might use in the pages on your site.


In October 2008 a feature which can display a random image from an image gallery became available. A URL such as http:show_image.php?galleryId=2 will return an image which represents the specified gallery. The image selection is controlled by an option in gallery configuration which controls whether a random image is shown, the first image is shown, etc.

Shadowbox eye-candy

When Shadowbox feature is enabled (only on Tiki sites from Tikiwiki 1.10 onwards), images can be shown in a more fancy way.

See this example from an image gallery:


Then when you click on an image (the one in the red cicle in this example), the screen becomes blackish for some seconds while it loads...


..and and the image opens in the middle of the screen, with some nagivation links below.


Known bugs and problems

GIF Patent Issue: Thumbnail generation does not work for GIF format, resulting in a thumbnail which is the same size as the original image. This is due to patent issues, and cannot be resolved unless the patent for GIF format expires.

More documentation

Related Information

Useful Links





  • User selector
  • Static Text Tracker Field
  • Subscription Tracker Field
  • System Tracker Field
  • Textarea Tracker Field
  • URL Tracker Field
  • Adding items to a tracker
  • How to change tracker field types
  • Linking trackers
  • Multilingual trackers
  • Searching tracker items
  • Viewing Tracker Results
  • Export trackers
  • Terms and Conditions
  • Accounting
  • User Preferences
  • Inter-User Messages
  • Gmap User
  • Bookmarks
  • Watch
  • User Page
  • MyTiki Details
  • Score vs Karma
  • User Action log
  • Search User
  • Mobile Tiki User
  • User Wizard
  • Must Reads

  • Keywords

    Keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):

    Accessibility (WAI and 508)
    Accounting (7.x)
    Articles and Submissions
    Batch (6.x)
    BigBlueButton audio/video/chat/screensharing (5.x)
    Browser Compatibility
    Link Cache
    Clean URLs
    Communication Center
    Compression (gzip)
    Contacts (Address Book)
    Contact us
    Content Templates
    Contribution (2.x)
    Credit (6.x)
    Custom Home and Group Home Page
    Date and Time
    Debugger Console
    Directory of hyperlinks
    Documentation link from Tiki to doc.tiki.org (Help System)
    Docs 8.x
    Draw 7.x
    Dynamic Content
    Dynamic Variable
    External Authentication
    Featured links
    File Gallery
    Friendship Network (Community)
    Gmap Google maps
    HTML Page
    i18n (Multilingual, l10n, Babelfish)
    Image Gallery
    Inter-User Messages
    Kaltura video management (4.x)
    Live Support
    Logs (system & action)
    Look and Feel
    Lost edit protection
    Map with Mapserver
    Meta Tags
    Mobile Tiki and Voice Tiki
    Performance Speed / Load
    Platform independence (Linux-Apache, Windows/IIS, Mac, BSD)
    Profile Manager
    Search engine optimization
    Search and Replace
    Semantic links (3.x)
    Shadow Layers
    Shopping cart
    Social Networks
    Spam protection (Anti-bot CATPCHA)
    Tags (2.x)
    Tell a Friend, alert + Social Bookmarking
    TikiTests (2.x)
    Theme CSS & Smarty
    Transitions (5.x)
    User Administration including registration and banning
    User Files
    User Menu
    WebDAV (5.x)
    Web Services
    Wiki 3D
    Wiki History, page rename, etc
    Wiki Page Staging and Approval (2.x)
    Wiki Plugin extends basic syntax
    Wiki Syntax
    Wiki structure (book and table of content)
    WYSIWYG (2.x)

    Tiki Newsletter

    Delivered fresh to your email inbox!
    Newsletter subscribe icon
    Don't miss major announcements and other news!
    Contribute to Tiki