domma-cms 1.6.47 → 1.6.48

package/admin/js/app.js

@@ -1,4 +1,4 @@
-import{views as G}from"./views/index.js";import{withPluginChrome as B}from"./lib/plugin-chrome.js";import{api as c,getUser as F,isAuthenticated as m,logout as z,sendToLogin as K}from"./api.js";import{isAuthScreen as C,loginHashFor as J}from"./lib/login-arrange.js";import{installHttpInterceptor as Y}from"./http-interceptor.js";import{installResizableSlideovers as Q}from"./lib/slideover-resizable.js";import{installActivityThrobber as X}from"./lib/activity-throbber.js";import{installUpdateNotice as Z}from"./lib/update-notice.js";import{isPathAllowed as tt,redirectFor as et}from"./lib/admin-scope.js";import{deliverDesktop as it,desktopActive as ot,notificationSettings as at}from"./lib/desktop-notify.js";import{avatarUrl as st}from"./lib/avatar.js";import{installCalculator as nt}from"./lib/calculator.js";import{takeOverviewPass as lt,withDashboardStrip as O}from"./lib/dashboards-strip.js";import{installHotkeys as rt}from"./lib/hotkeys-ui.js";$(()=>{Y(),nt(),Z(),X(),Q(),(async()=>{const{applyAdminTheme:t,refreshAdminTheme:i}=await import("./lib/admin-theme.js");m()?await i(c,{init:!0}):t({dommaTheme:"charcoal-dark"},{init:!0})})();let p=null,r="/",h=!1,w=null;function b(t){if(y[t])return E.toast(`${y[t]} is switched off on this site.`,{type:"info"}),"/";if(t.split("?")[0]==="/my-dashboard")return"/dashboards";const i=D[t]||et(p,t);return i||((t.split("?")[0]||"/")==="/"&&r&&r!=="/"&&!lt()?D[r]||r:null)}const D={},y={};R.use(async(t,i,e)=>{if(C(t.path))return e();if(!m()){K();return}const o=b(t.path);if(o){R.navigate(o);return}e()});async function g(){try{const t=await c.get("/auth/permissions");p=t.adminScope||null,r=t.adminHome||"/";const i=t.permissions||[];return h=tt(p,"/settings")&&i.some(e=>e==="settings"||e.startsWith("settings.")),w=i.some(e=>e==="notifications"||e.startsWith("notifications.")),i}catch{return p=null,r="/",h=!1,w=null,[]}}document.addEventListener("dm:admin-home-changed",()=>{g()});let N=null,P=!1;document.addEventListener("dm:sidebar-rebuild",()=>{if(N){P=!0;return}N=(async()=>{do{P=!1;try{await A(await g())}catch{}}while(P)})().finally(()=>{N=null})});async function A(t){const{renderAdminSidebar:i}=await import("./lib/sidebar-renderer.js");await i({mount:"#admin-sidebar",permissions:t,adminScope:p})}M.subscribe("router:afterChange",({to:t})=>{C(t.path)&&(u&&(clearInterval(u),u=null),p=null,r="/",h=!1,w=null)});const _=[{path:"/",view:"dashboard",title:"Dashboard - Domma CMS"},{path:"/dashboards",view:"dashboards",title:"Dashboards - Domma CMS"},{path:"/my-dashboard",view:"dashboards",title:"Dashboards - Domma CMS"},{path:"/pages",view:"pages",title:"Pages - Domma CMS"},{path:"/pages/new",view:"pageEditor",title:"New Page - Domma CMS"},{path:"/pages/edit/*",view:"pageEditor",title:"Edit Page - Domma CMS"},{path:"/media",view:"media",title:"Media - Domma CMS"},{path:"/menus",view:"menus",title:"Menus - Domma CMS"},{path:"/context-menus",view:"contextMenus",title:"Context Menus - Domma CMS"},{path:"/context-menus/new",view:"contextMenuEditor",title:"New Context Menu - Domma CMS"},{path:"/context-menus/edit/:slug",view:"contextMenuEditor",title:"Edit Context Menu - Domma CMS"},{path:"/menus/new",view:"menuEditor",title:"New Menu - Domma CMS"},{path:"/menus/edit/:slug",view:"menuEditor",title:"Edit Menu - Domma CMS"},{path:"/menu-locations",view:"menuLocations",title:"Menu Locations - Domma CMS"},{path:"/navigation",view:"menusRedirect",title:"Menus - Domma CMS"},{path:"/layouts",view:"layouts",title:"Layouts - Domma CMS"},{path:"/settings",view:"settings",title:"Settings - Domma CMS"},{path:"/theme",view:"theme",title:"Theme - Domma CMS"},{path:"/users",view:"users",title:"Users - Domma CMS"},{path:"/users/new",view:"userEditor",title:"New User - Domma CMS"},{path:"/users/edit/:id",view:"userEditor",title:"Edit User - Domma CMS"},{path:"/plugins",view:"plugins",title:"Plugins - Domma CMS"},{path:"/plugins/code/:name",view:"pluginCode",title:"Plugin Code - Domma CMS"},{path:"/documentation",view:"documentation",title:"Usage - Domma CMS"},{path:"/tutorials",view:"tutorials",title:"Tutorials - Domma CMS"},{path:"/tutorials/crud",view:"tutorialCrud",title:"Building a CRUD App - Domma CMS"},{path:"/tutorials/plugin",view:"tutorialPlugin",title:"Writing a Plugin - Domma CMS"},{path:"/tutorials/forms",view:"tutorialForms",title:"Form Follow-Up - Domma CMS"},{path:"/docs/components",view:"componentsReference",title:"Components Reference - Domma CMS"},{path:"/docs/components-howto",view:"componentsHowto",title:"Components How-To - Domma CMS"},{path:"/docs/components-walkthrough",view:"componentsWalkthrough",title:"Components Walkthrough - Domma CMS"},{path:"/docs/components-rules",view:"componentsRules",title:"Components Rules - Domma CMS"},{path:"/docs/usage/pages",view:"usagePages",title:"Pages - Usage - Domma CMS"},{path:"/docs/usage/media",view:"usageMedia",title:"Media - Usage - Domma CMS"},{path:"/docs/usage/navigation",view:"usageNavigation",title:"Navigation - Usage - Domma CMS"},{path:"/docs/usage/dconfig",view:"usageDconfig",title:"DConfig - Usage - Domma CMS"},{path:"/docs/usage/shortcodes",view:"usageShortcodes",title:"Shortcodes - Usage - Domma CMS"},{path:"/docs/usage/site-settings",view:"usageSiteSettings",title:"Site Settings - Usage - Domma CMS"},{path:"/docs/usage/plugins",view:"usagePlugins",title:"Plugins - Usage - Domma CMS"},{path:"/docs/usage/users-roles",view:"usageUsersRoles",title:"Users & Roles - Usage - Domma CMS"},{path:"/docs/usage/views",view:"usageViews",title:"Views - Usage - Domma CMS"},{path:"/docs/usage/actions",view:"usageActions",title:"Actions - Usage - Domma CMS"},{path:"/docs/usage/cta-shortcode",view:"usageCtaShortcode",title:"CTA Shortcode - Usage - Domma CMS"},{path:"/docs/usage/editions",view:"usageEditions",title:"Editions & Licences - Usage - Domma CMS"},{path:"/docs/usage/collections",view:"usageCollections",title:"Collections & Forms - Usage - Domma CMS"},{path:"/docs/usage/tools",view:"usageTools",title:"Built-in Tools - Usage - Domma CMS"},{path:"/docs/usage/dashboard",view:"usageDashboard",title:"Dashboard - Usage - Domma CMS"},{path:"/docs/plugins",view:"pluginGuides",title:"Plugin Guides - Domma CMS"},{path:"/docs/plugins/*",view:"pluginGuide",title:"Plugin Guide - Domma CMS"},{path:"/docs/api/authentication",view:"apiRefAuthentication",title:"Authentication - API - Domma CMS"},{path:"/docs/api/pages",view:"apiRefPages",title:"Pages - API - Domma CMS"},{path:"/docs/api/settings",view:"apiRefSettings",title:"Settings - API - Domma CMS"},{path:"/docs/api/layouts",view:"apiRefLayouts",title:"Layouts - API - Domma CMS"},{path:"/docs/api/navigation",view:"apiRefNavigation",title:"Navigation - API - Domma CMS"},{path:"/docs/api/media",view:"apiRefMedia",title:"Media - API - Domma CMS"},{path:"/docs/api/users",view:"apiRefUsers",title:"Users - API - Domma CMS"},{path:"/docs/api/plugins",view:"apiRefPlugins",title:"Plugins - API - Domma CMS"},{path:"/docs/api/collections",view:"apiRefCollections",title:"Collections - API - Domma CMS"},{path:"/docs/api/views",view:"apiRefViews",title:"Views API - Domma CMS"},{path:"/docs/api/actions",view:"apiRefActions",title:"Actions API - Domma CMS"},{path:"/docs/api/forms",view:"apiRefForms",title:"Forms API - Domma CMS"},{path:"/docs/api/scaffold",view:"apiRefScaffold",title:"Scaffold API - Domma CMS"},{path:"/docs/api/external",view:"apiRefExternal",title:"External API & Tokens - Domma CMS"},{path:"/docs/api/content",view:"apiRefContent",title:"Content API - Domma CMS"},{path:"/docs/api/builder",view:"apiRefBuilder",title:"API Builder - Domma CMS"},{path:"/api-reference",view:"apiReference",title:"API Reference - Domma CMS"},{path:"/collections",view:"collections",title:"Collections - Domma CMS"},{path:"/collections/new",view:"collectionEditor",title:"New Collection - Domma CMS"},{path:"/collections/edit/:slug",view:"collectionEditor",title:"Edit Collection - Domma CMS"},{path:"/collections/:slug/entries",view:"collectionEntries",title:"Entries - Domma CMS"},{path:"/forms",view:"forms",title:"Forms - Domma CMS"},{path:"/forms/new",view:"formEditor",title:"New Form - Domma CMS"},{path:"/forms/edit/:slug",view:"formEditor",title:"Edit Form - Domma CMS"},{path:"/forms/:slug/submissions",view:"formSubmissions",title:"Submissions - Domma CMS"},{path:"/views",view:"viewsList",title:"Views - Domma CMS"},{path:"/views/new",view:"viewEditor",title:"New View - Domma CMS"},{path:"/views/edit/:slug",view:"viewEditor",title:"Edit View - Domma CMS"},{path:"/views/:slug/preview",view:"viewPreview",title:"View Preview - Domma CMS"},{path:"/actions",view:"actionsList",title:"Actions - Domma CMS"},{path:"/actions/new",view:"actionEditor",title:"New Action - Domma CMS"},{path:"/actions/edit/:slug",view:"actionEditor",title:"Edit Action - Domma CMS"},{path:"/pro/docs",view:"proDocs",title:"Pro Documentation - Domma CMS"},{path:"/blocks",view:"blocks",title:"Blocks - Domma CMS"},{path:"/blocks/new",view:"blockEditor",title:"New Block - Domma CMS"},{path:"/blocks/edit/:name",view:"blockEditor",title:"Edit Block - Domma CMS"},{path:"/components",view:"components",title:"Components - Domma CMS"},{path:"/components/new",view:"componentEditor",title:"New Component - Domma CMS"},{path:"/components/edit/:name",view:"componentEditor",title:"Edit Component - Domma CMS"},{path:"/my-profile",view:"myProfile",title:"My Profile - Domma CMS"},{path:"/roles",view:"roles",title:"Roles & Permissions - Domma CMS"},{path:"/roles/edit/:id",view:"roleEditor",title:"Edit Role - Domma CMS"},{path:"/effects",view:"effects",title:"Effects - Domma CMS"},{path:"/search",view:"search",title:"Search - Domma CMS"},{path:"/content-api",view:"contentApi",title:"Content API - Domma CMS"},{path:"/notes",view:"notes",title:"Notes - Domma CMS"},{path:"/todo",view:"todo",title:"Todo - Domma CMS"},{path:"/calculator",view:"calculator",title:"Calculator - Domma CMS"},{path:"/analytics",view:"analytics",title:"Analytics - Domma CMS"},{path:"/seo",view:"seo",title:"SEO - Domma CMS"},{path:"/seo/:tab",view:"seo",title:"SEO - Domma CMS"},{path:"/contacts",view:"contacts",title:"Contacts - Domma CMS"},{path:"/calls/new",view:"callNew",title:"Call now - Domma CMS"},{path:"/system/notifications",view:"notifications",title:"Notifications - Domma CMS"},{path:"/api-tokens",view:"apiTokens",title:"API Tokens - Domma CMS"},{path:"/api-endpoints",view:"apiEndpoints",title:"API Builder - Domma CMS"},{path:"/api-endpoints/new",view:"apiEndpointEditor",title:"New API Endpoint - Domma CMS"},{path:"/api-endpoints/edit/:id",view:"apiEndpointEditor",title:"Edit API Endpoint - Domma CMS"},{path:"/projects",view:"projects",title:"Projects - Domma CMS"},{path:"/projects/new",view:"projects",title:"New Project - Domma CMS"},{path:"/projects/edit/:slug",view:"projects",title:"Edit Project - Domma CMS"},{path:"/projects/:slug/settings",view:"projectSettings",title:"Project settings - Domma CMS"},{path:"/projects/:slug/pages",view:"pages",title:"Project pages - Domma CMS"},{path:"/projects/:slug/collections",view:"collections",title:"Project collections - Domma CMS"},{path:"/projects/:slug/forms",view:"forms",title:"Project forms - Domma CMS"},{path:"/projects/:slug/actions",view:"actionsList",title:"Project actions - Domma CMS"},{path:"/projects/:slug/menus",view:"menus",title:"Project menus - Domma CMS"},{path:"/projects/:slug/blocks",view:"blocks",title:"Project blocks - Domma CMS"},{path:"/projects/:slug/components",view:"components",title:"Project components - Domma CMS"},{path:"/projects/:slug/views",view:"viewsList",title:"Project views - Domma CMS"},{path:"/projects/:slug/roles",view:"roles",title:"Project roles - Domma CMS"},{path:"/projects/:slug/users",view:"users",title:"Project users - Domma CMS"},{path:"/projects/:slug/apis",view:"apiEndpoints",title:"Project APIs - Domma CMS"},{path:"/projects/:slug",view:"projectDetail",title:"Project - Domma CMS"},{path:"/login",view:"login",title:"Sign in - Domma CMS",onEnter:()=>{$("#admin-sidebar").hide(),$("#admin-topbar").hide()}},{path:"/reset-password",view:"login",title:"Reset Password - Domma CMS",onEnter:()=>{$("#admin-sidebar").hide(),$("#admin-topbar").hide()}}];M.subscribe("router:afterChange",async({to:t,from:i})=>{if(!C(t.path)){if($("#admin-sidebar").show(),$("#admin-topbar").show(),C(i?.path)){$("#topbar-user-name").remove(),import("./lib/admin-theme.js").then(a=>a.refreshAdminTheme(c)),await I();const e=await g(),o=b(t.path);if(o&&R.navigate(o),A(e),at.read().signInToasts)try{const a=await c.system.notifications.list().catch(()=>[]),n=(Array.isArray(a)?a:[]).filter(s=>s.unread&&["warning","critical"].includes(s.data?.severity)).slice(0,3);for(const s of n){const f=d(s.data?.title||""),U=d((s.data?.body||"").slice(0,120));E.toast(`${f} - ${U}`,{type:s.data?.severity==="critical"?"error":"warning",duration:0})}}catch{}}T()}}),M.subscribe("router:afterChange",()=>{setTimeout(()=>{$(".btn-primary, .btn-danger").length&&Domma.effects.reveal(".btn-primary, .btn-danger",{animation:"fade",stagger:40,duration:300})},50)});const V=["#field-project","#menu-project","#collection-project","#endpoint-project","#action-project","#view-project","#block-project","#component-project","#role-project",'[name="project"]','[name="ownedByProject"]'];function W(t){return/^\/(pages|menus|context-menus|collections|forms|actions|views|blocks|components|users|roles|api-endpoints)\/(new|edit\/)/.test(t)}M.subscribe("router:afterChange",({to:t})=>{const i=t?String(t.path).split("?")[0]:"";if(!t||!W(i))return;const o=new URLSearchParams(location.hash.split("?")[1]||"").get("project");if(!o||!/\/new$/.test(i))return;let a=0;const n=60,s=1500,f=()=>{a+=n;for(const U of V){const v=document.querySelector(U);if(!v)continue;if(Array.from(v.options||[]).find(q=>q.value===o)){v.value=o,v.dispatchEvent(new Event("change",{bubbles:!0}));return}}a<s&&setTimeout(f,n)};setTimeout(f,n)});const x="cms_card_states",j=S.get(x)||{};M.subscribe("router:afterChange",()=>{setTimeout(()=>{$("#view-container .card-collapsible").each(function(){const t=$(this).find(".card-header h2, .card-header h3").first().text().trim();t&&j[t]==="collapsed"&&$(this).addClass("card-collapsed")})},200)}),$("#view-container").on("click",".card-collapsible .card-header",function(t){if($(t.target).closest("button, a").length)return;const i=$(this).closest(".card");i.toggleClass("card-collapsed");const e=$(this).find("h2, h3").first().text().trim();e&&(j[e]=i.hasClass("card-collapsed")?"collapsed":"open",S.set(x,j))}),rt(),document.addEventListener("keydown",t=>{if(!(t.ctrlKey||t.metaKey)||t.key!=="s"||window.location.hash.startsWith("#/login")||window.location.hash.startsWith("#/reset-password"))return;const i=document.querySelector("#view-container .view-header button.btn-primary");i&&(t.preventDefault(),i.click())});const l={...G},H={notes:{displayName:"Notes",icon:"edit-3"},todo:{displayName:"Todo",icon:"check-square"},calculator:{displayName:"Calculator",icon:"calculator"},analytics:{displayName:"Analytics",icon:"chart-bar"},seo:{displayName:"SEO",icon:"search"},contacts:{displayName:"Contacts",icon:"users"},projects:{displayName:"Projects",icon:"folder"},pages:{displayName:"Pages",icon:"file-text"},media:{displayName:"Media",icon:"image"},menus:{displayName:"Site menus",icon:"menu"},contextMenus:{displayName:"Context Menus",icon:"menu"},theme:{displayName:"Theme",icon:"droplet"},collections:{displayName:"Collections",icon:"database"},forms:{displayName:"Forms",icon:"layout"},viewsList:{displayName:"Views",icon:"eye"},actionsList:{displayName:"Actions",icon:"zap"},apiEndpoints:{displayName:"API Builder",icon:"code"},blocks:{displayName:"Blocks",icon:"box"},components:{displayName:"Components",icon:"component"},notifications:{displayName:"Notifications",icon:"bell"},roles:{displayName:"Roles",icon:"shield"},users:{displayName:"Users",icon:"users"},settings:{displayName:"Site Settings",icon:"settings"},effects:{displayName:"Effects",icon:"sparkles"},layouts:{displayName:"Layouts",icon:"layout"},plugins:{displayName:"Marketplace",icon:"store"},myProfile:{displayName:"My Profile",icon:"user"},apiTokens:{displayName:"API Tokens",icon:"key"},search:{displayName:"Search",icon:"search"},contentApi:{displayName:"Content API",icon:"file-text"},dashboard:{displayName:"Dashboard",icon:"home"},dashboards:{displayName:"Dashboards",icon:"home"},pageEditor:{displayName:"Pages",section:"Edit",icon:"file-text"},menuEditor:{displayName:"Site menus",section:"Edit",icon:"menu"},menuLocations:{displayName:"Site menus",section:"Locations",icon:"map-pin"},contextMenuEditor:{displayName:"Context Menus",section:"Edit",icon:"menu"},collectionEditor:{displayName:"Collections",section:"Edit",icon:"database"},collectionEntries:{displayName:"Collections",section:"Entries",icon:"database"},formEditor:{displayName:"Forms",section:"Edit",icon:"layout"},formSubmissions:{displayName:"Forms",section:"Submissions",icon:"inbox"},viewEditor:{displayName:"Views",section:"Edit",icon:"eye"},viewPreview:{displayName:"Views",section:"Preview",icon:"eye"},actionEditor:{displayName:"Actions",section:"Edit",icon:"zap"},apiEndpointEditor:{displayName:"API Builder",section:"Edit",icon:"code"},blockEditor:{displayName:"Blocks",section:"Edit",icon:"box"},componentEditor:{displayName:"Components",section:"Edit",icon:"component"},roleEditor:{displayName:"Roles",section:"Edit",icon:"shield"},userEditor:{displayName:"Users",section:"Edit",icon:"users"},projectDetail:{displayName:"Projects",section:"Overview",icon:"folder"},projectSettings:{displayName:"Projects",section:"Settings",icon:"folder"},pluginCode:{displayName:"Marketplace",section:"Code",icon:"code"}};for(const[t,i]of Object.entries(H))l[t]&&(l[t]=B(l[t],{plugin:t,licence:"Built in",...i}));l.dashboard=O(l.dashboard);const k=[..._];async function I(){if(m())try{const t=await c.plugins.adminConfig(),i=new Set(k.map(e=>e.path));for(const e of t.routes||[])i.has(e.path)||k.push(e);for(const[e,o]of Object.entries(t.views||{}))try{const a=await import(`/plugins/${o.entry}`);l[e]=B(a[o.exportName],(t.meta||{})[e])}catch{}l.dashboard=O(l.dashboard);for(const[e,{route:o}]of Object.entries(t.takeovers||{}))o&&(D[`/${e}`]=o);for(const[e,{enabled:o,displayName:a}]of Object.entries(t.tools||{}))o===!1&&(y[`/${e}`]=a);for(const{id:e,href:o}of t.css||[])if(!document.getElementById(e)){const a=document.createElement("link");a.id=e,a.rel="stylesheet",a.href=o,document.head.appendChild(a)}}catch{}}function T(){const t=F();if(!t||$("#topbar-user-name").length)return;const e={"super-admin":"Super Admin",admin:"Admin",user:"User"}[t.role]||t.role,o=st(t);$("#topbar-user").html(`
+import{views as G}from"./views/index.js";import{withPluginChrome as B}from"./lib/plugin-chrome.js";import{api as c,getUser as F,isAuthenticated as m,logout as z,sendToLogin as K}from"./api.js";import{isAuthScreen as C,loginHashFor as J}from"./lib/login-arrange.js";import{installHttpInterceptor as Y}from"./http-interceptor.js";import{installResizableSlideovers as Q}from"./lib/slideover-resizable.js";import{installActivityThrobber as X}from"./lib/activity-throbber.js";import{installUpdateNotice as Z}from"./lib/update-notice.js";import{isPathAllowed as tt,redirectFor as et}from"./lib/admin-scope.js";import{deliverDesktop as it,desktopActive as ot,notificationSettings as at}from"./lib/desktop-notify.js";import{avatarUrl as st}from"./lib/avatar.js";import{installCalculator as nt}from"./lib/calculator.js";import{takeOverviewPass as lt,withDashboardStrip as O}from"./lib/dashboards-strip.js";import{installHotkeys as rt}from"./lib/hotkeys-ui.js";$(()=>{Y(),nt(),Z(),X(),Q(),(async()=>{const{applyAdminTheme:t,refreshAdminTheme:i}=await import("./lib/admin-theme.js");m()?await i(c,{init:!0}):t({dommaTheme:"charcoal-dark"},{init:!0})})();let p=null,r="/",h=!1,w=null;function b(t){if(y[t])return E.toast(`${y[t]} is switched off on this site.`,{type:"info"}),"/";if(t.split("?")[0]==="/my-dashboard")return"/dashboards";const i=D[t]||et(p,t);return i||((t.split("?")[0]||"/")==="/"&&r&&r!=="/"&&!lt()?D[r]||r:null)}const D={},y={};R.use(async(t,i,e)=>{if(C(t.path))return e();if(!m()){K();return}const o=b(t.path);if(o){R.navigate(o);return}e()});async function g(){try{const t=await c.get("/auth/permissions");p=t.adminScope||null,r=t.adminHome||"/";const i=t.permissions||[];return h=tt(p,"/settings")&&i.some(e=>e==="settings"||e.startsWith("settings.")),w=i.some(e=>e==="notifications"||e.startsWith("notifications.")),i}catch{return p=null,r="/",h=!1,w=null,[]}}document.addEventListener("dm:admin-home-changed",()=>{g()});let N=null,P=!1;document.addEventListener("dm:sidebar-rebuild",()=>{if(N){P=!0;return}N=(async()=>{do{P=!1;try{await A(await g())}catch{}}while(P)})().finally(()=>{N=null})});async function A(t){const{renderAdminSidebar:i}=await import("./lib/sidebar-renderer.js");await i({mount:"#admin-sidebar",permissions:t,adminScope:p})}M.subscribe("router:afterChange",({to:t})=>{C(t.path)&&(u&&(clearInterval(u),u=null),p=null,r="/",h=!1,w=null)});const _=[{path:"/",view:"dashboard",title:"Dashboard - Domma CMS"},{path:"/dashboards",view:"dashboards",title:"Dashboards - Domma CMS"},{path:"/my-dashboard",view:"dashboards",title:"Dashboards - Domma CMS"},{path:"/pages",view:"pages",title:"Pages - Domma CMS"},{path:"/pages/new",view:"pageEditor",title:"New Page - Domma CMS"},{path:"/pages/edit/*",view:"pageEditor",title:"Edit Page - Domma CMS"},{path:"/media",view:"media",title:"Media - Domma CMS"},{path:"/menus",view:"menus",title:"Menus - Domma CMS"},{path:"/context-menus",view:"contextMenus",title:"Context Menus - Domma CMS"},{path:"/context-menus/new",view:"contextMenuEditor",title:"New Context Menu - Domma CMS"},{path:"/context-menus/edit/:slug",view:"contextMenuEditor",title:"Edit Context Menu - Domma CMS"},{path:"/menus/new",view:"menuEditor",title:"New Menu - Domma CMS"},{path:"/menus/edit/:slug",view:"menuEditor",title:"Edit Menu - Domma CMS"},{path:"/menu-locations",view:"menuLocations",title:"Menu Locations - Domma CMS"},{path:"/navigation",view:"menusRedirect",title:"Menus - Domma CMS"},{path:"/layouts",view:"layouts",title:"Layouts - Domma CMS"},{path:"/settings",view:"settings",title:"Settings - Domma CMS"},{path:"/theme",view:"theme",title:"Theme - Domma CMS"},{path:"/users",view:"users",title:"Users - Domma CMS"},{path:"/users/new",view:"userEditor",title:"New User - Domma CMS"},{path:"/users/edit/:id",view:"userEditor",title:"Edit User - Domma CMS"},{path:"/plugins",view:"plugins",title:"Plugins - Domma CMS"},{path:"/plugins/code/:name",view:"pluginCode",title:"Plugin Code - Domma CMS"},{path:"/documentation",view:"documentation",title:"Usage - Domma CMS"},{path:"/tutorials",view:"tutorials",title:"Tutorials - Domma CMS"},{path:"/tutorials/crud",view:"tutorialCrud",title:"Building a CRUD App - Domma CMS"},{path:"/tutorials/plugin",view:"tutorialPlugin",title:"Writing a Tool - Domma CMS"},{path:"/tutorials/forms",view:"tutorialForms",title:"Form Follow-Up - Domma CMS"},{path:"/docs/components",view:"componentsReference",title:"Components Reference - Domma CMS"},{path:"/docs/components-howto",view:"componentsHowto",title:"Components How-To - Domma CMS"},{path:"/docs/components-walkthrough",view:"componentsWalkthrough",title:"Components Walkthrough - Domma CMS"},{path:"/docs/components-rules",view:"componentsRules",title:"Components Rules - Domma CMS"},{path:"/docs/usage/pages",view:"usagePages",title:"Pages - Usage - Domma CMS"},{path:"/docs/usage/media",view:"usageMedia",title:"Media - Usage - Domma CMS"},{path:"/docs/usage/navigation",view:"usageNavigation",title:"Navigation - Usage - Domma CMS"},{path:"/docs/usage/dconfig",view:"usageDconfig",title:"DConfig - Usage - Domma CMS"},{path:"/docs/usage/shortcodes",view:"usageShortcodes",title:"Shortcodes - Usage - Domma CMS"},{path:"/docs/usage/site-settings",view:"usageSiteSettings",title:"Site Settings - Usage - Domma CMS"},{path:"/docs/usage/plugins",view:"usagePlugins",title:"Plugins - Usage - Domma CMS"},{path:"/docs/usage/users-roles",view:"usageUsersRoles",title:"Users & Roles - Usage - Domma CMS"},{path:"/docs/usage/views",view:"usageViews",title:"Views - Usage - Domma CMS"},{path:"/docs/usage/actions",view:"usageActions",title:"Actions - Usage - Domma CMS"},{path:"/docs/usage/cta-shortcode",view:"usageCtaShortcode",title:"CTA Shortcode - Usage - Domma CMS"},{path:"/docs/usage/editions",view:"usageEditions",title:"Editions & Licences - Usage - Domma CMS"},{path:"/docs/usage/collections",view:"usageCollections",title:"Collections & Forms - Usage - Domma CMS"},{path:"/docs/usage/blocks",view:"usageBlocks",title:"Blocks - Usage - Domma CMS"},{path:"/docs/usage/tools",view:"usageTools",title:"Built-in Tools - Usage - Domma CMS"},{path:"/docs/usage/dashboard",view:"usageDashboard",title:"Dashboard - Usage - Domma CMS"},{path:"/docs/plugins",view:"pluginGuides",title:"Plugin Guides - Domma CMS"},{path:"/docs/plugins/*",view:"pluginGuide",title:"Plugin Guide - Domma CMS"},{path:"/docs/api/authentication",view:"apiRefAuthentication",title:"Authentication - API - Domma CMS"},{path:"/docs/api/pages",view:"apiRefPages",title:"Pages - API - Domma CMS"},{path:"/docs/api/settings",view:"apiRefSettings",title:"Settings - API - Domma CMS"},{path:"/docs/api/layouts",view:"apiRefLayouts",title:"Layouts - API - Domma CMS"},{path:"/docs/api/navigation",view:"apiRefNavigation",title:"Navigation - API - Domma CMS"},{path:"/docs/api/media",view:"apiRefMedia",title:"Media - API - Domma CMS"},{path:"/docs/api/users",view:"apiRefUsers",title:"Users - API - Domma CMS"},{path:"/docs/api/plugins",view:"apiRefPlugins",title:"Plugins - API - Domma CMS"},{path:"/docs/api/collections",view:"apiRefCollections",title:"Collections - API - Domma CMS"},{path:"/docs/api/views",view:"apiRefViews",title:"Views API - Domma CMS"},{path:"/docs/api/actions",view:"apiRefActions",title:"Actions API - Domma CMS"},{path:"/docs/api/forms",view:"apiRefForms",title:"Forms API - Domma CMS"},{path:"/docs/api/scaffold",view:"apiRefScaffold",title:"Scaffold API - Domma CMS"},{path:"/docs/api/external",view:"apiRefExternal",title:"External API & Tokens - Domma CMS"},{path:"/docs/api/content",view:"apiRefContent",title:"Content API - Domma CMS"},{path:"/docs/api/builder",view:"apiRefBuilder",title:"API Builder - Domma CMS"},{path:"/api-reference",view:"apiReference",title:"API Reference - Domma CMS"},{path:"/collections",view:"collections",title:"Collections - Domma CMS"},{path:"/collections/new",view:"collectionEditor",title:"New Collection - Domma CMS"},{path:"/collections/edit/:slug",view:"collectionEditor",title:"Edit Collection - Domma CMS"},{path:"/collections/:slug/entries",view:"collectionEntries",title:"Entries - Domma CMS"},{path:"/forms",view:"forms",title:"Forms - Domma CMS"},{path:"/forms/new",view:"formEditor",title:"New Form - Domma CMS"},{path:"/forms/edit/:slug",view:"formEditor",title:"Edit Form - Domma CMS"},{path:"/forms/:slug/submissions",view:"formSubmissions",title:"Submissions - Domma CMS"},{path:"/views",view:"viewsList",title:"Views - Domma CMS"},{path:"/views/new",view:"viewEditor",title:"New View - Domma CMS"},{path:"/views/edit/:slug",view:"viewEditor",title:"Edit View - Domma CMS"},{path:"/views/:slug/preview",view:"viewPreview",title:"View Preview - Domma CMS"},{path:"/actions",view:"actionsList",title:"Actions - Domma CMS"},{path:"/actions/new",view:"actionEditor",title:"New Action - Domma CMS"},{path:"/actions/edit/:slug",view:"actionEditor",title:"Edit Action - Domma CMS"},{path:"/pro/docs",view:"proDocs",title:"Pro Documentation - Domma CMS"},{path:"/blocks",view:"blocks",title:"Blocks - Domma CMS"},{path:"/blocks/new",view:"blockEditor",title:"New Block - Domma CMS"},{path:"/blocks/edit/:name",view:"blockEditor",title:"Edit Block - Domma CMS"},{path:"/components",view:"components",title:"Components - Domma CMS"},{path:"/components/new",view:"componentEditor",title:"New Component - Domma CMS"},{path:"/components/edit/:name",view:"componentEditor",title:"Edit Component - Domma CMS"},{path:"/my-profile",view:"myProfile",title:"My Profile - Domma CMS"},{path:"/roles",view:"roles",title:"Roles & Permissions - Domma CMS"},{path:"/roles/edit/:id",view:"roleEditor",title:"Edit Role - Domma CMS"},{path:"/effects",view:"effects",title:"Effects - Domma CMS"},{path:"/search",view:"search",title:"Search - Domma CMS"},{path:"/content-api",view:"contentApi",title:"Content API - Domma CMS"},{path:"/notes",view:"notes",title:"Notes - Domma CMS"},{path:"/todo",view:"todo",title:"Todo - Domma CMS"},{path:"/calculator",view:"calculator",title:"Calculator - Domma CMS"},{path:"/analytics",view:"analytics",title:"Analytics - Domma CMS"},{path:"/seo",view:"seo",title:"SEO - Domma CMS"},{path:"/seo/:tab",view:"seo",title:"SEO - Domma CMS"},{path:"/contacts",view:"contacts",title:"Contacts - Domma CMS"},{path:"/calls/new",view:"callNew",title:"Call now - Domma CMS"},{path:"/system/notifications",view:"notifications",title:"Notifications - Domma CMS"},{path:"/api-tokens",view:"apiTokens",title:"API Tokens - Domma CMS"},{path:"/api-endpoints",view:"apiEndpoints",title:"API Builder - Domma CMS"},{path:"/api-endpoints/new",view:"apiEndpointEditor",title:"New API Endpoint - Domma CMS"},{path:"/api-endpoints/edit/:id",view:"apiEndpointEditor",title:"Edit API Endpoint - Domma CMS"},{path:"/projects",view:"projects",title:"Projects - Domma CMS"},{path:"/projects/new",view:"projects",title:"New Project - Domma CMS"},{path:"/projects/edit/:slug",view:"projects",title:"Edit Project - Domma CMS"},{path:"/projects/:slug/settings",view:"projectSettings",title:"Project settings - Domma CMS"},{path:"/projects/:slug/pages",view:"pages",title:"Project pages - Domma CMS"},{path:"/projects/:slug/collections",view:"collections",title:"Project collections - Domma CMS"},{path:"/projects/:slug/forms",view:"forms",title:"Project forms - Domma CMS"},{path:"/projects/:slug/actions",view:"actionsList",title:"Project actions - Domma CMS"},{path:"/projects/:slug/menus",view:"menus",title:"Project menus - Domma CMS"},{path:"/projects/:slug/blocks",view:"blocks",title:"Project blocks - Domma CMS"},{path:"/projects/:slug/components",view:"components",title:"Project components - Domma CMS"},{path:"/projects/:slug/views",view:"viewsList",title:"Project views - Domma CMS"},{path:"/projects/:slug/roles",view:"roles",title:"Project roles - Domma CMS"},{path:"/projects/:slug/users",view:"users",title:"Project users - Domma CMS"},{path:"/projects/:slug/apis",view:"apiEndpoints",title:"Project APIs - Domma CMS"},{path:"/projects/:slug",view:"projectDetail",title:"Project - Domma CMS"},{path:"/login",view:"login",title:"Sign in - Domma CMS",onEnter:()=>{$("#admin-sidebar").hide(),$("#admin-topbar").hide()}},{path:"/reset-password",view:"login",title:"Reset Password - Domma CMS",onEnter:()=>{$("#admin-sidebar").hide(),$("#admin-topbar").hide()}}];M.subscribe("router:afterChange",async({to:t,from:i})=>{if(!C(t.path)){if($("#admin-sidebar").show(),$("#admin-topbar").show(),C(i?.path)){$("#topbar-user-name").remove(),import("./lib/admin-theme.js").then(a=>a.refreshAdminTheme(c)),await I();const e=await g(),o=b(t.path);if(o&&R.navigate(o),A(e),at.read().signInToasts)try{const a=await c.system.notifications.list().catch(()=>[]),n=(Array.isArray(a)?a:[]).filter(s=>s.unread&&["warning","critical"].includes(s.data?.severity)).slice(0,3);for(const s of n){const f=d(s.data?.title||""),U=d((s.data?.body||"").slice(0,120));E.toast(`${f} - ${U}`,{type:s.data?.severity==="critical"?"error":"warning",duration:0})}}catch{}}x()}}),M.subscribe("router:afterChange",()=>{setTimeout(()=>{$(".btn-primary, .btn-danger").length&&Domma.effects.reveal(".btn-primary, .btn-danger",{animation:"fade",stagger:40,duration:300})},50)});const V=["#field-project","#menu-project","#collection-project","#endpoint-project","#action-project","#view-project","#block-project","#component-project","#role-project",'[name="project"]','[name="ownedByProject"]'];function W(t){return/^\/(pages|menus|context-menus|collections|forms|actions|views|blocks|components|users|roles|api-endpoints)\/(new|edit\/)/.test(t)}M.subscribe("router:afterChange",({to:t})=>{const i=t?String(t.path).split("?")[0]:"";if(!t||!W(i))return;const o=new URLSearchParams(location.hash.split("?")[1]||"").get("project");if(!o||!/\/new$/.test(i))return;let a=0;const n=60,s=1500,f=()=>{a+=n;for(const U of V){const v=document.querySelector(U);if(!v)continue;if(Array.from(v.options||[]).find(q=>q.value===o)){v.value=o,v.dispatchEvent(new Event("change",{bubbles:!0}));return}}a<s&&setTimeout(f,n)};setTimeout(f,n)});const T="cms_card_states",j=S.get(T)||{};M.subscribe("router:afterChange",()=>{setTimeout(()=>{$("#view-container .card-collapsible").each(function(){const t=$(this).find(".card-header h2, .card-header h3").first().text().trim();t&&j[t]==="collapsed"&&$(this).addClass("card-collapsed")})},200)}),$("#view-container").on("click",".card-collapsible .card-header",function(t){if($(t.target).closest("button, a").length)return;const i=$(this).closest(".card");i.toggleClass("card-collapsed");const e=$(this).find("h2, h3").first().text().trim();e&&(j[e]=i.hasClass("card-collapsed")?"collapsed":"open",S.set(T,j))}),rt(),document.addEventListener("keydown",t=>{if(!(t.ctrlKey||t.metaKey)||t.key!=="s"||window.location.hash.startsWith("#/login")||window.location.hash.startsWith("#/reset-password"))return;const i=document.querySelector("#view-container .view-header button.btn-primary");i&&(t.preventDefault(),i.click())});const l={...G},H={notes:{displayName:"Notes",icon:"edit-3"},todo:{displayName:"Todo",icon:"check-square"},calculator:{displayName:"Calculator",icon:"calculator"},analytics:{displayName:"Analytics",icon:"chart-bar"},seo:{displayName:"SEO",icon:"search"},contacts:{displayName:"Contacts",icon:"users"},projects:{displayName:"Projects",icon:"folder"},pages:{displayName:"Pages",icon:"file-text"},media:{displayName:"Media",icon:"image"},menus:{displayName:"Site menus",icon:"menu"},contextMenus:{displayName:"Context Menus",icon:"menu"},theme:{displayName:"Theme",icon:"droplet"},collections:{displayName:"Collections",icon:"database"},forms:{displayName:"Forms",icon:"layout"},viewsList:{displayName:"Views",icon:"eye"},actionsList:{displayName:"Actions",icon:"zap"},apiEndpoints:{displayName:"API Builder",icon:"code"},blocks:{displayName:"Blocks",icon:"box"},components:{displayName:"Components",icon:"component"},notifications:{displayName:"Notifications",icon:"bell"},roles:{displayName:"Roles",icon:"shield"},users:{displayName:"Users",icon:"users"},settings:{displayName:"Site Settings",icon:"settings"},effects:{displayName:"Effects",icon:"sparkles"},layouts:{displayName:"Layouts",icon:"layout"},plugins:{displayName:"Marketplace",icon:"store"},myProfile:{displayName:"My Profile",icon:"user"},apiTokens:{displayName:"API Tokens",icon:"key"},search:{displayName:"Search",icon:"search"},contentApi:{displayName:"Content API",icon:"file-text"},dashboard:{displayName:"Dashboard",icon:"home"},dashboards:{displayName:"Dashboards",icon:"home"},pageEditor:{displayName:"Pages",section:"Edit",icon:"file-text"},menuEditor:{displayName:"Site menus",section:"Edit",icon:"menu"},menuLocations:{displayName:"Site menus",section:"Locations",icon:"map-pin"},contextMenuEditor:{displayName:"Context Menus",section:"Edit",icon:"menu"},collectionEditor:{displayName:"Collections",section:"Edit",icon:"database"},collectionEntries:{displayName:"Collections",section:"Entries",icon:"database"},formEditor:{displayName:"Forms",section:"Edit",icon:"layout"},formSubmissions:{displayName:"Forms",section:"Submissions",icon:"inbox"},viewEditor:{displayName:"Views",section:"Edit",icon:"eye"},viewPreview:{displayName:"Views",section:"Preview",icon:"eye"},actionEditor:{displayName:"Actions",section:"Edit",icon:"zap"},apiEndpointEditor:{displayName:"API Builder",section:"Edit",icon:"code"},blockEditor:{displayName:"Blocks",section:"Edit",icon:"box"},componentEditor:{displayName:"Components",section:"Edit",icon:"component"},roleEditor:{displayName:"Roles",section:"Edit",icon:"shield"},userEditor:{displayName:"Users",section:"Edit",icon:"users"},projectDetail:{displayName:"Projects",section:"Overview",icon:"folder"},projectSettings:{displayName:"Projects",section:"Settings",icon:"folder"},pluginCode:{displayName:"Marketplace",section:"Code",icon:"code"}};for(const[t,i]of Object.entries(H))l[t]&&(l[t]=B(l[t],{plugin:t,licence:"Built in",...i}));l.dashboard=O(l.dashboard);const k=[..._];async function I(){if(m())try{const t=await c.plugins.adminConfig(),i=new Set(k.map(e=>e.path));for(const e of t.routes||[])i.has(e.path)||k.push(e);for(const[e,o]of Object.entries(t.views||{}))try{const a=await import(`/plugins/${o.entry}`);l[e]=B(a[o.exportName],(t.meta||{})[e])}catch{}l.dashboard=O(l.dashboard);for(const[e,{route:o}]of Object.entries(t.takeovers||{}))o&&(D[`/${e}`]=o);for(const[e,{enabled:o,displayName:a}]of Object.entries(t.tools||{}))o===!1&&(y[`/${e}`]=a);for(const{id:e,href:o}of t.css||[])if(!document.getElementById(e)){const a=document.createElement("link");a.id=e,a.rel="stylesheet",a.href=o,document.head.appendChild(a)}}catch{}}function x(){const t=F();if(!t||$("#topbar-user-name").length)return;const e={"super-admin":"Super Admin",admin:"Admin",user:"User"}[t.role]||t.role,o=st(t);$("#topbar-user").html(`
             ${o?`<img id="topbar-avatar" class="topbar-avatar" src="${d(o)}" alt="">`:""}
             <span id="topbar-user-name" class="topbar-user-name">${d(t.name)}</span>
             <span class="topbar-role-badge topbar-role-badge--${d(t.role)}">${e}</span>
@@ -20,4 +20,4 @@ import{views as G}from"./views/index.js";import{withPluginChrome as B}from"./lib
                 <span data-icon="log-out"></span>
                 <span>Sign out</span>
             </a>
-        `);const a=$("#topbar-bell").get(0);a&&(a.hidden=!0);const n=$("#topbar-settings").get(0);n&&(n.hidden=!h),$("#topbar-logout-btn").on("click",s=>{s.preventDefault(),z()}),Domma.icons.scan("#admin-topbar"),E.tooltip("#topbar-actions [data-tooltip]",{placement:"bottom"}),L(),u||(u=setInterval(L,6e4))}function d(t){return String(t).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;")}let u=null;async function L(){if(!(!m()||w===!1))try{const{count:t}=await c.system.notifications.unreadCount();$("#topbar-bell").removeAttr("hidden");const i=$("#topbar-bell-badge");t>0?i.text(t>99?"99+":String(t)).removeAttr("hidden"):i.attr("hidden","").text(""),t>0&&ot()&&it(await c.system.notifications.list().catch(()=>[]))}catch{}}(async()=>{if(!m()&&!window.location.hash.startsWith("#/reset-password"))window.location.hash.startsWith("#/login")||(window.location.hash=J(window.location.hash));else if(await I(),F()){const a=await g(),n=(window.location.hash||"#/").slice(1)||"/",s=b(n);s&&(window.location.hash=`#${s}`),await A(a),T()}const t=R._extractParams.bind(R);R._extractParams=function(o,a){const n=a.indexOf("?");if(n!==-1&&(a=a.slice(0,n)),o.endsWith("/*")){const s=o.slice(0,-2);return a.startsWith(s+"/")?{}:null}return t(o,a)};const i=R._renderNotFound.bind(R);let e="";R._renderNotFound=async function(o){return m()&&e!==o&&(e=o,await I(),R._matchRoute(o).route)?(e="",R._handleRouteChange()):(e="",m()&&$("#admin-sidebar").get(0)?.style.display==="none"?(E.toast("That link goes nowhere - here is your home page.",{type:"warning"}),R.navigate("/")):i(o))},R.init({container:"#view-container",routes:k,views:l,default:"/",transitions:{enter:"fadeIn",leave:"fadeOut",duration:150}})})()});
+        `);const a=$("#topbar-bell").get(0);a&&(a.hidden=!0);const n=$("#topbar-settings").get(0);n&&(n.hidden=!h),$("#topbar-logout-btn").on("click",s=>{s.preventDefault(),z()}),Domma.icons.scan("#admin-topbar"),E.tooltip("#topbar-actions [data-tooltip]",{placement:"bottom"}),L(),u||(u=setInterval(L,6e4))}function d(t){return String(t).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&#039;")}let u=null;async function L(){if(!(!m()||w===!1))try{const{count:t}=await c.system.notifications.unreadCount();$("#topbar-bell").removeAttr("hidden");const i=$("#topbar-bell-badge");t>0?i.text(t>99?"99+":String(t)).removeAttr("hidden"):i.attr("hidden","").text(""),t>0&&ot()&&it(await c.system.notifications.list().catch(()=>[]))}catch{}}(async()=>{if(!m()&&!window.location.hash.startsWith("#/reset-password"))window.location.hash.startsWith("#/login")||(window.location.hash=J(window.location.hash));else if(await I(),F()){const a=await g(),n=(window.location.hash||"#/").slice(1)||"/",s=b(n);s&&(window.location.hash=`#${s}`),await A(a),x()}const t=R._extractParams.bind(R);R._extractParams=function(o,a){const n=a.indexOf("?");if(n!==-1&&(a=a.slice(0,n)),o.endsWith("/*")){const s=o.slice(0,-2);return a.startsWith(s+"/")?{}:null}return t(o,a)};const i=R._renderNotFound.bind(R);let e="";R._renderNotFound=async function(o){return m()&&e!==o&&(e=o,await I(),R._matchRoute(o).route)?(e="",R._handleRouteChange()):(e="",m()&&$("#admin-sidebar").get(0)?.style.display==="none"?(E.toast("That link goes nowhere - here is your home page.",{type:"warning"}),R.navigate("/")):i(o))},R.init({container:"#view-container",routes:k,views:l,default:"/",transitions:{enter:"fadeIn",leave:"fadeOut",duration:150}})})()});

package/admin/js/templates/blocks.html

@@ -4,7 +4,7 @@
 <div class="blx">
     <p class="blx-note">Reusable HTML templates - one look for a collection's entries, a card, a call to action - placed on a
         page with a shortcode.
-        <span data-help-title="Blocks" data-help="A block is an HTML template with a placeholder for each field (the field name in double curly braces), and optionally its own CSS. Use it to show collection entries ([collection … display=&quot;block&quot; block=&quot;name&quot;]), on its own ([block template=&quot;name&quot; …]), or by its name as a short tag ([name … /]). Each block's comment at the top says what it expects; right-click a block to copy its shortcode."></span></p>
+        <span data-help-title="Blocks" data-help="A block is an HTML template with a placeholder for each field (the field name in double curly braces), and optionally its own CSS. Use it to show collection entries ([collection … display=&quot;block&quot; block=&quot;name&quot;]), on its own ([block template=&quot;name&quot; …]), or by its name as a short tag ([name … /]). Each block's comment at the top says what it expects; right-click a block to copy its shortcode. The book button above opens the full Blocks guide."></span></p>
 
     <!-- Hidden file picker driven by the Import banner action -->
     <input class="blx-import-file" type="file" accept=".dmblock.json,application/json" hidden>

package/admin/js/templates/docs/tutorial-crud.html

@@ -367,7 +367,7 @@
 
       <hr>
       <p class="text-muted" style="font-size:.9rem;">
-        Next: <a href="#/tutorials/plugin">Writing a Plugin</a>
+        Next: <a href="#/tutorials/plugin">Writing a Tool</a>
       </p>
 
     </div>

package/admin/js/templates/docs/tutorial-plugin.html

@@ -1,5 +1,5 @@
 <div class="view-header">
-  <h1><span data-icon="document"></span> Writing a Plugin</h1>
+  <h1><span data-icon="document"></span> Writing a Tool</h1>
   <a href="#/tutorials" class="btn btn-ghost btn-sm"><span data-icon="arrow-left"></span> All tutorials</a>
 </div>
 
@@ -7,12 +7,18 @@
   <div class="col-12">
     <div class="docs-body">
 
-      <p>Plugins live in the <code>plugins/</code> directory. Each plugin is a self-contained folder with
-        three required files and optional <code>admin/</code>, <code>public/</code> and <code>docs/</code>
-        subdirectories.</p>
+      <p>A <strong>Tool</strong> is a screen in the admin with its own place in the sidebar: Notes, Invoices,
+        Booking and Email are all Tools. The ones you add yourself are <strong>plugins</strong>. That is the older
+        name, and it is still used for the folder they live in, the API under <code>/api/plugins/</code> and the
+        files you share. Once a plugin is switched on it is a Tool like any other: it files under
+        <strong>Tools</strong> in the sidebar, gets the same banner, and an admin can move it, hide it or give it a
+        hotkey.</p>
+      <p>Each Tool is a self-contained folder in <code>plugins/</code>, with three required files and optional
+        <code>admin/</code>, <code>public/</code> and <code>docs/</code> subdirectories.</p>
       <p>The quickest start is <strong>New plugin</strong> in the banner of <a href="#/plugins">System &gt;
         Plugins</a> (the Marketplace screen). It copies the built-in template into <code>plugins/&lt;slug&gt;/</code>
-        with a server entry, config defaults, a wired admin view and a <code>CLAUDE.md</code>, switched on. Restart
+        with a server entry, config defaults, a wired admin view, a starter user guide and a <code>CLAUDE.md</code>,
+        switched on. Restart
         the server to activate it. The rest of this page explains what those files do.</p>
 
       <h3>Directory structure</h3>
@@ -81,7 +87,9 @@
         <tr>
           <td><code>admin.sidebar</code></td>
           <td>array</td>
-          <td>Sidebar items to add to the admin panel.</td>
+          <td>The Tool's sidebar entries. Each may name its default <code>folder</code> (<code>tools</code>
+            unless you say otherwise), a <code>group</code> inside it, a <code>hotkey</code> and a
+            <code>countUrl</code> for its badge - see section 5.</td>
         </tr>
         <tr>
           <td><code>admin.routes</code></td>
@@ -252,7 +260,94 @@ export const myPluginView = {
 
       <hr>
 
-      <h3>5. Injection snippets (optional)</h3>
+      <h3>5. Making it feel like a Tool</h3>
+      <p>These are what make a screen look and behave like the built-in Tools. None is required, and each one is
+        small.</p>
+
+      <h4>Its place in the sidebar</h4>
+      <pre class="code-block"><code>"sidebar": [
+    {
+        "text": "Invoices",
+        "url": "#/plugins/invoices",
+        "icon": "file-text",
+        "folder": "tools",
+        "group": "Business",
+        "hotkey": "i",
+        "permission": "invoices",
+        "countUrl": "/api/plugins/invoices/_count"
+    }
+]</code></pre>
+      <ul>
+        <li><code>folder</code> is where the Tool starts: <code>overview</code>, <code>content</code>,
+          <code>data</code>, <code>tools</code> (the default), <code>system</code> or <code>documentation</code>.
+          <code>group</code> puts it in a sub-folder by name, made if it is not there. An admin can move the Tool
+          anywhere in <strong>Content &gt; Site menus &gt; Admin sidebar</strong>, and their choice wins.</li>
+        <li><code>hotkey</code> is one letter: <kbd>G</kbd> then that letter opens the Tool. The built-in Tools claim
+          their letters first, and the first Tool to ask for a free one gets it.</li>
+        <li>A Tool is known by its <code>url</code>, so give each entry its own.</li>
+      </ul>
+
+      <h4>A badge with a popover</h4>
+      <p>A <code>countUrl</code> on the entry draws a count badge beside it. The route answers
+        <code>{count, label, tone, details}</code>. <code>tone</code> is <code>danger</code> (red, something is late),
+        <code>live</code> (a pulsing dot, happening now) or <code>info</code>. <code>details</code> fills the popover
+        shown on hover: <code>{title, rows: [{label, value}], items: [{text, meta}], empty}</code>, all plain
+        text. Counts refresh every minute. When your screen changes the number, tell the sidebar straight away with
+        <code>sidebarCount(url)</code> from the tool kit (below). With Dashboard Pro, the same answer is
+        offered as a Dashboard widget.</p>
+      <pre class="code-block"><code>fastify.get('/_count', { preHandler: [authenticate] }, async () =&gt; {
+    const overdue = await countOverdue();
+    return {
+        count: overdue,
+        label: `${overdue} overdue`,
+        tone: overdue ? 'danger' : 'info',
+        details: { title: 'Invoices', rows: [{ label: 'Overdue', value: String(overdue) }], empty: 'Nothing overdue.' }
+    };
+});</code></pre>
+
+      <h4>The banner, help and the tool kit</h4>
+      <p>Every Tool screen sits under a banner showing its name, version, date and licence, drawn by the admin. Put
+        screen-level buttons (New, Import, a settings cog) <strong>in</strong> the banner with
+        <code>addBannerAction</code>. Add a (?) beside anything that needs explaining with a <code>data-help</code>
+        attribute (plain text) and <code>helpPopovers</code>. <code>tool-kit.js</code> has the rest:
+        <code>openMenuAt</code> for a ⋮ button that opens a row's right-click menu, <code>viewLifetime</code> to
+        tidy up listeners when the user leaves, <code>onceClosed</code> to remove a slideover once it closes, and
+        <code>sidebarCount</code>.</p>
+      <p>Load these <strong>at run time</strong> with <code>import()</code>, never a static import. The admin is
+        replaced on every CMS update, so your Tool must keep working, with less, on a CMS that lacks one of them:</p>
+      <pre class="code-block"><code>async onMount($container) {
+    try {
+        const chrome = await import('/admin/js/lib/plugin-chrome.js');
+        chrome.addBannerAction?.($container, { icon: 'plus', title: 'New invoice', onClick: () =&gt; openNew() });
+        const help = await import('/admin/js/lib/help-popover.js');
+        help.helpPopovers($container, { position: 'bottom' });
+    } catch {
+        // an older admin: put the button in your own toolbar instead
+    }
+}</code></pre>
+      <p>Right-click menus come from <code>E.contextMenu</code> on your rows, and screens stay readable in every theme
+        if your CSS uses only the theme's <code>--dm-*</code> variables.</p>
+
+      <h4>Needing other Tools</h4>
+      <p><code>requires</code> lists Tools yours cannot work without: it is not loaded while one of them is off.
+        <code>uses</code> lists the ones it can do without, with what is lost
+        (<code>{"contacts": "Invite a contact group"}</code>). When an admin switches one of those off, the
+        Marketplace shows them that text first.</p>
+
+      <h4>Data and blocks</h4>
+      <p>A Tool that keeps records can ship collections (<code>collections/&lt;slug&gt;/schema.json</code>, created the
+        first time it is switched on), forms and pages. To give your public pages a design site owners can change, use
+        a <a href="#/docs/usage/blocks">block</a>. Create it in <code>onEnable</code>, which runs every time the Tool
+        is switched on, so only when it is not there yet - otherwise you would undo the site owner's changes in
+        <strong>Data &gt; Blocks</strong>:</p>
+      <pre class="code-block"><code>export async function onEnable({ services }) {
+    const exists = await services.blocks.getBlock('invoice-card').then(() =&gt; true, () =&gt; false);
+    if (!exists) await services.blocks.saveBlock('invoice-card', INVOICE_CARD_HTML, { css: INVOICE_CARD_CSS });
+}</code></pre>
+
+      <hr>
+
+      <h3>6. Injection snippets (optional)</h3>
       <p>HTML snippets declared in <code>inject.head</code>, <code>inject.headLate</code> and
         <code>inject.bodyEnd</code> are read from the plugin's folder and inserted into every public page. Use
         this for analytics scripts, stylesheets, or widgets. They are read once at start-up.</p>
@@ -272,15 +367,16 @@ export const myPluginView = {
 
       <hr>
 
-      <h3>6. User guide (optional)</h3>
+      <h3>7. User guide</h3>
       <p>Markdown files in the plugin's <code>docs/</code> folder become pages under <strong>Documentation &gt;
-        Plugins</strong> while the plugin is loaded, shown only to users who can use the plugin.
+        Plugins</strong> while the Tool is on, shown only to users who can use it.
         <code>guide.md</code> is the first page; further files become tabs. Start with <code>##</code> sections,
-        not a top-level heading, and write for site owners.</p>
+        not a top-level heading, and write for site owners: what it does, getting started, one section per
+        screen, settings, permissions. Update it in the same change as the feature.</p>
 
       <hr>
 
-      <h3>7. Switching it on and testing</h3>
+      <h3>8. Switching it on and testing</h3>
       <ol>
         <li>Create the <code>plugins/my-plugin/</code> directory with all three required files (or use
           <strong>New plugin</strong>, which does this and switches it on).</li>
@@ -294,6 +390,13 @@ export const myPluginView = {
         <li>Verify your endpoint: <code>GET /api/plugins/my-plugin/hello</code></li>
       </ol>
 
+      <h3>9. Sharing it</h3>
+      <p>On the Marketplace screen, right-click your Tool and choose <strong>Export .dcmsplugin</strong>. On another
+        site, <strong>Install from file</strong> in the Marketplace banner takes that file. Installing a newer version
+        of a Tool that is already there updates it in place, keeping its <code>data/</code>, and if anything goes
+        wrong the old version is put back. An unsigned file, or an older version than the one installed, asks for
+        your confirmation first.</p>
+
       <p class="text-muted" style="font-size:.9rem">Tip: use <code>npm run dev</code> during development -
         the server restarts automatically on file changes. Server-side files (<code>plugin.js</code>,
         <code>config.js</code>, <code>plugin.json</code>, snippets) only apply after a restart; the in-admin code

package/admin/js/templates/docs/usage-blocks.html

@@ -0,0 +1,243 @@
+<div class="view-header">
+  <h1><span data-icon="box"></span> Blocks</h1>
+  <a href="#/documentation" class="btn btn-ghost btn-sm"><span data-icon="arrow-left"></span> All usage topics</a>
+</div>
+
+<div class="row">
+  <div class="col-12">
+    <div class="docs-body">
+
+      <p>A <strong>block</strong> is a small piece of your own HTML, with an optional stylesheet, that you write once
+        and place anywhere. Its <strong>placeholders</strong> are filled in when the page is drawn: from a collection's
+        entries, from a view, or from values you type into the shortcode. Use a block when the built-in displays are
+        not quite the design you want. Team cards, product tiles, testimonials, a price table row and a contact panel
+        are all one block each, and the data behind them stays in a collection where anyone can edit it.</p>
+      <p>Blocks are kept in <strong>Data &gt; Blocks</strong>. Each one is a file in <code>content/blocks/</code>:
+        <code>&lt;name&gt;.html</code> holds the template, <code>&lt;name&gt;.css</code> its styles (optional) and
+        <code>&lt;name&gt;.meta.json</code> its project and bundled flag (optional).</p>
+
+      <h3>Three ways to place a block</h3>
+      <table class="table table-sm">
+        <thead>
+        <tr>
+          <th>You want</th>
+          <th>Write</th>
+          <th>Placeholders come from</th>
+        </tr>
+        </thead>
+        <tbody>
+        <tr>
+          <td>One copy per collection entry</td>
+          <td><code>[collection slug="team" display="block" block="team-card" cols="3" /]</code></td>
+          <td>Each entry's fields</td>
+        </tr>
+        <tr>
+          <td>One copy per row of a view (filtered, joined, sorted)</td>
+          <td><code>[view slug="open-jobs" display="block" block="job-card" /]</code></td>
+          <td>Each row of the view</td>
+        </tr>
+        <tr>
+          <td>One copy by itself, with values you type</td>
+          <td><code>[block template="cta-banner" heading="Book a call" /]</code> or the short tag
+            <code>[cta-banner heading="Book a call" /]</code></td>
+          <td>The shortcode's own attributes</td>
+        </tr>
+        </tbody>
+      </table>
+      <p>A block also draws each slide of a carousel or each row of a list group:
+        <code>[collection slug="team" display="carousel" block="team-card" /]</code> and
+        <code>display="listgroup" block="…"</code> work the same way.</p>
+
+      <hr>
+
+      <h3>Blocks with collections and views</h3>
+      <p>This is where blocks are most useful. The collection holds the data and the block holds the design, so a new
+        entry shows up on the page, styled, as soon as it is saved. There is no page to edit.</p>
+      <ul>
+        <li><code>display="block"</code> plus <code>block="&lt;name&gt;"</code> draws every entry through the block.</li>
+        <li>On a <code>[collection]</code>, <code>cols="2"</code> to <code>cols="6"</code> lays the copies out in a
+          responsive grid. Leave it out to stack them. A <code>[view]</code> always stacks them.</li>
+        <li>Everything else on <code>[collection]</code> still works: <code>limit</code>, <code>sort</code>,
+          <code>order</code>, the <code>where_&lt;field&gt;</code> filters, <code>scope="mine"</code>,
+          <code>empty</code>, <code>item-class</code> and the per-entry <code>cta</code> buttons (drawn under each
+          copy).</li>
+        <li>On a <code>[view]</code>, <code>block="…"</code> may be left out when the view's Display tab already names
+          a block.</li>
+        <li>Visitors can still right-click any copy to filter, sort, group, copy or export, as they can on the other
+          displays. Only the fields the block actually uses are offered.</li>
+      </ul>
+      <p>If the named block does not exist, the page shows <em>Block template "name" not found</em> where the entries
+        would be, so a typo is easy to spot.</p>
+
+      <h3>Blocks on their own</h3>
+      <p><code>[block template="name" … /]</code> draws one copy, with each other attribute filling the placeholder
+        of the same name. Every block can also be written with its name as the tag, so
+        <code>[contact-card full_name="Jane Doe" /]</code> means the same as
+        <code>[block template="contact-card" full_name="Jane Doe" /]</code>.</p>
+      <ul>
+        <li>Short tags are self-closing (end with <code>/]</code>). They work for any block whose name does not clash
+          with a built-in shortcode. A block called <code>card</code> or <code>menu</code> can only be placed with
+          <code>[block template="…"]</code>.</li>
+        <li><code>class</code> and <code>id</code> go on the wrapper around the copy.</li>
+        <li>A placeholder with no value comes out empty, and a block that does not exist is removed without a
+          message.</li>
+        <li>Values are written in double quotes. For a value that itself contains a double quote, use single quotes
+          around it instead.</li>
+        <li>Blocks are expanded even inside inline code and code fences on a page. To mention a block's shortcode in
+          ordinary text, write its opening bracket as <code>&amp;#91;</code>. Inside code that does not work (it shows
+          as written), so keep block shortcodes out of code samples on your pages.</li>
+      </ul>
+
+      <hr>
+
+      <h3>Writing the template</h3>
+      <p>A template is ordinary HTML. Domma classes (<code>card</code>, <code>badge</code>, <code>grid</code>,
+        <code>btn</code>) and icons (<code>&lt;span data-icon="mail"&gt;&lt;/span&gt;</code>) work as they do anywhere
+        else on the site. Placeholders are field names in double curly braces:</p>
+      <table class="table table-sm">
+        <thead>
+        <tr>
+          <th>Placeholder</th>
+          <th>What goes in</th>
+        </tr>
+        </thead>
+        <tbody>
+        <tr>
+          <td><code>&#123;&#123;field&#125;&#125;</code></td>
+          <td>The value, made safe as text (HTML is escaped). Use this almost everywhere.</td>
+        </tr>
+        <tr>
+          <td><code>&#123;&#123;field:DD MMM YYYY&#125;&#125;</code></td>
+          <td>The value formatted as a date. Tokens: <code>YYYY YY MMMM MMM MM M DD D dddd ddd HH H hh h mm m ss s A
+            a</code>; anything else passes through, so <code>DD/MM/YYYY</code> and <code>HH:mm</code> work. A value
+            that is not a date is shown as it is.</td>
+        </tr>
+        <tr>
+          <td><code>&#123;&#123;&#123;field&#125;&#125;&#125;</code></td>
+          <td>The value inserted <strong>as HTML</strong>, unescaped. Only for fields you trust, such as rich text
+            written by your own editors.</td>
+        </tr>
+        <tr>
+          <td><code>&#123;&#123;_id&#125;&#125;</code>, <code>&#123;&#123;_createdAt&#125;&#125;</code>,
+            <code>&#123;&#123;_updatedAt&#125;&#125;</code></td>
+          <td>The entry's id and its created and updated times (collections and views only). Combine them with a
+            format: <code>&#123;&#123;_createdAt:D MMMM YYYY&#125;&#125;</code>.</td>
+        </tr>
+        </tbody>
+      </table>
+      <p>The page is cleaned before it is sent, so anything in a block that could run code (a
+        <code>&lt;script&gt;</code>, an <code>onclick</code> or <code>onerror</code> handler, a
+        <code>javascript:</code> link) is removed, exactly as it would be in page content.</p>
+
+      <h4>Describe the block in a comment</h4>
+      <p>Start the template with an HTML comment saying what it is, what it expects and how to use it. The Blocks list
+        shows the first line as the block's description, and <strong>Copy shortcode</strong> copies the example.
+        Comments are stripped when the block is drawn, so they never reach the page.</p>
+      <pre class="code-block"><code>&lt;!--
+  team-card - One team member: photo, name, role and a short bio.
+
+  Parameters:
+    name   - Full name
+    role   - Job title
+    photo  - Image URL
+    bio    - One or two sentences
+
+  Example:
+    [collection slug="team" display="block" block="team-card" cols="3" /]
+--&gt;
+&lt;div class="card team-card"&gt;
+  &lt;img class="team-card-photo" src="&#123;&#123;photo&#125;&#125;" alt="&#123;&#123;name&#125;&#125;"&gt;
+  &lt;div class="card-body"&gt;
+    &lt;h3&gt;&#123;&#123;name&#125;&#125;&lt;/h3&gt;
+    &lt;span class="badge badge-secondary"&gt;&#123;&#123;role&#125;&#125;&lt;/span&gt;
+    &lt;p&gt;&#123;&#123;bio&#125;&#125;&lt;/p&gt;
+  &lt;/div&gt;
+&lt;/div&gt;</code></pre>
+
+      <h4>Styles</h4>
+      <p>A block's <strong>Custom CSS</strong> applies to that block only: the CMS wraps it in
+        <code>[data-block="name"] { … }</code>, so plain rules like <code>.team-card-photo { … }</code> cannot leak
+        onto the rest of the page. Use CSS nesting for child rules, and the theme's <code>--dm-*</code> variables
+        (<code>var(--dm-primary)</code>, <code>var(--dm-border)</code>) so the block follows the site theme and dark
+        mode.</p>
+      <pre class="code-block"><code>.team-card-photo {
+  width: 100%;
+  aspect-ratio: 1;
+  object-fit: cover;
+  border-bottom: 3px solid var(--dm-primary);
+}</code></pre>
+      <p><code>@keyframes</code>, <code>@font-face</code> and <code>@import</code> cannot be scoped. Put those in
+        <strong>Site Settings &gt; Custom CSS</strong>. A block's stylesheet may be up to 50 KB. It is sent once for
+        each shortcode that uses the block, however many entries that shortcode shows.</p>
+
+      <hr>
+
+      <h3>The Blocks screen</h3>
+      <p><strong>Data &gt; Blocks</strong> lists every block with its description, whether it has CSS, and how many
+        pages and views use it.</p>
+      <ul>
+        <li><strong>All</strong>, <strong>In use</strong> and <strong>Unused</strong> filter the list, and the search
+          box finds a block by name or description.</li>
+        <li><strong>Click</strong> a block to edit it. <strong>Right-click</strong> it (or use ⋮, or
+          <kbd>Shift</kbd>+<kbd>F10</kbd>) to copy its shortcode, see where it is used, duplicate, export or
+          delete it.</li>
+        <li><strong>New block</strong> and <strong>Import</strong> are in the banner at the top.</li>
+        <li>The sidebar badge counts your blocks. Hover over it for the unused ones and the latest changes.</li>
+      </ul>
+      <p><em>In use</em> is worked out from page sources and view settings. A Tool that draws a block from its own code
+        is not counted, so check before deleting a block marked unused.</p>
+
+      <h3>The block editor</h3>
+      <ul>
+        <li><strong>Details</strong>: the name (lowercase letters, digits and hyphens, fixed once the block is saved),
+          an optional project, and <strong>Bundled</strong>, which ships the block with fresh installs.</li>
+        <li><strong>Template HTML</strong>: the editor, with undo, cut, copy, paste and <strong>Format</strong> (tidies
+          the indentation). <strong>Edit</strong>, <strong>Split</strong> and <strong>Preview</strong> choose what you
+          see.</li>
+        <li><strong>Sample values</strong>: one box per placeholder the template uses, filled in for the preview only.
+          Nothing in them is saved. Right-click one to insert its placeholder into the template.</li>
+        <li><strong>Preview</strong>: the block drawn inside your own site page, with its theme, fonts and Custom CSS.
+          Try it at full, tablet or mobile width, as <strong>Three in a grid</strong> (as a collection with
+          <code>cols="3"</code> shows it), or in another theme. The site itself is not changed.</li>
+        <li><strong>Custom CSS</strong>: the block's scoped stylesheet (see Styles above).</li>
+        <li><strong>Placeholder reference</strong>: the table above, at the foot of the screen.</li>
+      </ul>
+      <p><kbd>Ctrl</kbd>+<kbd>S</kbd> saves from anywhere on the screen. If you leave with unsaved changes you are
+        asked first, and your work is kept as a draft for that block until you come back to it.</p>
+
+      <h3>Copying blocks between sites</h3>
+      <p><strong>Export</strong> on a block's right-click menu downloads it as a <code>&lt;name&gt;.dmblock.json</code>
+        file, with its HTML and CSS. On the other site, use <strong>Import</strong> in the Blocks banner. If a block
+        with that name already exists, you are asked before it is replaced.</p>
+
+      <hr>
+
+      <h3>Worked example: a team page</h3>
+      <ol>
+        <li>In <strong>Data &gt; Collections</strong>, create a <code>team</code> collection with the fields
+          <code>name</code>, <code>role</code>, <code>photo</code> and <code>bio</code>, and add a few people.</li>
+        <li>In <strong>Data &gt; Blocks</strong>, choose <strong>New block</strong>, call it <code>team-card</code> and
+          paste the template and CSS from above. Fill in the sample values and check the preview at mobile width and as
+          three in a grid. Save.</li>
+        <li>On your Team page, write
+          <code>[collection slug="team" display="block" block="team-card" cols="3" sort="name" order="asc" /]</code>.</li>
+        <li>From now on, adding a person to the collection adds a card to the page. Changing the block restyles every
+          card at once.</li>
+      </ol>
+
+      <h3>Who can use Blocks</h3>
+      <p>Blocks share the <strong>pages</strong> permission: <em>read</em> to see them, <em>update</em> to create, edit
+        and import, and <em>delete</em> to remove them. A block filed under a project is only shown to users who can see
+        that project.</p>
+
+      <h3>Blocks in your own Tools</h3>
+      <p>A Tool (plugin) can rely on blocks too. It can render one of its pages with a block shortcode, or
+        create the block it needs the first time it is switched on, so the site owner can restyle it here. See <a href="#/tutorials/plugin">Writing a Tool</a>.</p>
+
+      <p class="text-muted" style="font-size:.9rem;">Full shortcode syntax:
+        <a href="#/docs/usage/shortcodes">Shortcodes</a>. Collection displays:
+        <a href="#/docs/usage/collections">Collections &amp; Forms</a> and <a href="#/docs/usage/views">Views</a>.</p>
+
+    </div>
+  </div>
+</div>

package/admin/js/templates/docs/usage-plugins.html

@@ -120,7 +120,7 @@
                           what it does, its screens, settings and permissions.</li>
                       <li><a href="#/docs/usage/editions">Editions &amp; Licences</a> - free and Pro, rental and
                           perpetual licences, and what happens when one ends.</li>
-                      <li><a href="#/tutorials/plugin">Writing a Plugin</a> - build your own.</li>
+                      <li><a href="#/tutorials/plugin">Writing a Tool</a> - build your own.</li>
                   </ul>
 
     </div>

package/admin/js/templates/documentation.html

@@ -58,6 +58,10 @@
           <div class="card-body"><h3 style="margin-top:0;"><span data-icon="users"></span> Users &amp; Roles</h3>
             <p class="text-muted" style="margin-bottom:0;">Accounts, roles, the role ladder, confined roles and resets.</p></div>
         </a>
+        <a href="#/docs/usage/blocks" class="card" style="text-decoration:none;display:block;">
+          <div class="card-body"><h3 style="margin-top:0;"><span data-icon="box"></span> Blocks</h3>
+            <p class="text-muted" style="margin-bottom:0;">Your own HTML templates for collection entries, views and one-off pieces.</p></div>
+        </a>
         <a href="#/docs/usage/tools" class="card" style="text-decoration:none;display:block;">
           <div class="card-body"><h3 style="margin-top:0;"><span data-icon="list"></span> Built-in Tools</h3>
             <p class="text-muted" style="margin-bottom:0;">Contacts, Notes, Todo, Analytics, SEO, notifications and search.</p></div>
@@ -101,7 +105,7 @@
             <p class="text-muted" style="margin-bottom:0;">Emails, webhooks, Actions and what happens after a submission.</p></div>
         </a>
         <a href="#/tutorials/plugin" class="card" style="text-decoration:none;display:block;">
-          <div class="card-body"><h3 style="margin-top:0;"><span data-icon="package"></span> Writing a Plugin</h3>
+          <div class="card-body"><h3 style="margin-top:0;"><span data-icon="package"></span> Writing a Tool</h3>
             <p class="text-muted" style="margin-bottom:0;">Server routes, admin screens and page snippets of your own.</p></div>
         </a>
       </div>