페이지 모델¶

데이터베이스 필드¶

각 Wagtail 페이지 유형은 Django 모델이며, 데이터베이스에 별도의 테이블로 표현됩니다.

각 페이지 유형은 자체 필드 집합을 가질 수 있습니다. 예를 들어, 뉴스 기사에는 본문 텍스트와 게시 날짜가 있을 수 있지만, 이벤트 페이지에는 장소 및 시작/종료 시간에 대한 별도의 필드가 필요할 수 있습니다.

Wagtail에서는 모든 Django 필드 클래스를 사용할 수 있습니다. 타사 앱에서 제공하는 대부분의 필드 클래스도 작동해야 합니다.

Wagtail은 또한 자체 필드 클래스를 몇 가지 제공합니다.

• RichTextField - 리치 텍스트 콘텐츠용

• StreamField - 블록 기반 콘텐츠 필드(참조: StreamField를 사용한 자유 형식 페이지 콘텐츠)

태그 지정의 경우 Wagtail은 django-taggit을 완벽하게 지원하므로 이를 사용하는 것이 좋습니다.

검색¶

search_fields 속성은 검색 색인에 추가되는 필드와 색인화되는 방법을 정의합니다.

이것은 SearchField 및 FilterField 객체 목록이어야 합니다. SearchField 는 전체 텍스트 검색을 위한 필드를 추가합니다. FilterField 는 결과를 필터링하기 위한 필드를 추가합니다. 필드는 SearchField 및 FilterField 로 동시에 색인화할 수 있습니다(각각 하나의 인스턴스만).

위 예시에서는 body 를 전체 텍스트 검색용으로 색인화하고 date 를 필터링용으로 색인화했습니다.

이러한 필드 유형이 허용하는 인수는 추가 필드 색인화에 문서화되어 있습니다.

편집기 패널¶

페이지 편집기 인터페이스에서 페이지 필드가 정렬되는 방식을 정의하는 몇 가지 속성이 있습니다.

• content_panels - 본문 텍스트와 같은 콘텐츠용

• promote_panels - 태그, 썸네일 이미지 및 SEO 제목과 같은 메타데이터용

• settings_panels - 게시 날짜와 같은 설정용

이러한 각 속성은 Panel 객체 목록으로 설정되며, 이는 필드가 어떤 탭에 나타나고 각 탭에서 어떻게 구성되는지 정의합니다.

다음은 Wagtail이 기본적으로 제공하는 Panel 클래스에 대한 요약입니다. 전체 설명은 패널 유형을 참조하십시오.

기본

이것들은 모델 필드를 편집할 수 있도록 합니다. FieldPanel 클래스는 필드 유형에 따라 올바른 위젯을 선택합니다. 예를 들어 RichTextField 의 경우 리치 텍스트 편집기, 이미지 모델에 대한 ForeignKey 의 경우 이미지 선택기입니다. FieldPanel 은 페이지 모델에 대한 ForeignKey 에 대한 페이지 선택기 인터페이스도 제공하지만, 선택할 수 있는 페이지 유형을 더 세밀하게 제어하려면 PageChooserPanel 이 추가 구성 옵션을 제공합니다.

• FieldPanel

• PageChooserPanel

구조

이것들은 인터페이스에서 필드를 구조화하는 데 사용됩니다.

• MultiFieldPanel

• InlinePanel

• FieldRowPanel

부모 페이지 / 하위 페이지 유형 규칙¶

이 두 속성을 사용하면 사이트에서 페이지 유형을 사용할 수 있는 위치를 제어할 수 있습니다. 이를 통해 “블로그 항목은 블로그 색인 아래에서만 만들 수 있습니다”와 같은 규칙을 정의할 수 있습니다.

부모 및 하위 페이지 유형은 모델 클래스 또는 모델 이름 목록을 사용합니다. 모델 이름은 app_label.ModelName 형식입니다. app_label 이 생략되면 동일한 앱으로 간주됩니다.

• parent_page_types 는 이 유형을 만들 수 있는 페이지 유형을 제한합니다.

• subpage_types 는 이 유형 아래에 만들 수 있는 페이지 유형을 제한합니다.

기본적으로 모든 페이지 유형은 모든 페이지 유형 아래에 만들 수 있으며, 원하는 동작인 경우 이러한 속성을 설정할 필요가 없습니다.

parent_page_types 를 빈 목록으로 설정하는 것은 편집기 인터페이스에서 특정 페이지 유형이 생성되는 것을 방지하는 좋은 방법입니다.

페이지 설명¶

모든 Wagtail 페이지에는 help_text 모델 속성과 유사한 유용한 설명 텍스트를 추가할 수 있습니다. 페이지 모델에 page_description 을 추가하면 새 페이지를 만들거나 기존 페이지를 편집하거나 자식 페이지 유형을 선택하라는 메시지가 표시될 때 볼 수 있는 짧은 설명이 추가됩니다.

class LandingPage(Page):

    page_description = "사용자를 전환하는 데 이 페이지를 사용하십시오."

페이지 URL¶

페이지 URL을 검색하는 가장 일반적인 방법은 {% pageurl %} 또는 {% fullpageurl %} 템플릿 태그를 사용하는 것입니다. 템플릿에서 호출되므로 이러한 태그는 아래 언급된 최적화를 자동으로 포함합니다.

페이지 모델에는 페이지 URL을 재정의하거나 액세스하기 위한 몇 가지 하위 수준 메서드도 포함되어 있습니다.

def get_url_parts(self, *args, **kwargs):

super().get_url_parts(*args, **kwargs)

페이지 모델에 대한 템플릿 추가¶

Wagtail은 앱 레이블과 모델 클래스 이름을 기반으로 템플릿 이름을 자동으로 선택합니다.

형식: <app_label>/<model_name (snake cased)>.html

예를 들어, 위 블로그 페이지의 템플릿은 blog/blog_page.html 이 됩니다.

이름으로 액세스할 수 있는 위치에 템플릿을 만들기만 하면 됩니다.

템플릿 컨텍스트¶

Wagtail은 page 변수가 렌더링되는 페이지 인스턴스에 바인딩된 템플릿을 렌더링합니다. 이를 사용하여 페이지 콘텐츠에 액세스합니다. 예를 들어, 현재 페이지의 제목을 가져오려면 {{ page.title }} 를 사용합니다. 컨텍스트 프로세서에서 제공하는 모든 변수도 사용할 수 있습니다.

class BlogIndexPage(Page):
    ...

    def get_context(self, request, *args, **kwargs):
        context = super().get_context(request, *args, **kwargs)

        # 추가 변수를 추가하고 업데이트된 컨텍스트 반환
        context['blog_entries'] = BlogPage.objects.child_of(self).live()
        return context

{{ page.title }}

{% for entry in blog_entries %}
    {{ entry.title }}
{% endfor %}

템플릿 변경¶

클래스에 template 속성을 설정하여 다른 템플릿 파일을 사용합니다.

class BlogPage(Page):
    ...

    template = 'other_template.html'

class BlogPage(Page):
    ...

    use_other_template = models.BooleanField()

    def get_template(self, request, *args, **kwargs):
        if self.use_other_template:
            return 'blog/other_blog_page.html'

        return 'blog/blog_page.html'

class BlogPage(Page):
    ...

    ajax_template = 'other_template_fragment.html'
    template = 'other_template.html'

페이지 렌더링에 대한 더 많은 제어¶

모든 페이지 클래스에는 get_context 및 get_template 메서드를 내부적으로 호출하고 템플릿을 렌더링하는 serve() 메서드가 있습니다. 이 메서드는 Django 뷰 함수와 유사하며, Django Request 객체를 받아 Django Response 객체를 반환합니다.

이 메서드는 페이지 렌더링에 대한 완전한 제어를 위해 재정의할 수도 있습니다.

예를 들어, 페이지가 자체 JSON 표현으로 응답하도록 하는 방법은 다음과 같습니다.

from django.http import JsonResponse


class BlogPage(Page):
    ...

    def serve(self, request):
        return JsonResponse({
            'title': self.title,
            'body': self.body,
            'date': self.date,

            # 이미지 크기를 300px 너비로 조정하고 URL을 가져옵니다.
            'feed_image': self.feed_image.get_rendition('width-300').url,
        })

친숙한 모델 이름¶

Django의 내부 Meta 클래스를 verbose_name 과 함께 사용하여 Wagtail 사용자에게 모델 이름을 더 친숙하게 만들 수 있습니다. 예를 들어:

class HomePage(Page):
    ...

    class Meta:
        verbose_name = "홈페이지"

사용자에게 만들 페이지를 선택할 수 있는 옵션이 주어지면 페이지 유형 목록은 각 대문자를 기준으로 모델 이름을 분할하여 생성됩니다. 따라서 HomePage 모델은 “Home Page”로 이름이 지정되어 약간 어색합니다. 위 예시와 같이 verbose_name 을 정의하면 “Homepage”로 변경되어 약간 더 일반적입니다.

페이지 QuerySet 정렬¶

Page 파생 모델은 내부 Meta 클래스에 ordering 속성을 추가하는 표준 Django 접근 방식을 사용하여 기본 정렬을 지정할 수 없습니다.

class NewsItemPage(Page):
    publication_date = models.DateField()
    ...

    class Meta:
        ordering = ('-publication_date', )  # 작동하지 않음

이는 Page 가 경로별로 QuerySet 정렬을 강제하기 때문입니다. 대신 QuerySet을 구성할 때 정렬을 명시적으로 적용해야 합니다.

news_items = NewsItemPage.objects.live().order_by('-publication_date')

사용자 지정 페이지 관리자¶

Page 클래스에 사용자 지정 Manager 를 추가할 수 있습니다. 모든 사용자 지정 Manager는 wagtail.models.PageManager 에서 상속해야 합니다.

from django.db import models
from wagtail.models import Page, PageManager

class EventPageManager(PageManager):
    """ 이벤트 페이지에 대한 사용자 지정 관리자 """

class EventPage(Page):
    start_date = models.DateField()

    objects = EventPageManager()

또는 추가 QuerySet 메서드만 추가해야 하는 경우 wagtail.models.PageQuerySet 에서 상속하여 사용자 지정 Manager 를 빌드할 수 있습니다.

from django.db import models
from django.utils import timezone
from wagtail.models import Page, PageManager, PageQuerySet

class EventPageQuerySet(PageQuerySet):
    def future(self):
        today = timezone.localtime(timezone.now()).date()
        return self.filter(start_date__gte=today)

EventPageManager = PageManager.from_queryset(EventPageQuerySet)

class EventPage(Page):
    start_date = models.DateField()

    objects = EventPageManager()