📒 Templating

Templating Changelog

About Templating Plugin

See Plugin Documentation for details on available commands and use case.

DBW: REMEMBER THAT IF YOU ADDED ANY HELPERS IMPORTS, ADD THEM TO THE HELPER MODULE TO GIVE SCRIPTS ACCESS TO THEM ALSO

[2.2.10] 2026-03-16 @dwertheimer

Fixed

• templateRunner run-from-code when Forms create-new: When called with no template name but args containing newNoteTitle (and optionally non-empty templateBody), processTemplateArguments now sets isRunFromCode = true so the main block runs and the note is created and optionally opened in the editor. Previously only getNoteTitled or non-empty templateBody triggered run-from-code, so Forms create-new with empty templateBody in the first pass never entered the block.
• templateRunner return value when nothing executed: When the main block is not entered (no template name, not run-from-code, no passed template body), templateRunner now returns null instead of falling through to undefined, so callers (e.g. Forms) can treat it as failure and show an error instead of closing the window. Return type updated to Promise<string | void | null>.
• CommandBar.prompt return: When "You must supply a template title" is shown, the function now returns null so the caller does not treat it as success.

Edited in this release

• np.Templating/plugin.json — Version 2.2.10; lastUpdateInfo.
• np.Templating/CHANGELOG.md — This section.
• np.Templating/src/NPTemplateRunner.js — processTemplateArguments: treat args.newNoteTitle (or non-empty args.templateBody) as run-from-code; templateRunnerExecute: return null when main block skipped, and when CommandBar.prompt for missing template title; return type Promise<string | void | null>.

[2.2.9] 2026-01-XX @dwertheimer

• Add new hidden command getRenderContext for use by other plugins (e.g., Forms plugin)
  • Returns the full templating render context object with all globals, modules, and helpers (date, time, note, tasks, moment, etc.)
  • Includes timing logs for performance monitoring (setup, config, engine creation, context building, total time)
  • Allows other plugins to reuse templating context without duplicating code
  • Accessible via DataStore.invokePluginCommandByName('getRenderContext', 'np.Templating', [userData])
• Comprehensive template search refactoring - Expand template search functions to search in both @templates and @Forms directories across all spaces
  • New shared utility: Created getTemplateFolderPrefixes() function that builds complete list of folder prefixes including:
    • Private root folders: @Templates and @Forms (or localized equivalents)
    • All teamspace root folders: %%NotePlanCloud%%/<teamspaceID>/@Templates and %%NotePlanCloud%%/<teamspaceID>/@Forms
  • Core template search functions updated:
    • getFilteredTemplateList - Now searches in both private root and all teamspace root folders
    • getTemplateNote - Now searches all teamspaces, not just private root
    • getFilenameFromTemplate - Filters notes from all template folders in all spaces
    • getTemplateContent - Searches in all template folders when finding templates
    • templateExists - Searches in all template folders (Templates, Forms, all spaces)
  • User-facing commands updated:
    • templateInsert and templateAppend - Now use getTemplateNote (searches all folders/spaces)
    • <current> prompt validation - Now checks if note is in any template folder (not just @templates)
    • addFrontmatterToTemplate (NPTemplateRunner) - Now uses getTemplateNote
    • chooseTemplate - Now uses chooseNoteV2 for decorated note selection UI (shows icons, colors, folder paths)
      • Automatically displays templates from both @templates and @Forms directories across all spaces
      • No longer limited to just @templates folder in display logic
      • Improved user experience with visual decorations and better folder path display
  • Localization support:
    • All functions now use DataStore.preference('templateFolder') for localized template folder names instead of hardcoded '@templates'
    • All functions now use DataStore.preference('formsFolder') for localized forms folder names (with '@Forms' fallback)
  • Bug fixes:
    • Fixes issue where form processing templates stored in @Forms weren't found by templateRunner and getTemplateNote when processing form submissions
    • Fixes issue where templates in teamspaces weren't found by template search functions
  • Impact: Templates can now be stored in @Forms directory (for form processing) or @templates directory (for regular templates), in both private root and teamspace root folders, and all search functions will find them correctly
• Replace chooseNote/chooseOption with chooseNoteV2 throughout np.Templating - Modernize all note selection UI
  • All functions updated to use chooseNoteV2:
    • handleNoteSelection in NPTemplateRunner.js - Replaced deprecated chooseNote with chooseNoteV2
      • Uses DataStore.projectNotes which automatically includes notes from all spaces (private and teamspaces)
      • When templates use <choose> or <select> placeholders, users now see decorated note selection UI
    • chooseTemplate in templateManager.js - Replaced chooseOption with chooseNoteV2
      • Templates from both @templates and @Forms directories (across all spaces) are properly displayed with full paths
      • Removed complex label manipulation code that only handled @templates folder
    • getTemplateContent in templateManager.js - Replaced chooseOption with chooseNoteV2
      • When multiple templates match the same name, user selection now shows decorated UI with folder paths
      • Templates from all template folders (Templates, Forms, all teamspaces) are included in selection
  • Benefits:
    • Better UI with decorated options showing icons, colors, and folder paths
    • All note selection now searches across all spaces (private root and all teamspace root folders)
    • Consistent user experience across all template selection functions
    • Visual distinction between templates in different folders and spaces
  • Backward compatibility: chooseNote is still available in templates via helpers.chooseNote for backward compatibility, but helpers.chooseNoteV2 is recommended for new templates
  • Testing: Updated all test mocks to use chooseNoteV2 and added DataStore.preference mocks for template folder localization

[2.2.8] 2026-01-XX @dwertheimer

• Add triggerTemplateRunner command to automatically run templates when notes are opened
• New hidden command triggerTemplateRunner checks for runTemplateOnOpen frontmatter attribute
• When a note with runTemplateOnOpen is opened, the specified template is automatically executed
• Use triggers: onOpen => np.Templating.triggerTemplateRunner in note frontmatter to enable this feature
• Similar to Forms plugin's triggerOpenForm functionality, but for template execution
• Example use case: Automatically update age calculations or other dynamic content when a note is opened

[2.2.7] 2026-01-05 @dwertheimer

• templateRunnerExecute now returns AI analysis errors from all code paths
• Modified templateRunnerExecute to return Promise<string | void> instead of Promise
• Added hasAiAnalysisError helper function to detect AI analysis error marker
• Updated all handler functions (handleCurrentNote, handleRegularNote, handleTodayNote, handleWeeklyNote) to return errors
• Updated handleNewNoteCreation to return rendered content if it contains AI analysis error
• All early return paths in templateRunnerExecute now check for and return AI analysis errors
• This allows Forms plugin to capture and display template rendering errors to users

[2.2.6] 2026-01-04 @dwertheimer

• Fix allowCreate parameter parsing for promptMention and promptTag prompts: The allowCreate parameter (4th parameter) was not being parsed correctly from template tags, preventing the "➕ Add new [item]" option from appearing in selection dialogs. This fix:
  • Improved parameter parsing to handle both quoted strings ('true') and unquoted boolean literals (true)
  • Fixed regex pattern to handle both full template tag syntax (<%- promptMention(...) %>) and cleaned tag format (without <% %>)
  • Added fallback parsing logic for multiple parameters when the primary regex doesn't match
  • Works with all template tag syntax variations: <% %>, <%- %>, <%- -%>, <%= %>
  • Users can now properly use allowCreate to enable creating new mentions/hashtags when they don't exist in the list

[2.2.5] 2025-12-19 @dwertheimer

• Fix messaging in templateNew when templates not found
• Enhanced template: ignore code block handling: Code blocks starting with ```template: ignore on the first line are now completely removed from templates (not just protected). Comment-style ignores (// template: ignore or `/* template: ignore */`) continue to be protected during processing and restored in the output. This allows template authors to include metadata or instructions that should not appear in the final rendered output.
• TemplateRunner rendering improvements: TemplateRunner now consistently renders template tags in all fields before using them:
  • templateBody is now rendered in handleNewNoteCreation (for create-new path) to ensure template tags are replaced with form values before being written to notes
  • newNoteTitle is now rendered if it contains template tags before being used to create a new note
  • getNoteTitled (noteTitle) is now rendered if it contains template tags, while preserving special values like <today>, <current>, <choose>, <select>, <thisweek>, <nextweek>
  • writeUnderHeading is now rendered if it contains template tags, while preserving special values like <choose>, <select> (handled by handleHeadingSelection after rendering)
  • folder is now rendered if it contains template tags, while preserving special values like <select>, <choose>, <current> (handled by templateNew/getFolder after rendering)
  • This ensures consistent behavior across all TemplateRunner paths and prevents unrendered template tags from being written to notes

[2.2.4] 2025-12-03 @dwertheimer

• fix templateLocale setting to allow for locale-specific date/time formatting

[2.2.3] 2025-11-11 @dwertheimer

• add new weather formatting fields (location.*, :formatted: etc.)

[2.2.2] 2025-11-09 @dwertheimer

• Fix default weather formatting so calling <%- weather() %> uses the new NotePlan format string

[2.2.1] 2025-11-09 @dwertheimer

• Work around NotePlan weather API bug by sending null coordinates instead of 0,0 so auto-location lookup succeeds
• Mapped legacy weather placeholders (e.g. :FeelsLikeF:, :winddir16Point:, :region:) to fields from NotePlan's OpenWeatherMap response

[2.2.0] 2025-10-28 @dwertheimer

• switch weather service to use NotePlan's new weather API (<%- NotePlan.getWeather(units, latitude, longitude) %>)
• templateInsert and templateAppend now add a reload of the Editor in case any templating code changed the note underneath and we are reloading the note to get the new content before inserting the rendered template. to solve a but where plugin was writing to note but Editor was overwriting
• includes fix for iPad/iOS folder selection
• allow images in templates -- absolute paths get copied
• add debugging to template rendering to show session data and user options to try to find issues with template rendering
• fix edge case where template frontmatter was not working with trailing space behind "-- " for @thatdwayne
• Use DataStore.defaultNewNoteName instead of "New Note" in tests for brandNewNote creation (allows for translations to work)

[2.1.3] 2025-10-15 @dwertheimer

• Add debugging to chooseFolder() to show the actual index in the folders array that was chosen to try to find the ipad bug for clay russell
• fix clay russell's edge case of inline title not being detected when you have multiple sections that look like frontmatter but some aren't

[2.1.2] 2025-10-07 @dwertheimer (was never released, just included in 2.1.3)

• allow passing of templateRunner body content via xcallback with blank template title

[2.1.1] 2025-09-08 @dwertheimer

• fix using button on empty template, especially with teamspace notes
• use chooseFolder() to include teamspaces in folder selection of templateNew command
• add chooseNoteV2() to helpers module
• fix edge case in date.format() where it was not preserving timezone information in some cases
• fix other issues with DateModule and TimeModule where it was not preserving timezone information in some cases (using Date objects instead of moment objects -- now using moment objects exclusively)
• Add smart quotes replacement in import/include files
• Fix edge case where inline title was not being rendered if it contained EJS tags

b3

• fix chooseFolder() that was forcing new folder creation when it was not needed

[2.1.0] 2025-08-?? @dwertheimer

New Features

• Add helpers module to provide access to commonly used helper functions in templates. See Helpers for details
• Add tp:help command to open templating help page in browser
• Add ability to skip AI error analysis by adding disableAIErrorAnalysis: true to the frontmatter of the template

TemplateRunner Improvements Docs

• Update templateRunner to allow for passing an object as args (e.g. templateRunnerExecute('templateName', true, { getNoteTitled: 'myNoteTitle' }))
• Add headingLevel and addHeadingLocation to templateRunner to allow for control over where the heading is added and what level it is
• Add replaceHeading to templateRunner to allow for replacing the heading and all content under it
• Add createMissingHeading (default true) to templateRunner to allow for overriding and disabling the creation of missing headings (text will be lost if you do this)

Bug Fixes/Stability Improvements

• Automatically close code/comment tags with -%> so that people don't get extra newlines in the output if they forget to add the closing tag with the newline slurping (-%>)
• Add autoSlurpingCodeTags setting to allow for turning off the automatic closing of code/comment tags with -%>
• Fix YAML validation to allow hyphens and spaces in frontmatter key names (e.g., note-tag: #CTI, my key: value)
• Fix edge case where new template note was getting template tags in the filename (thx @clayrussell)
• Fix bug where folder in a meeting note button press was not prompting if you had content in the note
• Fix bug where CommandBar.prompt was being caught by the prompt handler regex and showing a listOptions with the code
• Add validation to ensure meeting note templates are run on calendar events and stop if not
• Add validation for meeting note templates to prevent execution without proper event data

Other

• Improve debugging output for frontmatter validation to show exactly why content is considered valid or invalid
• Add some JS error logging at end of console messages to make error finding easier
• Change log level of some log messages to info (variable passing)
• remove evaluation of code in standard prompt handler

[2.0.20] 2025-08-07 @dwertheimer

• Fix folder selection in new note command (adds folder path to chooser)

[2.0.19] 2025-08-06 @dwertheimer

• Fix calendar notes not working right after title searching changes
• Fix edge case where a template had -- frontmatter but no tags and was taking the fast path wrongly

[2.0.18] 2025-08-06 @dwertheimer

• add pluginID for iphone settings editing

[2.0.17] 2025-08-06 @dwertheimer

• Fix bug where non-fm-body templates which started with -- were being treated as frontmatter

[2.0.16] 2025-08-06 @dwertheimer

• Add pivot offset to date.now() method

[2.0.15] 2025-08-06 @dwertheimer

• Fix date module edge cases with timezones

[2.0.14] 2025-08-06 @dwertheimer

• Make it possible for a template to have any level of heading for the title (was previously H1 only)

[2.0.13] 2025-08-05 @dwertheimer

• Fix bug where inline H1 title was not being used in templateNew (thx @crussell)
• Ensure that inline H1 title is not created in frontmatter even if there is other frontmatter being created
• if there is newNoteTitle and also an inline H1 title, the newNoteTitle will take precedence and will be created in frontmatter

[2.0.12] 2025-08-02 @dwertheimer

• Fix templateNew to handle blank meeting note edge case

[2.0.11] 2025-07-31 @dwertheimer

• Fix getFolder to handle and to honor folder attribute in quick-note templates [2.0.10] 2025-07-30 @dwertheimer Fix quick-note with frontmatter [2.0.9] 2025-07-27 @dwertheimer Fix xcallback bug in append and insert [2.0.8] 2025-07-19 @dwertheimer Insert/AppendTemplate on a blank notewith folder will create a new note in the folder and move the current note to the trash Insert/AppendTemplate on a non-blank note with folder will prompt the user whether to move the current note to the folder Fix edge case where getValuesForKey was not working correctly Fix bug with scriptlet slurping tags <%_ and _%> Add web.services to globals to get automatic await stmt Change timeout message for web services to be more helpful (esp for advice, verse, quote, and weather) Fix TemplateRunner bug where it was not finding notes by title [2.0.7] 2025-07-15 @dwertheimer Fix renderTemplate() bug that was showing frontmatter in result [2.0.6] 2025-07-11 @dwertheimer Replace all smart quotes with straight quotes (works around auto-inserted smart quotes in Mac, iOS, and iPadOS) [2.0.5] 2025-07-08 @dwertheimer You can now add properties to a generated note by adding it using three dashes "---" Fix bug where new note frontmatter was not being processed correctly if there were no templating tags [2.0.4] 2025-07-03 @dwertheimer Fix limitation where template strings were not being evaluated in include/import tags [2.0.3] 2025-06-28 @dwertheimer Improve AI error handling analysis to include more context vars/functions in the prompt [2.0.2] 2025-06-26 @dwertheimer Add stoicQuote to globals and web module Add verse to globals and web module Add note.getRandomLine to NoteModule [2.0.1] 2025-06-25 @dwertheimer Fix bug @jgclark found where multi-line JS inside a single tag was not working [2.0.0] 2025-XX-XX @dwertheimer Update Add Frontmatter/Properties to Template command name add tag function getValuesForKey to get all values for a given frontmatter tag add tag function promptKey to prompt user for a value with a lot of flexibility on which folders to search for the value etc. add tag function getNote to get a note by title, filename, or by id add <select XXX> to allow for selecting a folder from a reduced list of folders starting with XXX update date module to use NotePlan's week numbering compatibility with NotePlan's user-configurable week start day preferences fix promises and lack of await keyword in template tags add openTasks, completedTasks, openChecklists, completedChecklists to NoteModule Change documentation links to point to new documentation site Fix the long-standing bug where template errors did not show proper line number, esp. when longer code blocks Improve templating error handling/making suggestions for how to fix on JS code execution errors Add detection/messaging of template function calls called without parentheses Add ability to pass newNoteTitle argument to templateNew command and JSON vars for Shortcuts support Added incrementalRender setting to allow for turning off incremental render debugging of templates when they fail to render Added editSettings command to allow for mobile editing of plugin settings Fix long-standing bug where date.format did not work correctly Fix templaterunner bug where the file was not opening in the Editor Add to templateAppend command for easy testing of templates Add journalingQuestion commands to WebModule per Tim Shaker - https://discord.com/channels/763107030223290449/963950027946999828/1051665188648132648 Add date.daysUntil to DateModule Fix bug in promises in date shorthand codes add note.currentNote() to NoteModule fixed formattedDateTime to work with strftime format (what it was) or moment (what we use everywhere else) added moment to globals fixed now which did not match the documentation -- now works with simple offsetDays fixed date8601 bug in the date module Developer Massively refactored rendering pipeline (NPTemplating) to make it easier to understand and maintain Added a lot of logging to help debug issues with templating that users may encounter Added event methods eventDate and eventEndDate to the templating context object so Meeting Notes could use DataStore.invoke which serializes and otherwise drops functions. this allows Meeting Notes to not need updating but always use the latest Templating Added init method to Templating.js to allow for automatic updates to the plugin (crazy that it was not there before) [1.12.0] 2025-03-09 @dwertheimer Add Add Frontmatter/Properties to Template command Improve template getter to not load every template in the DataStore [1.11.5] 2025-03-09 @dwertheimer Fix: Minor improvements in getTemplate inclusion [1.11.4] 2025-03-07 @dwertheimer Fix: templateRunnerExecute (templateRunner) was failing to process EJS tags in the frontmatter of receiving template (thx @jgclark) [1.11.3] 2025-03-06 @dwertheimer Fix: Improve Template error message (put it in a code block) [1.11.2] 2025-03-06 @dwertheimer Fix: Deal with multiple templates found for title [1.11.1] 2025-03-06 @dwertheimer Workaround for frontmatter UI and CSV strings [1.11.0] 2025-01-26 @dwertheimer Add and to template forms

[1.10.6] 2024-10-10 @dwertheimer

• Fix: Allows letters 'ejs' in text to be left intact
• Feature: Adding template forms (hidden command)

[1.10.5] 2024-02-23 @EduardMe

• Update documentation links

[1.10.4] 2024-02-19 @dwertheimer

• Allow basic templates without frontmatter

[1.10.3] 2024-02-14 @dwertheimer

• Fix: Do not look in @trash or @archive etc. for templates when searching

[1.10.2] 2024-01-30 @jgclark

• fixed issue when using progressUpdate(...) in template (from Habits & Summaries plugin)

[1.10.1] 2024-01-11 @dwertheimer

• Bug fix to remove spaces after comment tags (<%#...)

[1.10.0] 2023-10-31 @dwertheimer

• Command name changes require NotePlan 3.9.10
• Change commands to be more descriptive (using @EduardMe's new naming scheme)
• Tweak np:invoke to work correctly with frontmatter

[1.9.12] 2023-10-24 @dwertheimer

• Changed title to just 'Templating']

[1.9.11] 2023-10-12 @jgclark

• add 'todayProgressFromTemplate' template command (from Habits & Summaries v0.20)

[1.9.10] (aka 2.0.0-bet1.13): 2023-09-11 @dwertheimer

• add folder attribute to np:new for xcallback creation inside a specific folder]

[1.9.9] (aka 2.0.0-beta.12): 2023-08-12 @dwertheimer

• Fix templatejs code so it doesn't add extra spaces

[1.9.8] (aka 2.0.0-beta.11): 2023-07-12 @dwertheimer

• Fix web services intermittent bug

[1.9.7] (aka 2.0.0-beta.10) - 2023-05-01 @dwertheimer

• Fix bug in promptDate / promptDateInterval

[1.9.6] (aka 2.0.0-beta.09) - 2023-04-02 @dwertheimer

• Fix bug in template importing

[2.0.0-beta.08] - 2023-03-31 @dwertheimer NOTE: this version was released publicly as [1.9.5]

• Fix bug where you could not use the word 'prompt' in text in a tag

[2.0.0-beta.07] - NOTE: this version was released publicly as [1.9.4]

• Updated globals for command name change to: appendProgressUpdate

[2.0.0-beta.06] - NOTE: this version was released publicly as [1.9.3]

• double dashes in templates create frontmatter is now in render (not just np:new)

[2.0.0-beta.05] - 2023-03-01 (@dwertheimer)

• roll back change of replacing '---' with '*****'
• added new tests to ensure rendering with separators works as expected

[2.0.0-beta.04] - 2023-02-24 (@dwertheimer)

• Fixed issue that template was not passable to np:new and np:qtn
• Removed template migration code (now one year past migration)
• Added folder creation option to folder chooser

[2.0.0-beta.03] - 2023-02-05 (dwertheimer)

• Fixed minor issue in .isWeekend where NP was getting different answers than Jest. Has to do with locales, so changed it to use moment in this function. there are more that need to be changed.

[2.0.0-beta.02] - 2023-02-01 (dwertheimer)

• Fixed minor timezone issue in .add (now using same method as subtract was using)

[2.0.0-beta.01] - 2023-01-15 (mikeerickson)

• Lowered version to beta, this should not be a release version which was changed by @dwertheimer on 2022-01-13

[2.0.2] - 2023-01-13 (dwertheimer)

• fix bug that was keeping promptDateInterval from working
• fix bug that was causing prompts to fail if you had a period in the prompt

[2.0.1-alpha.14] - 2023-01-03 (dwertheimer)

• fix logging whitespace on error message

[2.0.0-alpha.13] - 2022-12-21 (dwertheimer)

• fix edge case in self-running templates
• Added getNoteTitled instead of writeNoteTitle|openNoteTitle

[2.0.0-alpha.12] - 2022-12-08 (dwertheimer)

• Added a little extra logging to self-running templates

[2.0.0-alpha.11] - 2022-12-13 (dwertheimer)

• Allow np:append to be called with a template variable

[2.0.0-alpha.10] - 2022-09-19 (dwertheimer)

• Tweaks to NPEditor to allow for replaceNoteContents to replace all content in a note
• Minor bug fixes for bugs found along the way

[2.0.0-alpha.09] - 2022-08-12 (dwertheimer)

• self-running templates: fixed problems in introduced by API changes in how args are passed using xcallbacks
• self-running templates: added | for heading and for file to open removed some logging I had previously put in for debugging MeetingNotes [2.0.0-alpha.08] - 2022-08-12 (mikeerickson) fixed issues with prompts that included reserved words such as import, note. [2.0.0-alpha.07] - 2022-07-24 (mikeerickson) [2.0.0-alpha.06] - 2022-07-24 (mikeerickson) incorporated Debugging section to np.Templating Settings (thanks @dwertheimer) [2.0.0-alpha.05] - 2022-07-17 (mikeerickson) Added renderFrontmatter code to NPTemplating.renderTemplate [2.0.0-alpha.04] - 2022-07-17 (mikeerickson) Renamed src/Editor.js -> src/NPEditor.js (my bad, didn't follow naming convention rules) [2.0.0-alpha.03] - 2022-07-17 (mikeerickson) quite a bit of refactoring, addressing growing Templating.js file (969 loc -> 647 loc) removed outdated commands (no longer a need as most users templates have been migrated) Note: The automatic template conversion will still run when np.Templating is installed, just removing command noise fixed issues when template code contained reserved words include, note, calendar, and template (was to loose with keyword replacement) expanded template error output to include line and position (results will vary depending on how you have constructed template) [2.0.0-alpha.02] - 2022-07-13 (mikeerickson) added Word Of The Day Use np:wotd to insert at cursor of current note Or, use in template <%- web.wotd() %> [2.0.0-alpha.01] - 2022-06-05 .. 2022-07-07 (mikeerickson) added template code block execution added import statement for importing any type of helper modules added include method (will include project notes, calendar notes, templates) when "including" template, it will be rendered automatically added template method you can also use include with the template and it will perform the same action as the include method when "including" template, it will be rendered automatically added note method you can also use include with a note and it will perform the same action as the note method added calendar method you can also use include with a note and it will perform the same action as the calendar method added clo helper which can be used to help debug more complex templates added a calendar module placeholder (more coming in the future but didn't want to lose sight ) getTemplateList will now filter out any templates which have type = ignore (@dwertheimer) added np:xcb command to build x-callback for current template [1.2.0] - 2022-06-04 (mikeerickson) Public Release Changed Plugin Name to "📒 np.Templating" Removed - New designation [1.2.0-rc.01] - 2022-06-02 (mikeerickson) Release Candidate #1 [1.2.0-beta.09] - 2022-06-02 (mikeerickson) Added daysBetween to Date Module [1.2.0-beta.08] - 2022-06-01 (mikeerickson) Added Note Module There are 14 new commands in Note Module, thus only listing the new module here, refer to documentation for more information Added startOfMonth to Date Module Added endOfMonth to Date Module Added daysInMonth to Date Module Added getFrontmatterText to Frontmatter Module [1.2.0-beta.07] - 2022-05-26 (mikeerickson) added NPTemplating.getTemplate export, supporting DataStore.invokePluginCommandByName added NPTemplating.renderFrontmatter export, supporting DataStore.invokePluginCommandByName added NPTemplating.render export, supporting DataStore.invokePluginCommandByName [1.2.0-beta.06] - 2022-05-24 (mikeerickson) fixed issue passing format string to web.weather (was not passing data in fix applied in 1.2.0-beta.03) adjusted np:invoke command to use prepend, insert, append [1.2.0-beta.05] - 2022-05-20 (mikeerickson) fixed regression created by merge conflicts in recent push [1.2.0-beta.04] - 2022-05-20 (mikeerickson) fixed issue with DateModule now when using offset value added template reentrance when calling FrontMatter.parse provide ability for attributes to use any attribute before the current attribute. added np:invoke which uses a new template attribute location to control where template is placed on current note append appends to the end of current note (same as np:append) cursor inserts at the cursor position of the current note insert inserts at the beginning of current note (same as np:insert) added convertProjectNoteToFrontmatter to FrontMatterModule class added new command np:convert which will convert the current project note to frontmatter format uses FrontmatterModule.convertProjectNoteToFrontmatter method [1.2.0-beta.03] - 2022-05-18 (mikeerickson) refactor web service implementation, experiencing issues latest vesion of NotePlan [1.2.0-beta.02] - 2022-05-17 (mikeerickson) fixed issue when template contains folder which has value of <select> to prompt user of where new note should be created (@jgclark) [1.2.0-beta.01] - 2022-05-15 (mikeerickson) added templateGroupTemplatesByFolder setting (default: false) If true, template chooser will show complete folder path If false, template choooser will only show template name implemented onSettingsUpdated to handle new templateGroupTemplatesByFolder setting fixed issue when using previousBusinessDay and nextBusinessDay when system Preferred language is not English US fixed issue with prompt command when using choices and one of choice values contained let text in option such as completed by fixed date display when using business functions (businessAdd, businessSubtract, nextBusinessDay, previousBusinessDay) fixed issue with prompt when supplying default value e.g. <%- prompt('placeholder','Enter First Name', 'Mike')%> added invokePluginCommandByName to globals.js process, decoupling associated plugin commands see globals.js for implementation extended template rendering error message to include line and column where available making it much easier to identify where the error exists in template [1.1.3-beta.02] - 2022-05-07 (mikeerickson) fix regression introduced in 1.1.2-beta.03 related to replacing --- with *****, was perform replacement too soon Revealed in jgclark.DailyJournal [1.1.3-beta.01] - 2022-05-06 (mikeerickson) WIP - Publishing Internal for @jgclark test with /dayStart [1.1.2-beta.04] - 2022-05-04 (mikeerickson) Interval validation passed (confirmed by @eduard, @dwertheimer, and @jgclark) Removed /Test condition applied to 1.1.2-beta.03 [1.1.2-beta.03] - 2022-05-04 (mikeerickson) IMPORTANT: Internal beta 03 release is migration templates to "@Templates/Test". This "Test" will be removed when released to public additional migration adjustments automatically correct template rendering when --- used as separator in body of template (replaced with *****) when migrating templates, all --- in template body (after frontmatter) will be replaced with **** Template Migration should only take place under the following conditions There are existing templates in "📋 Templates" folder There are 0 tempaltes in "@templates" folder which don't have a template containing tags: migrated-template If there are > 0 templates which have tags: migrated-template migration will NOT be executed. This is how I can determine if a previous migration was executed Also, it should be encouraged to rename "📋 Templates" to another name "📋 Templates (Legacy)" after it has been determined migration was successful, I can update the np.Templating docs about this [1.1.2-beta.02] - 2022-05-03 (mikeerickson) small adjustment to the template migration checker [1.1.2-beta.01] - 2022-05-03 (mikeerickson) public beta release, confirming template migration code is not executed when migration has already occurred. [1.1.1] - 2022-05-03 (mikeerickson) fixed issue which was prompting tempalte migration when install or updating np.Templating plugin [1.1.0] - 2022-05-02 (mikeerickson) public release [1.1.0-beta.02] - 2022-05-01 (mikeerickson) fixed date math when using .now() command with offset parameter deprecated pickDate will now return message stating deprecation, point to using promptDate deprecated pickDateInterval will now return message stating deprecation, point to using promptDateInterval Examples: <%- date.now('',10) %>, <%- date.now('', -90) %>, <%- date.now('', '10w') %>, <%- date.now('', '-3M') %> [1.1.0-beta.01] - 2022-04-30 (mikeerickson) made adjustments to the template migration code, no longer skipped if np.Templating sessions exist Note: You can execute np:migrate-templates at any time if you need to rexecute migration add template migration code to init method so it will be executed for each np.Templating command This will assure templates have been migrated should something of happened and they were not migrated during np.Templating installation fixed tag details (removed <%= from documentation, will be supported internally but not an "official" tag`) removed np:mtn command (and removed from documentation) as it was conflicting with np.MeetingNotes implementation fixed np:new which was not using entered note title (if newNoteTitle does not exist in template attributes) fixed issue with NPTemplating.getFolder interface, was displaying "Choose Destination Folder" even though a default folder was supplied added trim() to weather output, fixing an issue when applying NotePlan italic style *<%- web.weather() %>* would be rendered as a todo item added promptDate which should be used instead of pickDate so placeholder value can be used in same template in different location added promptDateInterval which should be used instead of pickInterval so placeholder value can be used in same template in different location fixed issues with templateLocale not be used properly in some methods in DateModule implemented workaround issue with date.dayNumber() when running in locales not en or en-US removed hard coded discuss variable in template rendering, would have collided if there was a variable in the rendering process which was dicsuss fixed prompt interface to only ouput prompt value when using output tag <%- for example, the following will get retrieve the prompt value into variable, but will not show value when template rendered <% prompt('myVar','Enter myVar;') %> [1.0.3] - 2022-04-17 (mikeerickson) [1.0.2] - 2022-04-16 (mikeerickson) version bump mistake, but it is what it is so we had a very short bug fix release which contained ONLY of version bump (sorry folks) [1.0.1] - 2022-04-16 (mikeerickson) changed getTemplateList and chooseTemplate commands to sort templates in alphabetical order fixed issue disabling nmn.Templates during install or update (onUpdateOrInstall hook) changed nmn.Templates disable message to be more clear and concise, and changed nmn.Templates to "Previous Templates" changed all dialogs which referenced np.Templating documentation url, providing consistency fixed np:qtn and np:mtn to prompt for new note title if newNoteTitle attribute not defined in template fixed np:qtn to prompt for destination folder if folder attribute not defined in template added default date/time prompt value when when using np:mtn (uses timestampFormat format in np.Templating settings) updated README command reference [1.0.0] - 2022-04-14 (mikeerickson) Public Release [1.0.0-beta.38] - 2022-04-12 (mikeerickson) fixed second regression, spreading userData from .renderFrontmatter to frontmatterAttributes (@EduardMe) [1.0.0-beta.37] - 2022-04-12 (mikeerickson) fixed regression in np.Templating.renderFrontmatter (@EduardMe) [1.0.0-beta.36] - 2022-04-12 (mikeerickson) Removed test code for template migration (np:migrate-template) (@dwertheimer) added action to disable nmn.Templates during np.Templating install, after template migration (@dwertheimer) [1.0.0-beta.35] - 2022-04-12 (mikeerickson) fixed some additional prompt issues (including regression handling of promps with spaced variables <%- sleep hours? %>) (@dwertheimer) [1.0.0-beta.34] - 2022-04-11 (mikeerickson) Implemented <current> and <select> when defined in templates which folder attribute Works with np:mtn, np:qtn and np:new commands fixed <%- meetingName %> issue when process Quick Note added NPTemplating :: getFolder fixed some prompt related issues fixed migration issue when changing date to legacyDate (was incorrectly updating progressUpdate) fixed migration issue, fronmatter title was not matching legacy template note name under certain circumstances refactor np:migrate-templates to not call np:migration-quick-notes intrisnically still executed together when running in onUpdateOrInstall method added action to disable nmn.Templates in onUpdateOrInstall method, after successful template migrations [1.0.0-beta.33] - 2022-04-10 (mikeerickson) fix issue passing renderData in data and method properties Resolved issue when using <%- discuss %> Recommend refactoring to use <%- prompt('discuss') %> Fixed issue with <%- selection() %> and <%- system.selection() %> [1.0.0-beta.32] - 2022-04-09 (mikeerickson) Refactored template migration np:migrate-templates to create frontmatter templates [1.0.0-beta.31] - 2022-04-09 (mikeerickson) Added NPTemplating.renderFrontmatter which will render frontmatter attributes Refactored FrontMatter.render to FrontMatter.parse Updated np:qtn and np:mtn to use new NPTemplating.renderFrontmatter method [1.0.0-beta.30] - 2022-04-05 (mikeerickson) Fixed issue when rendering frontmatter templates which have empty attribute values (this was realised when creating templates which had an empty type) [@dwertheimer] Extended Editor mock [@mikeerickson] Added CommandBar, and DataStor mocks [@mikeerickson] Updated np-module.spec.js to use new/updated mocks [@mikeerickson] Cleared up skipped specs, entire test suite is not executed Note: Still working on using alias importing when running specs, thus full E2E tests are incomplete [@dwertheimer] Added ignore to chooseTemplate which will ignore any templates which include type: ignore [1.0.0-beta.29] - 2022-04-04 (mikeerickson) Changed issue with np:mtn to use newNoteTitle template attribute if exists, otherwise user will be prompted to supply note title [@jgclark] Updated np:qtn and np:mtn documentation to note required use of new template format (no more legacy template support) [@jgclark] Fixed issue with np:qtn to use correct quick-note type when display template chooser (regression from b28) [@jgclark] Updated np:mtn to only prompt for discussion if refernce actually exists on template (e.g. <%- discussion %>) [@jgclark] [1.0.0-beta.28] - 2022-04-04 (mikeerickson) Added np:mtn which create a meeting note Refactored np:append, np:qtn, np:new, and np:insert to use new np.Templating chooseTemplate interface Added chooseTemplate method to NPTemplating module Added getTemplateList method to NPTemplating module [1.0.0-beta.27] - 2022-04-02 (mikeerickson) Modified clipboard access to only trigger on templates which have system.clipboard() [@EduardMe] Added chooseTemplate method, extending normal chooseOption method to show path to templates (required when templates have same name in different folders) [1.0.0-beta.26] - 2022-04-02 (mikeerickson) renamed date function to legacyDate when migrating templates [@dwertheimer] date is a reserved word in np.Templating used for DateModule updated np:migrate-quick-notes to enquote attribute values if they don't start with legal character (a-zA-z) [@jgclark] updated frontmatter-module.test.js to check for invalid attribute values see template documentation for details added legacyDates to np.Templating globals [@dwertheimer] fixed pickDate in np.Templating globals [@jgclark] Was throwing error parsing JSON5 (see @helpers/datePicker) due to invalid parameters fixed issue when testing for template types using .includes instead of === removed debug code in templateQuickNote method [1.0.0-beta.25] - 2022-04-01 (mikeerickson) fixed regressions with np:qtn (https://github.com//issues/255) fixed issue with global functions not workign properly when using np:qtn (https://github.com//issues/255) Refactor np:migrate-quick-notes to align with changes discussed with plugin team Add type field assigning quick-note value Extended migration to change all {{ and }} tags to align with remainder of template migration Refactor np:qtn command to only include templates which have type: quick-note all other templates will be ignored Refactor np:append, np:insert, np:new to exclude templates which have type: quick-note Added qqq alias to np:qtn command (requested by @dwertheimer) Note: The following aliases are available: qnt, qtn, quick Added aliases to each of the following commands (removing requirement for :) np:append (npa) np:new (npn) np:insert (npi) np:qtn (npq) [1.0.0-beta.24] - 2022-03-29 (mikeerickson) fixed regression introduced in b23 removed NotePlan environment specific debug code from all modules, all tests are passing now [1.0.0-beta.23] - 2022-03-29 (mikeerickson) fixed additional locations of .md and .txt support that were missed in b22 fixed issue accessing np.Templating Settings data when getting template list [1.0.0-beta.22] - 2022-03-29 (mikeerickson) Fixed issue when using <%- tag with data containing < and > characters in output variable (reported by @eduard) Added choose template interface when refrencing templates with same name (e.g. "Daily Note Template") Changed filename extension to support .md and .txt (previously assumed disk filename of .md) (reported by @dwertheimer) [1.0.0-beta.21] - 2022-03-28 (mikeerickson) Reverted settings access changed in b18 as it was not working properly (restored previous method of accessing np.Templating Settings) This will need to be tested in the library version used by NotePlan Removed migration test code inadvertenly left in published version [1.0.0-beta.20] - 2022-03-27 (mikeerickson) Syncing version with this document (thanks @jgclark) [1.0.0-beta.19] - 2022-03-27 (mikeerickson) Fixed template prompt issues when displaying ? at end of prompt Added np:about command to display current np.Templating information [1.0.0-beta.18] - 2022-03-27 (mikeerickson) Refactored loading np.Templating Settings as an attempt to fix issue when used as library in NotePlan core. This may be a permanent solution, but unable to confirm until it has been installed into NP core [1.0.0-beta.17] - 2022-03-27 (mikeerickson) fixed issue when using progressUpdate in template fixed issue when using prompts in tempaltes in new (frontmatter) format [1.0.0-beta.16] - 2022-03-26 (mikeerickson) Changed NotePlan minimum version to 3.5 Fixed issue when executing np:qtn [1.0.0-beta.15] - 2022-03-20 (mikeerickson) final beta release (barring any last minute issues) Added fog icon to extended weather [1.0.0-beta.14] - 2022-03-20 (mikeerickson) updated np:weather command to use extended weather service and np.Templating Settings - Weather Format updated globals :: weather command to use np.Templating settings [1.0.0-beta.13] - 2022-03-20 (mikeerickson) refactored WebModule imports to use path instead of aliases as they break tests refactored weahterSummary imports to use path instead of aliases as they break tests [1.0.0-beta.12] - 2022-03-20 (mikeerickson) Extended Weather Features Added weatherFormat settings object which contains the default format string to be used when using default weather <%- web.weather() %> If a format string has been supplied such as <%- web.weather( ':icon: :description: :FeelsLikeF:°F (:areaName:, :region:)' ) %>, it will override settings weatherFormat value Updated np:weather command to use settings weatherFormat value [1.0.0-beta.11] - 2022-03-19 (mikeerickson) fixed DateModule format helper to handle dates in mm/dd/yyyy format from producing Invalid Date added date8601 and timestamp helpers from DateModule (see date-module.test.js for example) added time helper from TimeModule (see time-module.test.js for example) extended np.weather( 'format_string' ) to allow a string parameter that gives a format for the resulting weather data from wttr.in. See the documentaiton for more details of what can be returned. added global now helper (e.g. <%- now() %>, same as calling <% date.now() %>) added global date8601 helper (e.g. <%- date8601() %>, same as calling <% date.date8601() %>) added global timestamp helper (e.g. <%- timestamp() %>, same as calling <% date.timestamp() %>) added global currentDate helper (e.g. <%- currentDate() %>, same as calling <% date.now() %>) added global currentTime helper (e.g. <%- currentTime() %>, same as calling <% time.now() %>) [1.0.0-beta.10] - 2022-03-18 (mikeerickson) refactored all fetch calls to use fetch with timeout in NP 3.4.2 or greater reverting attempt to use fetchWithTimeout call added in 1.0.0-beta.09 as it did not work due to unsupported AbortController interface which is part of Web API but not supported by NotePlan [1.0.0-beta.09] - 2022-03-15 (mikeerickson) replaced all fetch calls to use fetchWithTimeout which will handle condition where API service goes offline, returning "An error occurred accessing {serviceName} service" message if request takes longer than timeout fixed "Quick Notes" migration, removing Test defintion added np:migrate-templates command which can be used to inititate migration from "📋 Templates" to "@templates" added migraQuickNotes to end of migrateTemplates so the process will happen at the same time (previously you had to execute np:migrate-quick-notes manually) restored conversion of {{ date8601() }} to <%- date8601() %> added format and now helpers from DateModule (see date-module.test.js for example) added getAttributes and getBody from FrontMatterModule (see frontmatter-module.test.js for example) [1.0.0-beta.08] - 2022-03-14 (mikeerickson) Removed spurious dog override in "Quick Notes" Fixed issue when migrating Quick Notes (inadvertent Test folder creation) Fixed issue with promise based methods in templates not excecuting (all method calls are converted to async/await at runtime) You should not be required to have await keyword in templates For example: <%- date8601() %> is converted to <%- await date86010() %> at runtime [1.0.0-beta.07] - 2022-03-14 (mikeerickson) Removed usePrompts parameter from options as this will be on by default, thus no longer required Removed some spurious console.log statements (don't litter the console) Added alert if "Quick Notes" folder does not exists when executing np:qtn command See np.Templating Settings to override default "Quick Notes" folder name [1.0.0-beta.06] - 2022-03-14 (mikeerickson) removed docs directory, moved to np.Templating Docs fixed issue when selecting Cancel in prompt message, throwing incorrect error [1.0.0-beta.05] - 2022-03-14 (mikeerickson) fix __tests__/fronmatter-module.test.js using new fixtures added np:qtn to replace current /qtn and will be adding /qtn when nmn.Templates is deprecated fixed several issues with prompt interface, including display multiple prompts for same key [1.0.0-beta.04] - 2022-02-26 (mikeerickson) added support for new template format introduced by NotePlan 3.4.1 and frontmatter formatted templates fixed issue where templates were sometimes being loaded from old "Templates" directory, it should now ONLY use @templates renamed globals helper date to currentDate as date is a reserved work for internal Date Module fixed issues with globals date methods, including **pickdate:** - <%- pickDate() %> - <%- pickDate({question:'Please enter a date:'}) %> - <%- pickDateInterval() %> - <%- pickDateInterval({question:'Date interval to use:'}) %> [1.0.0-beta.03] - 2022-02-24 (mikeerickson) added template migration to onUpdateOrInstall method which will run first time np.Templating is installed added np:templating-migration command which can be used to run migration method on command updated to use @templates instead of 📋 Templates [1.0.0-beta.02] - 2022-02-22 (mikeerickson) Added Added generic formatting (removed pipe format from templates) Changed Implemented advanced getWeather (this may be removed in a future release) Reviewing use of globals.js and many (or all) of these functions may be removed - proceed accordingly [1.0.0-beta.01] - 2022-02-15 (mikeerickson) Added Initial Release Changelog The format is based on Keep a Changelog, and this project adheres to Semantic Versioning. Plugin Versioning Uses Semver All NotePlan plugins follow semver versioning. For details, please refer to semver website