update readme & changelog

jamiebrynes7 · Jan 31, 2024 · c2f47f5 · c2f47f5
1 parent df32810
commit c2f47f5
Show file tree

Hide file tree

Showing 2 changed files with 26 additions and 8 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,12 +9,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 > Note: the style changes in this release mean that you may need to tweak any custom CSS or themes. The changes are based on the default theme.
 
+### Deprecated
+
+- Please note that the "Render Descriptions", "Render Dates", "Render project & section", and "Render labels" settings are now deprecated. You can now control whether these render or not via the `show` property in the query itself. These will be removed in a future release.
+
 ### ✨ Features
 
 - Added the option to wrap page links in parenthesis when creating tasks with the command. You may find this useful if you primarily use Todoist on mobile where links are less obvious. Thanks to [@ThDag](https://github.com/ThDag) for the contribution!
 - You can now use the `{{filename}}` placeholder in the filter property. This will be replaced with the name of the file where the query is defined.
   - For example, if the full file path is `My Vault/Notes/How to Take Smart Notes.md` then the replaced file name will be `How to Take Smart Notes`.
 - Added "Add item" button to rendered queries. This will open the task creation modal.
+- Added the ability to control which elements of the task metadata render with tasks inside the query with the `show` keyword.
 
 ### 🔁 Changes
 

diff --git a/README.md b/README.md
@@ -26,13 +26,14 @@ An [Obsidian](https://obsidian.md/) plugin to materialize [Todoist](https://todo
 
 The query is defined in YAML and accepts the following keys:
 
-| Name          | Required | Description                                                                                                                                            | Type     | Default |
-| ------------- | :------: | ------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ------- |
-| `name`        |    ✓     | The title for the materialized query. You can use the `{task_count}` template which will be replaced by the number of tasks returned by the query.     | string   |         |
-| `filter`      |    ✓     | A valid [Todoist filter](https://get.todoist.help/hc/en-us/articles/205248842-Filters)<sup>[1](#footnote-1)</sup>                                      | string   |         |
-| `autorefresh` |          | The number of seconds between auto-refreshing. If omitted, the query use the default global settings.                                                  | number   | null    |
-| `sorting`     |          | Describes how to order the tasks in the query. Can be any of 'priority', 'dateAscending' (aliased as 'date'), 'dateDescending',  or multiple of these. | string[] | []      |
-| `group`       |          | Denotes whether this query should have its task grouped by project & section.                                                                          | bool     | false   |
+| Name          | Required | Description                                                                                                                                           | Type     | Default      |
+| ------------- | :------: | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------ |
+| `name`        |    ✓     | The title for the materialized query. You can use the `{task_count}` template which will be replaced by the number of tasks returned by the query.    | string   |              |
+| `filter`      |    ✓     | A valid [Todoist filter](https://get.todoist.help/hc/en-us/articles/205248842-Filters)<sup>[1](#footnote-1)</sup>                                     | string   |              |
+| `autorefresh` |          | The number of seconds between auto-refreshing. If omitted, the query use the default global settings.                                                 | number   | null         |
+| `sorting`     |          | Describes how to order the tasks in the query. Can be any of 'priority', 'dateAscending' (aliased as 'date'), 'dateDescending', or multiple of these. | string[] | []           |
+| `group`       |          | Denotes whether this query should have its task grouped by project & section.                                                                         | bool     | false        |
+| `show`        |          | Describes which elements of the task metadata to render. Possible values: 'due' (aliased as 'date'), 'description', 'project, and 'labels'.           | string[] | All metadata |
 
 ## Examples
 
@@ -42,7 +43,7 @@ Show current and overdue tasks, ordered by date and then priority, and finally g
 ```todoist
 name: Highest Priority & Date
 filter: "today | overdue"
-sorting: 
+sorting:
    - date
    - priority
 group: true
@@ -58,6 +59,18 @@ filter: "#Inbox"
 ```
 ````
 
+Show items from the "Chores" project, showing only due date and description:
+
+````
+```todoist
+name: Chores
+filter: "#Chores"
+show:
+   - due
+   - description
+```
+````
+
 ## Commands
 
 There are also a few commands bundled in with the plugin: