Configuration and Customization
*******************************

.. _configuration:

Portal Configuration
====================

There are many places in Kofa where portal parameters can be set or
page descriptions can be added. These parameters are attributes of
either dedicated configuration objects or of containers in the
academics and applicants section. The latter have been described
elsewehere. Here we explain the interfaces of the configuration
section.

Technically speaking, the portal configuration section is a
container of type `ConfigurationContainer` with id ``configuration``
which contains session configuration subcontainers::


  Portal Configuration (ConfigurationContainer)
  |
  +--->SessionConfiguration

Much like ``academics``, ``students``, ``applicants``, ``hostels``
and ``documents``, also ``configuration`` is a unique container
which is located in the `IUniversity` instance.

Site Settings
-------------

The site setting parameters are the attributes of the configuration
container to be set via the `ConfigurationContainerManageFormPage`.
The page opens, if an officer with
:py:class:`ManagePortalConfiguration<waeup.kofa.permissions.ManagePortalConfiguration>`
permission clicks the 'Portal Configuration' link in the side box.

.. literalinclude:: ../../../src/waeup/kofa/interfaces.py
   :pyobject: IConfigurationContainer

The page alows furthermore to add or access the containing session
configuration objects.

Session Settings
----------------



.. literalinclude:: ../../../src/waeup/kofa/interfaces.py
   :pyobject: ISessionConfiguration




.. _customization:

Portal Customization
====================