History: Image Gallery User

            ! 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:''
::^{picture file=img/wiki_up//ImgGal-USER-01.png} {picture file=img/wiki_up//ImgGal-USER-02.png}^::

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.

!! Prior to Gallery Creation
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. 

::^{picture file=img/wiki_up//ImgGal-USER-03.png}^::

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

::^{picture file=img/wiki_up//ImgGal-USER-04.png}^::

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: 

::^{picture file=img/wiki_up//ImgGal-USER-05.png}^::

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:

::^{picture file=img/wiki_up//ImgGal-USER-06.png}^::

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:  

::^{picture file=img/wiki_up//ImgGal-USER-08.png}^::
''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:  

::^{picture file=img/wiki_up//ImgGal-USER-09.png}^::

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: 

::^{picture file=img/wiki_up//ImgGal-USER-07.png}^::

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. 

::^{picture file=img/wiki_up//ImgGal-USER-10.png}^::

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. 

::^{picture file=img/wiki_up//ImgGal-USER-11.png}^::

!!! 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:

::^{picture file=img/wiki_up//ImgGal-USER-12.png}^::

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.

!! The System Gallery
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
!!Utility Gallery
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. 

::^{picture file=img/wiki_up//ImgGal-USER-13.png}^::

!!Random gallery image
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:

^::{img src="img/wiki_up/110_shadowbox_01.png" }::^

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...

^::{img src="img/wiki_up/110_shadowbox_01b_piece.png" }::^

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

^::{img src="img/wiki_up/110_shadowbox_02.png" }::^

! 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=-
{toc}

-=Related Information=-
* To enable Image Galleries for your site, see ((General Admin)).
* To specify permissions for Image Gallery users, see ((Permissions)) for the general procedure. 
* To administer Image Galleries, see ((Image Gallery Config)).
* For technical details, see ((Image Gallery Details)). 

-=Useful Links=-
* Unisys' GIF Patent
+ [http://www.unisys.com/about__unisys/lzw]
* Why No GNU GIFs?
+ [http://www.gnu.org/philosophy/gif.html]