Query Blocks
This plugin uses the concept of filters to fetch data from Todoist. To create a query block, insert a code block like the following in any note:
```todoist
filter: "today | overdue"
```
This query will fetch all tasks that are due either today or are overdue and will render them in place of this code block.
Options
The query is defined as YAML and there are a number of options available.
filter
The filter option is required and should be a valid Todoist filter. Note that this must be the content of the filter, you cannot refer to a filter that already exists in your Todoist account.
There are a few unsupported filters, these are tracked in this GitHub issue:
- Wildcard filters do not work as expected. E.g. -
@*ball
- You cannot combine multiple filters with commas. E.g. -
today | overdue, p1
name
If you want to have an embedded header rendered with your query, you can use the name
option. This will render a <h4>
element above your tasks.
For example:
```todoist
name: "Today & Overdue"
filter: "today | overdue"
```
autorefresh
The autorefresh
option allows you to specify the number of seconds between automatic refreshes. This takes precedence over the plugin level setting. Omitting this option means the query will follow the plugin level settings.
For example:
```todoist
filter: "today | overdue"
autorefresh: 120
```
sorting
The sorting
property allows you to specify the ordering for how your tasks are rendered. This is specified as a list, where we sort in the order of the properties in the list. The possible values are:
date
ordateAscending
: sorts tasks in ascending order based on due datedateDescending
: sorts tasks in descending order based on due datepriority
orpriorityAscending
: sorting tasks in ascending order based on prioritypriorityDescending
: sorts tasks in descending order based on priorityorder
: sorts task according to the ordering defined in TodoistdateAdded
ordateAddedAscending
: sorts tasks in ascending order based on the date the task was addeddateAddedDescending
: sorts tasks in descending order based on the date the task was added
If no sorting option is provided, tasks will be sorted by their Todoist order.
For example:
```todoist
filter: "today | overdue"
sorting:
- date
- priority
```
group
The group
property controls whether tasks are grouped into projects when rendered. This is a simple true or false option, further improvements to the grouping capabilities are planned.
```todoist
filter: "today | overdue"
group: true
```
show
The show
property controls which elements of the task metadata to render. This will override the plugin level settings if provided. If omitted, all task metadata will be rendered.
The possible values are:
due
ordate
: render the due date of the taskdescription
: render the description of the taskproject
: render the project (and section, if applicable) of the tasklabels
: render the labels of the task
For example:
```todoist
filter: "today | overdue"
show:
- due
- project
```