Теория

Узлы

Родительские узлы в дереве Wagtail, вероятно, захотят организовать и отобразить просматриваемый индекс своих потомков. Например, блог нуждается в способе отображения списка отдельных записей.

Родительский узел может предоставить собственную функцию, возвращающую объекты потомков.

class EventPageIndex(Page):
    # ...
    def events(self):
        # Get list of live event pages that are descendants of this page
        events = EventPage.objects.live().descendant_of(self)

        # Filter events list to get ones that are either
        # running now or start in the future
        events = events.filter(date_from__gte=date.today())

        # Order by date
        events = events.order_by('date_from')

        return events

В этом примере гарантируется, что возвращаемые объекты ограничены частями контента, которые имеют смысл, в частности, теми, которые были опубликованы через интерфейс администрирования Wagtail (live()) и являются потомками этого узла (descendant_of(self)). Установив свойство класса subpage_types, вы можете указать, какие модели разрешено устанавливать в качестве потомков, а установив свойство класса parent_page_types, вы можете указать, какие модели разрешено устанавливать в качестве родителей этой модели страницы. Wagtail по умолчанию разрешит любую модель, производную от Page. Независимо от этого, для родительской модели разумно предоставить индекс, отфильтрованный для осмысленности.

Листья

Листья — это сами фрагменты контента, страница, которая потребляется и, возможно, состоит из набора свойств. Лист страницы блога может содержать некоторый текст тела и изображение. Лист страницы человека может содержать фото, имя и адрес.

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

Модель листа может предоставить функцию, которая проходит по дереву в обратном направлении и возвращает соответствующего предка:

class EventPage(Page):
    # ...
    def event_index(self):
        # Find closest ancestor which is an event index
        return self.get_ancestors().type(EventIndexPage).last()

Если определены subpage_types и parent_page_types, они также ограничат модели родителей, которые могут содержать лист. Если нет, Wagtail разрешит любое сочетание родителей и листьев для ассоциации в дереве Wagtail. Как и в случае с индексными страницами, рекомендуется убедиться, что индекс фактически содержит ожидаемую модель, содержащую лист.

Другие отношения

Ваши модели, производные от Page, могут иметь другие взаимосвязи, которые расширяют базовое дерево Wagtail или полностью от него отличаются. Вы можете предоставить функции для навигации между братьями и сестрами, например, ссылку «Следующая запись» на странице блога (post->post->post). Поддеревья могут иметь смысл, например, в форуме обсуждения (forum->post->replies). Переход по иерархии может оказаться полезным, поскольку все объекты определенного класса моделей могут взаимодействовать независимо от своих предков (events = EventPage.objects.all). В основном модели определяют свои взаимосвязи, возможности действительно безграничны.