django-smartmenus

================= django-smartmenus

A Django app that provides template tags to easily incorporate smartmenus (http://www.smartmenus.org/).

Installation

To get started using django-smartmenus:

• install it with pip::

  $ pip install django-smartmenus

• add the app to INSTALLED_APPS. If you are using Django CMS, make sure it's before menus::

  INSTALLED_APPS = ( ... 'django_smartmenus', 'menus', #Only if you are using Django CMS ... )

Usage

The best way to see how it works is exploring the example project. But for the impatient, all you need to do is:

• load smartmenus tags in the templates::

  {% load smartmenus_tags %}

• Call smartmenus template tags where css and js files should show::

  {% smartmenus_css theme %}

  {% smartmenus_js %}

  theme is a string based parameter. Out of box, theme can be one of 'sm-blue', 'sm-clean', 'sm-mint' and 'sm-simple'. If you create a custom theme of your own, please put the theme file under static folder following smartmenus theme folder structure convention, ie. smartmenus/css/theme/theme.css.

• Render menu html in the templates. Please refer to smartmenus tutorial to see what the html should be.

This app also supports Django CMS:

• load smartmenus and menu tags in the templates::

  {% load menu_tags smartmenus_tags %}

• Call Django CMS specific template tags anywhere in the templates::

  {% addtoblock "js" %}{% endaddtoblock %} {% smartmenu_bootstrap_cms theme %}

  theme's usage is the same as above.

• Render Django CMS menu::

  theme-class-name is a string based parameter. Please refer to smartmenus doc regarding possible values. Usually it's the same as theme name unless it's a custom theme with different naming conventions.