Updated filters

Author: estruyf

content/docs/dashboard/content-view.md

@@ -3,7 +3,7 @@ title: Content view
 slug: content-view
 description: null
 date: 2022-11-28T14:55:04.221Z
-lastmod: 2023-10-06T13:36:12.765Z
+lastmod: 2024-02-22T10:46:27.387Z
 weight: 300.1
 ---
 
@@ -55,21 +55,91 @@ If you want to use other statuses, you can do so by specifying your own draft fi
 
 ![Draft filters][04]
 
-## Supported filters
+## Filters
 
+By default, the content view will show all your pages, but you can filter them by using the following
+filter:
+
+- Content folder (when you have multiple registered)
 - Tag filter
 - Category filter
-- Content folder (when you have multiple registered)
 
-## Supported sorting
+You can change the default filters, or configure your own by updating the `frontMatter.content.filters`
+setting.
+
+### Configure filters
+
+The default filter configuration is as follows:
+
+```json {{ "title": "Default content filters configuration" }}
+{
+  "frontMatter.content.filters": [
+    "contentFolders", 
+    "tags", 
+    "categories",
+  ]
+}
+```
+
+You can change the default filters, or configure your own by updating the `frontMatter.content.filters`
+setting as follows:
+
+```json {{ "title": "Example of adding custom filters" }}
+{
+  "frontMatter.content.filters": [
+    "contentFolders",
+    "tags",
+    {
+      "title": "My custom filter",
+      "name": "field-name",
+    }
+  ]
+}
+```
+
+> **Info**: The `name` property should be the name of the front matter field you want to filter by.
+
+## Sorting
+
+By default, the content is sorted by the following options:
 
 - Last modified
 - Filename (asc/desc)
 
-> **Info**: You can define custom sorting options by specifying these within the
-> [frontMatter.content.sorting][05] setting.
+You can change the sorting options by specifying the `frontMatter.content.sorting` setting. This
+setting allows you to define the sorting options for the content view.
+
+### Configure sorting options
 
-You are also able to define your default sorting options by setting the
+| Property | Description | Default |
+| --- | --- | --- |
+| `title` | The title of the sorting option | `""` |
+| `name` | The name of the field to sort by (needs to be present in your content its front matter) | `""` |
+| `order` | The order of the sorting (ascending or descending). Option values to use: `asc` or `desc`. | `""` |
+| `type` | The type of field value. Option values to use: `string`, `date`, and `number`. | `""` |
+
+```json {{ "title": "Example of adding custom sorting options" }}
+{
+  "frontMatter.content.sorting": [
+    {
+      "title": "Date (asc)",
+      "name": "date",
+      "order": "asc",
+      "type": "date"
+    },
+    {
+      "title": "Date (desc)",
+      "name": "date",
+      "order": "desc",
+      "type": "date"
+    }
+  ]
+}
+```
+
+### Default sorting
+
+To define your default sorting options by setting the
 `frontMatter.content.defaultSorting` setting for the content view, and the
 `frontMatter.media.defaultSorting` setting for the media view.
 
@@ -98,5 +168,4 @@ of the content view. This will allow you to quickly access.
 [02]: /releases/v7.1.0/draft-filters.png
 [03]: /docs/content-creation/fields#draft
 [04]: /releases/v5.3.0/draft-status.png
-[05]: /docs/settings/overview#frontmatter.content.sorting
 [06]: /docs/experimental/ui-extensibility#registering-a-custom-ui-extension

content/docs/settings/available-settings.md

@@ -3,7 +3,7 @@ title: Settings overview
 slug: settings/overview
 description: null
 date: 2023-02-13T16:44:09.618Z
-lastmod: 2024-02-21T16:01:09.014Z
+lastmod: 2024-02-22T10:16:24.290Z
 weight: 1100.2
 ---
 
@@ -169,41 +169,23 @@ you can use the following settings:
 - `source/images`: If you want to use the default image location of Hexo;
 - `hexo:post_asset_folder`: If you want to use the post asset folder functionality.
 
-### frontMatter.content.sorting
+### frontMatter.content.filters
 
-Define the sorting options for your dashboard content.
+Specify the filters you want to use for your content dashboard.
 
 - Type: `object[]`
-- Default: `[]`
+- Default: `["contentFolders", "tags", "categories"]`
 
-Properties:
+> **Info**: More information on how to use it can be found in the [Content View - Filters][23] section.
 
-- `title`: The title of the sorting option
-- `name`: The name of the field to sort by (needs to be present in your content its front matter)
-- `order`: The order of the sorting (ascending or descending). Option values to use: `asc` or
-  `desc`.
-- `type`: The type of field value. Option values to use: `string`, `date`, and `number`.
+### frontMatter.content.sorting
 
-Sample:
+Define the sorting options for your dashboard content.
 
-```json
-{
-  "frontMatter.content.sorting": [
-    {
-      "title": "Date (asc)",
-      "name": "date",
-      "order": "asc",
-      "type": "date"
-    },
-    {
-      "title": "Date (desc)",
-      "name": "date",
-      "order": "desc",
-      "type": "date"
-    }
-  ]
-}
-```
+- Type: `object[]`
+- Default: `[]`
+
+> **Info**: More information on how to use it can be found in the [Content View - Sorting][22] section.
 
 ### frontMatter.content.supportedFileTypes
 
@@ -865,3 +847,5 @@ This setting has been deprecated since version `3.1.0` in favour of the newly in
 [19]: /docs/snippets#snippet-wrapper
 [20]: /docs/settings#extending-with-code
 [21]: /docs/content-creation/multilingual
+[22]: /docs/content-view#sorting
+[23]: /docs/content-view#filters