1.19.0 - New 'explain' instruction

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

• Added explain instruction
  • See how Tasks interprets your queries.
  • No more guessing what next monday or due before in 7 days actually means!
  • Docs

Example result:

Full List

🌟 Features

• feat: Add 'explain' instruction, to visualise tasks block filters by @claremacrae in #1241
• feat: finish explain instruction: better output and added docs by @claremacrae in #1350

📖 Documentation

• docs: Remove obsolete warning from regex docs - tags now supported by @claremacrae in #1311
• docs: README now uses images in docs/images by @claremacrae in #1313
• docs: How to download Tasks-Demo vault with plugin build installed by @claremacrae in #1331
• docs: Add row headings to divide up Quick Reference page by @claremacrae in #1337
• docs: Add "Text filters" section, including how quotes are used by @claremacrae in #1338
• docs: Document using regex to find empty fields by @claremacrae in #1340
• docs: Prevent 2 lines running together in the published docs. by @claremacrae in #1352
• vault: Demo using dataview to get tasks in files with a tag by @claremacrae in #1342

🛠️ Behind the scenes

• chore: Make issue templates less shouty by @claremacrae in #1312
• chore: Document developer steps to add a new task filter by @claremacrae in #1314
• chore: Document developer steps to add a new field to Task by @claremacrae in #1315
• chore: Update all jest dependencies to current version. by @claremacrae in #1329
• chore: Update release steps, for changes made in #1194 - and more detail by @claremacrae in #1332
• test,chore: Add Approval Tests, as an alternative to Jest snapshots by @claremacrae in #1330

What's Changed

Full Changelog: 1.18.1...1.19.0

1.18.1

What's Changed

• fix: Editing via Pencil icon can now change scheduled dates based on date in file-name in #1309 - fixes #1300. Thanks @mvdkwast!

Full Changelog: 1.18.0...1.18.1

1.18.0

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

• Added : Optionally use first date in filename as scheduled date (thank you @mvdkwast)
  • Docs
    
• Fixed: Settings for the Global Filter are much clearer
• Fixed: Settings layout easier to understand
• Fixed: Much easier for contributors to update images in the user guide

Full List

🌟 Features

• feat: optionally use first date in filename as scheduled date by @mvdkwast in #1258

💪 Fixes

• fix: Clarify global filter in Settings user interface by @claremacrae in #1296
• ui: Group related settings together, with headings by @claremacrae in #1284

📖 Documentation

• docs: Minor improvements to the documentation for date fallback by @claremacrae in #1285
• docs: Enable images in docs to be tested locally by @claremacrae in #1290
• docs: Add screenshot to docs of global filter by @claremacrae in #1297
• ui, docs: Finalise 'Use Filename as Default Date' docs & settings by @claremacrae in #1298

🛠️ Behind the scenes

• chore: Add 'Feature Request' issue form by @claremacrae in #1292
• chore: Clearer steps for searching for duplicate issues by @claremacrae in #1293
• chore: more improvements to feedback forms and docs by @claremacrae in #1295

New Contributors

• @mvdkwast made their first contribution in #1258

Full Changelog: 1.17.0...1.18.0

1.17.0 - Streamlined "Create or edit Task" dialog

What's Changed

🌟 Most Notable

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

• Major improvements to layout of "Create or edit Task" dialog - thank you @Cito!
  • Layout is much clearer and uses space better
  • For small screen sizes, the layout automatically switches back to a single column.
  • The "Apply" button is larger and there is now a "Cancel" button.
    • This makes the apply button a bit easier to click or tap
  • Access keys (shortcuts) added to all the fields of the form (Alt-Key on Windows, Ctrl-Option+Key on Mac). The access keys are displayed as the underlined letters of the labels.
    • These can be turned off in settings, if they interfere with screen-readers or the OS's default short cuts.
  • Docs

The new dialog layout:

How to turn off the access keys in settings:

Full List

🌟 Features

• feat: More clearly arranged layout of the task edit dialog by @Cito in #1266
• feat: Add a setting to switch the access keys off by @Cito in #1277

📖 Documentation

• docs: Better cross-linking of info on priority by @claremacrae in #1264
• docs: Update ‘Create or edit Task’ docs for new layout by @claremacrae in #1283

🛠️ Behind the scenes

• chore: How to add Table of Contents to published docs by @claremacrae in #1265

Full Changelog: 1.16.0...1.17.0

1.16.0 - finding invalid dates & easier priority editing

What's Changed

🌟 Most Notable

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

• Added 4 instructions for finding any tasks with invalid dates
  • done date is invalid
  • due date is invalid
  • scheduled date is invalid
  • start date is invalid
  • Docs
• Added easier selection of priority when editing Tasks (Thanks @Cito)
  • Docs
• Fixed: Redraw Tasks results when dates change from valid to invalid

Full List

🌟 Features

• feat: Add 4 instructions: '(done|due|date|start) date is invalid' by @claremacrae in #1228
• feat: Faster controls to replace the priority selector by @Cito in #1229

💪 Fixes

• fix: Redraw Tasks results when dates change from valid to invalid by @claremacrae in #1232

📖 Documentation

• docs: Document iPhone scrollbar issue in Create/edit task. by @claremacrae in #1239
• docs: Use hyphen for unordered lists by @claremacrae in #1247
• docs: Add 'How to show tasks in a calendar' page. by @claremacrae in #1251
• docs: Document new priority control by @claremacrae in #1261
• docs: Improve docs on finding invalid dates by @claremacrae in #1263
• vault: Add new page Manual Testing/Invalid Dates.md to experiment with invalid dates

🛠️ Behind the scenes

• chore: Remove CRLF EOLs & add more file types to .gitattributes by @claremacrae in #1246
• chore: Use mdsnippets to add table of content to contributor docs by @claremacrae in #1248
• chore: Document screenshot and ToC creation in developer docs by @claremacrae in #1256
• chore: add 'Linking to other pages in the docs' section by @claremacrae in #1262
• refactor: Store original Markdown line in Task, where possible by @claremacrae in #1217
• refactor: Rename Filter type to FilterFunction by @claremacrae in #1221
• refactor: Reimplement FilterOrErrorMessage using new Filter class by @claremacrae in #1222
• refactor: Query now stores Filter instead of FilterFunction by @claremacrae in #1223
• refactor: BooleanField now stores Filter instead of FilterFunction by @claremacrae in #1224
• refactor: Add instruction field to Filter & FilterOrErrorMessage by @claremacrae in #1225
• refactor: Re-implement date presence & absence with FilterInstructions by @claremacrae in #1226

Full Changelog: 1.15.1...1.16.0

1.15.1: Improve next-date for monthly & yearly recurring tasks

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

💪 Fixed: Improve next-date calculation for monthly and yearly recurring tasks, to prevent skipping months in years in many cases

• Previously: When a recurrence rule stated "every month" and the next month did not have the day of the month that the task is scheduled, that month was skipped and the next valid month was used instead.
  • For example: When I marked a task that recurs "every month" done on January 31, the next occurrence would be scheduled on March 31, since February does not have 31 days. This is in line with the rrule specification, but not what users expect. This could be triggered by accident, for example when the task is based on the done date and the done date is on the 31st.
• Now: To fix the issue, the number of expected skipped months is parsed (defaults to one). So long as the actual number of skipped months is higher, the base date is adjusted one day into the past. In practice, this means that the example from above would now schedule the recurring task on the 28th of February (or the 29th for a leap year).
• The same applies for yearly recurrences, for example based on the 29th of February.
• Full details in major new section of the documentation: How the New Date is Calculated: Repeating Monthly

Full List

💪 Fixes

• fix: Improve next-date calculation for monthly and yearly recurring tasks by @schemar in #1197

📖 Documentation

• docs: Note release version of 'Only future dates' by @claremacrae in #1195
• vault: Update .gitignore for Obsidian 0.16.x changes (3f48c98)
• vault: Update appearance.json for Obsidian 0.16.x changes (2809b30)

Full Changelog: 1.15.0...1.15.1

1.15.0 - 'Only future dates' checkbox in Task editor

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

• Add 'Only future dates' checkbox to Task editor (Thanks @Cito)
  • The 'Create or edit Task' modal has always interpreted relative dates as being in the future, because that is usually what is wanted.
  • You can now change this behavior by unchecking “Only future dates” if you want to enter an overdue task or experiment with the way that relative dates in the past would be interpreted in queries.
  • Docs

Full List

🌟 Features

• feat: Add 'Only future dates' checkbox to Task editor by @Cito in #1183
• ui: Add dividers between date groups in Create or Edit Task by @claremacrae in #1188

📖 Documentation

• vault: Update Tasks plugin to 1.14.0 by @claremacrae in #1175
• docs: Update 'Create or edit Task modal' screenshot by @claremacrae in #1189

🛠️ Behind the scenes

• chore: Add a new Issue form, 'Internal Issue'. by @claremacrae in #1181
• chore: Add download of Tasks-Demo vault to Verify Commit CI build by @claremacrae in #1193
• chore: Streamline the release process by @claremacrae in #1194

Full Changelog: 1.14.0...1.15.0

1.14.0

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

• Added show urgency. (Thanks @Cito)
  • All the layout options now offer both show and hide.
  • Corresponding CSS Changes:
    • There is a new class tasks-urgency for the span that contains the urgency score.
    • The span for the edit button with the class tasks-edit is no longer inside the span with the span tasks-backlink: instead it is now a sibling.
    • If you styled the edit button with the class .tasks-backlink .tasks-edit, then you should remove the .tasks-backlinkpart, converting to .tasks-edit.
  • Docs
• Fixed: Tasks is now compatible with SlrVb's Alternative Checkboxes (Thanks @SlRvb)

Full List

🌟 Features

• feat: Add option to show urgency. More space before pencil icon. by @Cito in #1139

💪 Fixes

• fix: Support Booleans with single filters surrounded by parentheses by @claremacrae in #1170
• fix: Tasks works with SlrVb's Alternative Checkboxes by @claremacrae in #1174

📖 Documentation

• docs: Add How-to page 'Find tasks for coming 7 days' by @claremacrae in #1132
• docs: Make recurring tasks explanation clearer for 'when done' by @roschlau in #1134

🛠️ Behind the scenes

• refactor: Make tasks src directory structure match tasks-x by @claremacrae in #1118
• refactor: Rename tests/config/ to tests/Config/ by @claremacrae in #1119
• refactor: Rename Events.ts to TasksEvents.ts by @claremacrae in #1121
• refactor: Reformat code to match the format used by tasks-x plugin by @claremacrae in #1122
• refactor: Introduce new class TaskRegularExpressions by @claremacrae in #1123
• refactor: Capitalise the names of values in Status by @claremacrae in #1124
• refactor: Make TagsField a special MultiTextField; rename Field.filterRegexp() by @Cito in #1173
• test: Verify 'group by recurring' instruction works by @claremacrae in #1164
• vault: Update Tasks to 1.13.1 in Tasks-Demo vault by @claremacrae in #1117

New Contributors

• @roschlau made their first contribution in #1134
• @Cito made their first contribution in #1139

Full Changelog: 1.13.1...1.14.0

1.13.1

What's Changed

🌟 Most Notable

Please restart Obsidian after updating the plugin. Thank you.

This is a small release, with a few bug fixes, along with a new internal feature that is not yet connected to any user-visible behaviour.

• Contributors: Please read Reformatting and rearranging Tasks source code - Tuesday 6th September 2022 · #1052

Full List

🌟 Features

• feat: add feature toggle framework by @sytone in #970

💪 Fixes

• fix: Correctly scale the pencil icon for all font sizes by @TheTechnicGuy1 in #1113
• fix: Correct cursor position after 'Toggle task done' command by @AnnaKornfeldSimpson in #1103
• fix: Show any markdown in group headings correctly by @claremacrae in #909

🛠️ Behind the scenes

• chore: Reformat CONTRIBUTING, add dependency upgrade info, fix typos by @AnnaKornfeldSimpson in #1099
• vault: Update Tasks plugin in Tasks-Demo vault to 1.13.0 by @claremacrae in #1110
• test: Add initial tests for 'Toggle task done' command by @claremacrae in #1114

New Contributors

• @TheTechnicGuy1 made their first contribution in #1113

Full Changelog: 1.13.0...1.13.1

1.13.0 - search filenames, and regular expressions in tags

What's Changed

🌟 Most Notable

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

• Added filename instruction
  • Docs
• Added Regular Expressions support to tag /tags searches
  • Docs
  • Search for exact tags:
    • tag regex matches /#t$/
    • tag regex matches /#book$/
• Fixed: Tag include searches now honour any # character
  • In the unlikely event that you have an existing tag/tags query containing a # character that is not required be present in your tasks, please see #1107
• Document dataview support for completion dates. (Thanks @AnnaKornfeldSimpson)
• Document how to get all tasks in the current file
• Contributors: Please read Reformatting and rearranging Tasks source code - Tuesday 6th September 2022 · #1052

Full List

🌟 Features

• feat: Add filename filter by @claremacrae in #1098
• feat: Add regular expression search for tag and tags by @claremacrae in #1109

💪 Fixes

• fix: Make tags searches locale-aware by @claremacrae in #1055
• fix!!: Tag searches now honour any # character by @claremacrae in #1107

📖 Documentation

• docs: Add page on dataview settings for compatibility with Tasks by @AnnaKornfeldSimpson in #1064
• docs: Add image of dataview settings page by @AnnaKornfeldSimpson in #1073
• docs: Add 'How to get tasks in current file' by @claremacrae in #1091
• docs: Make it easier to find and install this plugin by @mpawelski in #1089
• docs: Fix "Toggle checkbox status" command name in README by @Calorion in #1101

🛠️ Dependencies

• build(deps-dev): bump @typescript-eslint/parser from 5.33.1 to 5.34.0 by @dependabot in #1062
• build(deps-dev): bump @typescript-eslint/eslint-plugin from 5.33.1 to 5.34.0 by @dependabot in #1063
• build(deps-dev): bump @types/jest from 28.1.7 to 28.1.8 by @dependabot in #1066
• build(deps-dev): bump @typescript-eslint/parser from 5.34.0 to 5.35.1 by @dependabot in #1069
• build(deps-dev): bump eslint from 8.22.0 to 8.23.0 by @dependabot in #1076
• build(deps-dev): bump esbuild from 0.14.54 to 0.15.6 by @dependabot in #1077
• build(deps-dev): bump @typescript-eslint/eslint-plugin from 5.34.0 to 5.36.1 by @dependabot in #1079
• build(deps-dev): bump svelte-check from 2.8.1 to 2.9.0 by @dependabot in #1081
• build(deps-dev): bump @typescript-eslint/parser from 5.35.1 to 5.36.1 by @dependabot in #1085

🛠️ Behind the scenes

• chore: lefthook was renamed by @AnnaKornfeldSimpson in #1074
• chore: update gitignore, CONTRIBUTING.md by @AnnaKornfeldSimpson in #1065
• refactor: Extract text searching out of TextField by @claremacrae in #1054
• refactor: Tags search now implemented with SubstringMatcher by @claremacrae in #1056
• refactor: Simplify TextField by @claremacrae in #1058
• refactor: Make public some selected methods in Field and derived classes by @claremacrae in #1096
• refactor: Prepare for adding regex searching for tags by @claremacrae in #1108
• test: Simplify the resetting of settings in tests by @claremacrae in #1105

New Contributors

• @mpawelski made their first contribution in #1089
• @Calorion made their first contribution in #1101

Full Changelog: 1.12.0...1.13.0