wagtail 6.0.1__py3-none-any.whl → 6.1rc1__py3-none-any.whl

wagtail/admin/views/workflows.py

@@ -1,8 +1,10 @@
+import django_filters
+from django import forms
 from django.contrib.contenttypes.models import ContentType
 from django.core.exceptions import PermissionDenied
 from django.core.paginator import Paginator
 from django.db import transaction
-from django.db.models import Count, OuterRef
+from django.db.models import Count, OuterRef, Prefetch
 from django.db.models.functions import Lower
 from django.http import Http404, HttpResponseBadRequest
 from django.shortcuts import get_object_or_404, redirect, render
@@ -18,6 +20,7 @@ from django.views.generic import TemplateView
 
 from wagtail.admin import messages
 from wagtail.admin.auth import PermissionPolicyChecker
+from wagtail.admin.filters import MultipleContentTypeFilter, WagtailFilterSet
 from wagtail.admin.forms.workflows import (
     TaskChooserSearchForm,
     WorkflowContentTypeForm,
@@ -26,7 +29,7 @@ from wagtail.admin.forms.workflows import (
     get_workflow_edit_handler,
 )
 from wagtail.admin.modal_workflow import render_modal_workflow
-from wagtail.admin.ui.tables import Column, TitleColumn
+from wagtail.admin.ui.tables import BaseColumn, Column, TitleColumn
 from wagtail.admin.views.generic import CreateView, DeleteView, EditView, IndexView
 from wagtail.coreutils import resolve_model_string
 from wagtail.models import (
@@ -36,6 +39,7 @@ from wagtail.models import (
     Workflow,
     WorkflowContentType,
     WorkflowState,
+    WorkflowTask,
 )
 from wagtail.permissions import (
     page_permission_policy,
@@ -48,35 +52,114 @@ from wagtail.workflows import get_task_types
 task_permission_checker = PermissionPolicyChecker(task_permission_policy)
 
 
+class WorkflowTitleColumn(TitleColumn):
+    cell_template_name = "wagtailadmin/workflows/includes/workflow_title_cell.html"
+
+
+class WorkflowUsedByColumn(TitleColumn):
+    cell_template_name = "wagtailadmin/workflows/includes/workflow_used_by_cell.html"
+
+    def get_cell_context_data(self, instance, parent_context):
+        context = super().get_cell_context_data(instance, parent_context)
+        context["workflow_enabled_models"] = get_workflow_enabled_models()
+        return context
+
+
+class WorkflowTasksColumn(BaseColumn):
+    cell_template_name = "wagtailadmin/workflows/includes/workflow_tasks_cell.html"
+    num_tasks = 5
+
+    def get_cell_context_data(self, instance, parent_context):
+        context = super().get_cell_context_data(instance, parent_context)
+        context["tasks"] = instance.workflow_tasks.all()[: self.num_tasks]
+        context["extra_count"] = instance.workflow_tasks.count() - self.num_tasks
+        return context
+
+
+class BaseWorkflowFilterSet(WagtailFilterSet):
+    show_disabled = django_filters.ChoiceFilter(
+        label=_("Show disabled"),
+        method="filter_show_disabled",
+        choices=(("true", _("Yes")), ("false", _("No"))),
+        widget=forms.RadioSelect,
+        empty_label=None,
+        initial="false",
+    )
+
+    def __init__(self, data=None, queryset=None, *, request=None, prefix=None):
+        if data is not None:
+            if data.get("show_disabled") is None:
+                filter = self.base_filters["show_disabled"]
+                data = data.copy()
+                data["show_disabled"] = filter.extra["initial"]
+        super().__init__(data, queryset, request=request, prefix=prefix)
+
+    def filter_show_disabled(self, queryset, name, value):
+        if value == "true":
+            return queryset
+        return queryset.filter(active=True)
+
+
+class WorkflowFilterSet(BaseWorkflowFilterSet):
+    class Meta:
+        model = Workflow
+        fields = []
+
+
 class Index(IndexView):
     permission_policy = workflow_permission_policy
     model = Workflow
     context_object_name = "workflows"
     template_name = "wagtailadmin/workflows/index.html"
+    results_template_name = "wagtailadmin/workflows/index_results.html"
     add_url_name = "wagtailadmin_workflows:add"
     edit_url_name = "wagtailadmin_workflows:edit"
     index_url_name = "wagtailadmin_workflows:index"
+    index_results_url_name = "wagtailadmin_workflows:index_results"
     page_title = _("Workflows")
     add_item_label = _("Add a workflow")
     header_icon = "tasks"
+    columns = [
+        WorkflowTitleColumn(
+            "name",
+            label=_("Name"),
+            url_name="wagtailadmin_workflows:edit",
+            width="25%",
+            sort_key="name",
+        ),
+        WorkflowUsedByColumn(
+            "usage",
+            label=_("Used by"),
+            url_name="wagtailadmin_workflows:usage",
+            width="15%",
+        ),
+        WorkflowTasksColumn("tasks", label=_("Tasks")),
+    ]
+    default_ordering = "name"
+    search_fields = ["name"]
+    filterset_class = WorkflowFilterSet
+    _show_breadcrumbs = True
+    paginate_by = 20
 
     def show_disabled(self):
-        return self.request.GET.get("show_disabled", "false") == "true"
+        return self.filters.form.cleaned_data.get("show_disabled") == "true"
 
-    def get_queryset(self):
-        queryset = super().get_queryset()
-        if not self.show_disabled():
-            queryset = queryset.filter(active=True)
+    def get_base_queryset(self):
+        queryset = super().get_base_queryset()
         content_types = WorkflowContentType.objects.filter(
             workflow=OuterRef("pk")
         ).values_list("pk", flat=True)
         queryset = queryset.annotate(content_types=Count(content_types))
-        return queryset
+        return queryset.prefetch_related(
+            "workflow_pages",
+            "workflow_pages__page",
+            "workflow_tasks",
+            "workflow_tasks__task",
+        )
 
     def get_context_data(self, **kwargs):
         context = super().get_context_data(**kwargs)
         context["showing_disabled"] = self.show_disabled()
-        context["workflow_enabled_models"] = get_workflow_enabled_models()
         return context
 
 
@@ -91,6 +174,7 @@ class Create(CreateView):
     index_url_name = "wagtailadmin_workflows:index"
     header_icon = "tasks"
     edit_handler = None
+    _show_breadcrumbs = True
 
     def get_edit_handler(self):
         if not self.edit_handler:
@@ -177,6 +261,7 @@ class Edit(EditView):
     header_icon = "tasks"
     edit_handler = None
     MAX_PAGES = 5
+    _show_breadcrumbs = True
 
     def get_edit_handler(self):
         if not self.edit_handler:
@@ -226,7 +311,7 @@ class Edit(EditView):
         ) and self.object.active
         context["can_enable"] = (
             self.permission_policy is None
-            or self.permission_policy.user_has_permission(self.request.user, "create")
+            or self.permission_policy.user_has_permission(self.request.user, "add")
         ) and not self.object.active
         context["media"] = bound_panel.media + form.media + pages_formset.media
         return context
@@ -334,7 +419,7 @@ def enable_workflow(request, pk):
     workflow = get_object_or_404(Workflow, id=pk)
 
     # Check permissions
-    if not workflow_permission_policy.user_has_permission(request.user, "create"):
+    if not workflow_permission_policy.user_has_permission(request.user, "add"):
         raise PermissionDenied
 
     # Set workflow to active if inactive
@@ -396,33 +481,75 @@ class TaskUsageColumn(Column):
     cell_template_name = "wagtailadmin/workflows/includes/task_usage_cell.html"
 
 
+class TaskFilterSet(BaseWorkflowFilterSet):
+    def __init__(self, data=None, queryset=None, *, request=None, prefix=None):
+        super().__init__(data, queryset, request=request, prefix=prefix)
+        task_types = get_task_types()
+        ct_ids = [
+            ct.id for ct in ContentType.objects.get_for_models(*task_types).values()
+        ]
+        if len(task_types) > 1:
+            self.filters["content_type"] = MultipleContentTypeFilter(
+                label=_("Type"),
+                widget=forms.CheckboxSelectMultiple,
+                queryset=lambda request: ContentType.objects.filter(pk__in=ct_ids),
+                field_name="content_type",
+            )
+
+    class Meta:
+        model = Task
+        fields = []
+
+
 class TaskIndex(IndexView):
     permission_policy = task_permission_policy
     model = Task
     context_object_name = "tasks"
     template_name = "wagtailadmin/workflows/task_index.html"
+    results_template_name = "wagtailadmin/workflows/task_index_results.html"
     add_url_name = "wagtailadmin_workflows:select_task_type"
     edit_url_name = "wagtailadmin_workflows:edit_task"
     index_url_name = "wagtailadmin_workflows:task_index"
+    index_results_url_name = "wagtailadmin_workflows:task_index_results"
     page_title = _("Workflow tasks")
     add_item_label = _("New workflow task")
     header_icon = "thumbtack"
     columns = [
         TaskTitleColumn(
-            "name", label=_("Name"), url_name="wagtailadmin_workflows:edit_task"
+            "name",
+            label=_("Name"),
+            url_name="wagtailadmin_workflows:edit_task",
+            sort_key="name",
+        ),
+        Column("type", label=_("Type"), accessor="get_verbose_name", width="25%"),
+        TaskUsageColumn(
+            "usage", label=_("Used on"), accessor="_active_workflows", width="25%"
         ),
-        Column("type", label=_("Type"), accessor="get_verbose_name"),
-        TaskUsageColumn("usage", label=_("Used on"), accessor="active_workflows"),
     ]
+    default_ordering = "name"
+    search_fields = ["name"]
+    filterset_class = TaskFilterSet
+    _show_breadcrumbs = True
+    paginate_by = 50
 
     def show_disabled(self):
-        return self.request.GET.get("show_disabled", "false") == "true"
+        return self.filters.form.cleaned_data.get("show_disabled") == "true"
 
     def get_queryset(self):
-        queryset = super().get_queryset()
-        if not self.show_disabled():
-            queryset = queryset.filter(active=True)
-        return queryset.specific()
+        return (
+            super()
+            .get_queryset()
+            .specific()
+            .prefetch_related(
+                Prefetch(
+                    "workflow_tasks",
+                    queryset=WorkflowTask.objects.filter(
+                        workflow__active=True
+                    ).select_related("workflow"),
+                    to_attr="_active_workflows",
+                )
+            )
+        )
 
     def get_context_data(self, **kwargs):
         context = super().get_context_data(**kwargs)
@@ -473,6 +600,7 @@ class CreateTask(CreateView):
     edit_url_name = "wagtailadmin_workflows:edit_task"
     index_url_name = "wagtailadmin_workflows:task_index"
     header_icon = "thumbtack"
+    _show_breadcrumbs = True
 
     @cached_property
     def model(self):
@@ -534,6 +662,7 @@ class EditTask(EditView):
     enable_item_label = _("Enable")
     enable_url_name = "wagtailadmin_workflows:enable_task"
     header_icon = "thumbtack"
+    _show_breadcrumbs = True
 
     @cached_property
     def model(self):
@@ -574,7 +703,7 @@ class EditTask(EditView):
         ) and self.object.active
         context["can_enable"] = (
             self.permission_policy is None
-            or self.permission_policy.user_has_permission(self.request.user, "create")
+            or self.permission_policy.user_has_permission(self.request.user, "add")
         ) and not self.object.active
 
         # TODO: add warning msg when there are pages/snippets currently on this task in a workflow, add interaction like resetting task state when saved
@@ -626,7 +755,7 @@ def enable_task(request, pk):
     task = get_object_or_404(Task, id=pk)
 
     # Check permissions
-    if not task_permission_policy.user_has_permission(request.user, "create"):
+    if not task_permission_policy.user_has_permission(request.user, "add"):
         raise PermissionDenied
 
     # Set workflow to active if inactive

wagtail/admin/viewsets/model.py

@@ -649,8 +649,8 @@ class ModelViewSet(ViewSet):
     def _legacy_urlpatterns(self):
         # RemovedInWagtail70Warning: Remove legacy URL patterns
         return [
-            path("<int:pk>/", self.redirect_to_edit_view),
-            path("<int:pk>/delete/", self.redirect_to_delete_view),
+            path("<str:pk>/", self.redirect_to_edit_view),
+            path("<str:pk>/delete/", self.redirect_to_delete_view),
         ]
 
     def on_register(self):

wagtail/admin/viewsets/pages.py

@@ -0,0 +1,77 @@
+from django.urls import path
+
+from wagtail.admin.views.pages.choose_parent import ChooseParentView
+from wagtail.admin.views.pages.listing import IndexView
+from wagtail.models import Page
+
+from .base import ViewSet
+
+
+class PageListingViewSet(ViewSet):
+    """
+    A viewset to present a flat listing of all pages of a specific type.
+    All attributes and methods from :class:`~wagtail.admin.viewsets.base.ViewSet`
+    are available.
+    For more information on how to use this class, see :ref:`custom_page_listings`.
+    """
+
+    #: The view class to use for the index view; must be a subclass of ``wagtail.admin.views.pages.listing.IndexView``.
+    index_view_class = IndexView
+    #: The view class to use for choosing the parent page when creating a new page of this page type.
+    choose_parent_view_class = ChooseParentView
+    #: Required; the page model class that this viewset will work with.
+    model = Page
+    #: A list of ``wagtail.admin.ui.tables.Column`` instances for the columns in the listing.
+    columns = IndexView.columns
+    #: A subclass of ``wagtail.admin.filters.WagtailFilterSet``, which is a
+    #: subclass of `django_filters.FilterSet <https://django-filter.readthedocs.io/en/stable/ref/filterset.html>`_.
+    #: This will be passed to the ``filterset_class`` attribute of the index view.
+    filterset_class = IndexView.filterset_class
+
+    def get_common_view_kwargs(self, **kwargs):
+        return super().get_common_view_kwargs(
+            **{
+                "_show_breadcrumbs": True,
+                "header_icon": self.icon,
+                "model": self.model,
+                "index_url_name": self.get_url_name("index"),
+                "add_url_name": self.get_url_name("choose_parent"),
+                **kwargs,
+            }
+        )
+
+    def get_index_view_kwargs(self, **kwargs):
+        return {
+            "index_results_url_name": self.get_url_name("index_results"),
+            "columns": self.columns,
+            "filterset_class": self.filterset_class,
+            **kwargs,
+        }
+
+    def get_choose_parent_view_kwargs(self, **kwargs):
+        return kwargs
+
+    @property
+    def index_view(self):
+        return self.construct_view(
+            self.index_view_class, **self.get_index_view_kwargs()
+        )
+
+    @property
+    def index_results_view(self):
+        return self.construct_view(
+            self.index_view_class, **self.get_index_view_kwargs(), results_only=True
+        )
+
+    @property
+    def choose_parent_view(self):
+        return self.construct_view(
+            self.choose_parent_view_class, **self.get_choose_parent_view_kwargs()
+        )
+
+    def get_urlpatterns(self):
+        return [
+            path("", self.index_view, name="index"),
+            path("results/", self.index_results_view, name="index_results"),
+            path("choose_parent/", self.choose_parent_view, name="choose_parent"),
+        ]

wagtail/admin/wagtail_hooks.py

@@ -1,6 +1,6 @@
 from django.conf import settings
 from django.contrib.auth.models import Permission
-from django.urls import reverse
+from django.urls import reverse, reverse_lazy
 from django.utils.functional import cached_property
 from django.utils.http import urlencode
 from django.utils.translation import gettext
@@ -743,6 +743,21 @@ def register_core_features(features):
                     # Keep pasted links with http/https protocol, and not-pasted links (href = undefined).
                     "href": "^(http:|https:|undefined$)",
                 },
+                "chooserUrls": {
+                    "pageChooser": reverse_lazy("wagtailadmin_choose_page"),
+                    "externalLinkChooser": reverse_lazy(
+                        "wagtailadmin_choose_page_external_link"
+                    ),
+                    "emailLinkChooser": reverse_lazy(
+                        "wagtailadmin_choose_page_email_link"
+                    ),
+                    "phoneLinkChooser": reverse_lazy(
+                        "wagtailadmin_choose_page_phone_link"
+                    ),
+                    "anchorLinkChooser": reverse_lazy(
+                        "wagtailadmin_choose_page_anchor_link"
+                    ),
+                },
             },
             js=[
                 "wagtailadmin/js/page-chooser-modal.js",
@@ -960,7 +975,7 @@ def register_reports_menu():
 
 @hooks.register("register_help_menu_item")
 def register_whats_new_in_wagtail_version_menu_item():
-    version = "6.0"
+    version = "6.1"
     return DismissibleMenuItem(
         _("What's new in Wagtail %(version)s") % {"version": version},
         wagtail_feature_release_whats_new_link(),
@@ -983,6 +998,28 @@ def register_editors_guide_menu_item():
     )
 
 
+@hooks.register("register_help_menu_item")
+def register_keyboard_shortcuts_menu_item():
+    """
+    Triggers the keyboard shortcuts dialog to open when clicked
+    while preventing the default link click action.
+    """
+
+    return MenuItem(
+        _("Shortcuts"),
+        icon_name="keyboard",
+        order=1200,
+        attrs={
+            "role": "button",  # Ensure screen readers announce this as a button
+            "data-a11y-dialog-show": "keyboard-shortcuts-dialog",
+            "data-action": "w-action#noop:prevent:stop",
+            "data-controller": "w-action",
+        },
+        name="keyboard-shortcuts-trigger",
+        url="#",
+    )
+
+
 @hooks.register("register_admin_menu_item")
 def register_help_menu():
     return DismissibleSubmenuMenuItem(
@@ -1061,6 +1098,7 @@ def register_icons(icons):
         "info-circle.svg",
         "italic.svg",
         "key.svg",
+        "keyboard.svg",
         "link.svg",
         "link-external.svg",
         "list-ol.svg",

wagtail/admin/widgets/button.py

@@ -103,20 +103,20 @@ class HeaderButton(Button):
         classname="",
         icon_name=None,
         attrs={},
+        icon_only=False,
         **kwargs,
     ):
-        classname = f"{classname} w-header-button".strip()
+        classname = f"{classname} w-header-button button".strip()
         attrs = attrs.copy()
-        attrs.update(
-            {
-                "data-controller": "w-tooltip w-link",
-                "data-w-tooltip-content-value": label,
-                "data-action": "w-swap:success@document->w-link#setParamsFromSwapRequest",
-                "aria-label": label,
-            }
-        )
+        if icon_only:
+            controller = f"{attrs.get('data-controller', '')} w-tooltip".strip()
+            attrs["data-controller"] = controller
+            attrs["data-w-tooltip-content-value"] = label
+            attrs["aria-label"] = label
+            label = ""
+
         super().__init__(
-            label="",
+            label=label,
             url=url,
             classname=classname,
             icon_name=icon_name,

wagtail/api/v2/filters.py

@@ -221,7 +221,7 @@ class AncestorOfFilter(BaseFilterBackend):
 
 class DescendantOfFilter(BaseFilterBackend):
     """
-    Implements the ?decendant_of filter which limits the set of pages to a
+    Implements the ?descendant_of filter which limits the set of pages to a
     particular branch of the page tree.
     """
 

wagtail/api/v2/tests/test_pages.py

@@ -197,7 +197,7 @@ class TestPageListing(WagtailTestUtils, TestCase):
         self.assertTrue(blog_page_seen, msg="No blog pages were found in the items")
         self.assertTrue(event_page_seen, msg="No event pages were found in the items")
 
-    def test_non_existant_type_gives_error(self):
+    def test_non_existent_type_gives_error(self):
         response = self.get_response(type="demosite.IDontExist")
         content = json.loads(response.content.decode("UTF-8"))
 

wagtail/blocks/base.py

@@ -143,10 +143,10 @@ class Block(metaclass=BaseBlock):
         Return this block's default value (conventionally found in self.meta.default),
         converted to the value type expected by this block. This caters for the case
         where that value type is not something that can be expressed statically at
-        model definition type (e.g. something like StructValue which incorporates a
-        pointer back to the block definion object).
+        model definition time (e.g. something like StructValue which incorporates a
+        pointer back to the block definition object).
         """
-        return self.meta.default
+        return self.normalize(self.meta.default)
 
     def clean(self, value):
         """
@@ -159,6 +159,15 @@ class Block(metaclass=BaseBlock):
         """
         return value
 
+    def normalize(self, value):
+        """
+        Given a value for any acceptable type for this block (e.g. string or RichText for a RichTextBlock;
+        dict or StructValue for a StructBlock), return a value of the block's native type (e.g. RichText
+        for RichTextBlock, StructValue for StructBlock). In simple cases this will return the value
+        unchanged.
+        """
+        return value
+
     def to_python(self, value):
         """
         Convert 'value' from a simple (JSON-serialisable) value to a (possibly complex) Python value to be
@@ -167,6 +176,9 @@ class Block(metaclass=BaseBlock):
         like the original value but provides a native HTML rendering when inserted into a template; or it
         might be something totally different (e.g. an image chooser will use the image ID as the clean
         value, and turn this back into an actual image object here).
+
+        For blocks that are usable at the top level of a StreamField, this must also accept any type accepted
+        by normalize. (This is because Django calls `Field.to_python` from `Field.clean`.)
         """
         return value
 
@@ -215,7 +227,7 @@ class Block(metaclass=BaseBlock):
         Return the template to use for rendering the block if specified on meta class.
         This extraction was added to make dynamic templates possible if you override this method
 
-        value contains the current value of the block, allowing overriden methods to
+        value contains the current value of the block, allowing overridden methods to
         select the proper template based on the actual block value.
         """
         return getattr(self.meta, "template", None)
@@ -564,14 +576,11 @@ class BlockWidget(forms.Widget):
             error = errors.as_data()[0]
             error_json = json.dumps(get_error_json_data(error))
         else:
-            error_json = "null"
+            error_json = json.dumps(None)
 
         return format_html(
             """
-                <div id="{id}" data-block="{block_json}" data-value="{value_json}" data-error="{error_json}"></div>
-                <script>
-                    initBlockWidget('{id}');
-                </script>
+                <div id="{id}" data-block data-controller="w-block" data-w-block-data-value="{block_json}" data-w-block-arguments-value="[{value_json},{error_json}]"></div>
             """,
             id=name,
             block_json=self.block_json,

wagtail/blocks/field_block.py

@@ -687,12 +687,6 @@ class RichTextBlock(FieldBlock):
         self.search_index = search_index
         super().__init__(**kwargs)
 
-    def get_default(self):
-        if isinstance(self.meta.default, RichText):
-            return self.meta.default
-        else:
-            return RichText(self.meta.default)
-
     def to_python(self, value):
         # convert a source-HTML string from the JSONish representation
         # to a RichText object
@@ -703,6 +697,11 @@ class RichTextBlock(FieldBlock):
         # the JSONish representation
         return value.source
 
+    def normalize(self, value):
+        if isinstance(value, RichText):
+            return value
+        return RichText(value)
+
     @cached_property
     def field(self):
         from wagtail.admin.rich_text import get_rich_text_editor_widget
@@ -757,11 +756,14 @@ class RawHTMLBlock(FieldBlock):
         super().__init__(**kwargs)
 
     def get_default(self):
-        return mark_safe(self.meta.default or "")
+        return self.normalize(self.meta.default or "")
 
     def to_python(self, value):
         return mark_safe(value)
 
+    def normalize(self, value):
+        return mark_safe(value)
+
     def get_prep_value(self, value):
         # explicitly convert to a plain string, just in case we're using some serialisation method
         # that doesn't cope with SafeString values correctly

wagtail/blocks/list_block.py

@@ -151,10 +151,6 @@ class ListBlock(Block):
             # Default to a list consisting of one empty (i.e. default-valued) child item
             self.meta.default = [self.child_block.get_default()]
 
-    def get_default(self):
-        # wrap with list() so that each invocation of get_default returns a distinct instance
-        return ListValue(self, values=list(self.meta.default))
-
     def value_from_datadict(self, data, files, prefix):
         count = int(data["%s-count" % prefix])
         child_blocks_with_indexes = []
@@ -183,8 +179,7 @@ class ListBlock(Block):
     def clean(self, value):
         # value is expected to be a ListValue, but if it's been assigned through external code it might
         # be a plain list; normalise it to a ListValue
-        if not isinstance(value, ListValue):
-            value = ListValue(self, values=value)
+        value = self.normalize(value)
 
         result = []
         block_errors = {}
@@ -224,6 +219,21 @@ class ListBlock(Block):
 
         return ListValue(self, bound_blocks=result)
 
+    def normalize(self, value):
+        if isinstance(value, ListValue):
+            return value
+        elif isinstance(value, list):
+            return ListValue(
+                self, values=[self.child_block.normalize(x) for x in value]
+            )
+        else:
+            raise TypeError(
+                f"Cannot handle {value!r} (type {type(value)!r}) as a value of a ListBlock"
+            )
+
+    def empty_value(self):
+        return ListValue(self, values=[])
+
     def _item_is_in_block_format(self, item):
         # check a list item retrieved from the database JSON representation to see whether it follows
         # the new format (https://github.com/wagtail/rfcs/blob/main/text/065-listblock.md) for a list item