Integration into Django-CMS
===========================

Set up list of authors
----------------------

The integration of the list of authors and individual authors' pages are realized through an Django Apphook in the CMS. That is, a CMS page is created that is subsequently managed throug the ``eoaauthors`` application. The Apphooks have to be registered in the Publication Platform in a file called ``cms_apps.py`` that is located next to the ``settings.py`` file. An example can be found at https://github.molgen.mpg.de/EditionOpenAccess/eoa-1.5/blob/master/src/eoa/cms_apps.py. After having created and populated that file, restart the Django service.

Create a new page in the CMS:

.. image:: /_static/create_page.png
   :scale: 50 %
   :alt: alternate text
   :align: center

.. note:: Pay attention to the ``slug`` entry. This has to match the path that is given in the template file, the default setting is ``author``.

.. image:: /_static/newpage_title-slug.png
   :scale: 50 %
   :alt: alternate text
   :align: center

Click on ``Save`` at the bottom of the page to finalize the creation.

.. image:: /_static/newpage-save.png
   :scale: 50 %
   :alt: alternate text
   :align: center

After the creation, edit the page again. You need to access the advanced settings. To do so, hold the shift key in the Pages overview page. The pencil icon will change to a gears icon. Now click it.

.. image:: /_static/advancedsettings.png
   :scale: 50 %
   :alt: alternate text
   :align: center

Scroll down to the field ``Application``.

.. image:: /_static/advanced_settings-01-application.png
   :scale: 50 %
   :alt: alternate text
   :align: center

Click on it to select the appropriate app hook.

.. image:: /_static/advanced_settings-02-apphook.png
   :scale: 50 %
   :alt: alternate text
   :align: center

Save the page again.

.. image:: /_static/advanced_settings-03-save.png
   :scale: 50 %
   :alt: alternate text
   :align: center

Back in the Pages overview, the dot in the row of the newly created page will be grey. That means that there are unpublished changes. Click on the dot to publish them.

.. image:: /_static/unpublishedpage.png
   :scale: 50 %
   :alt: alternate text
   :align: center

.. image:: /_static/publishpage.png
   :scale: 50 %
   :alt: alternate text
   :align: center

When visiting the page, it will be empty except for an introductory text. In order to insert authors, they need to be created in the Admin interface. The next section explains how to create entries of authors.

.. image:: /_static/emptyauthorpage.png
   :scale: 50 %
   :alt: alternate text
   :align: center