7.11.1: Improve usability and layout of Settings

What's Changed

Please quit and restart Obsidian after updating the plugin. Thank you.

• fix: Improve usability of Tasks Settings by @claremacrae in #3113
  • Thanks to @pjkaufman and @mnaoumov for ideas that helped with this.
• fix: Restore 'collapsed' state of Status setting sections by @claremacrae in #3114

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

• 7.11.0...7.11.1

🙏 Support Tasks development

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

Full Changelog: 7.11.0...7.11.1

7.11.0: Random sorting with 'sort by random'

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

🌟 Features

Add random sorting, with sort by random by @claremacrae and @qelo in #3110

Example search:

```tasks
not done
no happens date
limit 10

sort by random
```

Learn more in the documentation: Random sorting

🛠️ Behind the scenes

• refactor: test QueryResultsRenderer rendering of descriptions by @ilandikov and @claremacrae in #3109

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

• 7.10.2...7.11.0

🙏 Support Tasks development

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

7.10.2: Edit Task modal retains all Cancelled date edits; improve `group by status` & `sort by status`

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

💪 Fixes

• fix: Edit Task modal now retains edits to Cancelled date by @claremacrae in #3099
• fix: Improve usefulness of 'group by status' and 'sort by status' by @claremacrae in #3101

🛠️ Behind the scenes

• refactor: Replace Status factory functions with static objects by @ilandikov in #3093

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

• 7.10.1...7.10.2

🙏 Support Tasks development

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

7.10.1: Fixes to error messages, Postpone and Edit Task modal

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

💪 Fixes

• fix: Make 'filter by function' show statement in error messages by @claremacrae in #3075
• fix: Postpone puts a checkmark on menu item with currently selected date by @ilandikov in #3073
• fix: postpone to current date keeps postpone button active by @ilandikov in #3076
• fix: retain manually added Done & Cancelled dates in modal by @ilandikov in #3087

🛠️ Dependencies

• chore(deps-dev): bump builtin-modules from 3.3.0 to 4.0.0 [reverted] by @dependabot in #2957
• build(deps): bump requirejs from 2.3.6 to 2.3.7 by @dependabot in #3006
• chore(deps-dev): bump ts-jest from 29.1.1 to 29.2.5 by @dependabot in #3050
• chore(deps-dev): bump @testing-library/jest-dom from 6.1.6 to 6.5.0 by @dependabot in #3054

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

• 7.10.0...7.10.1

🙏 Support Tasks development

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

7.10.0: Faster start-up, especially on mobile - and right-click on dates to edit

What's Changed

Please quit and restart Obsidian after updating the plugin. Thank you.

Here are the most notable user-visible changes.

🌟 Features

Add date context menu in Reading mode and Tasks Query results by @claremacrae in #3045

• Right-click on any date value - in Reading mode and Tasks query results - to make some common edits, similar to the Postpone menu, but you control which field is edited.
• Note: this feature is not yet documented, in order to allow the following bug-fix to be released.

💪 Fixes

Load cache when workspace is ready by @rxkris in #3060

• This significantly speeds up Tasks start-up time, especially on mobile.

🛠️ Behind the scenes

Improvements made to new features prior to their release:

• feat: Add date picker in Reading mode and Tasks Query results by @claremacrae in #3038
• feat: Add a date picker to the Edit Task modal by @claremacrae in #3052
• fix: Improve Edit Task modal calendar 'button' layout by @claremacrae in #3058
• fix: Improve Edit Task modal calendar button behaviour by @claremacrae in #3059
• vault: Add date picker smoke tests & fix GitHub-created sample vault by @claremacrae in #3064
• fix: remove datepicker pending usability fixes by @ilandikov and @claremacrae in #3067

Other changes:

• refactor: test QueryResultsRenderer by @ilandikov in #3040

New Contributors

• @rxkris made their first contribution in #3060

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

• 7.9.0...7.10.0

🙏 Support Tasks development

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

7.9.0: hide & show 'on completion' fields; one-click support for Border theme

What's Changed

Please quit and restart Obsidian after updating the plugin. Thank you.

🌟 Features

• Add hide on completion and show on completion by @claremacrae in #3033
  • Documentation: Layout.
• Add one-click support for the Border theme by @claremacrae in #3036
  • Documentation: Border Theme.

🛠️ Behind the scenes

• chore: Fix cloning on Windows by @claremacrae in #3029
• refactor: Introduce 'DateTime/' sub-directories in 'src/' and 'tests/' by @claremacrae in #3037

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

• 7.8.0...7.9.0

🙏 Support Tasks development

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

7.8.0: New "On Completion" feature, and small Auto Suggest fixes

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

Main changes

Here are the most notable user-visible changes.

🌟 "On Completion" action

Tip

If you have ever wished that Tasks would automatically do something with the tasks that you complete (especially likely if you use recurring tasks, which tend to accumulate within the note that holds them), then the new "On Completion" feature could be the answer!

Here's what it looks like:

- [ ] Leave me alone
- [ ] Leave me alone too! 🏁 keep
- [ ] Delete me upon completion 🏁 delete
- [ ] Delete my completed instance  📅 2024-08-12 🔁 every day 🏁 delete

See the documentation for more info.

• New "On Completion" field with support for Delete automatic action by @therden in #2840
• Add 'keep' option to "On Completion" by @claremacrae in #3016
• Teach Auto Suggest to support "On Completion" by @claremacrae in #3028

💪 Fixes

• Render numbered sub-tasks and list items in Reading view by @claremacrae in #3012
• Various improvements to cursor positions in Auto-Suggest by @claremacrae in #3020
• Better dataview space & cursor in date Auto-Suggest by @claremacrae in #3025

🛠️ Behind the scenes

Improvements made to new features prior to their release:

• refactor: Small improvements to the 'On Completion' implementation by @claremacrae in #3010
• refactor: Refactor On Completion code and tests by @claremacrae in #3015
• refactor: introduce parameter object to functions in Suggestor.ts by @claremacrae in #3022
• refactor: Make the Auto Suggest code a bit easier to maintain by @claremacrae in #3023

Other changes:

• fix: collect root ListItems by @ilandikov in #3008
• refactor: add QueryResultsRenderer class by @ilandikov in #3018
• refactor: remove QueryResultsRenderer inheritance by @ilandikov in #3027

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

• 7.7.0...7.8.0

🙏 Support Tasks development

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

7.7.0: Filter, sort and group by Obsidian Properties (aka YAML or frontmatter)

What's Changed

🌟 Filter, sort and group by Obsidian Properties, also known as Frontmatter or YAML

Find tasks in Kanban plugin files:

filter by function task.file.hasProperty('kanban-plugin')

Find tasks in files with value project/project-1 in the tags property:

filter by function task.file.property('tags').includes('#project/project-1')

For details and more examples, see the Obsidian Properties documentation page.

Other notable changes

📖 Documentation

• docs: Simplify the top level of documentation by @claremacrae with @aubreyz in #2995
• contrib: add documentation on testing code that uses Obsidian API by @ilandikov in #2976

🛠️ Behind the scenes

Improvements made to new features prior to their release:

• refactor: move TasksFile object to TaskLocation by @claremacrae in #2959
• fix: Prevent task.frontmatter.tags being null if no frontmatter by @claremacrae in #2974
  • Do not use this value - it is undocumented, and will change or be removed in a future release.
• test: demo property custom searches by @ilandikov with @claremacrae in #2981
• feat: releasable code for accessing properties via task.file by @ilandikov with @claremacrae in #2991
• docs: Start documenting access to obsidian properties. by @claremacrae in #2997
• docs: Update snippet in markdown by @github-actions in #2998
• docs: more work on properties documentation by @claremacrae in #3001
• fix: Editing properties/frontmatter now updates Query results by @claremacrae in #3003
• fix: Tasks in renamed files forgot about any properties/frontmatter values in the file by @claremacrae with @ilandikov in #3005

Other changes:

• chore: Add Ilyas Landikov as co-author of Tasks by @claremacrae in #2973
• refactor: remove nesting in Recurrence.next() by @ilandikov in #2970
• refactor: extract nextOccurrence() method and reuse it by @ilandikov in #2975
• refactor: create Occurrence class by @ilandikov in #2978
• refactor: move behaviour from Recurrence to Occurrence methods isIdenticalTo() and getReferenceDate() by @ilandikov in #2979
• refactor: move referenceDate field to Occurrence class by @ilandikov in #2980
• refactor: create nextOccurrence and nextOccurrenceDate methods in Occurrence by @ilandikov in #2983
• refactor: move Occurrence class separate to a separate file and minor improvements by @ilandikov in #2985
• refactor: simplify Task.handleNewStatus() by @ilandikov in #2992

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

• 7.6.1...7.7.0

🙏 Support Tasks development

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

7.6.1: Tasks searches now work with Tabs plugin!

What's Changed

Please quit and restart Obsidian after updating the plugin. Thank you.

Here are the most notable user-visible changes.

💪 Fixes

• fix: Tasks search results now render correctly in Tabs plugin by @claremacrae in #2945 - thanks to @xhuajin for reporting the issue and finding the fix.

Tasks can now be used in the Tabs plugin!

For example:

````tabs

tab: Todo

```tasks
folder includes Obsidian
not done
```

tab: Done

```tasks
folder includes Obsidian
done today
```

````

Might give:

📖 Documentation

• docs: fixed a minor typo by @WhoAmI-WhereAmI in #2928
• docs: Fix first task example in Getting Started by @luxedo in #2948

🛠️ Dependencies

• build(deps): bump boon-js from 2.0.4 to 2.0.5 by @dependabot in #2427
• build(deps-dev): bump eslint from 8.54.0 to 8.57.0 by @dependabot in #2902
• chore(deps): bump ws from 8.14.2 to 8.17.1 by @dependabot in #2906
• chore(deps): bump braces from 3.0.2 to 3.0.3 by @dependabot in #2907
• chore(deps-dev): bump @evilmartians/lefthook from 1.5.2 to 1.7.2 by @dependabot in #2952
• chore(deps-dev): bump markdownlint-cli2 from 0.8.1 to 0.13.0 by @dependabot in #2747
• chore(deps-dev): bump svelte-check from 3.6.0 to 3.8.4 by @dependabot in #2927

🛠️ Behind the scenes

Improvements made to new features prior to their release:

CAUTION! Do not use these - they are subject to significant changes prior to their eventual release. Thank you.

• feat: Experimental access to raw frontmatter in query.file & task.file by @claremacrae in #2940
• feat: improve access to tags by @ilandikov in #2949
• fix: Prevent task.frontmatter.tags being null if no tags in frontmatter by @claremacrae in #2951

New Contributors

• @WhoAmI-WhereAmI made their first contribution in #2928
• @luxedo made their first contribution in #2948

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

• 7.6.0...7.6.1

🙏 Support Tasks development

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

7.6.0: New setting for format in file names; fix 'done date' if 'when done' reached invalid date

What's Changed

🌟 Most Notable

Please quit and restart Obsidian after updating the plugin. Thank you.

• feat: New setting to recognise dates format in file names by @j0rdanba1n in #2874
  • help: Additional date format
  • implements #1369
• fix: recurrence with 'when done' could give wrong 'done' date by @claremacrae in #2919
  • fixes #2867
• docs: Update the docs for Obsidian 1.6.5 release by @claremacrae in #2917
• test: ensure dates reset by @ilandikov in #2924

New Contributors

• @j0rdanba1n made their first contribution in #2874

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

• 7.5.0...7.6.0

🙏 Support Tasks development

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