User guide

Use the buttons below the tree control to organize galleries:

Home

Selects the root of the gallery tree

New

Creates new sub gallery inside the selected gallery
- if you want it in the root, click ‘Home’ first.

Gallery names are the physical folder names on your server.
You are only allowed to use English characters, space, hiphen, underscore and period.

You cannot create a sub gallery in a gallery which already contains images.
A gallery can only contain either subgalleries or images but not both.

Rename

Rename the selected gallery.

Delete

Delete the selected gallery, its sub-galleries and images.

Preview

Opens the directory.xml of the selected gallery in a separate browser window.

Gallery order

You can drag and drop galleries to change the order in which they appear.
The order is automatically saved and then reflected in gallery.xml.

Moving galleries

You can drag and drop a gallery to another location in the tree – this will initialize a Move operation.
You can only move a gallery into a new gallery which has no images inside.

You can enter a title and description for each gallery and image.
You can use special characters here.

Note that editing gallery title doesn’t affect gallery name (folder name),
image title doesn’t change the image name (image file name).

The entered text is automatically saved when you click away.

The changes are only reflected in gallery.xml when you publish.

It is possible to customize these fields and add new ones, for details contact us.

Uploaded images are automatically resized according to the options in the ‘Big image’ section on the Settings tab.
Thumbnails are created from images based in the ‘Thumbnail’ section.

• fit width & height
  - images are resized so that they fit within the given dimensions
  - both width and height have to be specified
  - these are maximum values, one of the two dimension will be actually smaller
  
  - image will keep its original aspect ratio

• fit height
  
  - images are resized so that their height doesn’t exceed the given value
  - image height has to be specified
  - image will keep its original aspect ratio

• fit width
  
  - images are resized so that their width doesn’t exceed the given value
  - image width has to be specified
  - image will keep its original aspect ratio

• crop
  
  - images are resized and cropped to the specified dimensions – if possible
  - image width and height have to be specified
  - these are the actual width and height values of the image to be created
  - image won’t keep its original aspect ratio

• no resize
  
  - original uploaded image is kept – this option is not available for thumbnails

If you don’t like the thumbnails generated at upload you can create new thumbnails by hand:

• click on a thumbnail, the big image will load
• click on ‘Create thumbnail’ button below
• the button will change its label and color
• a red rectangle will apear with four handles
• drag the handles to define a crop area
• the size and proportions of the crop area are constrained by the thumbnail resize settings for this gallery
• you can also click and move the whole rectangle
• once you are done click on ‘Save thumbnail’ – your thumbnail is created
• click on the image to switch back to thumbnail view to see the new thumbnail

Select the Users menu to manage PhotoAdmin users.

When a user is added she has a default set of permissions
(deleting permissions are not automatically checked).

You can specify a different image folder for each user
just make sure the folder is inside the images root folder.

You can change the password for any user.

Gallery permissions

• New gallery – user can create galleries
• Rename gallery – user can rename galleries
• Delete gallery – user can delete galleries
• Move gallery – user can move and reorder galleries
• Edit gallery data – user can edit gallery title and description
• Edit settings – user can change image settings (thumbnail and image resize settings)

Image permissions

• Upload images – user can download images
• Download images – user can download images
• Delete images – user can delete images
• Rotate images – user can rotate images
• Copy images – user can copy images to another folder
• Edit image data – user can edit image title and description
• Create thumbnail – user can create new thumbnails (limited by thumbnail resize settings)

Admin permissions

• Settings – user can change global settings
• Users – user has access to Users menu, che can manage users

User data is stored in settings/user.xml.

Global settings can be edited in the Settings menu.

These image and thumbnail settings are only applied to newly created galleries –
i.e. changing these won’t affect existing galleries.

Global settings are stored in settings/settings.xml