joplin-plugin-tag-navigator 2.8.0 → 2.9.1

package/README.md

@@ -31,10 +31,11 @@ This plugin adds inline tag support (such as #inline-tag) to [Joplin](https://jo
 1. It adds a panel for searching and viewing tagged paragraphs across all your notes. ([video](https://www.youtube.com/watch?v=im0zjQFoXb0))
     - **Search queries**: Search tags using logical operators (AND, OR, NOT), and using free text in the note, title, or notebook name / path.
     - **Save search queries** in notes and sync them across device. ([video](https://www.youtube.com/watch?v=GuzCwYxyYZ0), [tips](#saved-queries))
-    - **Sort results by tags** such as priorities, dates, colors, or any other tag. ([video](https://www.youtube.com/watch?v=HvunHOc2zlM), [tips](#saved-queries))
+    - **Sort results by tags** such as priorities, dates, colors, or any other tag. Right-click a tag to sort by it or add it to a multi-key sort. ([video](https://www.youtube.com/watch?v=HvunHOc2zlM), [tips](#saved-queries))
     - **Tag-by-notes:** Search for links or [[wikilinks]] to notes (including backlinks to the current note).
     - **Tag in front matter:** All Markdown front matter fields can be treated as tags. ([video](https://www.youtube.com/watch?v=L3zHletRk54), [tips](#front-matter-tags))
     - **Edit tags:** Add, replace and remove inline tags via the panel context menu (right-click on a tag).
+    - **Search / extend query from the editor**: Right-click on a tag in the editor to search for it or add it to the current query.
     - **Insert tags** from the panel into the note editor. ([tips](#tag-insertion))
     - **Toggle checkboxes** / TODOs from the panel, including [[x]it! style](https://xit.jotaen.net) checkboxes (click, or right-click for 6 task states). ([tips](#inline-todos))
     - **Nested tags** hierarchy: Search parent tags to find the locations of their children. Example: #parent/child. ([video](https://www.youtube.com/watch?v=h-HdX7npbIw))
@@ -50,6 +51,7 @@ This plugin adds inline tag support (such as #inline-tag) to [Joplin](https://jo
         - In a table / database. ([video](https://www.youtube.com/watch?v=L3zHletRk54), [tips](#table-views))
         - In a kanban board. ([video](https://www.youtube.com/watch?v=e7HhQJjpEJg), [tips](#kanban-views))
 3. It adds a panel for quickly navigating between inline tags that appear in the current note, or in all notes ([video](https://www.youtube.com/watch?v=h-HdX7npbIw)).
+    - Click a global tag to search for it, or Cmd/Ctrl+click to add it to the current query.
 4. It can convert your existing inline tags to native Joplin tags, so that they are accessible using Joplin's built-in tag search.
 5. It can convert your existing native Joplin tags to inline tags, so that they are accessible using inline tag search (this plugin). ([tips](#converting-joplin-tags))
 6. It renders inline tags and front matter in the Markdown preview, and front matter in the Markdown editor. ([tips](#styling-inline-tags))
@@ -270,6 +272,7 @@ Saved queries allow you to store search configurations in notes and reuse them a
 - A dropdown in the search panel lists all notes containing saved queries, allowing you to quickly switch between them.
 - When you navigate to a note with a saved query, it is automatically loaded into the search panel.
 - To disable automatic loading (for a static panel that only updates via explicit query selection), turn off the setting `Search: Auto-load saved queries from notes`.
+- When you change sort, grouping, or collapse settings from the search panel while a saved query is loaded, the changes are automatically stored in the query's per-query options (only values that differ from global defaults are saved).
 
 #### Basic structure
 
@@ -312,7 +315,10 @@ Saved queries allow you to store search configurations in notes and reuse them a
 
 #### Advanced options
 
-- **`sortBy`**: Comma-separated list of parent / value tags to sort by
+- **`sortBy`**: Comma-separated list of sort criteria
+  - Standard values: `"modified"`, `"created"`, `"title"`, `"text"`, `"notebook"`
+  - Tag values: any parent / value tag name (e.g., `"priority"`, `"date"`)
+  - Tip: Right-click a tag in the search panel and select `Sort by tag` or `Add to sort` to set sorting interactively. Available for tags with child or value components (e.g., `#priority/high`, `#date=2025-01-15`).
 - **`sortOrder`**: Comma-separated list of sort directions
   - Use "a" / "asc" / "ascend" or "d" / "desc" / "descend"
   - Must correspond to columns in `sortBy`
@@ -320,12 +326,17 @@ Saved queries allow you to store search configurations in notes and reuse them a
   - `"heading"`: Group by heading
   - `"consecutive"`: Group adjacent lines
   - `"item"`: Split by item
+  - `"none"`: No grouping (flat list) — each paragraph becomes its own card, enabling cross-note sorting by tag
   - To change the global grouping, right-click on a note title in the search panel. Saved queries can override this with their own `resultGrouping` property.
+- **`resultToggle`**: Boolean to collapse (`true`) or expand (`false`) result cards
 - **`includeCols`**: (Table view only) Comma-separated list of columns to display
   - Can include: note properties, tags, "modified", "created" timestamps
   - Use to slice, sort, or add specific columns
+  - Supports rename syntax `col:Display Name` to set custom header labels (e.g. `"status:Current Status, priority:Priority Level"`)
 - **`excludeCols`**: (Table view only) Comma-separated list of columns to hide
   - Removes columns even if they exist in the data
+- **`limit`**: Maximum number of results to display (positive integer)
+  - Applied after sorting and filtering
 
 #### Complete example
 
@@ -355,15 +366,16 @@ Saved queries allow you to store search configurations in notes and reuse them a
   "filter": "rock",
   "displayInNote": "table",
   "options": {
-    "includeCols": "title, artist, country, year, modified",
+    "includeCols": "title, artist, country:Country of Origin, year, modified",
     "excludeCols": "notebook, line",
     "sortBy": "year, artist",
-    "sortOrder": "asc, desc"
+    "sortOrder": "asc, desc",
+    "limit": 20
   }
 }
 ```
 
-This example searches for paragraphs that have both `#artist` AND `#album` tags, OR paragraphs with `#single` tag, then filters results containing "rock" anywhere in the text, and displays them in a table sorted by year (ascending) then by artist (descending).
+This example searches for paragraphs that have both `#artist` AND `#album` tags, OR paragraphs with `#single` tag, then filters results containing "rock" anywhere in the text, and displays them in a table sorted by year (ascending) then by artist (descending). The `country` column header is renamed to "Country of Origin".
 
 </details>
 
@@ -404,6 +416,7 @@ This example searches for paragraphs that have both `#artist` AND `#album` tags,
 - Filtering behaviour depends on the result grouping mode (right-click a note title on the panel to change):
     - **Group by heading** (default): Shows/hides entire sections based on whether they contain matching content.
     - **Split by item**: Shows/hides individual items, useful for filtering specific tasks like `"- [ ]"`.
+    - **No grouping**: Each paragraph is a separate card, enabling sorting across notes by tag (e.g., due dates, priorities).
 - To gain more control over filtering by notebook, you may enable the setting `Search: Extract the full notebook path`.
     - Example: Limit results to a notebook that appears in the top level by searching for `|/topNotebook`.
     - Example: Search for `topNotebook/childNotebook` to show only results from childNotebook.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "joplin-plugin-tag-navigator",
-  "version": "2.8.0",
+  "version": "2.9.1",
   "scripts": {
     "dist": "webpack --env joplin-plugin-config=buildMain && webpack --env joplin-plugin-config=buildExtraScripts && webpack --env joplin-plugin-config=createArchive",
     "prepare": "npm run dist",

package/publish/joplin.plugin.alondmnt.tag-navigator.json

@@ -6,7 +6,7 @@
 		"desktop",
 		"mobile"
 	],
-	"version": "2.8.0",
+	"version": "2.9.1",
 	"name": "Inline Tag Navigator",
 	"description": "Type inline tags or frontmatter in the note editor. View your tagged paragraphs and tasks / TODOs in a search panel, or in a generated note / kanban. Build a table view / database from notes and tags. Convert between Obsidian tags and Joplin tags.",
 	"author": "Alon Diament",
@@ -24,6 +24,6 @@
 	],
 	"screenshots": [],
 	"icons": {},
-	"_publish_hash": "sha256:1d782497553a684a46e1f4d649bab293093cb305a05ad1eae5b0b6e70bf6fe69",
-	"_publish_commit": "main:271b27c93be4c63f0e14ef494b7a806b8161c7c5"
+	"_publish_hash": "sha256:33280af54037f9eaf98751da2f3d4d97369977185f4dd4401e26341ee24825cb",
+	"_publish_commit": "main:620fdae6b028762d55c191d12ae5580769118144"
 }