###################
django CMS explorer
###################

.. image:: https://raw.githubusercontent.com/divio/django-cms/develop/docs/images/try-with-aldryn.png
   :target: http://demo.django-cms.org/
   :alt: Try demo with Aldryn Cloud

This is the "Explorer" theme used for the `django CMS demo <http://demo.django-cms.org/>`_.
The purpose of this project is to provide theme developers a cookie cutter theme
project to create or migrate their own theme.

We created `django-cms-demo <https://github.com/divio/django-cms-demo>`_ in addition
to make life easier for developers for playing around with a theme. You can also use
`Aldryn Cloud <http://www.aldryn.com>`_ to skip the local setup all together.

.. image:: https://raw.githubusercontent.com/divio/django-cms-explorer/master/static/img/visuals/explorer-preview.png


************
Installation
************

Demo Project
------------

The easiest way to install this project is the
`django-cms-demo <https://github.com/divio/django-cms-demo>`_ project.
Head over to the repository and follow the instructions in the
``README.txt``.

Manual
------

* The easiest way to install django CMS manually is by using the
  `djangocms-installer <http://docs.django-cms.org/en/develop/introduction/install.html>`_.
* You can also create a project from scratch following the very helpful Django
  `tutorial <https://docs.djangoproject.com/en/1.9/intro/tutorial01/>`_.
  Followed by installing django CMS `the "hard" way
  <http://docs.django-cms.org/en/develop/how_to/install.html>`_.

#. Choose a starting installation from above.
#. Once you have created a project, copy all files from **inside** the
   django-cms-explorer project **directly** into your projects ``mysite/`` directory.
   More about the file structure is documented in our 
   `boilerplate guidelines <https://aldryn-boilerplate-bootstrap3.readthedocs.io/en/latest/structure/index.html>`_.
#. Restart your server and open your site using ``http://localhost:8000/en/``.

You are ready to create your own theme.


****************
Supported Addons
****************

This theme supports, besides the `core addons
<http://docs.django-cms.org/en/develop/how_to/install.html#other-plugins>`_, also the following:

- `aldryn-bootstrap3 <https://github.com/aldryn/aldryn-bootstrap3>`_
- `aldryn-forms <https://github.com/aldryn/aldryn-forms>`_
- `aldryn-newsblog <https://github.com/aldryn/aldryn-newsblog>`_
- `aldryn-people <https://github.com/aldryn/aldryn-people>`_
- `aldryn-events <https://github.com/aldryn/aldryn-events>`_
- `aldryn-faq <https://github.com/aldryn/aldryn-faq>`_
- `aldryn-jobs <https://github.com/aldryn/aldryn-jobs>`_
- `cmsplugin-filer <https://github.com/divio/cmsplugin-filer>`_