Cette page n’est pas encore disponible en Français ; elle s’affiche donc en anglais.
Create, test and pack a plugin
Scaffold with the create-module wizard, iterate in Module Studio, write check.ts, then validate, pack with a checksum and install.
Create-module wizard
On the Plugins page, Create a new module scaffolds modules/<id>/ with the features you tick — admin page, settings, permission, scheduled job, hooks, public API, database table — including a working page, pure logic, check.ts, README and CHANGELOG. Widgets, filters and messages are added by hand from modules/_templates/module.json.
Module Studio
/admin/plugins/<id>/studio has a file tree, an editor (Ctrl+S), history, an AI assistant that proposes full-file changes shown as diffs, Verify (manifest validation → tsc --noEmit → eslint → your tests file) and Build & restart (the same pipeline as an install). Every apply snapshots the folder, and Revert to restores any snapshot.
Self-test
import { plan } from "./src/logic";
let failed = 0;
const check = (label: string, ok: unknown) => {
console.log((ok ? "ok " : "FAIL ") + label);
if (!ok) failed++;
};
check("plans a visit 2 days after sending", plan(new Date("2026-10-06T09:00:00Z")).toISOString().startsWith("2026-10-08"));
check("negative lead days count as 0", plan(new Date("2026-10-06T09:00:00Z"), -3).toISOString().startsWith("2026-10-06"));
if (failed) process.exit(1);npm run plugin:check site-visits # validates module.json (+ checksum) and runs check.ts
npm run plugin:pack site-visits -- --checksum # writes module.json → checksum, then
# the zip + its .sha256 in the plugins dist folder
npm run check:plugins # the plugin system's own checkOpen Admin → System → Apps → Plugins → Install a plugin.
Upload the zip, paste a URL (add
?sha256=<hex>to verify the download) or pick a folder already undermodules/.Click Check & preview plan and fix every issue it lists; compare the shown archive sha256 with the one you published.
Click Install: the job copies, registers, seeds, typechecks, builds and swap-restarts — and rolls back on any failure.
checksum in module.json. It is not signed. Marketplace releases are different: the platform signs the reviewed package (Ed25519) and every install verifies that signature.Written from: docs/PLUGINS.md, docs/PLUGIN-DEVELOPER-GUIDE.md, src/lib/plugins/studio.ts, src/lib/plugins/installer.ts, scripts/plugin-pack.mjs, modules/example-checklist/check.ts, docs/DEVELOPERS/PLUGIN-SDK.md, src/lib/plugins/checksum.ts