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

Set up series overview
----------------------

The integration of the series and their publications are realized through an Django Apphook in the CMS. That is, a CMS page is created that is subsequently managed throug the ``eoaseries`` 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 and click on ``Save`` at the bottom of the page to finalize the creation.:

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

From the ``Page`` dropdown menu, select ``Advanced settings``.

.. 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 that was defined in the ``cms_apps.py`` file and save the settings.

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

When visiting the page now, it will be empty. In order to insert one or more series, they need to be created in the Admin interface. The next section explains how to create them.

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