django-lineup 1.0.0

Navigation system for django sites

Multiple navigation system for django sites.

Django Lineup lets you manage a tree of items. Each first level node represents a menu you can include in your templates.

Documentation

The full documentation is at https://django-lineup.readthedocs.io.

Quickstart

Install Django Lineup:

pip install django-lineup

Add it to your INSTALLED_APPS:

INSTALLED_APPS = (
    ...
    'lineup.apps.LineupConfig',
    ...
)

Add to your main urls.py:

...
path("lineup/", include("lineup.urls", namespace="lineup")),
...

Make sure the requests context processor is included (it is by default):

TEMPLATES = [
  {
    'OPTIONS': {
      'context_processors': [
        "django.template.context_processors.request",
      ],
    },
  },
]

Render a menu::

{% load lineup_tags %}
{% lineup_menu 'my-root-item-slug '%}

Render the breadcrumbs::

{% load lineup_tags %}
{% lineup_breadcrumbs 'my-root-item-slug '%}

Import a menu from a json::

$ python manage.py import_menu_from_json

Json example::

{
  "label": "Main Menu",
  "slug": "main-menu",
  "order": 0,
  "children": [
    {
      "label": "Tools",
      "slug": "tools",
      "order": 0,
      "children": [
        {
          "label": "DNS Tools",
          "slug": "dns-tools",
          "order": 0,
          "login_required": true,
          "children": [
            {
              "label": "DMARC DNS Tools",
              "slug": "dmarc-dns-tools",
              "link": "/dmarc-tools/",
              "title": "DMARC Rulez",
              "order": 0
            }
          ]
        },
        {
          "label": "Password Generator",
          "slug": "password-generator",
          "order": 1
        }
      ]
    },
    {
      "label": "Disabled Item",
      "slug": "disabled-item",
      "order": 1,
      "enabled": false,
      "children": [
        {
          "label": "Disabled child",
          "slug": "disabled-child",
          "order": 0
        }
      ]
    },
    {
      "label": "Perm Item",
      "slug": "perm-item",
      "order": 2,
      "permissions": [
        "add_permission",
        "view_session"
      ]
    }
  ]
}

Features

• Multiple menus supported

• Visibility logic: login required / permissions

• Render menu tree templatetags

• Breadcrumbs templetetag

• Import a menu from json management command

• Rebuild tree button in admin

• Django Baton integration to highlight different menu in the admin

Running Tests

Does the code actually work?

source <YOURVIRTUALENV>/bin/activate
(myenv) $ pip install -r requirements_test.txt
(myenv) $ python runtests.py

Development commands

pip install -r requirements_dev.txt
invoke -l

Example app

This example is provided as a convenience feature to allow potential users to try the app straight from the app repo without having to create a django project.

It can also be used to develop the app in place.

To run this example, follow these instructions:

1. Navigate to the root directory of your application (same as manage.py)

2. Install the requirements for the package:

   pip install -r requirements_test.txt

3. Make and apply migrations

   python manage.py makemigrations

   python manage.py migrate

4. Run the server

   python manage.py runserver

5. Access from the browser at http://127.0.0.1:8000

6. Admin user account is admin:admin

Credits

Django Lineup is developed by Otto SRL.

Tools used in rendering this package:

• Cookiecutter

• cookiecutter-djangopackage

History

1.0.0 (2025-06-26)

• Fix migrations (breaking change)

• Fix active menu item class

0.3.4 (2024-06-18)

• Fix caching with multiple menus

0.3.3 (2024-06-18)

• Improve overall performance

• Add cache

0.3.2 (2024-05-30)

• Adds rebuild command in admin

0.3.1 (2022-12-22)

• Adds Dajngo 4 support

0.3.0 (2021-04-27)

• Adds the extras field

0.2.3 (2021-02-28)

• Fixes tests

0.2.2 (2021-02-28)

• Fixes baton row attributes method

0.2.1 (2020-12-14)

• Adds order field as editable in change list page

• First stable release

0.2.0 (2020-12-14)

• First stable release

0.1.0 (2020-12-11)

• First release on PyPI.