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

3.1.0 - Search for tasks in numbered week, month, quarter or year

What's Changed

🌟 Most Notable

Dependencies have been updated. Please restart Obsidian after updating the plugin. Thank you.

• 🌟 Search for tasks in given week, month, quarter or year - thanks @ilandikov!
  • Examples:
    - Year: happens in 2023
    - Quarter: created in 2023-Q1
    - Month: done in 2022-11
    - Week: due in 2023-W42
  • docs
• 🌟New Documentation Site
  • The Tasks user guide has moved to: publish.obsidian.md/tasks/
  • We now edit the docs in Obsidian, and publishing them with Obsidian Publish.
  • The documentation links in Settings have been updated to the new location
  • We will eventually make the old site redirect to the new one.

Full List

🌟 Features

• feat: Search for numbered week, month, quarter & year ranges by @ilandikov in #1756
• feat: date range explanations much more readable by @ilandikov in #1836

💪 Fixes

• fix:

📖 Documentation

• docs: Migrate Tasks docs from Jekyll to Obsidian Publish by @claremacrae in #1838
• docs: Use tags to link to related pages by @claremacrae in #1845
• docs: document new date searches e.g. 2023-W42, 2023-12, 2023-Q1, 2023 by @ilandikov in #1844
• contrib,fix: Updates for conversion to Obsidian Publish by @claremacrae in #1839

🛠️ Behind the scenes

• refactor: introduce GlobalFilter class by @ilandikov in #1793
• refactor: Simplify DateParser.parseDateRange() by @ilandikov in #1831

Full Changelog: 3.0.0...3.1.0

3.0.0 - Themability!

What's Changed

🌟 Most Notable 🌟

Dependencies have been updated. Please restart Obsidian after updating the plugin. Thank you.

• 🌟 Added major new styling capability - New CSS classes for "themeability" - thank you @esm7
  • Providing you with complete CSS styling control of your tasks in query blocks and in Reading mode
  • Coming soon: Find more snippets online!
    • We invite Tasks users who create their own Obsidian CSS snippets to share them in the “Show and tell” Discussions category
    • Help inspire others and allow them to use and learn from your CSS and design skills.
    • 🙏 Thank you in advance!
  • 📖 Docs
    • Note: If you find a previous CSS snippet for Tasks now longer works, see Appendix: Fixing CSS pre-existing snippets for Tasks 3.0.0
• 💪 Fixed: 'group by filename' links now work on filenames with underscores - thank you @ilandikov
• 💪 Fixed: Tasks query blocks now render correctly in Canvas cards, in Obsidian 1.2.0 Insider and newer - thank you, Obsidian development team! (See #1732)

🎉 A few example CSS snippets 🎉

See the comprehensive styling documentation for CSS snippets for all these and many more.

Colour-code your tasks by their Priority:

Colour-code your Due dates - here, whether over-due or due today:

Colour-code specific tags:

Complete example:

The possibilities are limitless!

Full List

🌟 Features

• feat: New CSS classes for "themeability" by @esm7 in #1519
• feat: Add CSS Status Type & Status Name selectors - by @esm7 by @claremacrae in #1817

💪 Fixes

• fix: 'group by filename' links now work on filenames with underscores by @ilandikov in #1805
• fix: Reading mode: nested bullets work in sample grid CSS by @esm7 in #1825

📖 Documentation

• docs, vault: Finalise CSS content for next release by @claremacrae in #1808
• docs: Add screenshots using the CSS snippets by @claremacrae in #1821
• docs: Further refinement of docs for CSS snippets by @claremacrae in #1826
• contrib: Add tips for developing Tasks with WebStorm by @claremacrae in #1823

🛠️ Dependencies

• build(deps-dev): bump async-mutex from 0.3.2 to 0.4.0 by @dependabot in #1100
• chore(deps): Bump json5 from 1.0.1 to 1.0.2 by @dependabot in #1490
• chore(deps-dev): bump prettier-plugin-svelte from 2.7.0 to 2.10.0 by @dependabot in #1790

🛠️ Behind the scenes

• refactor: Make Editor Suggestions more modular by @kedestin in #1773

Full Changelog: 2.0.1...3.0.0

2.0.1 - Speed up drawing of Tasks blocks after 2.0.0 release

What's Changed

• fix: Speed up drawing of Tasks blocks after 2.0.0 release by @claremacrae in #1801
• chore: Add 'donations' link by @claremacrae in #1792
• contrib: Shorter paras in dependencies docs & streamline editing by @claremacrae in #1794
• vault: Update Tasks plugin to 2.0.0 in sample vault by @claremacrae in #1789

Full Changelog: 2.0.0...2.0.1

2.0.0 - Improved date searches, new created field, public API to Edit task modal

⚠️ Version 2.0.0: See notes below to review selected Date Searches

Major improvements to date searches have changed results of some previously misleading searches. Details below.

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

• 🌟 New Roadmap board - currently showing what is work-in-progress.
• 🌟 New Contributing Site - helping developers contribute to the Tasks project.
• 🌟 Added searching of date ranges - thanks @ilandikov
  • Absolute and relative date ranges, for example:
  • done (before, after, in) YYYY-MM-DD YYYY-MM-DD
  • done (before, after, in) (last, this, next) (week, month, quarter, year)
  • Docs
  • ⚠️ Important: some date search results now give different, improved results
    • Review the comprehensive list of changes in date search results to decide if you need to update any of your existing tasks searches.
• 🌟 Added new optional created field added - thanks @vanadium23
  • - [ ] take out the trash ➕ 2021-04-09
  • Enable it in settings
  • then it's added automatically by:
    • ‘Create or edit Task’ Modal, when it creates a brand new task
    • and when you complete a recurring task
  • It already supports filtering, sorting and grouping
  • Docs - for the field
  • Docs - for searching
• 🌟 Added new tag filters - thanks @ilandikov
  • has tags
  • no tags
  • Docs
• 🌟 Added new public API to retrieve markdown string for a new task via the 'Add or edit task' modal - thanks @3bit
  • Authors of other plugins can now use the Tasks modal to prompt users for data for a new task
  • Feedback appreciated on this feature!
  • Docs show how to use this from the QuickAdd plugin to automatically add tasks to a specific file.
• 💪 Fixed some bugs which caused toggling of tasks in Reading view to sometimes write the updated task on the wrong line - thanks @BluBloos for getting this started
• 💪 Fixed rendering of Tasks query blocks in Obsidian Canvas - thanks @ilandikov (and to @gypsyav for reporting the problem)
• 💪 Fixed 'short mode' tooltip hiding task data - thanks @HynDuf

Full List

🌟 Features

• feat: Teach DateParser to read date ranges by @claremacrae in #1683
• feat: Add visual debugging aids for Tasks developers by @claremacrae in #1695
• feat: Show notice if there's a problem toggling task by @claremacrae in #1697
• feat: add created date to task by @vanadium23 in #1723
• feat: Add searches on date ranges by @ilandikov in #1734
• feat: Add filter, group and sorting for created date by @vanadium23 in #1744
• feat: Add created date to EditTask modal by @vanadium23 in #1745
• feat: Add public API to retrieve markdown string for a new task via the Task UI by @3bit in #1736
• feat: Add filters for tag presence and absence by @ilandikov in #1749
• feat: ‘Create or edit Task’ Modal usability improvements by @3bit in #1762

💪 Fixes

• fix: Prevent rare overwrite of wrong line in Reading mode & results blocks by @BluBloos in #1663
• fix: Prevent reading stale file data when replacing task by @BluBloos in #1672
• fix: Simplify cursor repositioning during the 'ToggleDone' command by @kedestin in #1712
• fix: render Tasks in canvas by @ilandikov in #1733
• fix: Tooltip pop up above the description of task in short mode by @HynDuf in #1735
• fix: Prevent exception if toggling in unsaved file in Reading mode by @claremacrae in #1772
• fix: Major improvements to toggling tasks in Reading view by @claremacrae in #1780

📖 Documentation

• docs: Finalise docs for 'created date' by @claremacrae in #1750
• docs: Add more info to API docs by @claremacrae in #1752
• docs: Fix a broken link I created in #1752 by @claremacrae in #1753
• docs: Adopt 'absolute' & 'relative' dates instead of 'formal & natural language' by @claremacrae in #1754
• docs: add date range examples by @ilandikov in #1755
• docs: Update description field docs for #1762 improvements by @claremacrae in #1781
• docs: Add appendix showing date filter changes by @claremacrae in #1784
• docs: Bump the next version to 2.0.0 by @claremacrae in #1785
• docs: Bump the next version to 2.0.0 in more docs files by @claremacrae in #1787
• vault: Update plugins: Tasks, dataview and Style Settings by @claremacrae in #1678
• vault: Enable detailed manual testing of toggling by @claremacrae in #1702

🛠️ Behind the scenes

• chore: Configure jest to work with Svelte components. by @3bit in #1757
• chore: Introduce 'contrib' Conventional Commit prefix for contributing docs by @claremacrae in #1775
• contrib: update CONTRIBUTING.md for improved codebase navigation by @BluBloos in #1654
• contrib: Migrate CONTRIBUTING & related to Obsidian Publish by @claremacrae in #1709
• contrib: Update all references to CONTRIBUTING.md by @claremacrae in #1710
• contrib: contributing: add 'Useful links', rename FAQs & more by @claremacrae in #1714
• contrib: Add several new pages on starting writing tests by @claremacrae in #1725
• contrib: Status change docs more readable and include modal by @claremacrae in #1776
• refactor: DateField, HappensDateField and approval tests on DueDateField by @ilandikov in #1665
• refactor: Refactor filtering in DateField and HappensDateField classes by @ilandikov in #1670
• refactor: regexp code in DateField and inherited classes by @ilandikov in #1671
• refactor: Add TaskLocation to encapsulate position data by @claremacrae in #1698
• refactor: Store task line numbers by @claremacrae in #1700
• refactor: Make Task reading and writing more modular by @kedestin in #1728
• refactor: More logical order of default settings values by @claremacrae in #1782
• test: Enable CustomMatchersForFilters without imports by @claremacrae in #1676
• test: Fix assertions in Task tests & fix tests; thanks SonarLint by @claremacrae in #1724
• test: Create mock tests for File.replaceTaskWithTasks() by @claremacrae in #1771

---

New Contributors

• @kedestin made their first contribution in #1712
• @vanadium23 made their first contribution in #1723
• @HynDuf made their first contribution in https://github.com/obsidian-tasks-group/obsidian-task...

1.25.0 - Safer editing in Edit task dialog

What's Changed

🌟 Features

• feat: Add validation to edit tasks modal by @BluBloos in #1648

Invalid values are shown in red, and you can't save the changes until they are fixed:

🛠️ Behind the scenes

• refactor: Remove repetition in Task modal by @claremacrae in #1645

New Contributors

• @BluBloos made their first contribution in #1648

Full Changelog: 1.24.0...1.25.0

1.24.0 - Statuses for more Themes!

What's Changed

Dependencies have been updated. Please restart Obsidian after updating the plugin. Thank you.

Full List

🌟 Features

• feat: One-click support for Things & Aura themes by @claremacrae in #1603
• feat: Add one-click support for Ebullientworks theme by @claremacrae in #1607
• feat: Add one-click support for AnuPpuccin theme by @claremacrae in #1610
• feat: Clarify theme buttons in status settings by @claremacrae in #1609

Improved readability in status settings

💪 Fixes

• fix: imported CANCELLED tasks now toggle to TODO by @claremacrae in #1608
• fix: typo in Custom Statuses screenshot image (issue #1600)

📖 Documentation

• docs: Update screenshots and docs for new themes and bug fixes by @claremacrae in #1611
• vault: Update Tasks plugin to "1.23.0" (from "1.19.0") by @claremacrae in #1588
• vault: Update data.json to 1.23.0 format by @claremacrae in #1593

🛠️ Behind the scenes

• refactor: Reduce cyclic dependencies by @claremacrae in #1592
• chore: Improve internal validation of theme status collections by @claremacrae in #1606

Full Changelog: 1.23.0...1.24.0

1.23.0 - Custom Statuses!

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

🌟 Major new feature: Custom Task Statuses

New search instructions:

status.name
status.type

Docs

• Statuses
• Style custom statuses
• Set up custom statuses
• Status Collections

Credit: Sytone and the 'Tasks SQL Powered' plugin

This plugin's implementation of reading, searching and editing custom statuses was entirely made possible by the work of @sytone and his fork of Tasks called 'Tasks SQL Powered'. ¹

Where code in Tasks has been copied from 'Tasks SQL Powered', Sytone has been specifically credited as a co-author, that is, joint author, and these commits can be seen on the GitHub site: Commits "Co-Authored-By: Sytone".

Subsequently, the custom statuses implementation in Tasks has diverged from the 'Tasks SQL Powered' significantly. However, none of the new features and fixes would have been possible without Sytone's foundation work, for which we are very grateful.

Full List

🌟 Features

• feat: Add & document 'In Progress' + 'Cancelled' by @claremacrae in #1460
• feat: ‘Create or edit Task’ modal supports custom task statuses by @claremacrae in #1463
• feat: adopt tasks-x's JSON settings facility by @claremacrae in #1465
• feat: Enable adding & editing of custom statuses by @claremacrae in #1467
• feat: Show core statuses, read-only by @claremacrae in #1482
• feat: Add status.name text search by @claremacrae in #1513
• feat: Add 'sort by status.name' by @claremacrae in #1518
• feat: Add status categories/types to eventually control behaviour by @claremacrae in #1538
• feat: update 'done' and 'not done' for new status types by @claremacrae in #1542
• feat: Bulk add and remove statuses by @claremacrae in #1544
• feat: Add 'status.type' filter and 'sort by status.type' by @claremacrae in #1547
• feat: Add 'group by status.name' by @claremacrae in #1550
• feat: Add 'group by status.type' by @claremacrae in #1553
• feat: Nicer syntax and better help for 'status.type' by @claremacrae in #1555
• feat: Add ability to edit core statuses by @claremacrae in #1567
• feat: Move '-' and '/' to custom statuses by @claremacrae in #1569
• feat: Make statuses more readable in settings by @claremacrae in #1571

💪 Fixes

• fix: Fix an unreleased error in StatusRegistry by @claremacrae in #1455
• fix: sort group & filter by status now match 1.22.0 by @claremacrae in #1459
• fix: Address minor usability issues when editing status by @claremacrae in #1464
• fix: Hide UI for status commands by @claremacrae in #1491
• fix: Status changes now applied immediately! by @claremacrae in #1496
• fix: toggling to unknown status now gives valid task by @claremacrae in #1504
• fix: No longer accept 'status-name' and similar instead of 'status.name' by @claremacrae in #1517
• fix: 'sort by status.name' was treated as 'sort by status' in queries by @claremacrae in #1520
• fix: Prevent Tasks getting stuck 'Loading Tasks...' by @claremacrae in #1524
• fix: Fix edit status error validation by @claremacrae in #1526
• fix: Improve wording & fix styling in status settings by @claremacrae in #1529
• fix: with global filter, the modal was losing custom status symbols by @claremacrae in #1533
• fix: reading of status settings now works again by @claremacrae in #1536
• fix: unchecked tasks are now correct in Reading view by @claremacrae in #1541
• fix: 'Add All Unknown Status Types' was creating duplicates by @claremacrae in #1545
• fix: Correct several bugs in next status with recurrence by @claremacrae in #1554
• fix: 'sort by status.type' now puts most actionable tasks first by @claremacrae in #1556
• fix: Remove verbose console debug output by @claremacrae in #1557
• fix: Make NON_TASK statuses match 'done' by @claremacrae in #1563

📖 Documentation

• docs: Start documenting custom statuses by @claremacrae in #1457
• docs: Improve README.md, for new users and devs by @claremacrae in #1469
• docs: Add 'Find tasks with potentially invalid data' by @claremacrae in #1506
• docs: Partial documentation for custom statuses by @claremacrae in #1510
• docs: Add info and warnings about custom status feature by @claremacrae in #1511
• docs: Improve tables of content and version banners by @claremacrae in #1514
• docs: Start documenting status types by @claremacrae in #1540
• docs: Update screenshots for custom status docs by @claremacrae in #1546
• docs: New Reference section, about supported themes by @claremacrae in #1577
• docs, fix: Finalise Statuses docs & UI by @claremacrae in #1584
• vault: Update Tasks-Demo vault for testing custom status by @claremacrae in #1452
• vault: Add and update custom checkbox info by @claremacrae in #1575

🛠️ Behind the scenes

• chore: New GitHub Action: 'Verify Build on Windows' by @claremacrae in #1516
• chore: Add stress_test_obsidian_tasks.py by @claremacrae in #1523
• chore: Update author list in main.js to match community store by @claremacrae in #1560
• refactor: Move Status class out to its own file by @claremacrae in #1450
• refactor: Add StatusConfiguration & Status from obsidian-tasks-x by @claremacrae in #1451
• refactor: Partial adoption of StatusRegistry from obsidian-tasks-x by @claremacrae in #1453
• refactor: Update 'Toggle task done' command to use StatusRegistry by @claremacrae in #1454
• refactor: remove originalStatusCharacter from Task and TaskBuilder by @claremacrae in #1456
• refactor: Divide up status settings code by @claremacrae in #1473
• refactor: Extract function createRowFor...

1. 'Tasks SQL Powered' as of revision 2c0b659 on 2 August 2022 ↩