diff -r cfb7276fdd33 -r dc2bd8068d7a src/source/appmanage.rst --- 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: