Fixes to includedCalendarSections

Author: jgclark

jgclark.Dashboard/plugin.json

@@ -4,7 +4,7 @@
   "plugin.id": "jgclark.Dashboard",
   "plugin.name": "🎛 Dashboard",
   "plugin.icon": "fa-gauge-high",
-  "plugin.iconColor": "purple-600",
+  "plugin.iconColor": "red-600",
   "plugin.description": "A Dashboard for NotePlan, that in one place shows:\n- a compact list of open tasks and checklists from today's note\n- scheduled open tasks and checklists from other notes.\n- similarly for yesterday's note, tomorrow's note, and the weekly, monthly and quarterly notes too (if used)\n- all overdue tasks\n- all open tasks and checklists that contain particular @tags or #mentions of your choosing\n- the next notes ready to review (if you use the 'Projects and Reviews' plugin).\nIt includes many other ways of speeding up managing your tasks: see the website for more details.",
   "plugin.author": "@jgclark",
   "plugin.comment": "TODO: On full release, change minAppVersion down to 3.7?",

jgclark.Dashboard/src/dashboardHelpers.js

@@ -1,7 +1,7 @@
 // @flow
 //-----------------------------------------------------------------------------
 // Dashboard plugin helper functions
-// Last updated 2026-01-16 for v2.4.0.b15, @jgclark
+// Last updated 2026-01-22 for v2.4.0.b17, @jgclark
 //-----------------------------------------------------------------------------
 
 import pluginJson from '../plugin.json'
@@ -691,13 +691,14 @@ export function filterParasByIncludedCalendarSections(
   if (!dashboardSettings.includedCalendarSections) {
     return paras
   }
+  const includedCalendarSections = stringListOrArrayToArray(dashboardSettings.includedCalendarSections, ',')
 
   const filteredParas = paras.filter((p) => {
     // only apply to calendar notes
     if (p.note?.type !== 'Calendar') return true
     // Apply to all H4/H3/H2 headings in the hierarchy for this para
     const theseHeadings = getHeadingHierarchyForThisPara(p)
-    return theseHeadings.some((h) => dashboardSettings.includedCalendarSections.includes(h))
+    return theseHeadings.some((h) => includedCalendarSections.includes(h))
   })
   logTimer(functionName, startTime, `- after filtering out calendar headings: ${filteredParas.length} paras`)
   return filteredParas

jgclark.Dashboard/src/dashboardSettings.js

@@ -1,7 +1,7 @@
 // @flow
 //-----------------------------------------------------------------------------
 // Settings for the dashboard - loaded/set in React Window
-// Last updated 2025-12-04 for v2.4.0, @jgclark
+// Last updated 2026-01-22 for v2.4.0.b17, @jgclark
 //-----------------------------------------------------------------------------
 
 import { defaultSectionDisplayOrder } from './constants.js'
@@ -82,7 +82,7 @@ export const dashboardSettingDefs: Array<TSettingItem> = [
     type: 'heading',
     label: 'What to Include and Exclude',
     description:
-      "These settings control what Spaces, folders and items are included and excluded in Dashboard's many sections. It will first use only the included Spaces. Then, it includes the folders from the next setting, and removes any specified from the following setting. Finally, individual lines in notes can be ignored by adding terms to the last setting.",
+      "These settings control what Spaces, folders and items are included and excluded in Dashboard's many sections. It will first use only the included Spaces. Then, it includes the folders from the next setting, and removes any specified from the following setting. Then certain Sections within Calendar notes can be included. Finally, individual lines in notes can be ignored by adding terms to the last setting.",
   },
   {
     key: 'includedTeamspaces',
@@ -105,21 +105,21 @@ export const dashboardSettingDefs: Array<TSettingItem> = [
     compactDisplay: true,
   },
   {
-    key: 'includedCalendarSections',
-    label: 'Calendar note Sections to Include',
+    key: 'excludedFolders',
+    label: 'Folders to Exclude',
     description:
-      "Comma-separated list of calendar note section headings to include when selecting open tasks/checklists to show. The matches are partial, so 'Home' will include 'Home' and 'The Home Areas' etc. If left blank, all sections are included.",
+      "Comma-separated list of folder(s) to ignore when selecting open tasks/checklists to show. The matches are partial, so 'Work' will exclude 'Work' and 'Work/CompanyA' etc. To ignore notes at the top-level (not in a folder), include '/' in the list. (@Trash is always ignored, but other special folders need to be specified, e.g. @Archive, @Templates.)",
     type: 'input',
-    default: '',
+    default: '@Archive, @Templates, Saved Searches',
     compactDisplay: true,
   },
   {
-    key: 'excludedFolders',
-    label: 'Folders to Exclude',
+    key: 'includedCalendarSections',
+    label: 'Calendar note Sections to Include',
     description:
-      "Comma-separated list of folder(s) to ignore when selecting open tasks/checklists to show. The matches are partial, so 'Work' will exclude 'Work' and 'Work/CompanyA' etc. To ignore notes at the top-level (not in a folder), include '/' in the list. (@Trash is always ignored, but other special folders need to be specified, e.g. @Archive, @Templates.)",
+      "Comma-separated list of calendar note section headings to include when selecting open tasks/checklists to show. The matches are partial, so 'Home' will include 'Home' and 'The Home Areas' etc. If left blank, all sections are included.",
     type: 'input',
-    default: '@Archive, @Templates, Saved Searches',
+    default: '',
     compactDisplay: true,
   },
   {

jgclark.Dashboard/src/types.js

@@ -1,7 +1,7 @@
 // @flow
 //-----------------------------------------------------------------------------
 // Types for Dashboard code
-// Last updated 2026-01-19 for v2.4.0.b16 by @jgclark
+// Last updated 2026-01-22 for v2.4.0.b17 by @jgclark
 //-----------------------------------------------------------------------------
 // Types for Settings
 
@@ -79,8 +79,9 @@ export type TDashboardSettings = {
   hidePriorityMarkers: boolean,
   ignoreChecklistItems: boolean,
   ignoreItemsWithTerms: string, // Note: Run through stringListOrArrayToArray() before use
-  includedTeamspaces: Array<string>, // Array of teamspace IDs to include ('private' for Private space)
+  includedCalendarSections: string, // Note: Run through stringListOrArrayToArray() before use
   includedFolders: string, // Note: Run through stringListOrArrayToArray() before use
+  includedTeamspaces: Array<string>, // Array of teamspace IDs to include ('private' for Private space)
   showFolderName: boolean, // Note: was includeFolderName before 2.2.0.
   showScheduledDates: boolean, // Note: was includeScheduledDates before 2.2.0.rename to show...
   showTaskContext: boolean, // Note: was includeTaskContext before 2.2.0.