Metadata-Version: 2.1
Name: djangocms-named-menus
Version: 1.0.1
Summary: Allows you to add and edit named menus similar to Wordpress menus
Home-page: https://github.com/mcldev/djangocms-named-menus
Author: Ryan Bagwell, Rogerio Carrasqueira, Michael Carder
Author-email: UNKNOWN
License: BSD
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Dist: Django (>=1.11)
Requires-Dist: django-classy-tags
Requires-Dist: django-cms (>=3.3)
Requires-Dist: jsonfield (>=1.0.0)
Requires-Dist: django-autoslug (>=1.7.2)

Django CMS Named Menus
======================

An extension for Django CMS that allows you to create multiple menus like Wordpress

Replaced
--------
**This replaces the previous versions by Ryan Bagwell and Rogerio Carrasqueira which are no longer actively updated**

Originally forked from:

- https://github.com/rgcarrasqueira/django-cms-named-menus
- https://github.com/ryanbagwell/django-cms-named-menus

Installation
------------

1. Install with pip ``pip install djangocms-named-menus``

2. Add ``cms_named_menus`` to INSTALLED_APPS

3. Run migrations ``python manage.py migrate``

Upgrading from Previous Version
-------------------------------

1. Uninstall previous version with pip ``pip uninstall -y django-cms-named-menus``

2. The migrations and code will pick up previous versions correctly.

Usage
-----

After installation, place the ``{% show_named_menu 'MenuName' %}`` template tag where you want your menu to appear.

.. code::

  {% load named_cms_menu_tags %}

  <ul>
    {% show_named_menu "Main Menu" %}
  </ul>

Next, create your menu in the admin area using the drag and drop interface.

Drag items with child menu items:

.. image:: ui.png

Drag items without child menu items:

.. image:: ui2.png


Settings
--------
The following settings can be changed by adding to your project's settings.py file:

1. Override the default cache duration for Named Menus, default = 3600 seconds

.. code::

  CMS_NAMED_MENUS_CACHE_DURATION = 3600


2. Set the application namespaces that can be used with Named Menus as a list, default is CMS pages only - as the page id will not be unique for other applications e.g. Aldryn NewsBlog etc. default = ['CMSMenu',]

.. code::

  CMS_NAMED_MENUS_NAMESPACES = ['CMSMenu',]

or to allow all namespaces:

.. code::

  CMS_NAMED_MENUS_NAMESPACES = None







