feat: Add page search schema extension for exact match queries

Author: metaforx

djangocms_rest/views.py

@@ -61,6 +61,18 @@
         ]
     )
 
+    extend_page_search_schema = extend_schema(
+        parameters=[
+            OpenApiParameter(
+                name="q",
+                type=OpenApiTypes.STR,
+                location=OpenApiParameter.QUERY,
+                description="Search for an exact match of the search term to find pages by title, page_title, menu_title, or meta_description",
+                required=False,
+            ),
+        ]
+    )
+
 except ImportError:  # pragma: no cover
 
     class OpenApiTypes:
@@ -85,6 +97,9 @@ def _decorator(obj: T) -> T:
     def extend_placeholder_schema(func: Callable[P, T]) -> Callable[P, T]:
         return func
 
+    def extend_page_search_schema(func: Callable[P, T]) -> Callable[P, T]:
+        return func
+
 
 # Generate the plugin definitions once at module load time
 # This avoids the need to import the plugin definitions in every view
@@ -137,6 +152,7 @@ def get_queryset(self):
 
 
 class PageSearchView(PageListView):
+    @extend_page_search_schema
     def get(self, request, language: str | None = None) -> Response:
         self.search_term = request.GET.get("q", "")
         self.language = language