name: rename the album (a virtual rename in case
+ of a physical album).
+
+
description: short text giving a general idea of the content,
+ this text will be displayed at the bottom of the thumbnails page.
+
+
+
+
Move
+
+
If the album is virtual, you can move it. Moving a album means
+changing its parent album.
+
+
Options
+
+
+
+
Access type: Permissions management. If you make a
+ album private, all its child albums becomes private. If you make a
+ album public, all its parent albums becomes public.
+
+
Lock: The album and its sub-albums will
+ be temporary disabled for maintenance.
+
+
Comments: Authorize users to comment photos of this
+ album.
+
+
+
+
You can also manage these options on the "Properties"
+management screen (screens Comments, Lock,
+Public/Private, Representative available from Administration » Albums » Properties).
+
+
Sort order
+
+
Use the default images sort order.
+
+
Indicate whether this sort order will apply to subalbums also.
+
+
Select specific sorting criteria to be used with this album.
+
+
Creation date: Photo shooting date
+
Post date: Synchronization date
+
Average rate (*): Average rate could be changed by the visitor rating
+
Most visited (*): The current visit might change the most visited order
+
File name: Name given in information field
+
Id: Internal Id (recent categories have an higher id than previous ones.
+
+
+
(*)Warning: Be sure to test these sort orders by yourself as they can give unexpected results.
+
+
+
Representant
+
+
The album representative is the thumbnail displayed on the main page (category.php) to represent
+the album when
+it contains only sub-albums and no direct photo (just as the root album).
+photo of a album :
+
+
+
+
Photo page: one of the action buttons let you set the current photo as the representative for the
+ displayed album. This button is available only for administrators.
+
+
Modify informations about a photo in
+ administration. This screen can be reached from picture.php or Batch
+ management in unit mode. See the help of this screen for
+ details.
+
+
Administration » Albums » Properties,
+ Representative. See the help of this screen for details.
+
+
Edit album (the present screen).
+
+
+
+
The choice of a representative depends on the
+allow_random_representative configuration parameter (see include/config_default.inc.php).
+
+
In default mode (allow_random_representative set to false),
+each album containing at least one element is represented by a fixed
+element. Once set (at album creation), the representative changes only
+when an administrator ask for it. If the representative is not appropriate,
+you can ask to Find a new representant by random.
+
+
If the allow_random_representative configuration parameter is
+set to true, a category containing photos may have no fixed
+representant. Just use Delete representant button.
+
+
If the album contains only sub-albums and no photo, it can nonetheless be represented by any element thanks to Modify
+informations about a photo screen. The only option on the current screen
+is the Delete representant button.
+
+
Link all album photos to a new album
+
+
+
+
Virtual album name: Name of the new album to be created,
+all photos of the current category will be linked to the new one.
+
+
Parent album: Where the new album will be,
+leave empty to create it at root.
+
+
+
+
Link all album photos to existing albums
+
+
+
+
Albums: Choose the destination album.
+
+
+
+
Send an information email to group members
+
+
+
+
Group: recipients group
+
+
Mail content: Free text to send to them.
+
+
\ No newline at end of file
diff --git a/language/en_US/help/cat_move.html b/language/en_US/help/cat_move.html
new file mode 100644
index 000000000..58f31152c
--- /dev/null
+++ b/language/en_US/help/cat_move.html
@@ -0,0 +1,14 @@
+
Moving virtual Albums
+
+
Only virtual albums can have a new parent album.
+
+
Virtual albums to move
+
+
Select one or several virtual albums you want to move.
+If the list is empty, that mean you have not created one yet.
+
+
New parent album
+
+
Select the new parent album (virtual or physical).
+If you do not select any parent, the virtual selected albums will be moved to the root.
+A album cannot be moved into itself or to one of its child.
\ No newline at end of file
diff --git a/language/en_US/help/cat_options.html b/language/en_US/help/cat_options.html
new file mode 100644
index 000000000..11222f344
--- /dev/null
+++ b/language/en_US/help/cat_options.html
@@ -0,0 +1,22 @@
+
Album options
+
+
Options management for several albums at once.
+
+
+
+
Comments
+
A photo can receive comments from your visitors if it belongs to an album with comments activated.
+
+
Lock
+
Locked albums are disabled for maintenance. Only administrators can view them in the gallery.
+
+
Public / private
+
Once an album become private, give access rights to users and groups
+
+
Representative
+
This option is available when you set the configuration setting
+allow_random_representative (see include/config_defaults.inc.php) to
+true. Each album can be represented by a random photo or by a photo chosen as a unique representative.
+
+
diff --git a/language/en_US/help/cat_perm.html b/language/en_US/help/cat_perm.html
new file mode 100644
index 000000000..cabda09fc
--- /dev/null
+++ b/language/en_US/help/cat_perm.html
@@ -0,0 +1,13 @@
+
Edit album permissions
+
+
This screen is only available for private albums. Here you can select
+users and groups authorized for a album.
+
+
Groups
+
+
You can deny or grant groups access for the current album. By modifying
+groups authorizations, the users belonging to these groups will be denied or granted access to the album.
+
+
Users
+
+
You can deny or grant access to individual users. Users that have access through a group can be denied access by exception.
diff --git a/language/en_US/help/configuration.html b/language/en_US/help/configuration.html
new file mode 100644
index 000000000..cb40e9a9d
--- /dev/null
+++ b/language/en_US/help/configuration.html
@@ -0,0 +1,101 @@
+
Configuration
+
+
This screen let the administrator do basic gallery configuration. Indeed, this screen only shows simple configuration parameters that should be enough for the vast majority of administrators. If you want to see other numerous (and advanced) configuration parameters, read the default configuration file include/config_default.inc.php.
+
+
The screen is divided into different sections, grouping configuration parameters by theme.
+
+
+
Main
+
+
Gallery title: used in RSS feed and notifications by email.
+
+
Page banner: displayed on top of each public page.
+
+
Gallery URL: used for the RSS feed.
+
+
Lock gallery: Lock the entire gallery for maintenance. Only administrator users will be able to reach the gallery.
+
+
Rating: Photo rating feature is enabled.
+
+
Rating by guests: Even unregistered users can rate images.
+
+
Allow user registration: Anybody can register.
+
+
Mail address is mandatory for all users: mail address will be checked on registration or profile update, except if the action is done by an administrator.
+
+
Email admins when a new user registers: administrators will be notified by mail for each registration.
+
+
Default photos order: you can define a personalized order with these drop-down menus.
+
+
+
+
History
+
+
Visits on pages category.php and picture.php will be saved in the history table.
+
+
Visits will be shown in Administration » Tools » History.
+
+
+
Save page visits by guests: page visits by guests will be recorded.
+
+
Save page visits by users: visits by registrered users will be recorded.
+
+
Save page visits by administrators: page visits by administrators will be recorded.
+
+
+
+
Comments
+
+
+
Comments for all: Even unregistered guest can post comments.
+
+
Number of comments per page.
+
+
Validation: an administrator must validate users comments before they become visible on the site. User comments validation
+ takes place in screen Administration » Tools » Pending Comments.
+
+
Email admins when a valid comment is entered: Sends an email to the administrators when a user enters a comment and this comment is validated.
+
+
Email admins when a comment requires validation:
+Sends an email to the administrators when a user enters a comment that requires validation by the admin.
+User comments validation takes place in the screen Administration » Tools » Pending Comments.
+
+
+
+
Default display
+
+
Here you can change display options used by guest, the default user that is not connected. Once connected, these options are overridden by the user's own options
+(modifiable in profile).
+
+
It is possible to change the display options for all existing users on the Administration »
+Users » Manage screen where you can select a list of users.
+
+
+
+
Language: Apply to Piwigo labels only. Album names, photo names and all descriptions fields are not localized.
+
+
Number of photos per row
+
+
Number of rows per page
+
+
Interface theme
+
+
Recent period: By days. Period during which a photo is shown as new. Must be greater than 1 day.
+
+
Expand all albums: Expand all albums by
+ default in the menu Warning: this option is resources intensive and may generate a huge menu if your album tree contains many albums.
+
+
Show number of comments: Show the number of comments for each photo on the thumbnails page. Resource intensive.
+
+
Show hits count: Display hits observed on photo just under its thumbnail on the thumbnails page. Only when advanced configuration parameter is:
+ $conf['show_nb_hits'] = true;
+ Notice: false by default.
+
+
Maximum width of the photos: maximum displayed width. Photos larger than this setting will be resized on display. Rather than choosing this option, you might consider modifying the width of your photos; that would be a better practice.
+
+
Maximum height of the photos: Same as for the maximum width setting.
+
+
\ No newline at end of file
diff --git a/language/en_US/help/extend_for_templates.html b/language/en_US/help/extend_for_templates.html
new file mode 100644
index 000000000..a46f94779
--- /dev/null
+++ b/language/en_US/help/extend_for_templates.html
@@ -0,0 +1,51 @@
+
Template Extension Configuration
+
+
About
+
Your Piwigo gallery can be customised by replacing existing template files with customised versions. For example, the default header template (header.tpl) can be replaced by a customised header template (my-header.tpl). After submitting the changes to the database the gallery will display the customised header instead of the original header.
+Template extensions are a powerful way to create customised themes for both new and advanced users. Used together with the LocalFiles Editor you can create your own child themes.
+
+
Original Template
+
A theme contains a number of template files that make up the gallery pages. These are the original templates.
+
+
Optional URL Keyword
+
These are words found in the gallery URL after the module name. They can also be active permalinks (See the permalink documentation for more information). WARNING: if the same original template and same keyword is used on more than one customised template only the last one is active.
+
+
Bound Theme
+
The bound theme is the theme from which the template files are being replaced.
+
+
Where are the original templates?
+
Original templates are the template files shipped with each theme. These are saved in /themes/default/template (or themes//template). These template files should not be edited in place as changes will be lost with theme upgrades.
+Supported original templates include:
+
+
index.tpl
+
mainpage_categories.tpl and/or thumbnails.tpl
+
menubar.tpl
+
header.tpl and/or footer.tpl
+
picture_content.tpl and/or picture.tpl
+
+
profile.tpl and/or profile_content.tpl
+
tags.tpl
+
upload.tpl
+
about.tpl
+
popuphelp.tpl
+
search.tpl and/or search_rules.tpl
+
nbm.tpl and/or notification.tpl
+
identification.tpl and/or register.tpl
+
redirect.tpl
+
+
Saving customised templates
+
Customised templates should be saved in the template-extension folder or subfolders. For example, /template-extension/my-default/header.tpl (or /template-extension//header.tpl) Template files can have any name with a .tpl extension. The template files in subfolders appear in the Template configuration screen as available custom templates.
+
Activating customised templates
+
Select the original template to replace. Optionally choose a URL keyword to ensure that the customised template is only shown on pages with that keyword. Select a bound theme and the changes will be effective on that theme. Submit the changes to the database.
+
Deactivating customised templates
+
Unselect the original template and submit the changes to the database.
+Delete the customised template files from the template-extension folder.
+
+
+
Warnings
+
+
The original template must be the original template otherwise you may have unpredictable results.
+
If the same original template and same URL keyword is used on more than one customised template only the last one is active.
+
Distributed sample template files are for test purposes only. Do not edit them. Create your own ones or copy existing theme template files into /template-extension//
+
When the customised template is deleted the original template file is immediately reactivated.
+
\ No newline at end of file
diff --git a/language/en_US/help/group_list.html b/language/en_US/help/group_list.html
new file mode 100644
index 000000000..eeae61d4c
--- /dev/null
+++ b/language/en_US/help/group_list.html
@@ -0,0 +1,22 @@
+
Groups list
+
+
This is the place where you manage groups.
+
+
Add a group
+
+
Administrator can add groups.
+
+
Groups list
+
+
For each group the following actions can be applied:
+
+
+
+
go to user management (Admin » Users » Manage)
+
go to permissions management screen to grant or deny access to private albums.
+
delete the group (requires a confirmation)
+
toggle status "default" (requires a confirmation)
+
+
+
Default groups
+
Default groups are groups that are automatically associated to each new user upon registration or creation by an administrator.
diff --git a/language/en_US/help/help_add_photos.html b/language/en_US/help/help_add_photos.html
new file mode 100644
index 000000000..8a8841141
--- /dev/null
+++ b/language/en_US/help/help_add_photos.html
@@ -0,0 +1,27 @@
+
Several ways to add your photos in your gallery:
+
+
+
Direct upload inside your web browser is the
+ simplest and most immediate way. It depends on your browser capabilities
+ and your web server. For a huge quantity of photos or in case you encounter some problem,
+ the other methods are just waiting for you!
pLoader is a desktop application, to be installed on your computer. Drag & drop photos into pLoader window, click on "Upload to Piwigo" and let pLoader do the job. You can find other desktop applications such as WinToPiwigo or the Digikam export plugin to Piwigo.
FTP transfer is the most recommended way to add a
+ very large collection of photos with a minimum number of clicks. Follow
+ the guide to prepare your photos. The FTP method let you control precisely
+ the physical organization of your photos on your server.
\ No newline at end of file
diff --git a/language/en_US/help/help_groups.html b/language/en_US/help/help_groups.html
new file mode 100644
index 000000000..aed7d7a8e
--- /dev/null
+++ b/language/en_US/help/help_groups.html
@@ -0,0 +1,11 @@
+
Groups are a convenient way to set permissions for a list of users.
+
+
Create groups in Administration » Users
+» Groups and associate users to this group
+in Administration » Users »
+Manage.
+
+
A user can belong to several groups. Authorization takes precedence over
+interdiction : if user "jack" belongs to groups "family" and "friends", and
+that only group "family" can see album "Christmas 2010" album then
+"jack" will be able to see "Christmas 2010".
diff --git a/language/en_US/help/help_misc.html b/language/en_US/help/help_misc.html
new file mode 100644
index 000000000..c46e82aaa
--- /dev/null
+++ b/language/en_US/help/help_misc.html
@@ -0,0 +1,9 @@
+
Once you created your gallery you can configure it for your visitor
+
+
The default display as you like in Administration » Configuration » Options tab Guest Settings
+
The default theme in Administration » Configuration » Themes
+
The default language in Administration » Configuration » Languages
+
+ By default, each new user will inherit these properties upon registration.
+
+
If you have any question, Piwigo community will welcome you on its forum.
\ No newline at end of file
diff --git a/language/en_US/help/help_permissions.html b/language/en_US/help/help_permissions.html
new file mode 100644
index 000000000..600d541ac
--- /dev/null
+++ b/language/en_US/help/help_permissions.html
@@ -0,0 +1,57 @@
+
+
+
diff --git a/language/en_US/help/help_virtual_links.html b/language/en_US/help/help_virtual_links.html
new file mode 100644
index 000000000..f6b5ca84d
--- /dev/null
+++ b/language/en_US/help/help_virtual_links.html
@@ -0,0 +1,12 @@
+
Photos are displayed in the album corresponding to their file
+directory.
+
+
You can also display a photo in several albums, without duplicating
+the file on your web server. Associate the photo to any album from the
+photo editing screen (that any administrator can reach from the photo page
+on the gallery side).
+
+
Virtual albums are based on this concept: they have no corresponding
+directory. Create virtual albums
+from Administration » Albums »
+Manage.
diff --git a/language/en_US/help/history.html b/language/en_US/help/history.html
new file mode 100644
index 000000000..701b2de10
--- /dev/null
+++ b/language/en_US/help/history.html
@@ -0,0 +1,22 @@
+
History
+
+
On these screens, you can monitor your gallery visits history according to the options you have chosen in: Administration » Configuration » Options » History
+
+
Statistics
+
+
If you have chosen to record the pages visited (index.php and picture.php), you can monitor them from this tab.
+
Global statistics: visits per year.
+
Yearly statistics: visits per month in the selected year .
+
Monthly statistics: visits per days in the selected month .
+
Daily statistics: visits per hours in the selected day.
+
+
+
Search
+
+
If you have chosen to record the pages visited (index.php and picture.php), you can browse the details from this tab with the help of different filters.
+
Filter by date: select the date range to search by setting start and end dates.
+
Filter by type of element: select the type of element for statistics on that element.
+
Filter by user: select the user for statistics on that user.
+
Filter by image identifier: select the image identifier for statistics on that image.
+
Filter by name of the file: select the file name for statistics on that file..
+
\ No newline at end of file
diff --git a/language/en_US/help/index.php b/language/en_US/help/index.php
new file mode 100644
index 000000000..41732f2fd
--- /dev/null
+++ b/language/en_US/help/index.php
@@ -0,0 +1,30 @@
+
diff --git a/language/en_US/help/maintenance.html b/language/en_US/help/maintenance.html
new file mode 100644
index 000000000..671c92ce6
--- /dev/null
+++ b/language/en_US/help/maintenance.html
@@ -0,0 +1,26 @@
+
Maintenance
+
+
To optimise page generation time Piwigo uses cached information. For example, instead of counting the number of photos contained in each album at each page reload this information is stored in the database. In theory this information should always be correct but sometimes an error can occur and cached information becomes out of date.
+
+
Some information becomes less useful as time goes by. Deleting this useless information from the database will save you some disk space.
+
+
+
Delete orphan tags
+
+
+
Update albums informations: For each album, the following information is checked, and updated if necessary : list of parent albums, number of photos, last photo date, position among brother albums, position among all albums. This action also checks the representative photos consistency.
+
Update photos information: For each photo, information updated is : full path to file, average rate. Warning, do not mix up: metadata information must be synchronised from Administration » Tools » synchronise, or on the modification screen of a single photo (through Photo for example).
+
+
+
Repair and optimise the database:Perform re-order, repair and optimise operations on each table of the database.
+
Reinitialize integrity check
+
+
+
+
Purge history details: Delete all lines from the history table. Screen Administration » Tools » History will not longer show information for the past history. Warning: all data will be lost, without any way to get them back.
+
Purge history summary: Delete all the summary information about visit history. This summary is calculated from the history details.
+
Purge sessions: Delete expired user sessions.
+
Purge never used notification feeds
+
Purge searches history
+
Purge compiled templates
+
\ No newline at end of file
diff --git a/language/en_US/help/notification_by_mail.html b/language/en_US/help/notification_by_mail.html
new file mode 100644
index 000000000..da9ac2a97
--- /dev/null
+++ b/language/en_US/help/notification_by_mail.html
@@ -0,0 +1,15 @@
+
Notification By Mail (NBM)
+
+
Configure and manage email notifications to users notifying them of changes to your site.
+
+
This screen comprises three tabs:
+
+
Settings
+
Available only for webmasters, this tab sets the notification by mail parameters.
+
+
Subscribe
+
Available only for webmasters, this tab manages a user's subscription to email notifications. Add users to the subscribed box for them to receive notifications by mail.
+
+
Send
+
Available only for webmasters and administrators, this tab allows administrators to send notification emails to subscribed users.
+
diff --git a/language/en_US/help/permalinks.html b/language/en_US/help/permalinks.html
new file mode 100644
index 000000000..fc4949237
--- /dev/null
+++ b/language/en_US/help/permalinks.html
@@ -0,0 +1,7 @@
+
Permalinks
+
+
Permalinks are used to make album urls nicer. When a album has a permalink defined, the id of the album is not required anymore in the url.
+
+
When a permalink is deleted, you can save it in the permalink history, so that external links to Piwigo pages still work. In the permalink history table you can see the date when the permalink has been deleted, the last time it was used and the number of times this permalink has been used.
+
+
Note that permalinks must be unique per album. Also in the permalink history you cannot have the same permalink defined more than once.
diff --git a/language/en_US/help/photos_add_ftp.html b/language/en_US/help/photos_add_ftp.html
new file mode 100644
index 000000000..3d39f1e63
--- /dev/null
+++ b/language/en_US/help/photos_add_ftp.html
@@ -0,0 +1,70 @@
+
+
+
diff --git a/language/en_US/help/search.html b/language/en_US/help/search.html
new file mode 100644
index 000000000..ae1330a31
--- /dev/null
+++ b/language/en_US/help/search.html
@@ -0,0 +1,24 @@
+
Search
+
+
This page let you search photos among the whole gallery.
+
+
+
+
Search for words
+
Search for one or several words among the attributes related to the photos
+ of the gallery. Use * as a wildcard for partial matches.
+
+
Search for an author
+
Use * as a wildcard for partial matches.
+
+
Search by date
+
Select a date and/or an ending date for your query. Leave date field empty
+ if you want to make a "before" query. The year in the last
+ field must be entered in the following format : AAAA (i.e. 2004)
+
+
Search in albums
+
Select album or albums you wish to search. All
+ sub-albums can be searched by selecting the parent album and setting enable
+ search sub-albums below.
+
+
diff --git a/language/en_US/help/synchronize.html b/language/en_US/help/synchronize.html
new file mode 100644
index 000000000..7eac01a6a
--- /dev/null
+++ b/language/en_US/help/synchronize.html
@@ -0,0 +1,14 @@
+
Synchronise
+
+
There are two different types of synchronisation:
+
+
directories/files
+
file metadata
+
+
+
Synchronising directories and files is about updating your directories tree with the album tree in the database.
+Synchronising file metadata is about updating photo information, such as filesize, dimensions in pixels, EXIF or IPTC information, in the database.
+
+
When synchronising your uploads with your gallery you must first synchronise directories and files.
+
+
The synchronisation process may take a long time (depending on server load and the number of elements to manage) so it is possible to do it album by album.
\ No newline at end of file
diff --git a/language/en_US/help/user_list.html b/language/en_US/help/user_list.html
new file mode 100644
index 000000000..371facf87
--- /dev/null
+++ b/language/en_US/help/user_list.html
@@ -0,0 +1,23 @@
+
Users list
+
+
This is where you manage the users of your Piwigo gallery.
+
+
Add a user
+
+
An administrator can add users manually. For each user create a username, a password and submit a valid email address.
+
+
Users list
+
+
The list of existing users can be filtered on username (use * as wildcard), group or status. It can be ordered by registration date or username, in ascending or descending order.
+
+
This screen allows the management of several users at once, using different actions:
+
+
+
delete users (requires confirmation)
+
change the status of the user
+
associate or dissociate from groups
+
modify display properties
+
modify additional preferences
+
+
+
The target is the selected user (by default) or all users as displayed in the filtered list.