4.0.0 - Custom Grouping!

What's Changed

Please restart Obsidian after updating the plugin. Thank you.

Most notable

⚠️ Important group by urgency now puts most urgent tasks first, not last.

If your vault uses group by urgency, please update your query blocks like this:

Old instruction	Use this instruction instead
group by urgency reverse	group by urgency
group by urgency	group by urgency reverse

🌟 group by function custom groups! - by @claremacrae and @hauntedhost

• A powerful, flexible mechanism to give users total control over task grouping.
• Credit: This work was only made possible by @hauntedhost, who kindly taught me how to evaluate user-supplied functions in TypeScript.
• Docs

Some example custom groups:

# Group by due date year and month number
group by function task.due.format("YYYY-MM")

# Group by any tags that contain "#context/"
group by function task.tags.filter( (tag) => tag.includes("#context/") )

# The opposite: create headings for all tags that do not contain "#tag".
group by function task.tags.filter( (tag) => ! tag.includes("#tag") )

You can also embed formatting in the group names, as markdown there is rendered.
For example, see the paler text in these group headings:

---

🙏 Supporting Tasks development (Optional!)

The Tasks plugin is completely free to use, and very willingly developed and supported by Clare Macrae since May 2022.

Making the group by function facility so well documented and usable, and this thoroughly tested, has been many, many days of work. It opens up some very exciting future capabilities.

If you would like to support Tasks development, and are able to do so, please see:

• https://github.com/sponsors/claremacrae

Donations will go towards my computing costs and licenses for development tools that I use for productivity. Thank you 🙏.

---

Main changes

Here are the most notable user-visible changes.

🌟 Features

• feat: Add custom grouping, with group by function option by @claremacrae and @hauntedhost in #2028
• feat: Add TasksDate class for use in group by function by @claremacrae in #2032
• feat: group by priority names are now more readable by @ilandikov in #2047
• feat: group by status.type names are now more readable by @ilandikov in #2045

💪 Fixes

• fix: Stop bundling Moment in release by @claremacrae in #2016
• fix: 'remove global filter' broke display of sub-tags of global filter by @ilandikov in #2022
• fix!!: group by urgency now puts most urgent tasks first, not last by @ilandikov in #2046

📖 Documentation

• docs: Add Scripting column to Quick Reference, showing property names by @claremacrae in #2033
• docs: Update snippets and examples in markdown by @github-actions in #2048
• contrib: Update snippets and examples in markdown by @github-actions in #2002

🛠️ Behind the scenes

• chore: Automate content generation of some Priority docs by @claremacrae in #2011
• chore(deps): bump peter-evans/create-pull-request from 3 to 5 by @dependabot in #2004
• chore: Fix "Cannot write file '....../global-setup.js' errors'" by @ilandikov in #2008
• chore(deps-dev): bump @types/jest from 29.5.1 to 29.5.2 by @dependabot in #2005
• test: add custom matcher to test group sort order by @ilandikov in #1999
• test: Add TaskBuilder.createFullyPopulatedTask() by @claremacrae in #2013
• test: add group sort order tests by @ilandikov in #2024

New Contributors

• @github-actions made their first contribution in #2002
• @hauntedhost made their first contribution in #2028

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 3.10.0...4.0.0

3.10.0 - Fix Auto Suggest for High priority, more links in Settings

What's Changed

Please restart Obsidian after updating the plugin. Thank you.

Here are the most notable user-visible changes.

🌟 Features

• feat: All settings sections now link to their docs by @claremacrae in #1987

💪 Fixes

• fix: Enable 'High priority' to be selected easily in Auto Suggest by @claremacrae in #1996

🛠️ Dependencies

• chore(deps-dev): bump ts-jest from 29.0.3 to 29.1.0 by @dependabot in #1912
• chore(deps-dev): Bump jest packages to latest by @claremacrae in #1988
• chore(deps-dev): bump typescript from 4.7.4 to 5.0.4 by @claremacrae in #1990
• chore(deps-dev): bump svelte from 3.49.0 to 3.59.1 by @dependabot in #1992
• build(deps-dev): bump svelte-preprocess from 4.10.7 to 5.0.4 by @dependabot in #1983
• chore(deps-dev): bump esbuild-svelte from 0.7.1 to 0.7.3 by @dependabot in #1991
• chore(deps-dev): bump eslint to 8.41.0, eslint-plugin-import to 2.27.5 by @claremacrae in #1993

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 3.9.0...3.10.0

3.9.0 - More priorities: Highest & lowest; fix Obsidian 1.3.0 log spam

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

Main changes

Here are the most notable user-visible changes.

🌟 Features

• feat: Add new priorities: highest and lowest by @chrabia in #1943
  • Highest: 🔺
  • Lowest: ⏬
  • docs
• feat: Update Urgency for Lowest to make linear by @claremacrae in #1984

💪 Fixes

• fix: prevent Obsidian 1.3.0 log spam by @esm7 in #1952

🛠️ Behind the scenes

• jsdoc,comment: Copy 2 tiny additions from my fork by @claremacrae in #1975
• refactor: Simplify grouping code in Field.ts by @claremacrae in #1976
• refactor: Simplify sorting code in Field.ts by @claremacrae in #1977
• test: More custom matchers, for easier Task testing by @claremacrae in #1979
• test: Add jest custom matcher toEqualMoment() by @claremacrae in #1980

New Contributors

• @chrabia made their first contribution in #1943

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 3.8.0...3.9.0

3.8.0 - control order of recurring tasks; control size of groups

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

Main changes

Here are the most notable user-visible changes.

🌟 Features

• feat: Optionally put next recurrence below current task by @ilandikov in #1958
  • docs
• feat: Add limit groups to <number> tasks by @ilandikov in #1963
  • docs

📖 Documentation

• docs: More group limits docs (+minor test & refactor) by @claremacrae in #1973

🛠️ Behind the scenes

• refactor: Clean up TaskGroups constructor by @ilandikov in #1956
• refactor: move TaskGroupingTreeStorage to TaskGroups by @ilandikov in #1957

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 3.7.0...3.8.0

3.7.0 - reverse sorting of groups

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

🌟 Added reverse sorting of groups - thank you @ilandikov

By popular demand (42 votes and a bunch of hearts)... It is now possible to reverse the order of group headings.

For example, group by due reverse will order headings from newest to oldest dates.

• Docs

Main changes

Here are the most notable user-visible changes.

🌟 Features

• feat: reverse sorting of groups by @ilandikov in #1954

🛠️ Behind the scenes

• refactor: Simplify BacklinkField & add test for #1927 by @claremacrae in #1949
• vault: Update Tasks plugin in demo vault to 3.6.0 by @claremacrae in #1946

Full Changelog: 3.6.0...3.7.0

3.6.0 - 'sort by recurring' - 'group by urgency' - better sorting of group headings

What's Changed

Please restart Obsidian after updating the plugin. Thank you.

Main changes

Here are the most notable user-visible changes.

🌟 Features

• feat: Add sort by recurring instruction by @claremacrae in #1941
  • documentation
• feat: Add group by urgency by @claremacrae in #1944
  • documentation

💪 Fixes

• fix: Use proper natural sorting order for group names by @claremacrae in #1942
  • For example, if you have more than 9 numbered headings, and group by heading, 9 will correctly appear before 10 now.

📖 Documentation

• docs: Major improvements to links between docs pages by @claremacrae in #1935

🛠️ Behind the scenes

• refactor, test: Re-enable 'show all suggested text' test by @claremacrae in #1928
• refactor: addgroupheading() refactoring by @ilandikov in #1921

Full Changelog (including changes too small to note above, and that do not affect the behaviour of the plugin itself):

• 3.5.0...3.6.0

3.5.0 - Global Query, and fixes to Dataview field display

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

• 🌟 Added Global Query setting - thanks @kedestin
  • You can set a global query in the settings that Tasks will add to the start of all the Queries in your vault.
  • Docs

• 💪 Fixed, or added workarounds, for Obsidian's display of multiple dataview fields on same line - thanks @kedestin
  • and thanks to @Chris-Andrews for finding and logging the issue
  • Docs

Full List

🌟 Features

• feat: Add a setting for Global Query by @kedestin in #1878

💪 Fixes

• fix: Documentation link in Task Format settings now works by @claremacrae in #1918
• fix: Dataview: Enable workarounds to prevent Obsidian from rendering inline fields as reference style links by @kedestin in #1916

📖 Documentation

• docs, usability: Minor improvements to Global Query docs & settings by @claremacrae in #1919

Full Changelog: 3.4.0...3.5.0

3.4.0 - backlinks jump to exact task line; filter by root and folder

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

🌟 Tasks now requires Obsidian 1.1.1 or above.

🌟 Clicking on backlinks now jumps to the task's exact line! Thanks @esm7.

• Docs

🌟 New filters root folder. Thanks @ilandikov.

• Docs: root and folder.

Full List

🌟 Features

• feat: Backlinks now jump to task's exact line by @esm7 in #1810
• feat: Add 'root' and 'folder' filters by @ilandikov in #1873

💪 Fixes

• fix: Allow filename filters to contain parentheses by @esm7 in #1907
• fix: query-related fields now have a "hidden" CSS class by @esm7 in #1908
• fix: created date suggestion appearing too often by @ldanet in #1897

📖 Documentation

• docs: Remove leftover Jekyll {% raw %} and {% endraw %} text from new docs by @claremacrae in #1904

🛠️ Dependencies

• chore(deps-dev): bump eslint-config-prettier from 8.5.0 to 8.8.0 by @dependabot in #1834
• chore(deps-dev): bump @typescript-eslint/eslint-plugin from 5.36.1 to 5.59.0 by @dependabot in #1885

🛠️ Behind the scenes

• refactor: remove Group class by @ilandikov in #1909
• test: check grouper property by @ilandikov in #1899
• test: Normalize timezone for tests to UTC by @kedestin in #1906

Full Changelog: 3.3.0...3.4.0

3.3.0 - Now with added Dataview format support!

What's Changed

Please restart Obsidian after updating the plugin. Thank you.

🌟 Reading either Dataview or Tasks Emoji formats

• Tasks can now read and write:
  • EITHER the existing Tasks Emoji format
  • OR the Dataview plugin's bracketed inline fields on task lines!
• This is a whole-vault setting, and a step on the way to support of both Dataview and Tasks formats simultaneously.
• Essential reading: About Task Formats and Dataview Format
• Many thanks to @kedestin for implementing this long-requested feature.

💪 Fixed some searches for past dates

• Fixed: Queries like due last Wednesday and due this monday can once again match tasks with dates before today
• If you are using a version of Tasks newer than 1.25.0, please do update.
• Many thanks to @PSFHU for finding and reporting the issue, and @ilandikov for assistance fixing it.

Full List

🌟 Features

• feat: Add support for either Dataview OR Tasks emoji task formats by @kedestin in #1824

💪 Fixes

• fix: Enable queries like 'due last Wednesday' to search dates before today by @claremacrae in #1903

📖 Documentation

• docs: Document Task formats, including Dataview format support by @claremacrae in #1895

🛠️ Behind the scenes

• chore: Use Templater plugin to add documentation snippets by @claremacrae in #1888

Full Changelog: 3.2.0...3.3.0

3.2.0 - 'created today' added to Auto-suggest; LYT Mode theme supported

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

• Auto-Suggest: Add created today to the Auto-Suggest menu - thank you @ldanet!
  • Docs
• Styles: Add one-button support for LYT Mode checkboxes
  • Docs
• Styles: Update for Aura theme's support of light mode
  • Docs

Full List

🌟 Features

• feat: Add one-button support for LYT Mode checkboxes by @claremacrae in #1874
• feat: Update for Aura theme's support of light mode by @claremacrae in #1875
• feat: Add Created date to Auto-Suggest menu by @ldanet in #1872

📖 Documentation

• docs: Add 'Report a Bug' page by @claremacrae in #1857
• docs: Update Dataview project link to correct URL by @bookchiq in #1858

🛠️ Behind the scenes

• chore: Update approval tests to v6.2.1 by @claremacrae in #1862
• refactor: date range abstraction by @ilandikov in #1837
• refactor: Move code for grouping by dates to DateField by @ilandikov in #1870
• refactor: existing *Field grouping migration to new grouping by @ilandikov in #1871

New Contributors

• @bookchiq made their first contribution in #1858
• @ldanet made their first contribution in #1872

Full Changelog: 3.1.0...3.2.0