Name | django-simple-menu JSON |
Version |
2.1.3
JSON |
| download |
home_page | |
Summary | Simple, yet powerful, code-based menus for Django applications |
upload_time | 2023-10-04 17:44:07 |
maintainer | |
docs_url | None |
author | |
requires_python | >=3.6 |
license | BSD 2-Clause |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
===================================
django-simple-menu |latest-version|
===================================
|jazzband| |build-status| |coverage| |docs| |python-support| |django-support|
.. |latest-version| image:: https://img.shields.io/pypi/v/django-simple-menu.svg
:target: https://pypi.python.org/pypi/django-simple-menu
:alt: Latest version on PyPI
.. |jazzband| image:: https://jazzband.co/static/img/badge.svg
:target: https://jazzband.co/
:alt: Jazzband
.. |build-status| image:: https://github.com/jazzband/django-simple-menu/actions/workflows/test.yml/badge.svg
:target: https://github.com/jazzband/django-simple-menu/actions
:alt: Build Status
.. |coverage| image:: https://img.shields.io/codecov/c/github/jazzband/django-simple-menu.svg
:target: https://codecov.io/github/jazzband/django-simple-menu
:alt: Test coverage status
.. |docs| image:: https://img.shields.io/readthedocs/django-simple-menu/latest.svg
:target: https://django-simple-menu.readthedocs.io/
:alt: Documentation status
.. |python-support| image:: https://img.shields.io/pypi/pyversions/django-simple-menu
:target: https://pypi.python.org/pypi/django-simple-menu
:alt: Supported Python versions
.. |django-support| image:: https://img.shields.io/pypi/djversions/django-simple-menu
:target: https://pypi.org/project/django-simple-menu
:alt: Supported Django versions
``django-simple-menu`` is an entirely code based menu system, because, who
really wants to define their menus inside Django Admin?..
It's simple to use, yet provides enough flexibility to provide unlimited
children menus, per-request generation and checking of menu items, badges,
and more.
Quickstart
----------
**Requirements:** Python 3.6+, Django 3.2+
**Note:** While this package does support Python 3.6 and 3.7 as well as
Django 4.0, we do not test the package under these versions and may miss some
bugs.
1. Install the ``django-simple-menu`` package.
2. Add ``simple_menu`` to your ``INSTALLED_APPS``.
- please ensure that you have ``django.template.context_processors.request``
listed under ``TEMPLATES[...]["OPTIONS"]["context_processors"]``.
3. Create ``menus.py`` inside each app you want to create a menu for and define
said menus using the ``Menu`` and ``MenuItem`` classes you can import from
the ``simple_menu`` package.
4. In your templates, load the template tags (``{% load simple_menu %}``) and
call ``{% generate_menu %}`` inside a block. Your context will be populated
with a new object named ``menus``. You can now iterate over it to render your
menus.
To quickly see ``django-simple-menu`` in action, check out the
`example project`_.
.. _example project: https://github.com/jazzband/django-simple-menu/tree/master/example
More
----
Full documentation, including installation and configuration instructions, is
available at https://django-simple-menu.readthedocs.io/.
``django-simple-menu`` is released under the *BSD 2-Clause "Simplified" License*.
If you like it, please consider contributing!
``django-simple-menu`` was originally created by
Evan Borgstom <evan@borgstrom.ca> and was further developed by many
contributors_.
.. _contributors: https://github.com/jazzband/django-simple-menu/graphs/contributors
Raw data
{
"_id": null,
"home_page": "",
"name": "django-simple-menu",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "",
"author": "",
"author_email": "Evan Borgstrom <evan@borgstrom.ca>",
"download_url": "https://files.pythonhosted.org/packages/f3/4b/0ac243423896a21d9d4ce06024004605087e52ecdc7427feacdedc8f8d9b/django-simple-menu-2.1.3.tar.gz",
"platform": null,
"description": "===================================\ndjango-simple-menu |latest-version|\n===================================\n\n|jazzband| |build-status| |coverage| |docs| |python-support| |django-support|\n\n.. |latest-version| image:: https://img.shields.io/pypi/v/django-simple-menu.svg\n :target: https://pypi.python.org/pypi/django-simple-menu\n :alt: Latest version on PyPI\n\n.. |jazzband| image:: https://jazzband.co/static/img/badge.svg\n :target: https://jazzband.co/\n :alt: Jazzband\n\n.. |build-status| image:: https://github.com/jazzband/django-simple-menu/actions/workflows/test.yml/badge.svg\n :target: https://github.com/jazzband/django-simple-menu/actions\n :alt: Build Status\n\n.. |coverage| image:: https://img.shields.io/codecov/c/github/jazzband/django-simple-menu.svg\n :target: https://codecov.io/github/jazzband/django-simple-menu\n :alt: Test coverage status\n\n.. |docs| image:: https://img.shields.io/readthedocs/django-simple-menu/latest.svg\n :target: https://django-simple-menu.readthedocs.io/\n :alt: Documentation status\n\n.. |python-support| image:: https://img.shields.io/pypi/pyversions/django-simple-menu\n :target: https://pypi.python.org/pypi/django-simple-menu\n :alt: Supported Python versions\n\n.. |django-support| image:: https://img.shields.io/pypi/djversions/django-simple-menu\n :target: https://pypi.org/project/django-simple-menu\n :alt: Supported Django versions\n\n``django-simple-menu`` is an entirely code based menu system, because, who\nreally wants to define their menus inside Django Admin?..\n\nIt's simple to use, yet provides enough flexibility to provide unlimited\nchildren menus, per-request generation and checking of menu items, badges,\nand more.\n\n\nQuickstart\n----------\n\n**Requirements:** Python 3.6+, Django 3.2+\n\n**Note:** While this package does support Python 3.6 and 3.7 as well as\nDjango 4.0, we do not test the package under these versions and may miss some\nbugs.\n\n1. Install the ``django-simple-menu`` package.\n\n2. Add ``simple_menu`` to your ``INSTALLED_APPS``.\n\n - please ensure that you have ``django.template.context_processors.request``\n listed under ``TEMPLATES[...][\"OPTIONS\"][\"context_processors\"]``.\n\n3. Create ``menus.py`` inside each app you want to create a menu for and define\n said menus using the ``Menu`` and ``MenuItem`` classes you can import from\n the ``simple_menu`` package.\n\n4. In your templates, load the template tags (``{% load simple_menu %}``) and\n call ``{% generate_menu %}`` inside a block. Your context will be populated\n with a new object named ``menus``. You can now iterate over it to render your\n menus.\n\nTo quickly see ``django-simple-menu`` in action, check out the\n`example project`_.\n\n.. _example project: https://github.com/jazzband/django-simple-menu/tree/master/example\n\n\nMore\n----\n\nFull documentation, including installation and configuration instructions, is\navailable at https://django-simple-menu.readthedocs.io/.\n\n``django-simple-menu`` is released under the *BSD 2-Clause \"Simplified\" License*.\nIf you like it, please consider contributing!\n\n``django-simple-menu`` was originally created by\nEvan Borgstom <evan@borgstrom.ca> and was further developed by many\ncontributors_.\n\n.. _contributors: https://github.com/jazzband/django-simple-menu/graphs/contributors\n",
"bugtrack_url": null,
"license": "BSD 2-Clause",
"summary": "Simple, yet powerful, code-based menus for Django applications",
"version": "2.1.3",
"project_urls": {
"Source Code": "https://github.com/jazzband/django-simple-menu"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5701a1305b1dead7e80f454df15569ddc1a1273fb9dcc8dbdd3e5e3b83ada12f",
"md5": "5c29b4faf16ca14d465b8bef776a6a88",
"sha256": "371ed124cc35c72496c2b99672fac759d268950454984c7f15f2cbdedb4f2840"
},
"downloads": -1,
"filename": "django_simple_menu-2.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5c29b4faf16ca14d465b8bef776a6a88",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 13865,
"upload_time": "2023-10-04T17:43:49",
"upload_time_iso_8601": "2023-10-04T17:43:49.138517Z",
"url": "https://files.pythonhosted.org/packages/57/01/a1305b1dead7e80f454df15569ddc1a1273fb9dcc8dbdd3e5e3b83ada12f/django_simple_menu-2.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f34b0ac243423896a21d9d4ce06024004605087e52ecdc7427feacdedc8f8d9b",
"md5": "1bc70240b6ff6ddb79b1ad856a27ba40",
"sha256": "4246c12fa267598e4652793dfec5d123f97f82430965bd34a8c42d38d5be1801"
},
"downloads": -1,
"filename": "django-simple-menu-2.1.3.tar.gz",
"has_sig": false,
"md5_digest": "1bc70240b6ff6ddb79b1ad856a27ba40",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 184588,
"upload_time": "2023-10-04T17:44:07",
"upload_time_iso_8601": "2023-10-04T17:44:07.090041Z",
"url": "https://files.pythonhosted.org/packages/f3/4b/0ac243423896a21d9d4ce06024004605087e52ecdc7427feacdedc8f8d9b/django-simple-menu-2.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-04 17:44:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jazzband",
"github_project": "django-simple-menu",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "django-simple-menu"
}