--- a/src/source/appmanage.rst Wed May 16 12:00:26 2018 +0200
+++ b/src/source/appmanage.rst Wed May 16 14:06:43 2018 +0200
@@ -16,7 +16,6 @@
Local registry utilities
''''''''''''''''''''''''
-
One of PyAMS pre-requisites is to use the ZODB, at least to store the site root application,
it's configuration and a set of local utilities.
@@ -29,27 +28,38 @@
to delete an index before recreating it by running the database upgrade script another time (see :ref:`scripts`).
**Internal IDs** utility:
- List of unique identifier used to localise and access easily to a resource or object declared in zo database.
+ The catalog object doesn't store direct references to objects, but their internal IDs which are generated by this
+ utility.
**Language negotiator**:
- Allows the management of several languages for different contents
+ As a web site or application can be localized, this utility allows you to define priorities between language
+ definition options (between *user session*, *browser* end *server*), and to define which languages are available
+ to your users (which is particularly important when managing potentially multi-lingual contents).
+
+ .. tip::
+ Static texts like those displayed into PyAMS management interface are always translated to the language defined
+ into browser language, if available.
**Portal templates** container:
- Allows you to define and save, one or more reuse template.
- These templates can be shared with the entire application for build new site.
+ Portal templates are used to define *presentation templates* based on *portlets* (see :ref:`pyams_portal`). You can
+ create *local* templates, or create *shared templates* into this utility which can then be reused into several
+ places in your web site.
**Security manager**:
- Manage role and permission grant to a user
+ This utility is used to define authentication sources which will be available to authenticate your users.
+ :ref:`pyams_security` package provides several authentication modules (like local users, or via OAuth/OAuth2
+ providers); :ref:`pyams_ldap` add authentication plug-in via an LDAP directory.
**Sequential IDs** utility:
-
+ This utility is used to assign simple sequential IDs to site contents (like sites, news, topics and more); these
+ IDs are simple to identify a given content; several versions of a given content handle by workflow share the same
+ sequential ID.
**Server timezone** utility:
- Setup the timezone server
+ Define the timezone server to display date and time accordingly.
**User profiles** container:
-
-
+ This utility is used to store information associated to principals through their user profile.
Optional utilities can also include: