Loading...
 
Skip to main content

History: ImageGalleryDoc

Preview of version: 11

Image galleries are collections of images. Users can create galleries and upload images to private or public galleries. You can select the number of thumbnails to appear in gallery rows/files as well as the thumbnail's size. Thumbnails are automatically created by Tiki; you don t have to upload them. Galleries can be used for albums, stories, showrooms, and many other applications.

If you have the right permission you will be able to create galleries and upload images to the galleries.

insert graphic

This is the menu that is displayed when you expand the Image Galleries section in the main menu. There are three options in the menu: Galleries, Rankings and Upload Images (options may change depending on your permissions). We are going to examine each option in detail.


Note that all galleries can be accessed by all users, there is not a way to make a gallery only accesible by some users, don't include private photos in a gallery unless you can accept that everybody can see the images. There is no thing such as a private gallery. You can control who can create or edit galleries but not who can view/browse a gallery.


If you are following the manual your first visit to the Galleries screen will display no records.

insert graphic

Creating a gallery


If you click in the create gallery link a screen with a form to create a new gallery will be displayed:

insert graphic

The fields are explained in the following table:

Field Description
Name The gallery name
Description The gallery description
Gallery is visible to non-admin users If not set then the gallery will be visible only to users with the tiki_p_admin_galleries permission set.
Max Rows per page Maximum number of rows of thumbnails that will be displayed when someone visits the gallery.
Images per row Maximum number of thumbnails per row when visiting the gallery.
Thumbnails size X Width for Thumbnails
Thumbnails size Y Height for Thumbnails
Available scalesno clue but with me it is 'No scales available'
Add scaled images size X x Yagain no clue
Other users can upload images to this gallery If checked then other users can upload images to your gallery, they won t be able to delete images or change the gallery.


Create a gallery for testing if you want, we'll use it in the next sections.

insert graphic

After creating a gallery you can see the options you have in the listing (again options may vary according to permissions), the whole package of options is:

  • Edit: edit the gallery information
  • Remove: remove the gallery
  • Upload: upload images to the gallery
  • Browse: browse the gallery (click on the gallery name)
  • List: gallery listing
  • Configure individual permissions for the gallery (if admin)

Edit

Edit will allow you to edit the gallery using the same form you used to create the gallery, you can change the gallery information here, size of thumbnails, etc. Note that changin the size of the thumbnails doesn t actually rebuild the thumbnails, you must use the rebuild thumbnails option when browsing the gallery to rebuild them.

Remove

Remove will remove the gallery and all the images in the galleries, this won t ask for confirmation, all the galleries and images will be gone so use it very carefully. Upload This option will take you to the upload image screen that is explained later.

Browse

The browse option (clicking on the gallery name) can be used to browse the gallery, when you browse a gallery you will see thumbnails for the gallery images. We ll show you an example of browsing a gallery after we explain how to upload images to the gallery.

List

List is a non-graphical representation of a gallery instead of thumbnails for each image you will see a listing with one row per image, if you want to delete images or take a quick-look at a gallery content without viewing the images you may want to use list instead of browse since listing is faster than browsing the gallery.

Upload Image

The Upload image screen let s you upload images to galleries.

insert graphic

The fields are self-explanatory, note that you have to select a gallery where the image will be uploaded, you can upload images to galleries you created or public galleries created by other users(!).

There re two ways to upload images: entering the image URL or uploading an image from your disk, the upload screen admits both formats but you should use only one method for each image. (If you enter a URL you dont have to upload and if you upload you don t have to enter a URL). If you use both then the result is unpredictable.

Optionally you can also upload a thumbnail for the image, if you don t upload a thumbnail Tiki will auto-generate a thumbnail using a reduced version of the uploaded image, if you don t like how Tiki generates thumbnails or if you want to provide your own thumbnails or if you want thumbnails different than the full image you should upload a thumbnail along with the image.

If everything goes fine the image will be uploaded and you will see the image and the thumbnail displayed.

For example:

insert graphic

The image was uploaded and stored into the Tiki database!

You will se the image, the thumbnail and information about how to browse the image and how to include the image in an HTML page or a Wiki page. Keep this links in mind since you may want to upload some images to a gallery that can later be used in your Wiki pages or in your Blog posts. Uploading images to a gallery is a nice way to keep images stored in the Tiki system so they won t fail if a site that held them goes offline or removes the images.

If you see the thumbnail with the same size as the image then: if the image was a GIF file this is normal, don t worry, if the image is not a GIF your PHP installation doesn t have the GD extension or the GD extension is too old, in such a case thumnbnails will be generated resizing the original image.

Uploading Images reminder:


Note: You can upload images to:

  1. Galleries created by you
  2. Public galleries (galleries with the public option set)

The System Gallery

As you already know if enabled from the admin screen Tiki can capture images referenced from other sites/URLs storing them in the Tiki database. Those images will be stored in a special gallery called The system gallery if you are admin you can browse the system gallery and check what images are stored there, and if you want you can also remove images (if they are no longer referenced from user pages). A feature to automatically remove orphan images (images not being used in any page) will be added to future Tiki versions.

Browsing galleries

Once you have some images uploaded you may want to browse the gallery you created:

insert graphic

The browse gallery screen displays the thumbnails, the gallery description and links to edit the gallery, rebuild the thumbnails and upload images (if you have the right permissions). The x link can be used to remove an image from the gallery if you want.

There are options to sort the images in the galleries by Name, Date, Hits, Size and User if you want a different order (clicking the link again will reverse the ordering)

For each image a thumbnail is displayed showing the image title, it s size and the number of hits (a hit is computed each time the image is browsed). If you click on the image you will browse the image:

insert graphic

In the browse image screen you will see the full image, the image information, an option to move the image to another gallery (if you have permission) and the information on how to link to browsing the image or how 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/prev image in the gallery to browse all the gallery images if you want.

Individual permissions for image galleries


From the gallery listing screen if you have the right permissions you will see a link labeled perms this link can be used to set-up individual permissions for an image gallery:

insert graphic

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

History

Information Version
Greg Martin 23
View
Greg Martin 22
View
Greg Martin 21
View
Mikko Ohtamaa 20
View
Patrick Salsbury Added links to some useful docs about file-size configuration, and a question. 19
View
cords 18
View
cords 17
View
Greg Martin 16
View
Philippe Cloutier Updated thumbnail problem 15
View
tibi 13
View
tibi 12
View
tibi 11
View
tibi typo's and reviewed 10
View