Меню и навигация¶

show_menu¶

Тег show_menu отображает навигацию текущей страницы. Вы можете переписать внешний вид и HTML, если добавите шаблон menu/menu.html в свой проект или отредактируете тот, что поставляется с django CMS. show_menu принимает шесть необязательных параметров: start_level, end_level, extra_inactive, extra_active, namespace и root_id.

Первые два параметра, start_level (по умолчанию=0) и end_level (по умолчанию=100), определяют, с какого уровня должна отображаться навигация и на каком уровне она должна остановиться. Если у вас корневым узлом является home (т.е. уровень 0) и вы не хотите отображать корневой узел (узлы), установите start_level в 1.

Третий параметр, extra_inactive (по умолчанию=0), определяет, сколько уровней навигации должно отображаться, если узел не является прямым предком или потомком текущего активного узла.

Четвертый параметр, extra_active (по умолчанию=100), определяет, сколько уровней потомков активного узла должно быть отображено.

Пятый параметр, namespace, в настоящее время не реализован.

Шестой параметр root_id задает идентификатор корневого узла.

Вы можете снабдить тег параметром template.

{% load menu_tags %}
<ul>
    {% show_menu 0 100 100 100 %}
</ul>

<ul>
    {% show_menu 0 100 0 100 %}
</ul>

<ul>
    {% show_menu 0 100 0 1 %}
</ul>

<ul>
    {% show_menu 1 %}
</ul>

{% show_menu 0 100 100 100 "myapp/menu.html" %}

show_menu_below_id¶

Если вы задали id в расширенных настройках страницы, вы можете отобразить подменю этой страницы с помощью тега шаблона. Например, у нас есть страница под названием meta, которая не отображается в навигации и имеет id «meta»:

<ul>
    {% show_menu_below_id "meta" %}
</ul>

Вы можете задать ему те же необязательные параметры, что и show_menu:

<ul>
    {% show_menu_below_id "meta" 0 100 100 100 "myapp/menu.html" %}
</ul>

Однако, в отличие от show_menu, мягкие корни не влияют на меню при использовании show_menu_below_id.

показать_под_меню¶

Отображает подменю текущей страницы (в виде вложенного списка).

Первый аргумент, levels (default=100), определяет, на сколько уровней вглубь должно быть отображено подменю.

Второй аргумент, root_level (default=None), указывает, на каком уровне, если таковой имеется, меню должно иметь свой корень. Например, если root_level равен 0, то меню будет начинаться с этого уровня, независимо от того, на каком уровне находится текущая страница.

Третий аргумент, nephews (default=100), определяет, сколько уровней племянников (детей братьев и сестер) будет показано.

Четвертый аргумент, template (default=menu/sub_menu.html), является шаблоном, используемым тегом; если вы хотите использовать другой шаблон, вы должны предоставить значения по умолчанию для root_level и nephews.

Примеры:

<ul>
    {% show_sub_menu 1 %}
</ul>

Укоренение на уровне 0:

<ul>
    {% show_sub_menu 1 0 %}
</ul>

Или с помощью пользовательского шаблона:

<ul>
    {% show_sub_menu 1 None 100 "myapp/submenu.html" %}
</ul>

показать_хлебную крошку¶

Отображает навигационные хлебные крошки текущей страницы. Шаблон HTML можно найти по адресу menu/breadcrumb.html.:

{% show_breadcrumb %}

Или с пользовательским шаблоном и отображением только уровня 2 или выше:

{% show_breadcrumb 2 "myapp/breadcrumb.html" %}

Обычно в хлебных крошках отображаются только страницы, видимые в навигации. Чтобы включить все страницы в хлебную крошку, напишите:

{% show_breadcrumb 0 "menu/breadcrumb.html" 0 %}

Если текущий URL не обрабатывается CMS или расширителем навигации, текущий узел меню не может быть определен. В этом случае вам может понадобиться предоставить собственную хлебную крошку через шаблон. В основном это необходимо для таких страниц, как вход в систему, выход из системы и сторонние приложения. Этого можно легко добиться с помощью блока, который вы перезаписываете в своих шаблонах.

Например, в вашем base.html:

<ul>
    {% block breadcrumb %}
    {% show_breadcrumb %}
    {% endblock %}
<ul>

А затем в шаблоне вашего приложения:

{% block breadcrumb %}
<li><a href="/">home</a></li>
<li>My current page</li>
{% endblock %}

Свойства узлов навигации в шаблонах¶

{{ node.is_leaf_node }}

Он последний на дереве? Если это так, то у него нет детей.

{{ node.level }}

Уровень узла. Начинается с 0.:

{{ node.menu_level }}

Уровень узла от корневого узла меню. Начинается с 0. Если ваше меню начинается с уровня 1 или у вас есть «мягкий корень» (описанный в следующем разделе), первый узел все равно будет иметь 0 в качестве menu_level.:

{{ node.get_absolute_url }}

Абсолютный URL узла, без указания протокола, домена или порта.:

{{ node.title }}

Заголовок на текущем языке узла.:

{{ node.selected }}

Если true, то этот узел является текущим выбранным/активным на данном URL.:

{{ node.ancestor }}

Если true, то этот узел является предком текущего выбранного узла.:

{{ node.sibling }}

Если true, то этот узел является родственником текущего выделенного узла.:

{{ node.descendant }}

Если true, то этот узел является потомком текущего выбранного узла.:

{{ node.soft_root }}

Если true, то этот узел является soft root. Страница может быть отмечена как мягкий корень в ее «Расширенных настройках».

Изменение и расширение меню¶

Обратитесь к документации Как настроить меню навигации.

Классы и функции системы меню¶