Compare commits

...
174 Commits
Author SHA1 Message Date
github-actions[bot] 046d854ec9 Bump versions for v13.23 2026-11-20 20:25:24 +00:00
Lauri Ojansivu f5d2a208f8 Prepare v13.23 release 2026-11-20 22:24:25 +02:00
Lauri Ojansivu 38db577f31 Merge remote-tracking branch 'origin/main' 2026-11-20 22:23:52 +02:00
Lauri Ojansivu 71b0eb9b7c Update WeKan changelog: company headings in Import and Export.
Thanks to xet7 !
2026-11-20 22:17:19 +02:00
Lauri Ojansivu fa28e3fba8 Import and Export: a company's products under the company's name.
37signals (Basecamp, Fizzy), Atlassian (Trello, Jira), Google (Takeout,
Tasks, Keep) and Microsoft (Planner, To Do, Excel, GitHub) each have a
heading of their own after WeKan, and their products are shown without
the company's name in front of them.

Thanks to xet7 !
2026-11-20 22:17:02 +02:00
github-actions[bot] 79cc436257 Bump versions for v13.22 2026-11-20 19:05:46 +00:00
Lauri Ojansivu 67fa4344c6 Prepare v13.22 release 2026-11-20 21:04:53 +02:00
Lauri Ojansivu 7b2d37fb41 Update WeKan changelog: Rocket.Chat and Fizzy.
Thanks to xet7 !
2026-11-20 20:29:28 +02:00
Lauri Ojansivu dffbafd30f Import and export Rocket.Chat and Fizzy.
Rocket.Chat: "Download my data" as JSON (channels.json and a message file
per room, with its assets), one room's .json, and the .zip Rocket.Chat's
CSV importer reads are imported for Board View / Chat - a room is a card,
its messages the comments. A board exports as that CSV importer .zip:
users.csv, channels.csv and a messages.csv per card.

Fizzy (37signals): its account export (data/<table>/<id>.json and
storage/) and personal data export (<number>.json per card) are imported -
boards become swimlanes, columns lists between Maybe?, Not now and Done,
with tags, assignees, steps, comments, golden and files. A board exports as
the account export Fizzy's account import reads, every row with every
column its import requires, ids as base36 UUIDv7.

Both formats are read and written from their projects' source code, with
tests, documentation and the import instruction in every language. Low
confidence translations include chr, ay, bm, bua, bo, cv, csb, ak, bi, ace,
ba, gn, gv, iu, kl, ig, kok, nah, qu, kw, lld, nap, rm, om, ks, tlh, tig,
rup, sah, se, ss, sm, to, tpi, dz, ee, ff, fj, fo, uz-AR, ve, ve-PP, vo,
wal, wa, wo, zgh, ve-CC, wa-RR, wuu-Hans, yi, xh and yo.

Thanks to xet7 !
2026-11-20 20:29:01 +02:00
Lauri Ojansivu dd57704ed1 Update WeKan changelog: Planner columns.
Thanks to xet7 !
2026-11-20 19:54:55 +02:00
Lauri Ojansivu d3aa34e7b8 Planner: the newer "Export as Excel" column names are read too; Linear is checked against its importer.
Microsoft's "Export a plan to Excel" page describes the newer Planner's
export with Status, Task title and Assignments, where the classic export
(the plannr fixture the tests use) writes Progress, Task Name and Assigned
To. The import now finds a column by either name, so the newer workbook is
not refused for a missing Task Name column. Linear's open-source importer
(@linear/import, LinearCsvImporter.ts) declares the columns the parser
reads, so Linear leaves TODO.md's list; Planner stays until a real newer
export confirms the exact header spelling.

tests/plannerFormat.test.cjs: the newer names, and a sheet without a title
column still refused.

Thanks to xet7 !
2026-11-20 19:54:54 +02:00
Lauri Ojansivu c5f30d8b7f Release audit: allow files.slack.com for the Slack file download.
The Slack import's file sign-in (models/lib/importAttachmentAuth.js) names
https://files.slack.com, the one host a Slack token is sent to, and the
release risk audit (tests/releaseTelemetry.test.cjs) stopped on the new URL
origin. It is added to that file's allowlist beside Asana's.

Thanks to xet7 !
2026-11-20 19:53:09 +02:00
Lauri Ojansivu 3a4163cfc3 TODO: Redmine and monday.com take a new column as a custom field; the proprietary tools are left.
Thanks to xet7 !
2026-11-20 19:44:54 +02:00
Lauri Ojansivu 2120be5ae1 Update WeKan changelog: GitLab health and severity.
Thanks to xet7 !
2026-11-20 19:44:34 +02:00
Lauri Ojansivu c916b15473 GitLab: an issue's health status and an incident's severity are kept as labels.
GitLab's Issues API v4 gives an issue a health_status (on_track,
needs_attention, at_risk) and an incident a severity, and the import
dropped both. They are now "health:..." and "severity:..." labels, as the
issue type is a "type:..." one; an UNKNOWN severity is none.

tests/gitlabImport.test.cjs: both labels, and none for a missing health or
an unknown severity.

Thanks to xet7 !
2026-11-20 19:44:33 +02:00
Lauri Ojansivu 0ef02911a8 TODO: GitHub checked against its REST issue; Focalboard's format is frozen since 2023.
Thanks to xet7 !
2026-11-20 19:43:51 +02:00
Lauri Ojansivu 246b23eaf7 Docs: GitHub's issue type as a type: label.
Thanks to xet7 !
2026-11-20 19:43:00 +02:00
Lauri Ojansivu b4e66b7584 Update WeKan changelog: GitHub issue types.
Thanks to xet7 !
2026-11-20 19:42:47 +02:00
Lauri Ojansivu 9ceb4dbf55 GitHub's issue type is kept as a "type:" label.
GitHub's issues have a type since 2025 (Bug, Feature, Task, or the
organization's own), { name, color, ... } on the issue, and the import
dropped it. It is now a "type:<name>" label, as the GitLab import keeps
issue_type.

tests/githubImport.test.cjs: the label, and none without a type.

Thanks to xet7 !
2026-11-20 19:42:46 +02:00
Lauri Ojansivu 49dd8dcb00 Update WeKan changelog: GitHub, Gitea and Forgejo dates and people.
Thanks to xet7 !
2026-11-20 19:42:20 +02:00
Lauri Ojansivu efeb55f57a GitHub, Gitea and Forgejo keep an issue's creation and close dates, people and Gitea's time estimate, both ways.
Checked against Gitea's current Issue struct (modules/structs/issue.go): the
import read neither created_at nor closed_at nor Gitea 1.23's
time_estimate, and the export wrote no dates, no assignee and no author, so
a round trip lost the creation date, the owner and the requester (as
tests/exportRoundTripFields.test.cjs showed). The import now reads
created_at as the creation date, closed_at of a closed issue as its end and
time_estimate (seconds) as the Time estimate (hours) custom field; the
export writes the owner as assignee and assignees, the creator as user,
created_at, closed_at of a closed issue and the time estimate.

tests/githubImport.test.cjs: the dates and the estimate, and an open issue
without an end; tests/exportRoundTripFields.test.cjs holds all three to the
creation date, owner and requester now.

Thanks to xet7 !
2026-11-20 19:42:18 +02:00
Lauri Ojansivu 85da7079fb TODO: Plane, Kanri, Obsidian Kanban and Nullboard checked against their current source; Pivotal Tracker is shut down.
Plane's current IssueExportSerializer has the fields the parser reads, in
the same order; Kanri's kanban-types.d.ts the board, column, card, task and
tag fields; Obsidian Kanban's parser the frontmatter key, settings block,
archive and complete markers; Nullboard's board object its format, id,
revision, title, lists and notes, and a history of revision numbers that
is not board data (noted in nullboardFormat.js). Pivotal Tracker was shut
down in 2025. They leave the list of tools still to check with a real
export.

Thanks to xet7 !
2026-11-20 19:40:31 +02:00
Lauri Ojansivu bb733d7692 Update WeKan changelog: Slack files.
Thanks to xet7 !
2026-11-20 19:38:17 +02:00
Lauri Ojansivu dd8242b82f Slack import downloads the messages' files with a Slack token.
A Slack export names each message file by its url_private on
files.slack.com, behind Slack's sign-in, and does not carry it; the import
counted every one. The import page's file sign-in now offers Slack too: with
a token of the files:read scope, each file is downloaded from
files.slack.com only - the token goes to no other host, and the download is
the import's guarded fetch like every other attachment - and attached to
the channel's card. Without a token a file is reported as not downloaded,
since Slack would answer with its sign-in page; a deleted file or one
hidden by the plan's history limit has no address and is counted.

tests/importAttachmentAuth.test.cjs: the token on Slack's file host only,
no download without one, the files on the channel card and the counted
ones.

Thanks to xet7 !
2026-11-20 19:38:16 +02:00
Lauri Ojansivu 709fa87f4a Update WeKan changelog: Super Productivity repeats.
Thanks to xet7 !
2026-11-20 19:35:50 +02:00
Lauri Ojansivu 35f3f6c9db Super Productivity export writes a repeating card's taskRepeatCfg, so it repeats there too.
The import read a task's repeat config, and the export wrote none, so a
repeating card came back from Super Productivity once. It was left until
the config could be checked against the app; it is now written with the
fields and defaults of Super Productivity's own model
(src/app/features/task-repeat-cfg/task-repeat-cfg.model.ts, TaskRepeatCfgCopy
and DEFAULT_TASK_REPEAT_CFG): every required field, the cycle and its quick
setting, the start date (due, or created), the weekday of a weekly repeat,
and today as the last creation day, since the card is this period's task.
An open card only, and the slice only when there is one.

tests/recurrenceMap.test.cjs: the required fields, the three cycles, no
config for a finished or one-off card, the task's repeatCfgId and the round
trip; tests/exportRoundTripFields.test.cjs: Super Productivity keeps the
recurrence.

Thanks to xet7 !
2026-11-20 19:35:49 +02:00
Lauri Ojansivu f918deef0f TODO: the import/export review is done against every documented format; what is left needs accounts on the tools or a running copy.
The review went through every parser and formatter; what it found is fixed
in the Upcoming release and held by the round-trip tests. The rest needs a
real export of each tool's newest release, a running Super Productivity, or
a Slack token, and is listed under the category that says so.

Thanks to xet7 !
2026-11-20 19:25:38 +02:00
Lauri Ojansivu deb4eed14e Update WeKan changelog: Telegram and Discord files.
Thanks to xet7 !
2026-11-20 19:25:18 +02:00
Lauri Ojansivu 828ca63713 Telegram and Discord imports bring their message files: a zipped export folder's photos and files are attachments.
Telegram Desktop writes result.json with photos/ and files/ beside it, and
DiscordChatExporter with --media a <name>.json_Files folder; the imports
read only the JSON and counted every file. Both now also take the export
folder zipped (the Import page, the many-files import and api.py): the
JSON is read as before, and every file its messages name by a local path
is read under the same per-file and whole-archive inflate limits as the
Slack zip (server/lib/chatArchives.js), then attached to the chat's card
through the generic importer's embedded-file path - so the after-upload
type and size checks of every upload apply. A file the folder does not
carry ("File not included", a Discord link) is still counted; a file no
message names is not read.

tests/chatExportFormats.test.cjs: both zips, only the named files read, the
left-out file counted, the JSON alone as before, and the wiring.
tests/importSources.test.cjs: the zip sources, and api.py agreeing.

Thanks to xet7 !
2026-11-20 19:25:17 +02:00
Lauri Ojansivu 133be01324 Update WeKan changelog: Linear cycles.
Thanks to xet7 !
2026-11-20 19:20:45 +02:00
Lauri Ojansivu 75694ac644 Linear cycles become Scrum sprints and project milestones Scrum releases.
Linear's CSV export carries each issue's cycle with its Cycle Start and
Cycle End, and its project milestone, and the import kept the cycle name as
a custom field and reported the dates and the milestone. With Scrum ticked
in the import, each cycle is now a sprint with those dates - one per team,
since a cycle number is its team's - and each project milestone a release,
through models/lib/externalScrumPlanning.js like GitLab's iterations and
Pivotal's. As for Pivotal and Jira, a cycle whose issues are all done is
finished and not imported (no commitment or close snapshot in the export),
and any other is planned; a milestone has no dates in the CSV. Both are in
the loss report.

tests/linearCsv.test.cjs pinned the cycle dates and milestones as lost
columns and now pins the sprints and releases, per team, with the finished
cycle and an issue without either.

Thanks to xet7 !
2026-11-20 19:20:44 +02:00
Lauri Ojansivu 9a18cc3dda Update WeKan changelog: Basecamp steps.
Thanks to xet7 !
2026-11-20 19:17:27 +02:00
Lauri Ojansivu a72b297268 Basecamp card steps keep their due date and assignee.
A Basecamp card step has its own due_on and assignees, and the import kept
only its title and done mark; a WeKan checklist item has a due date and an
assignee too (models/lib/importedTaskPlan.js importedChecklists). The step's
due date and first assignee are now its item's.

tests/basecampApiImport.test.cjs: the step's fields onto the checklist
item, and a step without them.

Thanks to xet7 !
2026-11-20 19:17:26 +02:00
Lauri Ojansivu 651378d163 Update WeKan changelog: Taiga blocked.
Thanks to xet7 !
2026-11-20 19:15:35 +02:00
Lauri Ojansivu ab884547f4 Taiga's blocked state is the card's Blocked flow field, both ways.
WeKan cards have a Blocked flow field with a reason, and the Taiga import
put is_blocked / blocked_note into a "Blocked" custom field, from before the
flow field existed. A normalized task may now carry blocked and
blocked_reason, which the shared import plan writes as the card's flow
field; the importer turns on Board Settings / Card's Blocked display for a
board with a blocked card, since flow fields are off until a board shows
them. Taiga uses it, and its export writes the card's Blocked flow field
(or the custom field of a board imported before) back to is_blocked and
blocked_note.

tests/taigaFormat.test.cjs pinned the custom field and now pins the flow
field, the board display and the export; tests/exportRoundTripFields.test.cjs
holds every format to whether it keeps Blocked.

Thanks to xet7 !
2026-11-20 19:15:34 +02:00
Lauri Ojansivu 8ac7afe95f Update WeKan changelog: Todoist and TickTick columns.
Thanks to xet7 !
2026-11-20 19:04:21 +02:00
Lauri Ojansivu c72a05d11a Todoist and TickTick report a column they do not write, instead of dropping it.
A sweep of the CSV imports with an extra column (each format's own export
plus one) found Linear, MeisterTask, Pivotal and Quire reporting it,
Redmine, Notion and now ClickUp keeping it as a custom field - and Todoist
and TickTick dropping it without a word. Their own exports have fixed
columns, so an extra one is a hand-edited file; it is now named in the loss
report.

tests/todoistCsv.test.cjs and tests/ticktickCsv.test.cjs: the report, and
none for the format's own export.

Thanks to xet7 !
2026-11-20 19:04:20 +02:00
Lauri Ojansivu 01f52748f3 Update WeKan changelog: ClickUp custom fields.
Thanks to xet7 !
2026-11-20 19:03:04 +02:00
Lauri Ojansivu 60f569afe6 ClickUp: a workspace's custom field columns come across both ways, and the task link is kept.
A ClickUp workspace export writes each custom field as a column of its own,
and the import dropped every column it did not name - Story Points, Sprint,
any field of the workspace's - without a word, as it dropped Task Link.
Every column ClickUp does not name is now a custom field of its name, the
export writes a card's other custom fields back as columns (named over the
whole board, so every page has the same header), and the Task Link is
"Source: <link>" at the end of the description, as other imports keep a
source's link. ClickUp's own Rolled Up Time and Text columns repeat other
columns and are still not read.

tests/clickupCsv.test.cjs: both ways, one column per field, ClickUp's own
columns not made fields, and the Source line.

Thanks to xet7 !
2026-11-20 19:03:03 +02:00
Lauri Ojansivu d8fff9a41a Update WeKan changelog: Notion relations.
Thanks to xet7 !
2026-11-20 19:01:15 +02:00
Lauri Ojansivu f546ff2383 Notion relations between rows of an export become "related to" dependencies.
A Notion relation column names the related pages by title and path, and
the import reported every relation column as not imported. A related page
that is exactly one row of the export, in any of its databases, is now a
"related to" dependency between the two cards. A relation to a page that is
not a row, or to a title two rows share, is not guessed and is counted in
the loss report.

tests/notionFormat.test.cjs pinned the relation column as a loss and now
pins the dependency, with the negative cases.

Thanks to xet7 !
2026-11-20 19:01:13 +02:00
Lauri Ojansivu e38168789d Update WeKan changelog: Push Snap to Store.
Thanks to xet7 !
2026-11-20 18:59:04 +02:00
Lauri Ojansivu ce646dc937 Push Snap to Store releases what the store already has, each channel on its own, and uploads a file once.
The v13.20 and v13.21 runs uploaded wekan_13.21_amd64.snap again and again,
each time answered "Error checking upload uniqueness", and never released
it. The cause: snapcraft 9 renamed list-revisions to revisions, and the old
name only prints that and fails, so the script never found the revision the
store already had, and the store takes a file only once. On the dashboard
the wekan and wekan-gantt-gpl 13.21 revisions are "Can't be released:
ReviewQueued" - held for the store's manual review, greyed out on the web
too.

Now:
- the store's revisions are read with `snapcraft revisions` (the old name
  for an older snapcraft), and a revision the store has is released, never
  uploaded again;
- a file is uploaded once by default; after "Error checking upload
  uniqueness" the store's revision is released, or reported as held with
  how to ask for the review;
- every release goes to each channel on its own, so one the store refuses
  does not keep the revision out of the others, and each refusal is an
  error line in the log;
- after a release's files, the newest revision of every architecture the
  store has is released to every channel too
  (releases/snap-store-release-newest.sh), whatever the GitHub release
  holds - a revision approved later is released by the next run;
- a release with no wekan-ondra or wekan-gantt-gpl snap gets them made from
  its wekan snaps (releases/snap-rename.sh), as Release All Missing does;
- the release-time upload (snap-upload-retry.sh) still retries a
  uniqueness error (on v10.78 a store glitch), and when it outlasts the
  retries reports the file as held instead of failing the build.

Release All and Release All Missing both end by calling this workflow, so
the same steps run in all three. tests/snapStorePush.test.cjs and
tests/snapUploadProcessingBudget.test.cjs drive the scripts with a fake
snapcraft that answers as snapcraft 9 does.

Thanks to xet7 !
2026-11-20 18:59:03 +02:00
Lauri Ojansivu ae1f084fb1 Update WeKan changelog: subtask due dates and people.
Thanks to xet7 !
2026-11-20 18:37:54 +02:00
Lauri Ojansivu cf6f67e789 Imported subtasks keep their due date and person: a checklist item has both.
A WeKan checklist item has a due date and an assignee, and the shared
import plan and writer carried only its title and done mark - so Google
Tasks and KanbanFlow reported a subtask's due date and person as having "no
place on a WeKan checklist item". A normalized item may now carry `due` and
`assignee`; the plan maps the person to a board member (left out when not
mapped) and the writer stores dueAt and assigneeId. Google Tasks keeps a
subtask's due date, KanbanFlow its due date and person; a subtask's notes
and links are still reported.

tests/kanbanflowApiImport.test.cjs pinned the loss and now pins the item's
due date and assignee; tests/googletasksApiImport.test.cjs: the due date,
the notes still reported, and a due date that is no date.

Thanks to xet7 !
2026-11-20 18:37:53 +02:00
Lauri Ojansivu 3ccce83480 Update WeKan changelog: Planka 2.
Thanks to xet7 !
2026-11-20 18:29:00 +02:00
Lauri Ojansivu 0d65eec4f2 Planka 2: custom fields and stopwatch time come across.
Planka 2's custom fields (customFieldGroups, customFields,
customFieldValues) and a card's stopwatch were reported as not imported,
though imports make custom fields and WeKan cards have spent time. A value
is now the card's custom field of its field's name - "Group: Field" when two
groups have a field of that name - and the stopwatch total (seconds) is the
spent time. A value of a field the export does not name is still reported.

tests/plankaApiImport.test.cjs: both, the group disambiguation, and the
unnamed field.

Thanks to xet7 !
2026-11-20 18:28:58 +02:00
Lauri Ojansivu b26b148779 Update WeKan changelog: Asana.
Thanks to xet7 !
2026-11-20 18:27:33 +02:00
Lauri Ojansivu 57a657445e Asana: html_notes, approval states and comment likes come across.
An Asana API export asked for html_notes may carry only those, and the
card came in without a description; an approval task's approved, rejected
or changes-requested state, and who liked a comment, were dropped without a
word. The rich text is now the description, as text (the Microsoft To Do
body's careful stripping), the approval state a label, and a comment
story's likes its 👍 reactions, by who liked it - the likes the export does
not name are counted in the loss report.

tests/asanaImport.test.cjs: each of them, notes winning over html_notes,
and a pending approval being no state.

Thanks to xet7 !
2026-11-20 18:27:32 +02:00
Lauri Ojansivu b5a97bcd11 Update WeKan changelog: templates.
Thanks to xet7 !
2026-11-20 18:26:16 +02:00
Lauri Ojansivu a4359731b1 WeKan import keeps templates: a template board, card, list or swimlane stays a template.
The WeKan JSON import wrote no board, card, list or swimlane type, so a
template board came back as an ordinary board and its card, list and
swimlane templates as ordinary ones. tests/wekanCardFields.test.cjs did not
catch it: "type" appears elsewhere in wekanCreator.js (attachments have one)
and counted as written.

Now template-board, template-card, template-list and template-swimlane are
kept. A user's own Templates board (template-container) is imported as a
template board, since the importing user's Templates board is the one their
profile points to, and the loss report says so; its section swimlanes
become ordinary swimlanes. A linked card or board points at the exporting
WeKan, so it comes as an ordinary card.

Attachment versions need nothing: the original is the file, and a thumbnail
is made from it when first shown (#3275). A part of a board is exported by
Board Settings / Export's scope and imports as a board of its own. Both are
noted in the docs, and the WeKan item leaves TODO.md.

Thanks to xet7 !
2026-11-20 18:26:15 +02:00
Lauri Ojansivu c05ff7b9a8 TODO: the plain-Node round-trip test covers 32 formats.
Thanks to xet7 !
2026-11-20 18:24:09 +02:00
Lauri Ojansivu d7b0641295 Changelog: shorten the export round-trip summary.
Thanks to xet7 !
2026-11-20 18:24:02 +02:00
Lauri Ojansivu 105a1ed0c1 Update WeKan changelog: export round-trip fields.
Thanks to xet7 !
2026-11-20 18:23:48 +02:00
Lauri Ojansivu 1a02de4b5b Every export is held to what its own import reads back: Asana time tracking, Deck's done tick, Kanboard colors.
tests/exportRoundTripFields.test.cjs exports a card with every field set in
each of the 32 formats WeKan both writes and reads as text or JSON, parses
the file back, and holds each format to a KEEPS table of start and creation
dates, spent time, the due date's done tick, recurrence, owner, requester,
custom fields and color - the fields the Playwright round-trip spec does not
look at. A format that keeps less, or more, fails until its line changes.

What it found, fixed here:
- Asana: the import did not read actual_time_minutes, Asana's time
  tracking, and the export did not write it. Both do now.
- Nextcloud Deck: the export wrote done only with an end date, so a due date
  ticked done came back not done. It writes done: true then, which the
  import reads.
- Kanboard: the import mapped color_id to a card color and the export wrote
  none. It writes it back (the map moved to models/lib/kanboardFields.js).
(Kanboard, OpenProject, ClickUp and GitLab were fixed in the commits before.)

Thanks to xet7 !
2026-11-20 18:23:47 +02:00
Lauri Ojansivu 59ee94667d Update WeKan changelog: ClickUp and GitLab spent time.
Thanks to xet7 !
2026-11-20 18:14:11 +02:00
Lauri Ojansivu 14afc74adb ClickUp and GitLab exports write spent time, which their imports read and a round trip lost.
Both imports read a task's spent time (ClickUp's Time Spent milliseconds,
GitLab's time_stats.total_time_spent seconds), and neither export wrote it.
They do now, in the same units, so it comes back.

tests/clickupCsv.test.cjs and tests/gitlabImport.test.cjs: the round trip,
and nothing written when nothing was spent.

Thanks to xet7 !
2026-11-20 18:14:10 +02:00
Lauri Ojansivu ab1067e0b1 Update WeKan changelog: OpenProject time.
Thanks to xet7 !
2026-11-20 18:12:49 +02:00
Lauri Ojansivu 9bd503a71b OpenProject: remaining time is imported, and spent time is exported, so it survives a round trip.
The import read a work package's spentTime and estimatedTime but not its
remainingTime, and the export wrote no spentTime at all, so a card's spent
hours were lost on the way out. remainingTime is now the custom field
Remaining time (hours), and the export writes the spent hours as an ISO 8601
spentTime (PT1.5H), which the import reads back.

tests/openProjectImport.test.cjs: both ways, and none written when there is
none.

Thanks to xet7 !
2026-11-20 18:12:48 +02:00
Lauri Ojansivu a81050e9b8 Update WeKan changelog: Deck label colors.
Thanks to xet7 !
2026-11-20 18:11:33 +02:00
Lauri Ojansivu 22d000b913 Nextcloud Deck labels keep their colors.
A Deck label has a hex color, and the import created every label black.
The label now carries its color to the board label (hex colors are label
colors since #5514; models/lib/importedTaskPlan.js planImportedLabels
already took them from Kanri). A label without one stays black.

tests/deckImport.test.cjs pinned the bare label name and now pins the
color, onto the board label, with the colorless case.

Thanks to xet7 !
2026-11-20 18:11:32 +02:00
Lauri Ojansivu 1081ea7c88 Update WeKan changelog: Kanboard recurrence and fields.
Thanks to xet7 !
2026-11-20 18:10:05 +02:00
Lauri Ojansivu 28891103f6 Kanboard keeps its task recurrence, estimate, score, reference and external links, both ways.
WeKan's card recurrence was modelled on Kanboard's, and the Kanboard import
ignored a task's recurrence_status / _factor / _timeframe; it reported the
estimate as having no place although imports make custom fields; it
reported external links, and dropped score and reference without a word.
Now a repeat every 1 day, 7 days or 1 month is the card's recurrence (any
other is reported), time_estimated, score and reference are custom fields,
and each external link is a line of the description. The export writes
time_spent, the recurrence of an open card and those custom fields back.
The shared helpers are models/lib/kanboardFields.js, so the formatters,
which load on the client too, do not pull in the parsers.

tests/kanboardImport.test.cjs: both ways and the negative cases; it pinned
the estimate as a loss and now pins the custom field.
tests/recurrenceMap.test.cjs accepts a recurrence read through a module that
uses the mapper.

Thanks to xet7 !
2026-11-20 18:10:04 +02:00
Lauri Ojansivu a86e9d34e8 TODO: issue tracker reactions are reported; the rest is checked against each tool's export docs.
Thanks to xet7 !
2026-11-20 18:00:08 +02:00
Lauri Ojansivu 57413fd66a Update WeKan changelog: issue reaction counts.
Thanks to xet7 !
2026-11-20 17:59:59 +02:00
Lauri Ojansivu 1b9ec7b9a1 GitHub, Gitea, Forgejo and GitLab imports report reaction counts instead of dropping them.
An issue's and its comments' reactions summary (GitHub, Gitea, Forgejo) and
GitLab's upvotes and downvotes are counts, without who reacted. A WeKan
reaction is kept by who reacted (models/lib/importedReactions.js), so they
cannot come across - but they were dropped without a word. The loss report
now counts them.

tests/githubImport.test.cjs: the counts reported, and none when there are
none.

Thanks to xet7 !
2026-11-20 17:59:58 +02:00
Lauri Ojansivu 2268f9d8bd Update WeKan changelog: WeKan import keeps lists, checklists, custom fields and replies.
Thanks to xet7 !
2026-11-20 17:58:38 +02:00
Lauri Ojansivu 24b6b9b024 WeKan JSON import keeps lists' WIP limits, policies and splits, checklist settings, custom field access, item assignees and comment replies.
The same gap as the board and its cards, one level down: a list came back
without its WIP limit, flow policy, split into Doing and Done and role
restrictions; a swimlane without its height; a checklist without its hide
settings and reset schedule; an item without its assignee; a custom field
without "admin only" and "read only" - so a field only admins could see or
edit was open to everyone on the imported board; a reply without the
comment it answers.

models/lib/wekanRecordFields.js writes them, with the users, cards and
comments they name remapped (left out when they did not come), a
checklist's reset counted from the import, and a reply linked even when its
comment comes later in the export. A list role exception is kept only where
it restricts a role: a file does not open a list to a role the board's rule
keeps out. Sync bookkeeping, trash state and other boards' ids are named
with the reason they are not written.

tests/wekanCardFields.test.cjs holds every list to its schema, with
negative tests. The Meteor mocha tests of wekanCreator were not run here.

Thanks to xet7 !
2026-11-20 17:58:37 +02:00
Lauri Ojansivu 07f1028d03 Update WeKan changelog: WeKan import keeps every board and card field.
Thanks to xet7 !
2026-11-20 17:49:20 +02:00
Lauri Ojansivu c640c5c376 WeKan JSON import keeps every board and card field: all Board Settings, flow fields, votes, poker, stickers, drawings.
The WeKan JSON export writes the whole board and card documents, and the
import wrote 32 of the 210 board fields and about 30 of the 87 card fields.
A board exported and imported back came back with every Board Settings
choice at its default - what a card and a minicard show and in which order,
the flow policies, the board views, column sets, WIP limit groups, the date
format, notification delivery, the announcement - and its cards without
their flow fields (Blocked, Class of service, MoSCoW, WSJF), votes, planning
poker, stickers, locations, drawings, column-set columns, the due date's
done tick, mail headers, kind, map position and display settings.

models/lib/wekanBoardFields.js and wekanCardFields.js now write them, with
the users in a vote, a poker card or "blocked by" mapped to the new board's
(left out when they are not on it), lists remapped in the commitment point
and WIP limit groups, and a drawing's PNG by its new attachment id. The
Board Settings are written once the lists exist; a value the schema refuses
- from an older or newer WeKan - is left at its default and reported, and
the WeKan import now has a loss report at all. Not written, each with its
reason: access (organizations, teams, domains, instance editing) and
inbound email, which a file must not turn on; the trash, sync bookkeeping
and running timers; ids of other boards.

tests/wekanCardFields.test.cjs holds both lists to the schemas, so a field
added to WeKan is imported or named with why it is not. The Meteor mocha
tests of wekanCreator were not run here.

Thanks to xet7 !
2026-11-20 17:49:19 +02:00
Lauri Ojansivu 0999864cef Update WeKan changelog: chat threads.
Thanks to xet7 !
2026-11-20 17:35:52 +02:00
Lauri Ojansivu 1122e49ca9 Chat imports keep threads: a reply is a reply to the comment of the message it answers.
Slack (thread_ts), Mattermost (nested replies), Telegram
(reply_to_message_id) and Discord (reference) all say which message a reply
answers, and WeKan comments have replies (parentId, one level deep) - but
the import made every reply a comment of its own, a "↳" line at best. The
parsers now give each message its id and the id it answers, the import plan
(threadImportedComments) turns that into the comment it goes under -
flattened to one level, as WeKan's replies are - and the writer stores its
parentId. A reply to a message that is not in the file stays a comment of
its own, marked "↳".

tests/importedThreads.test.cjs: the four exports through the plan, the
writer, and the negative cases. tests/chatExportFormats.test.cjs pinned the
"↳" text and now pins the thread link.

Thanks to xet7 !
2026-11-20 17:35:51 +02:00
Lauri Ojansivu f72277a398 Update WeKan changelog: chat reactions.
Thanks to xet7 !
2026-11-20 17:33:47 +02:00
Lauri Ojansivu f467e31d17 Chat imports keep reactions: Slack, Mattermost, Telegram and Discord reactions become the comments' reactions.
All four exports say who reacted to a message with what, and WeKan
comments have reactions (card_comment_reactions: an emoji code point and the
users who reacted) - but every reaction was dropped without a word in the
import loss report. models/lib/importedReactions.js turns an emoji, or a
Slack / Mattermost shortcode, into the code point WeKan stores, and keeps a
reaction for each person mapped to a WeKan user. The import plan carries
them, the inserter writes the comment's reaction row, and the loss report
counts the reactions of people not mapped and those WeKan cannot store: an
unknown shortcode, a server's own emoji, several code points (a skin tone,
a flag).

tests/importedReactions.test.cjs: the mapping, the four parsers, the plan,
the writer, and negative tests - including that nothing else builds a
reaction code point.

Thanks to xet7 !
2026-11-20 17:33:46 +02:00
Lauri Ojansivu 8ff76652d4 TODO: the task tools keep priorities, sub-tasks, sections and repeats; the Super Productivity repeat export is left.
Thanks to xet7 !
2026-11-20 17:21:44 +02:00
Lauri Ojansivu 20c4d90217 Update WeKan changelog: Markdown labels, due dates and checklists.
Thanks to xet7 !
2026-11-20 17:21:08 +02:00
Lauri Ojansivu 10caa20b09 Markdown: #tags, due dates and indented checkboxes are labels, due dates and checklists, both ways.
The Markdown import read only a card's title, done mark and indented text:
the #tags and due dates markdown-kanban tools write stayed in the title, and
an indented "- [ ]" line - the card's checklist in those tools - became
description text. The export wrote neither labels, dates nor checklists.

Now #tag words are labels (a word starting with a letter: not "#1234", not
"C#"), @{day} @@{time} (Obsidian Kanban), 📅 day (Obsidian Tasks) and
due:day (todo.txt) are the due date, and indented checkboxes are the
checklist. The export writes them back, escaping a description line that
looks like a checklist item as "\- [ ]" so it reads back as text. A due day
that is no date is reported.

tests/markdownImportExport.test.cjs: both ways and the negative cases. The
round-trip spec's KEEPS table now has Markdown keep the checklist, label
and due date; that Playwright spec was not run here.

Thanks to xet7 !
2026-11-20 17:21:07 +02:00
Lauri Ojansivu 720374efd8 Update WeKan changelog: Leo creation dates.
Thanks to xet7 !
2026-11-20 17:18:52 +02:00
Lauri Ojansivu 3be07b147b Leo: a node's id stamp is the card's creation date, both ways; plugin data is reported.
Leo stamps every node's id (gnx) with the time it was made -
ekr.20260902080910.2 - and the import read it only as a key, while the
export wrote ids as wekan.1.N: a card's creation date was lost both ways.
The import now takes the time from the gnx (local time, read as UTC, as Org
does), and the export writes wekan.YYYYMMDDHHMMSS.n for a card that has a
creation date. Attributes of a <v> or <t> that Leo itself does not write are
its plugins' pickled data, dropped without a word until now; they are
reported.

tests/leoOutline.test.cjs: both ways, invalid stamps, and Leo's own
attributes not reported. tests/exportPaging.test.cjs looked a card's gnx up
as wekan.1.N and now accepts the stamped form.

Thanks to xet7 !
2026-11-20 17:18:50 +02:00
Lauri Ojansivu c2a9c36829 Update WeKan changelog: OPML attributes.
Thanks to xet7 !
2026-11-20 17:16:48 +02:00
Lauri Ojansivu 95b88095c4 OPML keeps created, category, links and an outliner's own attributes.
A card outline's created (OPML 2.0's creation date), its category (its
tags), and any attribute of the outliner's own - OmniOutliner writes its
columns as attributes - were dropped without a word, and a url / htmlUrl /
xmlUrl link was only reported. Now created is the creation date, each
comma-separated category a label (its leading "/" taken off), a link goes at
the end of the description, and any other attribute is a custom field. The
export writes created (RFC 822) and the labels as category. An attribute of
a list or a checklist item, and a created that is not a date, are reported;
type, isComment and isBreakpoint only say how a row is drawn.

tests/opmlOutline.test.cjs: both ways and the negative cases. The
round-trip spec's KEEPS table now has OPML keep labels; that Playwright
spec was not run here.

Thanks to xet7 !
2026-11-20 17:16:47 +02:00
Lauri Ojansivu 18740f4c22 Update WeKan changelog: every CSV, TSV and Excel column.
Thanks to xet7 !
2026-11-20 17:14:58 +02:00
Lauri Ojansivu 5b9fa791a8 CSV, TSV and Excel imports keep every column: one with no card field becomes a text custom field.
A column the header guess had no field for - "Story points", "Sprint", any
column of the user's own - was imported only when ticked in the import
page's mapping step, and dropped without a word otherwise: always for a REST
import, which sends no mapping, and on the page unless someone ticked it.
guessCsvMapping now puts every other named column in customFieldColumns,
and the mapping step starts with them ticked, so nothing is left behind
unless it is unticked. WeKan's own Number, Last activity and Voting columns,
a blank header and a number cell of a sparse row (#6620) are not made fields.

tests/csvCreator.headerMapping.test.cjs pinned "unknown headers are not
mapped" and now pins that the column comes across, with the negative cases.

Thanks to xet7 !
2026-11-20 17:14:37 +02:00
Lauri Ojansivu b1ab04a764 Update WeKan changelog: Org mode properties and clocks.
Thanks to xet7 !
2026-11-20 17:12:47 +02:00
Lauri Ojansivu 55c3f574f4 Org mode: every property is kept, :ID: is the card's reference, LOGBOOK clocks are its spent time.
Of an Org heading's property drawer only :CREATED: was read, and the rest
of it - :ID:, :EFFORT:, any property of the user's own - and the whole
:LOGBOOK: drawer were dropped without a word in the import loss report.
Now :ID: / :CUSTOM_ID: is the card's source reference, every other property
is a custom field of that name (:NAME+: appends), and the closed CLOCK
lines add up to the spent time. The export writes the custom fields back as
properties. An open clock, a property line that is not :NAME: value, a
:CREATED: that is not a date and any other drawer are reported.

tests/orgMode.test.cjs: the round trip and the negative cases.

Thanks to xet7 !
2026-11-20 17:12:38 +02:00
Lauri Ojansivu 1984f72d5e Update WeKan changelog: Tasks.org, Vikunja and Super Productivity repeats.
Thanks to xet7 !
2026-11-20 17:10:39 +02:00
Lauri Ojansivu 878e53f418 Tasks.org, Vikunja and Super Productivity repeats become the card's recurrence too.
The rest of the task tools with a repeat rule, through
models/lib/recurrenceMap.js like the others:
- Tasks.org: the task's RRULE, imported and written back.
- Vikunja: repeat_after of a day or a week, repeat_mode 1 (monthly),
  imported and written back.
- Super Productivity: a task's repeatCfgId points to a taskRepeatCfg; one
  repeating every 1 day, week or month, not paused, makes the card repeat.
  Writing a repeat config back on export is left in TODO.md: it needs the
  app's scheduler fields checked against a running Super Productivity.
Any other rule, and the repeat of a finished task, stays in the import loss
report. Google Tasks' API has no repeat to read.

tests/recurrenceMap.test.cjs covers all three with negative tests; the
Tasks.org and Vikunja suites pinned "imported once" and now pin the repeat.

Thanks to xet7 !
2026-11-20 17:10:18 +02:00
Lauri Ojansivu 887fdc7e6d Merge remote-tracking branch 'origin/main' 2026-11-20 17:01:56 +02:00
Lauri Ojansivu bfdb37526e Update WeKan changelog: repeating tasks, snaps on every Snap Store channel.
Thanks to xet7 !
2026-11-20 16:59:46 +02:00
Lauri Ojansivu dc0a1ad049 Snaps: Release All pushes wekan, wekan-ondra and wekan-gantt-gpl to every Snap Store channel; Release All Missing adds what a release lacks.
The Push Snap to Store run for v13.20 failed three ways:
- wekan-ondra and wekan-gantt-gpl: "no assets match the file pattern". The
  snap-variants job uploaded them to the store but never attached them to
  the GitHub Release. It does now (github-release-upload.sh, on always()
  after its verify step).
- wekan: the store answered "Error checking upload uniqueness", a store-side
  failure, and snap-store-push.sh then waited two hours for a revision that
  upload never made. It now uploads again after a store failure (5xx,
  uniqueness), waits only when the store is really processing or already has
  the file, and fails at once on any other refusal.
- It ran on workflow_run and took "the latest release", which was v13.20.
  Release All now ends with a snap-store job that calls the workflow
  (workflow_call) for the tag it released, after snap-native,
  snap-launchpad and snap-variants.

Release All Missing:
- expected-assets.sh lists the snaps: wekan on six architectures, the two
  variants on amd64 and arm64.
- A missing variant snap is made from the release's own wekan snap by
  releases/snap-rename.sh, which changes only name and title in
  meta/snap.yaml - what snap-variants changes - and attached; then the
  release's snaps are pushed to the store.
- With no version, a scan job (releases/release-missing-scan.sh) checks the
  newest releases and starts one run per release missing something.
- What it cannot build no longer fails the plan, which skipped every build
  that could have been made; the done job is red for it at the end.

tests/snapStorePush.test.cjs: the retry and the immediate refusal, both
workflows, the rename and the scan, with fake snapcraft, squashfs and gh.

Thanks to xet7 !
2026-11-20 16:59:23 +02:00
Lauri Ojansivu 24ac6b2bd2 Repeating tasks of other tools repeat in WeKan: daily, weekly and monthly as the card's recurrence.
WeKan cards can repeat daily, weekly or monthly, but no import set it and no
export wrote it: Taskwarrior, Microsoft To Do, Todoist, TickTick, iCalendar,
Org mode and Obsidian Kanban all reported a repeat as lost and imported the
task once. models/lib/recurrenceMap.js reads their rules - RRULE, recur,
Org repeaters, "every week", To Do patterns - and returns daily, weekly or
monthly only when the rule is exactly that; anything else (every two weeks,
yearly, weekdays, a count or an end) stays in the import loss report.

The import plan sets recurrenceInterval and lastRecurrenceAt = the import
time, so the recurrence job does not copy every imported card at once from
its old creation date. Of Taskwarrior's instances, only the newest open one
of each template repeats. A finished task's repeat is reported, not kept.
The exports write it back: Taskwarrior recur, Org +1w, Obsidian 🔁, TickTick
Repeat, and RRULE in the iCal feed. The WeKan JSON import now keeps
recurrenceInterval too.

tests/recurrenceMap.test.cjs: every format both ways, and negative tests -
rules WeKan cannot keep stay reported, and no import sets a recurrence
outside the three or without the mapper. The five format suites that pinned
"imported once" now pin the repeat.

Thanks to xet7 !
2026-11-20 16:59:14 +02:00
github-actions[bot] 8440a5e0fb Bump versions for v13.21 2026-11-20 14:32:35 +00:00
Lauri Ojansivu 31a808be6e Prepare v13.21 release 2026-11-20 16:31:29 +02:00
Lauri Ojansivu 2ce90cb95e Update WeKan changelog: docs follow the menus, newest features, README.
Thanks to xet7 !
2026-11-20 16:25:12 +02:00
Lauri Ojansivu 0c277c4d18 Docs follow the menus: Scrum meetings under Board Settings, the newest features, README feature list.
Scrum meetings moved to Board Settings / Scrum-Meetings.md, Board Settings
Card, List and Scrum pages name the flow fields, list policies, Definition
of Ready, standup and retrospective settings. Admin Panel / Settings /
Features lists the new Kanban and Scrum features, and every doc that still
said Settings / Visibility / Features names the pane where they are now.
Newest-Features.md gains a November 2026 guide, and README.md lists the
reports, flow features, mail/calendar/chat imports and paged exports.

Thanks to xet7 !
2026-11-20 16:24:41 +02:00
Lauri Ojansivu b0612ebe57 Update WeKan changelog: Taiga export paged.
Thanks to xet7 !
2026-11-20 16:20:05 +02:00
Lauri Ojansivu 9f85b51695 Taiga export is written a page of cards at a time; every export is now paged.
Taiga's project was built whole, the last export that was. Every page now
makes the project over the whole board from the light first pass - every
ref, kanban and task order, status, point and attribute definition the
whole board's - and keeps only its own cards' epics, stories, tasks and
issues, their descriptions and histories (the text the first pass does not
read) from the cards themselves. The tasks made of story checklist items,
which have no card of their own, are on the last page, after the other
tasks, as in the whole project; whether the project has epics and issues
is said from the whole board. The paged JSON writer writes the four arrays
a pass each.

TODO.md's "Import and Export of large files" is done: every export is
written a page at a time. tests/exportPaging.test.cjs checks every page
size against the whole project; the round trip of every export (Taiga
among them) and the import/export audit (173) pass.

Thanks to xet7 !
2026-11-20 16:20:04 +02:00
Lauri Ojansivu 9c3a543f0a Update WeKan changelog: Push Snap to Store.
Thanks to xet7 !
2026-11-20 16:11:30 +02:00
Lauri Ojansivu 49dbdbb6d6 Push Snap to Store: a workflow that releases the wekan, wekan-ondra and wekan-gantt-gpl snaps of a GitHub release to every Snap Store channel.
On v13.20 every build was green and the snaps were on the GitHub release,
but the Snap Store kept the old version. The release jobs upload with
`snapcraft upload --release=stable,candidate,beta,edge`; the store kept
the revisions in "processing", releases/snap-upload-retry.sh stopped
waiting after 1800 s and left the release to the store with a warning, and
the store never released them.

.github/workflows/snap-store.yml ("Push Snap to Store") runs after every
"Release All Platforms" run and by hand for any tag, snap names and
channels. It downloads <name>_*.snap from the release, and for each file
releases/snap-store-push.sh:
- releases the revision the store already has for that version and
  architecture - an earlier upload that finished processing later -
  without uploading it again;
- otherwise uploads without --release and releases the revision the
  upload created, by number;
- when the upload is cut off while the store is processing, asks the
  store until the revision appears and releases it; when it never does,
  fails, so the run is red rather than green with an old snap.
The release job's processing warning now says that this workflow finishes
the release.

tests/snapStorePush.test.cjs runs the script against a fake snapcraft
through all four ways, and checks the workflow's triggers, defaults and
input checks.

Thanks to xet7 !
2026-11-20 16:11:21 +02:00
Lauri Ojansivu 17ab5f8459 Update WeKan changelog: Super Productivity export paged.
Thanks to xet7 !
2026-11-20 16:00:45 +02:00
Lauri Ojansivu 6187806cf1 Super Productivity export is written a page of cards at a time.
Its backup was built whole. Every page now makes the backup over the
whole board from the light first pass - projects, tags, panels, task ids,
sub-task lists - and keeps only its own cards' task entities, their notes
(the description and checklists, the one part the first pass does not
read) from the cards themselves. The paged JSON writer streams an
object's entries as well as an array's elements, each entry passing the
export boundary with its key, and writes data.task.entities a page at a
time.

tests/exportPaging.test.cjs checks every page size: the pages' entities,
in order, are the whole backup's, and the rest is the same. The round
trip of every export (Super Productivity among them) and the
import/export audit (173) pass.

Thanks to xet7 !
2026-11-20 16:00:44 +02:00
Lauri Ojansivu 369dd91789 Update WeKan changelog: Vikunja export streamed.
Thanks to xet7 !
2026-11-20 15:41:24 +02:00
Lauri Ojansivu bd34f44460 Vikunja export is streamed a page of cards at a time, and carries what each task waits for.
Vikunja's export was built whole: a .zip of data.json made in memory. Its
formatter now plans the whole board once from the light first pass - each
card's task id, project, index and position, its comments' ids, the users
and labels in the order the cards first name them, the parent links - and
writes only its own page's tasks, with the same projects, views and
buckets on every page. The .zip is written by streamVikunjaZip: data.json
through streamJsonArrays, each project's tasks, task buckets and positions
a pass over the pages, the tasks as the archive writes them
(vikunjaArchiveData), the HTML made from text the export boundary has
checked, as the whole export's is; then filters.json and VERSION.

A task's dependencies are its "blocked" relations, which the Vikunja
import reads as is-blocked-by. The round trip of every export now
includes Vikunja, through its .zip: it keeps the description, checklist,
comment, dependency, label and due date. tests/exportPaging.test.cjs
checks every page size against the whole document; the import/export
audit (173) passes.

Thanks to xet7 !
2026-11-20 15:41:23 +02:00
Lauri Ojansivu 2d823e16dc Update WeKan changelog: four more exports carry dependencies.
Thanks to xet7 !
2026-11-20 15:17:36 +02:00
Lauri Ojansivu c9da13b63e Asana, OpenProject, Obsidian and Wrike exports carry what each card waits for.
Each of their imports reads a task's dependencies - Asana's dependencies,
OpenProject's blocked relations, Obsidian's Tasks plugin 🆔 and ⛔, Wrike's
Depends On <Key>FS - but none of the exports wrote them. Each now does,
from one reading of the board's dependencies: what every card waits for,
from a dependency stored on either card, over the whole board whichever
page is written (models/lib/exportPaging.js blockersOf, which
Taskwarrior's depends now uses too).

The round trip of every export keeps the dependency in eight formats now
(KEEPS): Jira, Kanboard, OpenProject, Asana, Taskwarrior, Obsidian,
Redmine and Wrike. tests/exportDependencies.test.cjs; the import/export
audit (173) passes.

Thanks to xet7 !
2026-11-20 15:17:35 +02:00
Lauri Ojansivu 80e653b4ba Update WeKan changelog: .mbox labels.
Thanks to xet7 !
2026-11-20 14:56:02 +02:00
Lauri Ojansivu c0b3d9013d The .mbox export carries the card labels as Gmail's; the round trip of every export checks labels and due dates.
The mail import reads X-Gmail-Labels into labels, but the .mbox export
wrote no labels, so they were lost. A card's message now carries its
labels in that header (a comma in a name, which separates them there, is
a space); its comment replies carry none.

export-import-round-trip.e2e.js gives Alpha Card a board label and a due
date, and its KEEPS table two more columns, written from what each
format's file kept: what a format has no place for - an outline's labels
and due dates, OpenProject's labels, Wrike's template, which has no tags
column - stays out. tests/mailFormat.test.cjs; the import/export audit
(173) passes.

Thanks to xet7 !
2026-11-20 14:56:01 +02:00
Lauri Ojansivu 394a8fd32c Update WeKan changelog: Jira and Taskwarrior dependencies.
Thanks to xet7 !
2026-11-20 14:32:08 +02:00
Lauri Ojansivu d613a00030 Jira and Taskwarrior exports carry the card dependencies; the round trip of every export checks them.
Both imports read dependencies - Jira's fields.issuelinks
(models/jiraCreator.js createDependencies), Taskwarrior's depends as "is
blocked by" - but neither export wrote them, so they were lost. Jira's
issue links keep the direction of blocks and duplicates and are Relates
otherwise; Taskwarrior's depends lists what each card waits for, from a
dependency stored on either card. The keys and uuids are the whole
board's, whichever page the card is on.

export-import-round-trip.e2e.js gives Alpha Card a dependency on Beta Card
and its KEEPS table a fourth column: Jira, Kanboard, Taskwarrior and
Redmine keep it. tests/exportDependencies.test.cjs; the import/export
audit (173) passes.

Thanks to xet7 !
2026-11-20 14:32:07 +02:00
Lauri Ojansivu d1a1d46b73 Update WeKan changelog: Trello .zip export with attachments.
Thanks to xet7 !
2026-11-20 14:02:46 +02:00
Lauri Ojansivu e8330fb090 Trello .zip export: the Trello board JSON with the cards' attachment files, imported back with them.
Board Settings / Export / Trello .zip Attachments (export/trellozip)
downloads trello.zip: the Trello document as board.json, written a page
of cards at a time by the multi-array writer, and each exported card's
attachments as the files they are, attachments/<id>_<name>, piped from
the file store as WeKan's own .zip export does
(server/lib/renderExternalExport.js streamTrelloZip). board.json names
each attachment by that file name (trelloZipFileName), which the Trello
.zip import matches, so the files come back with their cards. It is not an
"Export all boards" format, which makes each board's file whole.

The round trip spec imports a Trello .zip with a file, exports it as a
Trello .zip, finds the file's exact bytes in it, imports that back and
downloads the same bytes from the imported board. The Trello docs page
describes it.

Thanks to xet7 !
2026-11-20 14:02:45 +02:00
Lauri Ojansivu a18d2a553c Update WeKan changelog: Trello archived cards and lists.
Thanks to xet7 !
2026-11-20 13:37:39 +02:00
Lauri Ojansivu 3ac8b802c5 Trello export carries the archived cards and lists, as Trello's closed ones.
Trello's own export has its closed cards and lists; WeKan's had only the
open ones. The Trello export now collects the archived cards and lists too
(ARCHIVED_FORMATS in models/lib/externalExporters.js; every other format,
the open ones, and no format a deleted one) and writes them closed: true,
which the Trello import reads back as archived. The round trip spec exports
an archived card and finds it archived on the imported board.

Thanks to xet7 !
2026-11-20 13:37:38 +02:00
Lauri Ojansivu 1fa7af0679 Update WeKan changelog: GitHub-like comments, the round trip of every export.
Thanks to xet7 !
2026-11-20 13:19:09 +02:00
Lauri Ojansivu df92d8de63 Every export that WeKan also imports is round-tripped in one spec, each held to what its file keeps.
tests/playwright/specs/export-import-round-trip.e2e.js exports a board -
a card with a description, a checklist, a comment and a label - in each of
the 41 formats WeKan both writes and reads, imports the file back through
POST /api/boards/import/<tool>, and requires the card to come back. Its
KEEPS table is what each format's file keeps of the description, the
checklist and the comment, as found now; a format that keeps less fails,
and one that keeps more fails too, so the table is raised with it. That is
how the Trello export that did not import back went unnoticed: no test
imported an export of it.

Thanks to xet7 !
2026-11-20 13:19:08 +02:00
Lauri Ojansivu ba31f2b592 GitHub, Gitea and Forgejo exports carry the cards' comments.
They are written as comments_data, the embedded comments the issues parser
reads (models/lib/externalParsers.js issueComments), with each author's
login and date, so an exported board imports back with its comments.

Thanks to xet7 !
2026-11-20 13:19:08 +02:00
Lauri Ojansivu ba657b9ab7 Update WeKan changelog: Trello custom fields.
Thanks to xet7 !
2026-11-20 12:56:15 +02:00
Lauri Ojansivu c20c7296a8 Trello export carries the custom fields; the Trello import reads a number field's value as a number.
The board's custom fields are Trello fields, one per name its cards use,
typed by what every value of it is (checkbox, number, date, else text),
and each card's values are its customFieldItems in Trello's value shapes.
Trello writes a number field's value as text, so the Trello import now
stores it as a number, for a real Trello file as for WeKan's export.
tests/trelloExportImportable.test.cjs and the round trip spec, which
exports a number field and finds it, and its value 3, on the imported
board; the import/export audit (173) and admin-only field specs (12) pass.

Thanks to xet7 !
2026-11-20 12:56:14 +02:00
Lauri Ojansivu 9222a60e41 Update WeKan changelog: the Trello export imports back; a Trello file with no members imports.
Thanks to xet7 !
2026-11-20 12:36:30 +02:00
Lauri Ojansivu cde21a7651 Trello export imports back, with its checklists, comments and members.
The first tool of the import/export coverage review (TODO.md). The Trello
export wrote no card's dateLastActivity or pos, which WeKan's own Trello
import checks every card for, so no Trello export imported back at all;
and its checklists and comment actions were empty arrays.

Every card now has an ISO date of its last activity and its position (over
the whole board, whichever page it is on); the card's checklists are
Trello checklists with their items' state, its comments commentCard
actions with their dates, and the board's people - owners, assignees,
comment authors, from the whole board - Trello members, each card naming
its own in idMembers. A label with no name is an empty name.

The paged JSON writer writes a document with several card arrays, each by
a pass of its own over the pages (streamJsonArrays); Trello's cards,
checklists and actions are three.

tests/trelloExportImportable.test.cjs holds the export to what the
import's checks require; tests/playwright/specs/trello-export-round-trip.e2e.js
exports a board as Trello and imports it back with its checklist, comment
and title. The import/export audit (173) and the admin-only custom field
specs (12) pass.

Thanks to xet7 !
2026-11-20 12:36:23 +02:00
Lauri Ojansivu d1be2d2131 Trello import of a file with no members no longer does nothing.
trelloGetMembersToMap called data.members.forEach, so a Trello board file
without a members list - a board nobody else is on, or one written by
another tool - threw in the browser, and Import and Import without mapping
members silently did nothing. No members is nobody to map, as the WeKan
import's mapper already reads it.

Thanks to xet7 !
2026-11-20 12:36:23 +02:00
Lauri Ojansivu 5d8c4a7635 Update WeKan changelog: every workbook export is streamed.
Thanks to xet7 !
2026-11-20 11:41:30 +02:00
Lauri Ojansivu db9c06dc5e monday.com, Businessmap and Wrike workbooks are streamed a page at a time too.
Every workbook export is now written by ExcelJS's streaming workbook
writer, a row at a time, instead of a whole workbook in memory.

- monday.com and Businessmap: one sheet each; the columns any card fills
  (monday.com's custom fields; Businessmap's optional columns, comment
  columns and other fields) and Businessmap's parent Card IDs are found
  over the whole board from the light first pass, the header written on
  the first page (server/lib/streamSheetWorkbook.js, shared).
- Wrike: the lanes' order, the folder rows and every row's Key are planned
  over the whole board (wrikePlan, wrikePageOrder); the pages come in that
  order and a lane's folder row goes before its first card. The date
  columns are date cells, as in the whole workbook.

tests/workbookStream.test.cjs checks every page size against the whole
sheet and reads each streamed workbook back as the whole one; the
import/export audit (173) and the admin-only custom field specs (12) pass.

Thanks to xet7 !
2026-11-20 11:41:28 +02:00
Lauri Ojansivu 338674fd1e Update WeKan changelog: Teamwork and Planner workbooks are streamed.
Thanks to xet7 !
2026-11-20 11:21:51 +02:00
Lauri Ojansivu a2257442a8 Teamwork and Planner workbooks are written a page of cards at a time with ExcelJS's streaming writer.
The workbook exports were built whole, as an ExcelJS workbook in memory.
Teamwork's and Planner's are now written to the response by
ExcelJS.stream.xlsx.WorkbookWriter, each row committed as it comes
(server/lib/renderExternalExport.js STREAMED_WORKBOOKS), every page's rows
through the export boundary as the whole workbook's are.

Teamwork's rows are a task tree: its order and each card's depth are
planned over the whole board from the light first pass (teamworkPlan,
teamworkPageOrder), the pages come in that order, and each page writes its
own rows. Planner's rows stand on their own: its head on the first page,
each card's row after it.

tests/workbookStream.test.cjs checks every page size against the whole
sheet, and that the streamed workbook reads back - and is read by
Teamwork's own parser - as the whole one; the import/export audit (173)
and the admin-only custom field specs (12) pass.

Thanks to xet7 !
2026-11-20 11:21:50 +02:00
Lauri Ojansivu 03e2fb416d Update WeKan changelog: Nullboard exports are paged.
Thanks to xet7 !
2026-11-20 11:01:04 +02:00
Lauri Ojansivu 4666bb60f4 Nullboard exports are written a page at a time, each list around its notes.
Nullboard's formatter writes its JSON as text, so the nested writer reads
it as JSON (text: true) and ends the file with its newline. Its lists -
the board's, then one per title of a list its cards name that is not
exported - are found over the whole board, so every page has the same
lists, and the pages come list by list with those cards grouped by the
title (byList: 'listIdsThenTitles'). tests/exportPaging.test.cjs checks
every page size; the import/export audit (173) and the admin-only custom
field specs (12) pass.

Thanks to xet7 !
2026-11-20 11:01:03 +02:00
Lauri Ojansivu bd9ec7e585 Update WeKan changelog: Deck and Kanri exports are paged.
Thanks to xet7 !
2026-11-20 10:42:25 +02:00
Lauri Ojansivu 21c64e092d Deck and Kanri exports are written a page at a time, each list around its cards.
Deck's stacks and Kanri's columns hold their cards. The pages come list
by list in the board's order by list id (byListIdOrder, a list only a card
names after them); the document around the lists and each list around its
cards are made on the first page from the board's lists and its light
first pass, and each list is opened at its first card and closed after its
last, a list with no cards written where it stands. Every part passes the
export boundary and the admin-only field redaction.

A Deck card is in the stack of its own list by id: two lists of one name
each carried the other's cards. Kanri's cards of no list are one column,
where each such card made a column of its own; its tags in use are found
over the whole board, list by list.

tests/exportPaging.test.cjs checks every page size against the whole
document; the import/export audit (173) and the admin-only custom field
specs (12) pass.

Thanks to xet7 !
2026-11-20 10:42:24 +02:00
Lauri Ojansivu fc502d7206 Update WeKan changelog: JSON exports with one card array are paged.
Thanks to xet7 !
2026-11-20 10:23:17 +02:00
Lauri Ojansivu f293ae4076 JSON exports whose cards are one array are written a page at a time: Trello, Jira, Asana, Zenkit, OpenProject, GitHub, Gitea, Forgejo, GitLab.
The first page writes the document around the card array, with the array
left open, and every page then writes its own cards into it
(server/lib/renderExternalExport.js JSON_PAGED, streamJsonExport). Each
part passes the export boundary (secureTransfer) and the admin-only field
redaction, as sendJsonResult does for a whole document; the headers are
sendJsonResult's.

What a card refers to on another page is counted over the whole board from
the light first pass: Jira's issue keys and custom field names, and
OpenProject's numbers, positions and custom field columns.

tests/exportPaging.test.cjs checks, for every page size, that the pages'
arrays together are the whole array and the document around them the
first page's, and that nothing is written without passing the boundary and
the redaction. The import/export audit (173) and the admin-only custom
field specs (12) pass.

Thanks to xet7 !
2026-11-20 10:23:16 +02:00
Lauri Ojansivu df731e648c Update WeKan changelog: Focalboard and Mattermost exports are paged.
Thanks to xet7 !
2026-11-20 10:02:26 +02:00
Lauri Ojansivu bad71f9a1e Focalboard and Mattermost exports are written a page of cards at a time.
Both are NDJSON. Focalboard's board record names its status, label and
custom field options over the whole board, and Mattermost's head names
every channel and user over the whole board: each is written on the first
page from the board's light first pass, and every page then writes its own
cards' blocks or posts. tests/exportPaging.test.cjs checks every page size
against the whole file; the import/export audit passes, 173/173.

Thanks to xet7 !
2026-11-20 10:02:25 +02:00
Lauri Ojansivu b021a8be99 Update WeKan changelog: Leo outlines are paged.
Thanks to xet7 !
2026-11-20 09:52:23 +02:00
Lauri Ojansivu e1261ef5fb Leo outlines are written a page of cards at a time too.
Leo's file holds the outline (<vnodes>) and, after it, the card texts
(<tnodes>) under the outline's node numbers. The outline holds only titles
and checklists, which the board's light first pass already has, so the
first page writes the whole outline from it, and every page then writes
its own cards' texts, numbered the same pre-order way as before: a list,
its cards, each card's checklists and their items. tests/exportPaging.test.cjs
checks every page size against the whole file, and the import/export audit
passes, 173/173.

Thanks to xet7 !
2026-11-20 09:52:05 +02:00
Lauri Ojansivu 46a66c623b Update WeKan changelog: the outlines and the Notion CSV are paged.
Thanks to xet7 !
2026-11-20 09:43:28 +02:00
Lauri Ojansivu ce40b56abd The Markdown, Obsidian, OPML and Org mode outlines and the Notion CSV are written a page of cards at a time.
The outlines group cards under their lists, so their pages come list by
list in the board's order (byList: 'lists', models/lib/exportPaging.js
byListOrder): a list's heading opens before its first card and closes
after its last, wherever the page boundary falls, and a list with no cards
is written where it stands, from the board's light first pass
(outlineMarks). Lines are joined with the separator before each line
(joinPage), so the pages together are byte for byte the whole file. The
Notion CSV counts its swimlane and custom field columns over the whole
board and writes its header on the first page.

Every page also passes the board's, lists' and swimlanes' titles through
the export boundary, as the whole-file export does; before, a paged
format's list titles came straight from the database.

Markdown and Obsidian write a list title once: two lists of one name used
to write their heading twice, each with the cards of both.

Leo stays whole: its card texts are a second section after the whole
outline. tests/exportPaging.test.cjs checks every page size against the
whole file, with empty lists and a card of a list the board does not have;
tests/playwright/specs/import-export-format-audit.e2e.js passes, 173/173.

Thanks to xet7 !
2026-11-20 09:43:18 +02:00
Lauri Ojansivu 3cbf938ae8 Update WeKan changelog: split lists, the archived v12.49.
Thanks to xet7 !
2026-11-20 09:16:52 +02:00
Lauri Ojansivu fd5c207006 Lists split into Doing and Done.
A list can be split into Doing and Done (models/lib/boardFlowPolicies.js):
a card of it marked Done here, with the circle at its minicard's corner,
waits dimmed and edged green to be pulled into the next list, and the
list header counts Doing and Done. The mark names the list it was made in
(card.flow.splitDoneListId, written by setCardFlow from the card's own
list, and only in a split list), so a card moved on is in Doing of its new
list without anybody clearing it.

A board admin allows split lists in Board Settings / List, and each list
is split from its menu. Admin Panel / Settings / Visibility / Features /
Split lists hides it on every board. Translated in every language.

Thanks to xet7 !
2026-11-20 09:16:10 +02:00
Lauri Ojansivu 3a1d670155 Archive v12.49 in old-CHANGELOG/2026/10.md, where the changelog's size budget moved it.
The previous changelog commit removed v12.49 from CHANGELOG-big.md, as
releases/changelog-archive.mjs does when the file is over its budget, but
left out the archive part that holds it.

Thanks to xet7 !
2026-11-20 09:16:00 +02:00
Lauri Ojansivu 4989cd0b51 Update WeKan changelog: standup timer, retrospective board, list policy fix.
Thanks to xet7 !
2026-11-20 08:54:46 +02:00
Lauri Ojansivu 2f7a4e210f Daily standup timer and retrospective board in the board menu.
Two Scrum meeting helpers, offline and with no AI
(models/lib/scrumMeetings.js, docs/Features/Scrum/Meetings.md):

- Daily standup: the board's active members in a shuffled order, each
  with the same timebox (Minutes per person in the Scrum settings, 1-15,
  2 by default), counted down and red once over; Next hands over, and the
  end says how long it took. It runs in the browser and writes nothing.
- Retrospective board: a new private board, titled with this board's name
  and the day, with the lists Start doing, Stop doing, Keep doing and
  Action items, made through createBoardWithInitialSwimlanes so "who may
  create boards" applies.

Both are in the board menu for every member, next to Summary. Each is
turned off for one board in its Scrum settings and for the instance in
Admin Panel / Settings / Visibility / Features. Translated in every
language.

Thanks to xet7 !
2026-11-20 08:54:34 +02:00
Lauri Ojansivu 524946c1bf List policy popup asks the board's write capability, not each role helper.
The popup's canEdit called the role helpers with optional calls, which
tests/roleHelperRegressions.test.cjs reads as bare references. It now asks
Utils.currentUserCan('write'), the capability the server's Lists allow rule
grants.

Thanks to xet7 !
2026-11-20 08:54:24 +02:00
Lauri Ojansivu 6f67fd298e Board Settings in Mandarin and Cantonese is a board, not a chessboard; Yoruba and Yiddish say it in their own words.
Mandarin and Cantonese named Board Settings with 棋盘/棋盤, a chessboard,
beside their own 看板 for a board. Yoruba had the English word Board in it,
and Yiddish spelled Board, Boards and Settings out in Hebrew letters. Low
confidence for Yoruba and Yiddish.

Thanks to xet7 !
2026-11-20 08:34:27 +02:00
Lauri Ojansivu 6aedd70eeb Update WeKan changelog: list policies, commitment point, WIP per person, Definition of Ready.
Thanks to xet7 !
2026-11-20 08:32:23 +02:00
Lauri Ojansivu 9ac7b916c0 List policies, the commitment point, a WIP limit per person, and the Definition of Ready.
Kanban practices for a board's lists (models/lib/boardFlowPolicies.js,
docs/Features/Lists/Flow-Policies.md), offline and with no AI:

- List policy: each list's own entry and exit criteria, written from the
  list menu and shown as a gavel at the list header, its tooltip the text.
- Commitment point: the list from which work is committed to, flagged at
  its header; the lists before it are options.
- WIP limit per person: how many open cards one person may hold on the
  board; an opened card names each of its people over it.

Each is off until a board admin turns it on in Board Settings / List, and
each is a feature of Admin Panel / Settings / Visibility / Features, which
hides it on every board.

The Scrum settings get a Definition of Ready beside the Definition of
Done, and both are now readable by every member in the Scrum views once
written. The four Scrum translation guards count 128 keys with it.

Translated in every language.

Thanks to xet7 !
2026-11-20 08:32:10 +02:00
Lauri Ojansivu 5673fd3bcd Update WeKan changelog: flow fields on cards, ten paged exports.
Thanks to xet7 !
2026-11-20 08:09:17 +02:00
Lauri Ojansivu 0071dde0f3 Flow fields on cards: Blocked with a reason, Class of service with Expedite's WIP limit, MoSCoW and WSJF.
Four Kanban and Scrum practices other tools have, kept on the card
(card.flow, models/lib/cardFlow.js), offline and with no AI:

- Blocked: ticked with a reason; who marked it and since when are the
  server's. A red Blocked badge on the minicard, the reason its tooltip.
- Class of service: Standard, Fixed date, Expedite, Intangible. Expedite
  has a WIP limit of one open card per board; a second is refused.
- MoSCoW priority: Must, Should, Could, Won't have.
- WSJF score: business value, time criticality and risk reduction divided
  by job size, each on the 1-20 scale; shown once every part is set.

Each is a row of Board Settings / Card in the Card section, off on the
card and the minicard until a board turns it on, and an Admin Panel /
Features / Card field that hides it on every board. Written only by the
setCardFlow method, which checks the card edit right, an assigned-only
member's own cards and the values; a client write of flow is denied.
Translated in every language.

Thanks to xet7 !
2026-11-20 08:08:26 +02:00
Lauri Ojansivu 94ad2fd958 Update WeKan changelog: InviteBleed's old six-digit codes and the sign-up throttle.
Thanks to meifukun and xet7 !
2026-11-20 07:48:56 +02:00
Lauri Ojansivu 4fad2a9000 Fix InviteBleed's remainder: six-digit invitation codes and the unthrottled sign-up method.
GHSA-rg85-qx5c-qx67 reported the InviteBleed brute force again, now as a
GitHub Security Advisory. The 128-bit code of the first fix was still in
place, but two things it left were open:

- An invitation made before the fix, and not used yet, kept its six-digit
  Math.random() code and was still accepted at sign-up; a re-invite even
  mailed the same code again. A code shorter than the 22 base64url
  characters of a 128-bit code is now refused at sign-up, in both places it
  is looked up, and hasUsableCode() treats it as missing, so a re-invite
  replaces it with a strong one (models/lib/invitationCodeEmail.js
  isStrongInvitationCode).
- The DDPRateLimiter rule was on createUser, which a client is refused
  anyway, while the sign-up form creates the account through useraccounts'
  ATCreateUserServer, which had no limit. It now takes at most 10 attempts
  a minute per address, and each refusal is an InviteBleed row in Admin
  Panel -> Problems (brute.invite).

The other two advisories of the same report were checked against the
current code and are already fixed: GHSA-6944-p22h-3qpx (OIDC shared
serviceData race) since #4897 on 2026-07-17, whose per-login objects are
locals of the callback, and GHSA-j4x8-689m-h4hv (stale impersonation record
allows export), where every export route authorizes through
canExportBoardData() only and the impersonation record is just the audit
row written after it.

Thanks to meifukun and xet7 !
2026-11-20 07:48:22 +02:00
Lauri Ojansivu 735f52ed11 TODO: import and export of everything each tool has, and the Kanban and Scrum features to add.
Thanks to xet7 !
2026-11-20 07:33:45 +02:00
Lauri Ojansivu e2cbbe5104 Ten more exports are written a page of cards at a time, their references read in a light first pass.
Todoist, TickTick, ClickUp, MeisterTask, Linear, Pivotal, Redmine,
Quire, Taskwarrior and todo.txt refer from one row to others - a parent's
number, columns counted over the board, the order of the lists - so a
page could not be written without the rest. The export now reads the
board once lightly (no descriptions, comments only counted,
models/lib/exportPaging.js) and then the cards 500 at a time, each page
with those references; a formatter writes its head on the first page and
its tail on the last, Todoist's cards come list by list. The pages
together are byte for byte the file the whole board is written as,
whatever the page size (tests/exportPaging.test.cjs). TODO.md lists the
formats still built whole.

Thanks to xet7 !
2026-11-20 07:30:06 +02:00
Lauri Ojansivu 4e23929ee6 Update WeKan changelog: streamed JSON, Jira and CSV uploads, the server bundle check.
Thanks to xet7 !
2026-11-20 06:55:20 +02:00
Lauri Ojansivu 60bbf69164 Jira and CSV / TSV files are uploaded too; their people and columns are read from the file on the server.
They were the last files the Import page read itself and sent whole. A
chosen Jira file is now uploaded like the other sources: the people of
its map-members step are read from it by the server (the Jira mapper is
shared, models/lib/jiraMembersMapper.js), and the estimate mapping goes
with the import call. A CSV / TSV file's header, sample rows and guessed
mapping come from the server (csvUploadPreview), its people from the
columns chosen (csvUploadPeople), and the import parses it there. Both
methods read only the sender's own upload, signed in and while import is
enabled, and leave it for the import that follows.

Thanks to xet7 !
2026-11-20 06:46:46 +02:00
Lauri Ojansivu 905f60a1ea UI specs: the Release Burndown report gets a release to show; the limit test signs in by the login cookie.
The board-reports spec seeds a Scrum release with a card, so Release
Burndown has a table row, and removes it afterwards. The upload limit
test POSTs with the HttpOnly login cookie, as the page's own upload does,
instead of a Bearer header with no token in it, and checks the page's
warning says which limit.

Thanks to xet7 !
2026-11-20 06:34:26 +02:00
Lauri Ojansivu 11992ac951 Fix the server failing to start: the streamed export's collect had a parameter named like a const in its body.
The page-at-a-time export (3b1c7ce7bb) gave collect() a parameter
cardIds while its body already declares const cardIds - a SyntaxError
("Identifier 'h' has already been declared" once minified), so the
server bundle did not load. No node suite loads that ES module, which is
why they all passed. The parameter is pageCardIds, and
tests/serverBundleSyntax.test.cjs checks the built server bundle with
node --check whenever a build is there. TODO.md says why most other
export formats cannot simply be paged.

Thanks to xet7 !
2026-11-20 06:29:47 +02:00
Lauri Ojansivu 640e492593 Uploaded JSON is parsed from the file a chunk at a time; a Mattermost export a line at a time.
A JavaScript string cannot be longer than about 512 MB, so reading an
uploaded JSON export with readFile and JSON.parse could not read a larger
one at all. server/lib/streamJson.js builds the value from the file as it
is read - every escape, surrogate pairs and chunk boundaries anywhere,
the same value and the same refusals as JSON.parse, a __proto__ key as
an own property, nesting bounded. A Mattermost bulk export is read a line
at a time; the other text formats are read as one text up to 256 MB and
refused with that reason beyond it.

Thanks to xet7 !
2026-11-20 06:14:07 +02:00
Lauri Ojansivu e54c0f4646 Update WeKan changelog: Board View reports, grouped menus, large-file import and export, translations.
Thanks to xet7 !
2026-11-20 06:11:40 +02:00
Lauri Ojansivu d1732bd3a5 Translations: locale files that held another language get their own.
Values that were in another language than their locale's tag are
replaced with the tag's language, as the translation rules ask: Northern
Sami values seeded in Finnish (se), Veps in Venda (ve-PP), Maltese
sentences in Italian (mt; single words that are Maltese too are kept),
Northern Ndebele in Shona (nd), Uzbek in Latin letters in the Arabic-
script file (uz-AR), Wolaytta in Ethiopic script (wal), Tsonga in Swati
(ts), Luganda in Swahili (lg), the Armenian "board" that said
"administration" (hy) and the Vietnamese "history" that was Malay (vi).
Words that are correct in the tag's language, though spelled as in the
other one, are kept. The uz-AR guard and its audited copy-many sample
follow the Arabic script; placeholders are as in English.

Low confidence: the chart and metric names in Veps, Wolaytta, Tsonga,
Luganda and Northern Sami.

Thanks to xet7 !
2026-11-20 06:10:51 +02:00
Lauri Ojansivu 3b1c7ce7bb WeKan and Trello .zip imports use the shared upload, limit and disk check; .mbox and .enex export a page at a time.
The WeKan .zip route and the Trello package route wrote their uploads
with caps of their own (5 GB and 200 MB, 1 GB unpacked). They now go
through the same receiver as every Import page upload: the Admin Panel's
largest import (else WEKAN_IMPORT_ZIP_MAX_BYTES for the WeKan zip), or
with none the free disk space, checked before and while the file is
written, and a Trello package may unpack to as much as that.

The .mbox and .enex exports are written to the response 500 cards at a
time, waiting for the socket when it is full, instead of being built
whole in memory; the pages together are the same file. TODO.md keeps
what is left: streamed reading of large JSON and text, and the other
formats' exports.

Thanks to xet7 !
2026-11-20 06:10:37 +02:00
Lauri Ojansivu 0d8f8b8d96 The list, card and swimlane menus are grouped under headings.
As the board menu and the Board View menu are: Share and history, Export
and import, Add, Watch, Edit or Appearance, Settings, Move and copy, and
Archive. No entry moved or changed its condition; each heading sits
inside its group's own condition, so a member who sees none of a group
sees no heading over it, and a heading is not something to click. The
two header bars keep their layout, which was regrouped before. The three
new headings are translated into every language; the others reuse
existing words.

Thanks to xet7 !
2026-11-20 06:10:28 +02:00
Lauri Ojansivu 63b5e089f5 Twelve Board View reports: Created vs. Resolved, Net Flow, Time in List, Average Age, Throughput Run, Due Date Performance and more.
Added after comparing WeKan's charts with the reports of Jira, Azure
DevOps, Nave, ActionableAgile and the Flow Framework: Created vs.
Resolved, Net Flow, Time in List, Average Age, Throughput Run Chart and
Due Date Performance under Kanban flow; Release Burndown and Epic
Progress under Scrum; Workload, Distribution, Dependency Map and Activity
Heatmap under Overview. Each opens like the other charts, with the export
bar at its top, a Chart.js chart and its data table, which is also what
its PDF and Excel export write.

The calculations are pure (models/lib/boardReports.js) and answer one
shape, { bars, table }, so the chart view and both exports read every
report the same way; the server loads only what a report reads. A member
who may see only their assigned cards gets none of them, as with the
other charts. The report names and table headings are translated into
every language.

Thanks to xet7 !
2026-11-20 06:10:13 +02:00
Lauri Ojansivu 32c24ed84e Import page uploads stream to the server's disk, checked against the free space and an Admin Panel limit.
A file chosen on the Import page for the generalized importer's sources
is POSTed to /api/import/upload/:source and written to
WRITABLE_PATH/import-uploads a part at a time, instead of being read in
the browser and sent whole, as text or base64, through importBoard. The
size the browser announces is checked before the first byte against the
largest import set in Admin Panel / Settings / Security (none: no limit)
and against the free space of that disk less a reserve, and the space is
checked again every 64 MB while it is written; a refused or interrupted
upload leaves no file behind. importBoard then reads the file by its
id: a .zip export (Slack, Google Takeout, Vikunja, Notion, Plane) is
opened from the disk, its entries inflating up to the limit or the free
space, and a mailbox is read a message at a time, also inside a Takeout
zip. The upload is removed once read, or after an hour.

The HTML-only mail text is read through the parsed document rather than
stripped with a pattern. TODO.md says what is left of large files, and
which locale files hold another language.

Thanks to xet7 !
2026-11-20 05:42:27 +02:00
Lauri Ojansivu 257835733b Board View menu and the Import and Export lists are grouped under headings.
The Board View menu, and Board Settings / Board View, show the views in six
groups - Board, Calendar and time, Scrum, Kanban flow, Overview, and
Communication and code - with the board's own order inside each; the six
separators of the old order are the headings now. The Import page and the
Export menu list the other tools under the same headings from one table,
models/lib/toolGroups.js: Kanban and project tools, Issue trackers and
version control, Task and to-do apps, Spreadsheets and tables, Text and
outlines, Mail, calendars, chats and notes, and Fetched from a service.
The thirteen headings are translated into every language; "Scrum" stays
as it is, like the other method names. The Tigre instructions of the new
imports keep the attested plural for files.

Thanks to xet7 !
2026-11-20 05:18:02 +02:00
Lauri Ojansivu ef8e82200f Update WeKan changelog: import and export of mail, calendars, chats and notes.
Thanks to xet7 !
2026-11-20 05:03:59 +02:00
Lauri Ojansivu ccfa6cf362 Import and export mail, calendars, chats and notes: mbox/.eml, iCalendar, Google Takeout, Slack, Mattermost, Telegram, WhatsApp, Discord, Evernote.
The Import page reads nine more kinds of export, each into the view it
is for: mail (mbox, .eml) as cards of Board View / Email, one per
conversation with the replies as comments; an .ics file's tasks by
status and its events, with their dates; a Google Takeout .zip as one
board with a swimlane per product (Mail, Tasks, Keep, Calendar, Google
Chat); a Slack workspace export, a Mattermost bulk export, Telegram
Desktop's JSON, a WhatsApp chat .txt and a DiscordChatExporter JSON as
channels whose messages are comments, for Board View / Chat; and an
Evernote .enex as notes with their to-dos as checklists. The Export menu
writes a board as an .mbox, an .enex and a Mattermost bulk import file,
each read back by the same import.

MIME is decoded with mailparser and ENEX with htmlparser2 on the server,
and the zips are read under the zip-bomb guards of the other zip imports.
An imported message's Message-IDs pass the import sanitizer without
their brackets, so a later reply to the board joins the thread. The
instructions of the nine are translated into every language. TODO.md
also gets the next items: grouped menus, large-file import and export,
and the reports to add.

Thanks to xet7 !
2026-11-20 05:03:27 +02:00
Lauri Ojansivu c4da72ff72 Shared templates spec: one instance setting, so its tests run in order and wait for the reset.
The scopes are a setting the whole instance shares, not each browser's
storage: the describe runs serially, waits until the page shows the reset
the test server sees at its next database poll, and finds each template
link inside its own group.

Thanks to xet7 !
2026-11-20 04:26:42 +02:00
Lauri Ojansivu 96e730922e Update WeKan changelog and TODO.md: the menu fixes are done; Import/Export formats and reports to add.
Moves the five menu items done from TODO.md to the Upcoming release, and
adds to TODO.md the Import and Export formats (mail, Google Takeout,
iCalendar, Slack, Mattermost, Telegram, WhatsApp, Discord, Evernote) and
the Board View reports (Created vs. Resolved, Net Flow, Time in List and
others) still to add.

Thanks to xet7 !
2026-11-20 04:26:37 +02:00
Lauri Ojansivu a24e3a49a9 Sandstorm: comment activity notifications await the card, comment and board.
The notifier read the card, the comment and the board from ReactiveCache
without await - on the server those are Promises - so comment.text.match
threw on every comment activity, and a card's members were never found.
tests/serverReactiveCacheAwaited.test.cjs sweeps server/ for any other
unawaited ReactiveCache result kept in a variable.

Thanks to xet7 !
2026-11-20 04:20:22 +02:00
Lauri Ojansivu c0339ccc59 Shared templates: the group kinds to share with are an instance setting, and the targets appear.
Which group kinds - Organizations, Teams, email Domains - Admin Panel /
People / Shared templates allows came from the browser's localStorage,
so it differed per browser and was empty for every user but the admin
who ticked it. It is Settings.sharedTemplatesScopes now, published to
every client, and an admin's earlier ticks are carried over once.

The All Boards / Templates targets were empty for everyone anyway:
getMyShareableGroups did not await ReactiveCache.getUser, so it read
orgs, teams and emails from a Promise.

Thanks to xet7 !
2026-11-20 04:20:22 +02:00
Lauri Ojansivu b00e2c8133 Board menu: All Boards Settings is back, below Date, for board admins.
The entry was commented out for the #4214 "icons random dance", which
left the popup - card counters and member avatars on All Boards, card
aging, auto-archive and personal list widths - with no way in. The All
Boards tiles now read one fetch of getAllBoardsTileData rather than
reactive cursors, so the loop cannot return.

Thanks to xet7 !
2026-11-20 04:20:14 +02:00
Lauri Ojansivu 60c25690df Card menu: Create board from this card is shown to members who can edit the card.
It sat under unless canModifyCard, so exactly the members the
createBoardFromCard method lets convert a card never saw it. It was in
both branches when added; a refactor kept only that one. It is now under
the card menu's write entries, not for Workers, when board creation is
allowed.

Thanks to xet7 !
2026-11-20 04:20:14 +02:00
Lauri Ojansivu 0ccf182001 Support page: a signed-out visitor sees a Public page, and no text of one that is not.
The /support route sent every signed-out visitor to sign-in, so the
Public setting of Admin Panel / Settings / Visibility had no effect and
the template's "only for logged-in users" case was never reached - while
the page's text was sent to every signed-out subscriber of 'setting'
anyway. The route is open now, and a visitor who is not signed in
receives supportPageText only when the page is Public. The supportPopup
the member menu no longer opened, and its supportPopupText publication,
are removed.

Thanks to xet7 !
2026-11-20 04:20:14 +02:00
Lauri Ojansivu 42959d02f1 Edit Profile saves a member's own new username when Username change is allowed.
setUsername wrote only for a site admin, so with Admin Panel / People /
Login Username change allowed a member's new username was not saved, and
the popup closed as if it had. It now follows setEmail: an admin renames
any account, a member their own when the setting allows it, and anything
else is refused with not-authorized instead of returning quietly.
setUsernameAndEmail asks for both changes to be allowed.

Thanks to xet7 !
2026-11-20 04:20:05 +02:00
619 changed files with 49358 additions and 3136 deletions

No files matched your search

+134 -6
View File
@@ -53,9 +53,14 @@ on:
workflow_dispatch:
inputs:
version:
description: 'Release to complete, without the v (e.g. 10.58). Empty = the newest release.'
description: 'Release to complete, without the v (e.g. 10.58). Empty = check the newest releases and complete each one that is missing something.'
required: false
type: string
scan:
description: 'With no version: how many of the newest releases to check.'
required: false
type: string
default: '10'
# Read-only by default; the job that writes is granted it below.
permissions:
@@ -74,6 +79,10 @@ concurrency:
jobs:
recover:
# One release at a time: with no version, scan below starts a run of this
# workflow for every release that is missing something, and each of those
# recovers its own release.
if: ${{ inputs.version != '' }}
permissions:
contents: read
actions: write
@@ -95,6 +104,41 @@ jobs:
[ -n "$V" ] || V="$(gh release view --repo "$GITHUB_REPOSITORY" --json tagName --jq .tagName)"
python3 releases/retry-failed-release.py "$V"
# With no version: which releases are missing something. Each of them gets a
# run of its own (`-f version=...`), which does everything below for it -
# retries the failed jobs of its full release, builds what can be built,
# renames the variant snaps and finishes its Snap Store release - so one
# run of this workflow, with no input, adds everything that is missing.
scan:
if: ${{ inputs.version == '' }}
permissions:
contents: read
actions: write
timeout-minutes: 15
name: which releases are missing something
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Start a run for each incomplete release
env:
GH_TOKEN: ${{ github.token }}
SCAN: ${{ inputs.scan }}
run: |
set -euo pipefail
case "${SCAN:-10}" in ''|*[!0-9]*) echo "::error::scan must be a number of releases, not '$SCAN'."; exit 1 ;; esac
bash releases/release-missing-scan.sh "${GITHUB_REPOSITORY:-wekan/wekan}" "${SCAN:-10}" > incomplete.txt
{
echo "### Releases missing something"
echo ""
if [ -s incomplete.txt ]; then sed 's/^/- /' incomplete.txt; else echo "None - the ${SCAN:-10} newest releases are complete."; fi
} >> "$GITHUB_STEP_SUMMARY"
while read -r version count; do
echo "v$version is missing $count asset(s): starting Release all missing for it."
gh workflow run release-all-missing.yml --repo "${GITHUB_REPOSITORY:-wekan/wekan}" --ref "${GITHUB_REF_NAME:-main}" -f version="$version"
done < incomplete.txt
plan:
needs: recover
# The planner runs whatever recover's rerun ended with. A rerun that still
@@ -102,7 +146,7 @@ jobs:
# so in every rerun of it (v12.68's OpenBSD start) - used to skip the
# planner and every build after it, so not even the assets that COULD be
# filled were. recover stays red and names the jobs; the rest goes on.
if: ${{ !cancelled() }}
if: ${{ !cancelled() && inputs.version != '' }}
timeout-minutes: 15
name: what the release is missing
runs-on: ubuntu-latest
@@ -114,6 +158,8 @@ jobs:
mac: ${{ steps.plan.outputs.mac }}
flatpak: ${{ steps.plan.outputs.flatpak }}
windows: ${{ steps.plan.outputs.windows }}
variant: ${{ steps.plan.outputs.variant }}
snap: ${{ steps.plan.outputs.snap }}
manual: ${{ steps.plan.outputs.manual }}
total: ${{ steps.plan.outputs.total }}
steps:
@@ -168,7 +214,7 @@ jobs:
total="$(wc -l < missing.txt | tr -d ' ')"
echo "total=$total" >> "$GITHUB_OUTPUT"
for kind in extra appimage mac flatpak windows bun; do
for kind in extra appimage mac flatpak windows bun variant snap; do
sels="$(awk -v k="$kind" '$1 == k { print $2 }' missing.txt)"
json="$(printf '%s\n' $sels | sed '/^$/d' | jq -R . | jq -sc .)"
[ -n "$json" ] || json='[]'
@@ -197,18 +243,25 @@ jobs:
echo ""
echo "Not buildable here (run release-all.yml): \`$manual\`"
fi
if grep -q '^snap ' missing.txt; then
echo ""
echo "wekan snaps are rebuilt by retrying the release's snap-native or snap-launchpad job (recover, above)."
fi
fi
} >> "$GITHUB_STEP_SUMMARY"
echo "Missing $total. Needs release-all.yml: ${manual:-none}"
# Not a failure HERE: a red plan skipped every build below (they need
# plan to succeed), so a release missing its amd64 zip did not get even
# the AppImages that could be made. The done job, at the end, is red
# for it instead.
- name: Say plainly what this run will not do
if: ${{ steps.plan.outputs.manual != '' }}
env:
STEP_PLAN_VERSION: ${{ steps.plan.outputs.version }}
STEP_PLAN_MANUAL: ${{ steps.plan.outputs.manual }}
run: |
echo "::error::v${STEP_PLAN_VERSION} still lacks ${STEP_PLAN_MANUAL} after recovery. Inspect the matching full-release run; older unnamed runs need their failed jobs retried manually."
exit 1
echo "::warning::v${STEP_PLAN_VERSION} still lacks ${STEP_PLAN_MANUAL} after recovery, which this workflow cannot build; the rest is built anyway. Inspect the matching full-release run; older unnamed runs need their failed jobs retried manually."
# The six architectures nobody else builds for, repacked from the PUBLISHED
# amd64 bundle - which is what makes this possible without a Meteor build.
@@ -517,6 +570,74 @@ jobs:
esac
echo "$mark charts" >> "$GITHUB_STEP_SUMMARY"
# wekan-ondra and wekan-gantt-gpl snaps the release lacks: the release's own
# wekan snap of that architecture under the variant's name and title
# (releases/snap-rename.sh) - what snap-variants builds from source, with
# nothing else changed. Releases before v13.21 have none attached.
variants:
permissions:
contents: write
name: variant snap ${{ matrix.variant }}
needs: plan
if: ${{ !cancelled() && needs.plan.result == 'success' && needs.plan.outputs.variant != '[]' }}
runs-on: ubuntu-24.04
timeout-minutes: 60
strategy:
fail-fast: false
matrix:
variant: ${{ fromJSON(needs.plan.outputs.variant) }}
env:
VERSION: ${{ needs.plan.outputs.version }}
VARIANT: ${{ matrix.variant }}
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
persist-credentials: false
- name: Rename the release's wekan snap
id: rename
env:
GH_TOKEN: ${{ github.token }}
run: |
set -euo pipefail
name="${VARIANT%%:*}"
arch="${VARIANT#*:}"
case "$name" in
wekan-ondra) title='Wekan Ondra' ;;
wekan-gantt-gpl) title='Wekan Gantt GPL' ;;
*) echo "::error::'$name' is not a variant snap."; exit 1 ;;
esac
case "$arch" in *[!a-z0-9]*|'') echo "::error::'$arch' is not an architecture."; exit 1 ;; esac
sudo apt-get install -y squashfs-tools >/dev/null
mkdir -p source out
if ! gh release download "v$VERSION" --repo "$GITHUB_REPOSITORY" --dir source --pattern "wekan_${VERSION}_${arch}.snap"; then
echo "::error::v$VERSION has no wekan_${VERSION}_${arch}.snap to make $name from. Retry the release's snap job first (recover does), then run this again."
exit 1
fi
bash releases/snap-rename.sh "source/wekan_${VERSION}_${arch}.snap" "$name" "$title" out
- name: Attach it to the release
if: ${{ always() && steps.rename.outcome == 'success' }}
env:
GH_TOKEN: ${{ github.token }}
run: |
set -euo pipefail
bash releases/github-release-upload.sh "$GITHUB_REPOSITORY" "v$VERSION" out/*.snap
# Every snap of the release, in every channel of its snap name: the same
# "Push Snap to Store" that release-all.yml ends with. A revision the store
# already has is released by number; nothing is uploaded twice.
snap-store:
needs: [plan, variants]
if: ${{ !cancelled() && needs.plan.result == 'success' }}
permissions:
contents: read
uses: ./.github/workflows/snap-store.yml
with:
tag: v${{ needs.plan.outputs.version }}
snaps: wekan wekan-ondra wekan-gantt-gpl
channels: stable,candidate,beta,edge
secrets:
SNAP_AUTH: ${{ secrets.SNAP_AUTH }}
# The end of the run attaches nothing: every job above attached its own files
# as it finished them. This only reports what the release still lacks, and it
# runs on always() - not !cancelled() - so a cancelled run still says what
@@ -525,7 +646,7 @@ jobs:
done:
timeout-minutes: 15
name: what is still missing
needs: [plan, extra-arches, appimage, mac, flatpak, windows-exe, charts, bun]
needs: [plan, extra-arches, appimage, mac, flatpak, windows-exe, charts, bun, variants, snap-store]
if: ${{ always() && needs.plan.result == 'success' }}
runs-on: ubuntu-latest
steps:
@@ -566,3 +687,10 @@ jobs:
echo "::warning::v$V is still missing:${still}"
echo "Still missing:\`${still# }\`" >> "$GITHUB_STEP_SUMMARY"
fi
# What only release-all.yml can build, still missing: red here,
# once everything that could be built has been.
case " $still" in
*" meteor/"*|*" repack/"*|*" sandstorm/"*)
echo "::error::v$V still lacks what only release-all.yml builds:${still}. Inspect the matching full-release run."
exit 1 ;;
esac
+42
View File
@@ -5530,6 +5530,10 @@ jobs:
needs: [prepare, release, snap-auth-check]
continue-on-error: true
timeout-minutes: 90
# contents: write attaches the built snap to the GitHub Release; the
# workflow's default is read.
permissions:
contents: write
strategy:
fail-fast: false
matrix:
@@ -5655,6 +5659,7 @@ jobs:
echo "snap=$BUILT_SNAP" >> "$GITHUB_OUTPUT"
- name: Verify the built snap is ${{ matrix.snapname }}
id: verify
if: steps.guard.outputs.snap == 'true'
env:
STEP_BUILD_SNAP: ${{ steps.build.outputs.snap }}
@@ -5684,6 +5689,21 @@ jobs:
SNAP_UPLOAD_LABEL="${STEP_BUILD_SNAP}" \
bash "$GITHUB_WORKSPACE/wekan/releases/snap-upload-retry.sh" "${STEP_BUILD_SNAP}" stable,candidate,beta,edge
# always(): a built variant snap goes onto the GitHub Release even when the
# Snap Store push above failed. "Push Snap to Store"
# (.github/workflows/snap-store.yml) releases the snaps OF A GITHUB
# RELEASE to the store - and until v13.21 this job only uploaded to the
# store, so v13.20 had no wekan-ondra_*.snap or wekan-gantt-gpl_*.snap and
# that workflow failed with "no assets match the file pattern".
- name: Attach the ${{ matrix.snapname }} ${{ matrix.arch }} snap to the GitHub Release
if: ${{ always() && steps.verify.outcome == 'success' && steps.build.outputs.snap != '' }}
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
STEP_BUILD_SNAP: ${{ steps.build.outputs.snap }}
run: |
set -euo pipefail
bash "$GITHUB_WORKSPACE/wekan/releases/github-release-upload.sh" "${GITHUB_REPOSITORY:-wekan/wekan}" "v${VERSION}" "${STEP_BUILD_SNAP}"
# Always, as the last step: the run summary then answers "what worked and what
# did not" for the whole release at a glance, instead of eighteen job logs. A
# step that failed has already printed an ::error:: saying why; this names the
@@ -5710,6 +5730,28 @@ jobs:
# Refresh the selected changelog notes after builds. Binary provenance remains
# in build artifacts and is never appended to release notes.
# ─── Finish the Snap Store release of all three snaps ───────────────────────
# snap-native, snap-launchpad and snap-variants upload each snap with
# --release to every channel, but the store can keep a revision in
# "processing" for hours and then not release it: on v13.20 every snap job
# was green and the store kept the old version of wekan, wekan-ondra and
# wekan-gantt-gpl. This job takes the snaps those jobs attached to THIS
# release and releases each to stable, candidate, beta and edge - a revision
# the store already has by number, a missing one by uploading it - and is red
# when one did not get there. It also runs by hand as "Push Snap to Store".
snap-store:
needs: [prepare, snap-native, snap-launchpad, snap-variants]
if: ${{ !cancelled() && needs.prepare.result == 'success' }}
permissions:
contents: read
uses: ./.github/workflows/snap-store.yml
with:
tag: v${{ needs.prepare.outputs.version }}
snaps: wekan wekan-ondra wekan-gantt-gpl
channels: stable,candidate,beta,edge
secrets:
SNAP_AUTH: ${{ secrets.SNAP_AUTH }}
release-notes:
permissions:
contents: write
+195
View File
@@ -0,0 +1,195 @@
name: Push Snap to Store
# Puts the .snap files of a GitHub release on the Snap Store and RELEASES them
# to every channel: wekan, wekan-ondra and wekan-gantt-gpl, every architecture
# the release carries.
#
# WHY: release-all.yml uploads each snap as it builds it, with
# `snapcraft upload --release=...`. The store can keep a revision in
# "processing" for hours, and an upload that gives up waiting leaves the
# release to the store - the job is green either way. On v13.20 every build
# was green and the snaps were on the GitHub release, but the Snap Store kept
# the old version. This workflow finishes that from the release itself,
# without building anything: releases/snap-store-push.sh releases a revision
# the store already has, uploads one it has not, waits for one still
# processing, and FAILS - red, not green - when a snap still did not reach a
# channel.
#
# "Release All Platforms" calls it as its last snap job, for the tag it just
# released (its snap-store job), and it runs by hand from the Actions tab for
# any release, snap names and channels. It used to run on workflow_run after
# every Release All run and take "the latest release" - which, for a run that
# finished before its release was published, was the previous one (v13.20).
#
# Secrets: SNAP_AUTH, as for release-all.yml - an exported login carrying
# package_access, package_push, package_release and package_update for all
# three names.
on:
workflow_dispatch:
inputs:
tag:
description: 'Release tag (e.g. v13.20). Empty: the latest release.'
required: false
default: ''
snaps:
description: 'Snap names, space separated'
required: false
default: 'wekan wekan-ondra wekan-gantt-gpl'
channels:
description: 'Channels to release to'
required: false
default: 'stable,candidate,beta,edge'
workflow_call:
inputs:
tag:
type: string
required: true
snaps:
type: string
required: false
default: 'wekan wekan-ondra wekan-gantt-gpl'
channels:
type: string
required: false
default: 'stable,candidate,beta,edge'
secrets:
SNAP_AUTH:
required: true
permissions:
contents: read
concurrency:
group: snap-store
cancel-in-progress: false
env:
DO_NOT_TRACK: 1
jobs:
plan:
runs-on: ubuntu-24.04
timeout-minutes: 10
outputs:
tag: ${{ steps.plan.outputs.tag }}
snaps: ${{ steps.plan.outputs.snaps }}
channels: ${{ steps.plan.outputs.channels }}
steps:
- name: Which release, which snaps, which channels
id: plan
env:
GH_TOKEN: ${{ github.token }}
INPUT_TAG: ${{ inputs.tag }}
INPUT_SNAPS: ${{ inputs.snaps }}
INPUT_CHANNELS: ${{ inputs.channels }}
run: |
set -euo pipefail
tag="${INPUT_TAG:-}"
if [ -z "$tag" ]; then
tag="$(gh release view --repo "$GITHUB_REPOSITORY" --json tagName --jq .tagName)"
fi
case "$tag" in v[0-9]*) ;; *) echo "::error::'$tag' is not a release tag like v13.20."; exit 1 ;; esac
snaps="${INPUT_SNAPS:-wekan wekan-ondra wekan-gantt-gpl}"
for s in $snaps; do
case "$s" in wekan|wekan-ondra|wekan-gantt-gpl) ;; *) echo "::error::'$s' is not one of WeKan's snaps (wekan, wekan-ondra, wekan-gantt-gpl)."; exit 1 ;; esac
done
channels="${INPUT_CHANNELS:-stable,candidate,beta,edge}"
case "$channels" in *[!a-z0-9/,.-]*) echo "::error::'$channels' is not a channel list."; exit 1 ;; esac
echo "tag=$tag" >> "$GITHUB_OUTPUT"
echo "snaps=$(printf '%s\n' $snaps | jq -R . | jq -cs .)" >> "$GITHUB_OUTPUT"
echo "channels=$channels" >> "$GITHUB_OUTPUT"
echo "Release $tag: $snaps -> $channels"
push:
needs: [plan]
runs-on: ubuntu-24.04
# One snap name per job; its architectures one after another. A store
# still processing may take the whole wait of snap-store-push.sh.
timeout-minutes: 360
strategy:
fail-fast: false
matrix:
snap: ${{ fromJSON(needs.plan.outputs.snaps) }}
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
with:
sparse-checkout: releases
persist-credentials: false
- name: Install snapcraft and check SNAP_AUTH
id: snapcraft
env:
SNAP_AUTH: ${{ secrets.SNAP_AUTH }}
run: |
set -euo pipefail
if [ -z "${SNAP_AUTH:-}" ]; then
echo "::error::SNAP_AUTH is not set. snapcraft export-login --snaps wekan,wekan-ondra,wekan-gantt-gpl --acls package_access,package_push,package_release,package_update snap-auth.txt && gh secret set SNAP_AUTH --repo wekan/wekan < snap-auth.txt"
exit 1
fi
installed=""
for i in 1 2 3 4 5; do
if timeout 180 sudo snap install snapcraft --classic; then installed=1; break; fi
sudo snap abort --last=install >/dev/null 2>&1 || true
echo "snapcraft install attempt $i/5 failed; retrying in 30s..."
sleep 30
done
[ -n "$installed" ] || { echo "::error::snapcraft could not be installed: the Snap Store did not answer. Re-run the job."; exit 1; }
SNAPCRAFT_STORE_CREDENTIALS="$SNAP_AUTH" snapcraft whoami
- name: Download ${{ matrix.snap }} from ${{ needs.plan.outputs.tag }}
env:
GH_TOKEN: ${{ github.token }}
TAG: ${{ needs.plan.outputs.tag }}
SNAP: ${{ matrix.snap }}
run: |
set -euo pipefail
mkdir -p snaps
# A release cut before v13.22 has no wekan-ondra or wekan-gantt-gpl
# snap attached (snap-variants did not attach them). A variant IS
# wekan with another name and title, so it is made from the
# release's wekan snaps (releases/snap-rename.sh), as Release All
# Missing does.
if ! gh release download "$TAG" --repo "$GITHUB_REPOSITORY" --dir snaps --pattern "${SNAP}_*.snap"; then
case "$SNAP" in
wekan-ondra) title='Wekan Ondra' ;;
wekan-gantt-gpl) title='Wekan Gantt GPL' ;;
*) echo "::error::Release $TAG has no ${SNAP}_*.snap to push: its snap job did not attach one (snap-native and snap-launchpad attach wekan). Re-run that job of the release, or Release All Missing, then this workflow."; exit 1 ;;
esac
mkdir -p wekan-snaps
if ! gh release download "$TAG" --repo "$GITHUB_REPOSITORY" --dir wekan-snaps --pattern "wekan_*.snap"; then
echo "::error::Release $TAG has neither ${SNAP}_*.snap nor a wekan_*.snap to make it from. Re-run the release's snap jobs, or Release All Missing, then this workflow."
exit 1
fi
sudo apt-get install -y squashfs-tools >/dev/null
for f in wekan-snaps/wekan_*.snap; do
bash releases/snap-rename.sh "$f" "$SNAP" "$title" snaps
done
echo "::notice::$TAG had no ${SNAP} snap; made it from the release's wekan snaps."
fi
ls -l snaps
- name: Push ${{ matrix.snap }} to the Snap Store, releasing to ${{ needs.plan.outputs.channels }}
env:
SNAPCRAFT_STORE_CREDENTIALS: ${{ secrets.SNAP_AUTH }}
CHANNELS: ${{ needs.plan.outputs.channels }}
run: |
set -euo pipefail
failed=""
for f in snaps/*.snap; do
# Each architecture on its own: one that the store is still
# processing does not stop the others.
if ! bash releases/snap-store-push.sh "$f" "$CHANNELS"; then failed="$failed $(basename "$f")"; fi
done
if [ -n "$failed" ]; then
echo "::error::Not released:$failed. The ::error:: lines above say why."
exit 1
fi
# The newest revision the store has of each architecture, released to
# every channel too - one that reached the store some other way, or a
# reviewer approved later, whatever this release's files are. always():
# also when a file above was not taken.
- name: Release the newest ${{ matrix.snap }} revisions the store has to ${{ needs.plan.outputs.channels }}
if: ${{ always() && steps.snapcraft.outcome == 'success' }}
env:
SNAPCRAFT_STORE_CREDENTIALS: ${{ secrets.SNAP_AUTH }}
CHANNELS: ${{ needs.plan.outputs.channels }}
SNAP: ${{ matrix.snap }}
run: bash releases/snap-store-release-newest.sh "$SNAP" "$CHANNELS"
+928 -951
View File
File diff suppressed because it is too large. Load diff
+37 -31
View File
@@ -5,6 +5,43 @@ each one changed and the project status are in
Written by `node releases/changelog-short.mjs` from CHANGELOG-big.md:
make changes there.
# v13.23 2026-11-20 WeKan ® release
The **Import** page and the **Export** menu list a company's
products under the company's name: **37signals**, **Atlassian**, **Google** and
**Microsoft**.
[All changes in v13.23](CHANGELOG-big.md#v1323-2026-11-20-wekan--release)
# v13.22 2026-11-20 WeKan ® release
Repeating tasks of **Taskwarrior**, **Microsoft To Do**,
**Todoist**, **TickTick**, **Tasks.org**, **Vikunja**, **Super Productivity**,
**iCalendar**, **Org mode** and **Obsidian Kanban** now repeat in WeKan, and
their exports write the repeat back. **Release All**
builds and pushes **wekan**, **wekan-ondra** and **wekan-gantt-gpl** to every
Snap Store channel, and **Release All Missing** adds what a release lacks,
snaps included. A **WeKan board** imported from its own export keeps all of
its Board Settings and card fields, and **Rocket.Chat** and **Fizzy** are
imported and exported.
[All changes in v13.22](CHANGELOG-big.md#v1322-2026-11-20-wekan--release)
# v13.21 2026-11-20 WeKan ® release
Twelve new **Board View reports** - Created vs. Resolved, Net
Flow, Time in List and more - and **grouped menus**: the Board View menu, the
Import and Export lists and the list, card and swimlane menus have headings.
WeKan imports **mail**, **calendars**, **chats** and **notes**, and large files
are **streamed to disk** within the free space or an Admin Panel limit. Menu
entries that did nothing now work. Cards get the **Kanban and Scrum flow
fields** Blocked, Class of service, MoSCoW and WSJF, lists their **policies**,
the board menu a **standup timer** and a **retrospective board**, every export
is **written a page at a time**, and **InviteBleed** is closed for the old
invitation codes too.
[All changes in v13.21](CHANGELOG-big.md#v1321-2026-11-20-wekan--release)
# v13.20 2026-11-19 WeKan ® release
The **REST API** card lists of a list and of a swimlane now carry
@@ -21,34 +58,3 @@ to process an upload, or when a **Termux** or **BSD** package mirror has a bad
minute.
[All changes in v13.19](CHANGELOG-big.md#v1319-2026-11-19-wekan--release)
# v13.18 2026-11-19 WeKan ® release
**Admin Panel / Problems** says what its numbers count - "New
problems: 1" and "Checks with findings: 8 / 31", in every language - and a
report row's address, location and user always belong to the same occurrence.
[All changes in v13.18](CHANGELOG-big.md#v1318-2026-11-19-wekan--release)
# v13.17 2026-11-19 WeKan ® release
The **Admin Panel** answers one question per tab: Settings gains
**Appearance**, **Features**, **Feature profiles**, Security, Activities and
notifications, and Delete, Problems keeps only what is going wrong, and every
old
address redirects. The docs now have a page for every menu entry, and cards of
an archived swimlane no longer appear in the first swimlane.
[All changes in v13.17](CHANGELOG-big.md#v1317-2026-11-19-wekan--release)
# v13.16 2026-11-19 WeKan ® release
**ListLockBulkBleed** is fixed, and a list that refuses a role
now also refuses that role's bulk writes, dependency lines, rule actions and
changes to the list or swimlane itself. Administrators can give chosen users,
teams and organizations a smaller WeKan with opt-in **feature profiles**. A
server no longer runs out of memory in the hourly **History integrity audit**,
**scheduled rules** can create cards again, and **Card Excel export** and
clearing a card's text work again.
[All changes in v13.16](CHANGELOG-big.md#v1316-2026-11-19-wekan--release)
+1 -1
View File
@@ -38,7 +38,7 @@ FROM --platform=$BUILDPLATFORM debian:trixie AS bundle
ARG TARGETARCH
ARG TARGETVARIANT
ARG VERSION=13.20
ARG VERSION=13.23
ARG DEBIAN_FRONTEND=noninteractive
COPY --chmod=755 releases/check-telemetry.py /tmp/check-telemetry.py
+16 -5
View File
@@ -44,8 +44,11 @@ that by providing one-click installation on various platforms.
- Add Board / Import ([all import and export formats](docs/Features/Board-Sidebar/Board-Settings/Import-Export/External-Tools.md)):
- WeKan JSON/.zip, CSV/TSV, Excel, Markdown, Obsidian Kanban, Leo, OPML, Org mode, todo.txt
- Trello, Jira, Asana, Zenkit, Focalboard, Todoist, Microsoft Planner, MeisterTask, Linear, TickTick, ClickUp, Nullboard, Kanri, Pivotal Tracker, Redmine, Tasks.org, monday.com,
Super Productivity, Taiga, Vikunja, Wrike (Excel and workflow), Quire, Teamwork.com, Businessmap, Notion, Plane
- Kanboard, Nextcloud Deck, OpenProject, Taskwarrior
Super Productivity, Taiga, Vikunja, Wrike (Excel and workflow), Quire, Teamwork.com, Businessmap, Notion, Fizzy, Plane
- Kanboard, Nextcloud Deck, OpenProject, Taskwarrior, Planka, KanbanFlow, Basecamp, Microsoft To Do, Google Tasks
- Mail (.eml/mbox), Calendars (iCalendar), Google Takeout, Google Keep, Evernote,
Chats: Slack, Mattermost, Rocket.Chat, Telegram, WhatsApp, Discord - each into the view it fits
- Large files are streamed to disk, within its free space or the Admin Panel limit
- GitHub, GitLab, Gitea, Forgejo
- Import many boards at once: several export files, or a .zip of them, each its own board;
One board per project splits an export of a whole app into a board per project
@@ -72,6 +75,9 @@ that by providing one-click installation on various platforms.
- Minicard: At list there is card, that has not been not opened yet
- Card: Opened card popup of minicard
- Attachments viewer for PDF and Office documents
- Kanban and Scrum flow fields: Blocked, Class of service, MoSCoW priority, WSJF score
- List policies, Definition of Ready, commitment point, WIP limit per person,
lists split into Doing and Done
- Drag drop reorder one or Multi-Selection: Swimlanes, Lists, Minicards, Checklists, Checklist Items
- Collapse/Uncollapse: Menus, Swimlanes, Lists, Cards
- Table, Calendar, Multi Board Calendar, Time, Timeline
@@ -82,6 +88,9 @@ that by providing one-click installation on various platforms.
Lead Time, Throughtput Histogram, WIP Run, Pulse, Aging WIP,
Blocker Analysis, Monte Carlo Forecasts, Process Behavior (XmR),
Work Item Size vs Cycle Time, Map
- Reports: Created vs. Resolved, Net Flow, Time in List, Average Age,
Throughput Run Chart, Due Date Performance, Release Burndown, Epic Progress,
Workload, Distribution, Dependency Map, Activity Heatmap - each with PDF and Excel export
- Right Sidebar / Board Settings:
- Rules: like IFTTT like Trello Butler
- Lists view for Rules
@@ -96,10 +105,11 @@ that by providing one-click installation on various platforms.
Microsoft Planner, MeisterTask, Obsidian Kanban, Linear, TickTick, ClickUp, Nullboard, Kanri, Pivotal Tracker, Redmine, Tasks.org, monday.com,
Super Productivity, Taiga, Vikunja, Wrike (Excel and workflow), Quire, Teamwork.com, Businessmap, Notion,
Trello, Jira, NextCloud Deck, OpenProject, GitHub, GitLab,
Gitea, Forgejo, Asana, Zenkit
Gitea, Forgejo, Asana, Zenkit, Trello .zip with attachments, mbox, Evernote, Mattermost, Rocket.Chat, Fizzy
- Every export is written a page of cards at a time, so a large board exports without running out of memory
- Export all boards at once (All Boards sidebar, or Multi-Selection): Excel as one workbook
with a sheet per board, every other format as a .zip with a file per board
- Scrum Settings
- Scrum Settings: Definition of Ready and Done, Daily standup timer, Retrospective board
- Change color theme, Change Background Image, Date settings
- Settings:
- Board View: Show/Hide and drag drop reorder what is shown atat Public Board and Private Board
@@ -108,7 +118,8 @@ that by providing one-click installation on various platforms.
- Admin Panel
- Settings
- Version
- Visibility: What is shown/hidden, Whitelabeling
- Features: which features this WeKan offers, Card fields, Feature profiles
- Appearance: What is shown/hidden, Whitelabeling
- Announcement
- Accessibility
- Translation: Add custom translation strings
+1 -1
View File
@@ -1,5 +1,5 @@
appId: wekan-public/apps/77b94f60-dec9-0136-304e-16ff53095928
appVersion: "v13.20.0"
appVersion: "v13.23.0"
files:
userUploads:
- README.md
+33 -23
View File
@@ -20,28 +20,38 @@ the changelog only says what changed.
- The WebKit stage cannot run in the Flatpak sandbox: MiniBrowser needs its own
sandbox, and turning that off is not allowed there. Run it on a host.
## Found while documenting the menus, to fix
## Need accounts on the tools, or a running copy of one
- Member menu / Edit Profile: with Admin Panel / People / Login **Username
change** allowed, a user's new username is not saved - `setUsername`
(`server/models/users.js`) writes only when the caller is a site admin, while
`setEmail` beside it allows a self change when the setting says so. The popup
closes as if it had saved. Found on 2026-11-19.
- Member menu / Support: the Support page template has a case for signed-out
visitors, but the `/support` route sends them to sign-in first, so that case is
never reached; and `supportPopup` with its `.js-support` handler is no longer
opened by the menu, which links to `/support`. Decide whether signed-out
visitors should see the page, and remove the unused popup.
- Card menu / Create board from this card: the entry sits under `unless
canModifyCard` in `cardDetailsActionsPopup` (`client/components/cards/
cardDetails.jade`), so a member who can edit the card does not see it, while
the `createBoardFromCard` method requires write access. It was in both
branches when added (17c6d8d9b9); a later refactor kept only this one. Check in
the running app and restore it for members who can edit the card.
- Board menu / All Boards Settings: the board menu entry is commented out
("Bug Board icons random dance", [#4214](https://github.com/wekan/wekan/issues/4214)), so the popup cannot be reached.
- Admin Panel / People / Shared templates: which group kinds the "Share template
with" picker offers comes from the browser's `localStorage`
(`sharedTemplatesScopes`), so it differs per browser and is empty in a browser
where the admin never ticked them. An instance setting belongs in Settings.
The import/export review asked on 2026-11-20 (everything each tool with a
WeKan import or export can hold comes across, whole or in part) went through
every parser and formatter against the export format its header documents.
What it found is fixed and in the Upcoming release; the round trips are held
by `tests/playwright/specs/export-import-round-trip.e2e.js` (41 formats, the
description, checklist, comment, dependency, label and due date) and
`tests/exportRoundTripFields.test.cjs` (32 formats in plain Node: start and
creation dates, spent time, the done tick, recurrence, people, custom fields,
color, Blocked), and a WeKan board's every field by
`tests/wekanCardFields.test.cjs`. What is left needs what this checkout does
not have:
- Each tool's newest release, checked with a real export file of it: Planner,
Wrike, Teamwork, Businessmap, MeisterTask, Quire and Jira - the
proprietary ones, whose current export is only seen with an account
(Planner's newer Status, Task title and Assignments columns are read, as
Microsoft's help page names them; a real file would confirm their exact
spelling). The parsers follow
the formats the tools document and report what they do not read, so a new
field shows up in the import's loss report; checking for one needs an
account on each tool. (Checked against their current source on 2026-11-20:
Plane's IssueExportSerializer, Kanri's kanban-types.d.ts, Obsidian Kanban's
markers, Nullboard's board object, and Gitea's (and Forgejo's) Issue
struct, whose created_at, closed_at and time_estimate are read now;
GitHub's REST issue, whose issue type is read now; GitLab's Issues API v4,
whose health status and incident severity are read now. Redmine and
monday.com import every column they do not name as a custom field, so a
column a new release adds comes across without a change. Focalboard's archive
format is frozen: Mattermost stopped merging changes to Focalboard and
Boards in September 2023.
Pivotal Tracker was shut down in 2025, so there is no newer release.
Linear's open-source importer, @linear/import, declares the columns the
parser reads.)
+3 -2
View File
@@ -2029,10 +2029,11 @@ if arguments >= 3 and sys.argv[1] == 'exportboardpdf':
# { excelBase64 } (Plane's as { xlsxBase64 }), an export .zip as { zipBase64 },
# a CSV/TSV file as rows, a text format as its text, and the rest as JSON.
EXCEL_IMPORT_SOURCES = {'excel', 'planner', 'monday', 'wrike', 'teamwork', 'businessmap'}
ZIP_IMPORT_SOURCES = {'vikunja', 'notion', 'plane'}
ZIP_IMPORT_SOURCES = {'vikunja', 'notion', 'plane', 'slack', 'googletakeout', 'telegram', 'discord', 'rocketchat', 'fizzy'}
TEXT_IMPORT_SOURCES = {'markdown', 'todotxt', 'taskwarrior', 'focalboard', 'todoist', 'meistertask', 'obsidian',
'linear', 'ticktick', 'clickup', 'nullboard', 'pivotal', 'redmine', 'superproductivity',
'quire', 'orgmode', 'leo', 'opml', 'vikunja', 'notion', 'plane'}
'quire', 'orgmode', 'leo', 'opml', 'vikunja', 'notion', 'plane',
'mail', 'ical', 'mattermost', 'whatsapp', 'evernote', 'slack', 'googletakeout', 'rocketchat', 'fizzy'}
def import_document(source, filepath):
import base64, csv, io, os
+24
View File
@@ -110,6 +110,30 @@ template(name="boardBody")
+processBehaviorView
else if isViewSizeCycleTime
+sizeCycleTimeView
else if isViewCreatedResolved
+createdResolvedView
else if isViewNetFlow
+netFlowView
else if isViewTimeInList
+timeInListView
else if isViewAverageAge
+averageAgeView
else if isViewThroughputRun
+throughputRunView
else if isViewDueDatePerformance
+dueDatePerformanceView
else if isViewReleaseBurndown
+releaseBurndownView
else if isViewEpicProgress
+epicProgressView
else if isViewWorkload
+workloadView
else if isViewDistribution
+distributionView
else if isViewDependencyMap
+dependencyMapView
else if isViewActivityHeatmap
+activityHeatmapView
else if isViewPulse
+pulseView
else if isViewMap
+49
View File
@@ -964,6 +964,55 @@ Template.boardBody.helpers({
return Utils.boardView() === 'board-view-size-cycle-time';
},
// The reports of 2026-11-20 (models/lib/boardReports.js).
isViewCreatedResolved() {
return Utils.boardView() === 'board-view-created-resolved';
},
isViewNetFlow() {
return Utils.boardView() === 'board-view-net-flow';
},
isViewTimeInList() {
return Utils.boardView() === 'board-view-time-in-list';
},
isViewAverageAge() {
return Utils.boardView() === 'board-view-average-age';
},
isViewThroughputRun() {
return Utils.boardView() === 'board-view-throughput-run';
},
isViewDueDatePerformance() {
return Utils.boardView() === 'board-view-due-date-performance';
},
isViewReleaseBurndown() {
return Utils.boardView() === 'board-view-release-burndown';
},
isViewEpicProgress() {
return Utils.boardView() === 'board-view-epic-progress';
},
isViewWorkload() {
return Utils.boardView() === 'board-view-workload';
},
isViewDistribution() {
return Utils.boardView() === 'board-view-distribution';
},
isViewDependencyMap() {
return Utils.boardView() === 'board-view-dependency-map';
},
isViewActivityHeatmap() {
return Utils.boardView() === 'board-view-activity-heatmap';
},
isViewMap() {
return Utils.boardView() === 'board-view-map';
},
+16
View File
@@ -983,3 +983,19 @@ body.board-view.mobile-mode #header #header-main-bar .board-header-sidebar-toggl
font-size: calc(16px * var(--wekan-ui-font-scale, 1));
}
}
/* Board View menu: the heading over each group of views
(models/lib/boardViewSettings.js BOARD_VIEW_GROUPS). */
.pop-over-list .board-view-group-heading {
padding: 8px 10px 2px;
font-size: 0.8em;
font-weight: bold;
text-transform: uppercase;
letter-spacing: 0.04em;
color: #6b778c;
cursor: default;
}
.pop-over-list .board-view-group-heading:not(:first-child) {
margin-top: 4px;
border-top: 1px solid #dfe1e6;
}
+4 -2
View File
@@ -173,16 +173,18 @@ template(name="boardChangeWatchPopup")
(js-open-<view>-view), which is what the click handlers in boardHeader.js
listen for. docs/Features/Board-Sidebar/Board-Settings/Board-View.md
template(name="boardChangeViewPopup")
//- Grouped, a heading over each group (models/lib/boardViewSettings.js
BOARD_VIEW_GROUPS), the board's own order inside a group.
ul.pop-over-list
each boardViewMenuEntries
if groupLabelKey
li.board-view-group-heading {{_ groupLabelKey}}
li
a.js-board-view-entry(class="{{jsClass}}")
i.fa(class="{{icon}}")
| {{_ labelKey}}
if isCurrent
i.fa.fa-check
if separatorAfter
hr
//- The Create Board form: a title, what the board is visible to, and Create.
Four templates drew it letter for letter - the one on the All Boards page and
+61
View File
@@ -452,6 +452,55 @@ Template.boardChangeViewPopup.events({
Utils.setBoardView('board-view-size-cycle-time');
Popup.back();
},
// The reports of 2026-11-20 (models/lib/boardReports.js).
'click .js-open-created-resolved-view'() {
Utils.setBoardView('board-view-created-resolved');
Popup.back();
},
'click .js-open-net-flow-view'() {
Utils.setBoardView('board-view-net-flow');
Popup.back();
},
'click .js-open-time-in-list-view'() {
Utils.setBoardView('board-view-time-in-list');
Popup.back();
},
'click .js-open-average-age-view'() {
Utils.setBoardView('board-view-average-age');
Popup.back();
},
'click .js-open-throughput-run-view'() {
Utils.setBoardView('board-view-throughput-run');
Popup.back();
},
'click .js-open-due-date-performance-view'() {
Utils.setBoardView('board-view-due-date-performance');
Popup.back();
},
'click .js-open-release-burndown-view'() {
Utils.setBoardView('board-view-release-burndown');
Popup.back();
},
'click .js-open-epic-progress-view'() {
Utils.setBoardView('board-view-epic-progress');
Popup.back();
},
'click .js-open-workload-view'() {
Utils.setBoardView('board-view-workload');
Popup.back();
},
'click .js-open-distribution-view'() {
Utils.setBoardView('board-view-distribution');
Popup.back();
},
'click .js-open-dependency-map-view'() {
Utils.setBoardView('board-view-dependency-map');
Popup.back();
},
'click .js-open-activity-heatmap-view'() {
Utils.setBoardView('board-view-activity-heatmap');
Popup.back();
},
'click .js-open-map-view'() {
Utils.setBoardView('board-view-map');
Popup.back();
@@ -976,6 +1025,18 @@ Template.boardViewMenu.helpers({
'board-view-chat': 'board-view-chat',
'board-view-version-control': 'board-view-version-control',
'board-view-column-sets': 'board-view-column-sets',
'board-view-created-resolved': 'board-view-created-resolved',
'board-view-net-flow': 'board-view-net-flow',
'board-view-time-in-list': 'board-view-time-in-list',
'board-view-average-age': 'board-view-average-age',
'board-view-throughput-run': 'board-view-throughput-run',
'board-view-due-date-performance': 'board-view-due-date-performance',
'board-view-release-burndown': 'board-view-release-burndown',
'board-view-epic-progress': 'board-view-epic-progress',
'board-view-workload': 'board-view-workload',
'board-view-distribution': 'board-view-distribution',
'board-view-dependency-map': 'board-view-dependency-map',
'board-view-activity-heatmap': 'board-view-activity-heatmap',
};
return TAPi18n.__(names[Utils.boardView()] || 'board-view');
},
+5 -10
View File
@@ -75,16 +75,11 @@ import { errorMessage } from '/client/lib/errorMessage';
// SubsManager removed for Meteor 3 migration
// #5850: which sharing scopes (organizations/teams/domains) the admin enabled
// in Admin Panel > People > Shared Templates (stored in localStorage, like the
// Shared Templates admin UI). Used to gate the drag-to-share drop targets.
// in Admin Panel > People > Shared Templates - an instance setting, the same in
// every browser. Used to gate the drag-to-share drop targets.
function loadSharedTemplatesScopes() {
try {
const raw = window.localStorage.getItem('sharedTemplatesScopes');
const arr = raw ? JSON.parse(raw) : [];
return Array.isArray(arr) ? arr : [];
} catch (e) {
return [];
}
const { sharedTemplatesScopes } = require('/models/lib/sharedTemplatesScopes');
return sharedTemplatesScopes(ReactiveCache.getCurrentSetting());
}
// #5850: share a (template) board with an Organization / Team / Domain by adding
@@ -1178,7 +1173,7 @@ Template.boardList.helpers({
return Template.instance().selectedMenu.get() === type;
},
// #5850: drag-to-share drop targets — the user's organizations/teams/domains,
// gated by the admin's Shared Templates scopes (localStorage). Shown in the
// gated by the admin's Shared Templates scopes (Settings). Shown in the
// Templates view so a personal Template Board can be dragged onto one to share.
shareTargets() {
const scopes = loadSharedTemplatesScopes();
@@ -51,3 +51,42 @@ template(name="processBehaviorView")
template(name="sizeCycleTimeView")
+boardChartView(chartKey="sizeCycleTime" titleKey="board-view-size-cycle-time")
//- The reports of 2026-11-20 (models/lib/boardReports.js): each answers bars and
a table, drawn and exported by boardChartView like the charts above.
template(name="createdResolvedView")
+boardChartView(chartKey="createdResolved" titleKey="board-view-created-resolved")
template(name="netFlowView")
+boardChartView(chartKey="netFlow" titleKey="board-view-net-flow")
template(name="timeInListView")
+boardChartView(chartKey="timeInList" titleKey="board-view-time-in-list")
template(name="averageAgeView")
+boardChartView(chartKey="averageAge" titleKey="board-view-average-age")
template(name="throughputRunView")
+boardChartView(chartKey="throughputRun" titleKey="board-view-throughput-run")
template(name="dueDatePerformanceView")
+boardChartView(chartKey="dueDatePerformance" titleKey="board-view-due-date-performance")
template(name="releaseBurndownView")
+boardChartView(chartKey="releaseBurndown" titleKey="board-view-release-burndown")
template(name="epicProgressView")
+boardChartView(chartKey="epicProgress" titleKey="board-view-epic-progress")
template(name="workloadView")
+boardChartView(chartKey="workload" titleKey="board-view-workload")
template(name="distributionView")
+boardChartView(chartKey="distribution" titleKey="board-view-distribution")
template(name="dependencyMapView")
+boardChartView(chartKey="dependencyMap" titleKey="board-view-dependency-map")
template(name="activityHeatmapView")
+boardChartView(chartKey="activityHeatmap" titleKey="board-view-activity-heatmap")
@@ -15,6 +15,18 @@ const PLACEHOLDER_VIEW_TEMPLATES = [
'throughputHistogramView',
'wipRunView',
'pulseView',
'createdResolvedView',
'netFlowView',
'timeInListView',
'averageAgeView',
'throughputRunView',
'dueDatePerformanceView',
'releaseBurndownView',
'epicProgressView',
'workloadView',
'distributionView',
'dependencyMapView',
'activityHeatmapView',
];
PLACEHOLDER_VIEW_TEMPLATES.forEach(name => {
@@ -98,6 +98,12 @@ function barsFromSeries(series, valueKey, labelKey) {
function computeBarRows(chartKey, data) {
if (!data) return [];
// The reports (models/lib/boardReports.js) answer their bars ready to draw.
if (Array.isArray(data.bars)) {
const { labelText } = require('/models/lib/boardReports');
return data.bars.map(bar => ({ label: labelText(bar.label, (key, fallback) => TAPi18n.__(key) || fallback),
value: Math.round((Number(bar.value) || 0) * 100) / 100 }));
}
if (chartKey === 'burndown') return barsFromSeries(data.series, 'remaining', 'day');
if (chartKey === 'burnup') return barsFromSeries(data.series, 'completed', 'day');
if (chartKey === 'wipRun') return barsFromSeries(data.series, 'count', 'day');
+24 -1
View File
@@ -238,11 +238,18 @@ const EXPORT_FORMAT_GROUPS = [
// Straight into Trello through its API (server/trelloApiExport.js), not
// a file: an action that opens its own popup.
{ key: 'trello-api', icon: 'fa-trello', label: 'Trello', action: 'js-export-to-trello', scopes: BOARD_ONLY },
// Trello's board.json with the cards' attachments as files, the .zip
// the Trello import reads (server/lib/renderExternalExport.js streamTrelloZip).
{ key: 'trellozip', icon: 'fa-file-archive-o', labelKey: 'attachments', labelPrefix: 'Trello .zip', path: 'export/trellozip', ext: 'zip', scopes: BOARD_ONLY },
{ key: 'kanboard', icon: 'fa-upload', label: 'Kanboard', path: 'export/kanboard', ext: 'json', scopes: BOARD_ONLY },
{ key: 'markdown', icon: 'fa-file-text-o', label: 'Markdown', path: 'export/markdown', ext: 'md', scopes: BOARD_ONLY },
{ key: 'leo', icon: 'fa-sitemap', label: 'Leo', path: 'export/leo', ext: 'leo', scopes: BOARD_ONLY },
{ key: 'opml', icon: 'fa-indent', label: 'OPML', path: 'export/opml', ext: 'opml', scopes: BOARD_ONLY },
{ key: 'orgmode', icon: 'fa-list-alt', label: 'Org mode', path: 'export/orgmode', ext: 'org', scopes: BOARD_ONLY },
{ key: 'mbox', icon: 'fa-envelope-o', label: 'Mail (mbox)', path: 'export/mbox', ext: 'mbox', scopes: BOARD_ONLY },
{ key: 'enex', icon: 'fa-sticky-note', label: 'Evernote (.enex)', path: 'export/enex', ext: 'enex', scopes: BOARD_ONLY },
{ key: 'mattermost', icon: 'fa-comments', label: 'Mattermost', path: 'export/mattermost', ext: 'jsonl', scopes: BOARD_ONLY },
{ key: 'rocketchat', icon: 'fa-comments', label: 'Rocket.Chat', path: 'export/rocketchat', ext: 'zip', scopes: BOARD_ONLY },
{ key: 'todotxt', icon: 'fa-list-ul', label: 'todo.txt', path: 'export/todotxt', ext: 'txt', scopes: BOARD_ONLY },
{ key: 'taskwarrior', icon: 'fa-terminal', label: 'Taskwarrior', path: 'export/taskwarrior', ext: 'json', scopes: BOARD_ONLY },
{ key: 'focalboard', icon: 'fa-th-large', label: 'Focalboard', path: 'export/focalboard', ext: 'jsonl', scopes: BOARD_ONLY },
@@ -261,6 +268,7 @@ const EXPORT_FORMAT_GROUPS = [
{ key: 'monday', icon: 'fa-table', label: 'monday.com', path: 'export/monday', ext: 'xlsx', scopes: BOARD_ONLY },
{ key: 'superproductivity', icon: 'fa-check-circle-o', label: 'Super Productivity', path: 'export/superproductivity', ext: 'json', scopes: BOARD_ONLY },
{ key: 'vikunja', icon: 'fa-file-archive-o', label: 'Vikunja', path: 'export/vikunja', ext: 'zip', scopes: BOARD_ONLY },
{ key: 'fizzy', icon: 'fa-file-archive-o', label: 'Fizzy', path: 'export/fizzy', ext: 'zip', scopes: BOARD_ONLY },
{ key: 'wrike', icon: 'fa-table', label: 'Wrike', path: 'export/wrike', ext: 'xlsx', scopes: BOARD_ONLY },
{ key: 'wrikeworkflow', icon: 'fa-sitemap', label: 'Wrike workflow', path: 'export/wrikeworkflow', ext: 'json', scopes: BOARD_ONLY },
{ key: 'teamwork', icon: 'fa-table', label: 'Teamwork.com', path: 'export/teamwork', ext: 'xlsx', scopes: BOARD_ONLY },
@@ -316,7 +324,22 @@ function resolvedFormatGroups() {
url: entry.path ? exportUrl(`/api/boards/:boardId/${entry.path}`, entry.query || {}) : '',
})),
}))
.filter(group => group.entries.length);
.filter(group => group.entries.length)
// The other tools' formats under headings by kind (models/lib/toolGroups.js),
// the same groups as the Import page; WeKan's own JSON keeps "JSON", and
// a company with several products is headed by the company's name.
.flatMap(group => {
if (group.key !== 'json') return [group];
const { groupTools } = require('/models/lib/toolGroups');
const parts = [];
for (const entry of groupTools(group.entries)) {
if (entry.groupStart) {
parts.push({ key: `json-${entry.group}`, heading: entry.groupLabelKey ? TAPi18n.__(entry.groupLabelKey) : entry.groupLabel || group.heading, entries: [] });
}
parts[parts.length - 1].entries.push(entry);
}
return parts;
});
}
// Import writes to the board, so unlike export it is offered only to somebody
@@ -63,3 +63,8 @@
global form rules give selects one row's height; show a few rows. */
.scrum-view select[multiple], .scrum-metadata select[multiple] { min-height: 5.5em; height: auto; }
.scrum-multiple-help { display: block; opacity: .8; max-width: 32em; }
/* The Definition of Ready and of Done, readable by every member. */
.scrum-definition .scrum-definition-text {
white-space: pre-wrap;
}
@@ -33,6 +33,16 @@ template(name="scrumView")
p {{_ 'scrum-history-job-running' done=historyJob.done total=historyJob.total}}
.scrum-progress
.scrum-progress-bar(style=historyJob.style)
//- The team's Definition of Ready and Definition of Done, readable by
every member - the settings below are the board admin's.
if settings.definitionOfReady
details.scrum-definition.js-scrum-definition-of-ready
summary {{_ 'scrum-definition-of-ready'}}
p.scrum-definition-text= settings.definitionOfReady
if settings.definitionOfDone
details.scrum-definition.js-scrum-definition-of-done
summary {{_ 'scrum-definition-of-done'}}
p.scrum-definition-text= settings.definitionOfDone
if canAdmin
details.scrum-settings(open=settingsOpen)
summary {{_ 'scrum-settings'}}
@@ -42,8 +52,21 @@ template(name="scrumView")
| {{_ 'scrum-enabled'}}
label {{_ 'scrum-product-goal'}}
textarea(name="productGoal") {{settings.productGoal}}
//- Definition of Ready (2026-11-20): when a backlog item may be
taken into a sprint, beside the Definition of Done.
label {{_ 'scrum-definition-of-ready'}}
textarea(name="definitionOfReady") {{settings.definitionOfReady}}
label {{_ 'scrum-definition-of-done'}}
textarea(name="definitionOfDone") {{settings.definitionOfDone}}
//- The meeting helpers of the board menu (scrumMeetings.js).
label
input(type="checkbox" name="standupTimer" checked=settings.standupTimer)
| {{_ 'daily-standup'}}
label {{_ 'standup-minutes'}}
input(type="number" name="standupMinutes" min="1" max="15" value=settings.standupMinutes)
label
input(type="checkbox" name="retrospectiveBoard" checked=settings.retrospectiveBoard)
| {{_ 'retrospective-board'}}
each accountabilityFields
label {{label}}
select(name=field multiple=multiple)
+4 -1
View File
@@ -306,7 +306,10 @@ Template.scrumView.events({
event.preventDefault(); const values = fields(event.currentTarget);
const formData = new FormData(event.currentTarget);
await mutate(tpl, 'scrum.configure', { enabled: values.enabled === 'on', productGoal: values.productGoal,
definitionOfDone: values.definitionOfDone, estimateSource: values.estimateSource,
definitionOfDone: values.definitionOfDone, definitionOfReady: values.definitionOfReady,
standupTimer: values.standupTimer === 'on', retrospectiveBoard: values.retrospectiveBoard === 'on',
standupMinutes: require('/models/lib/scrumMeetings').standupMinutes(values.standupMinutes),
estimateSource: values.estimateSource,
estimateCustomFieldId: nullable(values.estimateCustomFieldId), estimateUnit: values.estimateUnit,
completionPolicy: values.completionPolicy, productOwnerId: nullable(values.productOwnerId),
scrumMasterId: nullable(values.scrumMasterId), developerIds: formData.getAll('developerIds'),
+31 -6
View File
@@ -398,6 +398,8 @@ template(name="cardFieldSectionDate")
template(name="cardFieldSectionMembers")
+cardSectionHeader(section="members" icon="fa-users" label="members")
if isSectionOpen "members"
//- The board's WIP limit per person (listFlowPolicies.jade).
+cardPersonWipWarnings(card=this)
.card-details-group-body
each field in orderedMembersFields
if $eq field "members"
@@ -548,6 +550,19 @@ template(name="cardFieldSectionCard")
a.js-add-dependency(title="{{_ 'add-dependency'}}")
i.fa.fa-plus
| {{_ 'add-dependency'}}
//- The Kanban and Scrum flow fields (docs/Features/Cards/Flow-Fields.md).
if $eq field "blocked"
if currentBoard.allowsBlockedOnCard
+cardFlowBlocked(card=this canModifyCard=canModifyCard)
if $eq field "classOfService"
if currentBoard.allowsClassOfServiceOnCard
+cardFlowClassOfService(card=this canModifyCard=canModifyCard)
if $eq field "moscow"
if currentBoard.allowsMoscowOnCard
+cardFlowMoscow(card=this canModifyCard=canModifyCard)
if $eq field "wsjf"
if currentBoard.allowsWsjfOnCard
+cardFlowWsjf(card=this canModifyCard=canModifyCard)
if $eq field "cardSortingByNumber"
if currentBoard.allowsCardSortingByNumber
.card-details-item.card-details-sort-order
@@ -1141,9 +1156,13 @@ template(name="cardDetailsActionsPopup")
Planning Poker, Change spent time and Card kind are in the hamburger of
their own section of the opened card, and in Card Settings' pane of that
section (docs/Features/Cards/Card-Fields.md).
//- Grouped under headings (2026-11-20): Move and copy, Watch, Appearance,
Share and history, Archive. Every entry keeps its own condition; a heading
sits inside its group's.
if currentUser
ul.pop-over-list
if cardMenuWrites
li.menu-group-heading {{_ 'menu-group-move-copy'}}
if currentUser.isBoardAdmin
li
a.js-move-card
@@ -1175,6 +1194,7 @@ template(name="cardDetailsActionsPopup")
a.js-move-card-to-bottom
i.fa.fa-arrow-down
| {{_ 'moveCardToBottom-title'}}
li.menu-group-heading {{_ 'watch'}}
li
a.js-toggle-watch-card
if isWatching
@@ -1196,6 +1216,7 @@ template(name="cardDetailsActionsPopup")
unless currentUser.isWorker
hr
ul.pop-over-list
li.menu-group-heading {{_ 'appearance'}}
li
a.js-set-card-color
i.fa.fa-paint-brush
@@ -1214,6 +1235,7 @@ template(name="cardDetailsActionsPopup")
| {{_ 'action-items-create'}}
hr
ul.pop-over-list
li.menu-group-heading {{_ 'menu-group-share'}}
if currentUser
//- Copy link, named - the card's header carried this as an icon with only
a tooltip. docs/Features/General/Board-Item-Links.md
@@ -1254,6 +1276,7 @@ template(name="cardDetailsActionsPopup")
if currentUser
if cardMenuWrites
unless currentUser.isWorker
li.menu-group-heading {{_ 'archives'}}
if archived
li
a.js-restore-archived-card
@@ -1269,12 +1292,14 @@ template(name="cardDetailsActionsPopup")
span.emoji-icon
i.fa.fa-link
| {{_ 'cardMorePopup-title'}}
unless canModifyCard
if boardCreationAllowed
li
a.js-create-board-from-card
i.fa.fa-external-link
| {{_ 'linkCardToNewBoard'}}
//- For every member who may write the card (cardMenuWrites, not a
Worker), as when it was added; createBoardFromCard checks the same
write access and the assigned-only scope on the server.
if boardCreationAllowed
li
a.js-create-board-from-card
i.fa.fa-external-link
| {{_ 'linkCardToNewBoard'}}
span.copied-tooltip {{_ 'copied'}}
//- #1173: the card export popup IS the shared export body - the same checkbox
+3
View File
@@ -933,6 +933,9 @@ function cardSectionHasContent(card, board, id) {
case 'card': {
const swimlane = typeof card?.swimlane === 'function' ? card.swimlane() : null;
return Boolean(board.allowsDependencies || board.allowsCardSortingByNumber || board.allowsShowLists
// The flow fields (models/lib/cardFlow.js).
|| board.allowsBlockedOnCard || board.allowsClassOfServiceOnCard || board.allowsMoscowOnCard
|| board.allowsWsjfOnCard
|| (board.allowsSwimlaneNameOnCard && swimlane && swimlane.title)
|| (board.allowsCardButtonsOnCard !== false && cardHasButtons(card)));
}
+69
View File
@@ -0,0 +1,69 @@
/* The Kanban and Scrum flow fields (docs/Features/Cards/Flow-Fields.md). */
/* Blocked is a labelled native checkbox; the app-wide material form rule hides
native checkboxes three ways (display, visibility, an offset), so all three
are undone, as in scrumView.css. */
.card-flow-blocked-toggle input[type="checkbox"] {
display: inline-block;
visibility: visible;
position: static;
inset-inline-start: auto;
width: 16px;
height: 16px;
min-height: 0;
margin: 0;
margin-inline-end: 4px;
padding: 0;
vertical-align: middle;
}
.card-details-item-flow-blocked.is-blocked .card-details-item-title,
.card-flow-blocked-text {
color: #c0392b;
}
.card-details-item-flow-blocked .js-card-flow-blocked-reason {
display: block;
width: 100%;
margin-top: 4px;
}
.card-flow-blocked-since {
font-size: 0.85em;
}
.card-flow-wsjf-score {
margin-inline-start: 6px;
font-weight: bold;
}
.card-flow-wsjf-parts {
display: flex;
flex-wrap: wrap;
gap: 4px 12px;
}
.card-flow-wsjf-part {
display: inline-flex;
align-items: center;
gap: 4px;
}
.minicard .badges .minicard-flow-blocked {
color: #fff;
background: #c0392b;
border-radius: 3px;
padding: 0 4px;
}
.minicard .badges .minicard-flow-class.flow-class-expedite {
color: #fff;
background: #d35400;
border-radius: 3px;
padding: 0 4px;
}
.minicard .badges .minicard-flow-class.flow-class-fixed-date {
color: #8e44ad;
}
.minicard .badges .minicard-flow-moscow {
border: 1px solid currentColor;
border-radius: 3px;
padding: 0 4px;
}
.minicard .badges .minicard-flow-moscow.flow-moscow-must {
color: #c0392b;
}
.minicard .badges .minicard-flow-moscow.flow-moscow-wont {
color: #7f8c8d;
}
+66
View File
@@ -0,0 +1,66 @@
//- The Kanban and Scrum flow fields of the opened card (models/lib/cardFlow.js,
docs/Features/Cards/Flow-Fields.md): each a row of Board Settings / Card,
drawn in the Card section. Saved through the setCardFlow method.
template(name="cardFlowBlocked")
with flowOf card
.card-details-item.card-details-item-flow-blocked(class="{{#if blocked}}is-blocked{{/if}}")
h3.card-details-item-title
i.fa.fa-ban
| {{_ 'card-blocked'}}
if ../canModifyCard
label.card-flow-blocked-toggle
input.js-card-flow-blocked(type="checkbox" checked=blocked)
| {{_ 'card-blocked'}}
if blocked
input.js-card-flow-blocked-reason(type="text" maxlength="1000" value=blockedReason placeholder="{{_ 'card-blocked-reason'}}")
else
if blocked
span.card-flow-blocked-text {{_ 'card-blocked'}}{{#if blockedReason}}: {{blockedReason}}{{/if}}
if blocked
if blockedAt
.card-flow-blocked-since.quiet {{_ 'card-blocked-since' date=(flowDate blockedAt) user=(flowUser blockedBy)}}
template(name="cardFlowClassOfService")
with flowOf card
.card-details-item.card-details-item-flow-class
h3.card-details-item-title
i.fa.fa-road
| {{_ 'class-of-service'}}
if ../canModifyCard
select.js-card-flow-class
each option in classOptions
option(value=option.value selected=option.selected) {{#if option.labelKey}}{{_ option.labelKey}}{{else}}-{{/if}}
else
span.card-flow-value {{#if classLabelKey}}{{_ classLabelKey}}{{else}}-{{/if}}
template(name="cardFlowMoscow")
with flowOf card
.card-details-item.card-details-item-flow-moscow
h3.card-details-item-title
i.fa.fa-sort-amount-desc
| {{_ 'moscow-priority'}}
if ../canModifyCard
select.js-card-flow-moscow
each option in moscowOptions
option(value=option.value selected=option.selected) {{#if option.labelKey}}{{_ option.labelKey}}{{else}}-{{/if}}
else
span.card-flow-value {{#if moscowLabelKey}}{{_ moscowLabelKey}}{{else}}-{{/if}}
template(name="cardFlowWsjf")
with flowOf card
.card-details-item.card-details-item-flow-wsjf
h3.card-details-item-title
i.fa.fa-balance-scale
| {{_ 'wsjf-score'}}
if wsjfScore
span.card-flow-wsjf-score {{wsjfScore}}
.card-flow-wsjf-parts
each part in wsjfParts
label.card-flow-wsjf-part
span {{_ part.labelKey}}
if ../canModifyCard
select.js-card-flow-wsjf(data-part=part.key)
each option in part.options
option(value=option.value selected=option.selected) {{option.text}}
else
span.card-flow-value {{#if part.value}}{{part.value}}{{else}}-{{/if}}
+87
View File
@@ -0,0 +1,87 @@
// The Kanban and Scrum flow fields of a card (models/lib/cardFlow.js,
// docs/Features/Cards/Flow-Fields.md): the opened card's rows and the
// minicard's `cardFlowOf` helper. Every change goes through setCardFlow, which
// checks the card edit right and the Expedite limit on the server.
import { Meteor } from 'meteor/meteor';
import { Template } from 'meteor/templating';
import { ReactiveCache } from '/imports/reactiveCache';
import { TAPi18n } from '/imports/i18n';
const { flowView, CLASSES_OF_SERVICE, MOSCOW, WSJF_PARTS, WSJF_SCALE, CLASS_LABEL, MOSCOW_LABEL } = require('/models/lib/cardFlow');
const WSJF_LABEL = { businessValue: 'wsjf-business-value', timeCriticality: 'wsjf-time-criticality',
riskReduction: 'wsjf-risk-reduction', jobSize: 'wsjf-job-size' };
// A linked card shows its source's flow, as the server writes it.
function sourceOf(card) {
if (card && typeof card.isLinkedCard === 'function' && card.isLinkedCard()) {
return ReactiveCache.getCard(card.linkedId) || card;
}
return card;
}
Template.registerHelper('cardFlowOf', card => {
const view = flowView(sourceOf(card));
return view.blocked || view.classOfService || view.moscow || view.wsjfScore ? view : null;
});
function choices(values, labels, chosen) {
return [{ value: '', labelKey: null, selected: !chosen },
...values.map(value => ({ value, labelKey: labels[value], selected: value === chosen }))];
}
function save(card, patch) {
Meteor.callAsync('setCardFlow', card._id, patch).catch(error => {
if (error && error.error === 'expedite-limit') window.alert(TAPi18n.__('expedite-limit'));
else window.alert((error && (error.reason || error.error)) || String(error));
});
}
const helpers = {
flowOf(card) { return flowView(sourceOf(card)); },
flowDate(date) { return date ? new Date(date).toLocaleString() : ''; },
flowUser(userId) {
const user = userId && ReactiveCache.getUser(userId);
return (user && (user.profile?.fullname || user.username)) || '-';
},
// Each select's options, the empty one ("-") first, with which is chosen.
classOptions() { return choices(CLASSES_OF_SERVICE, CLASS_LABEL, this.classOfService); },
moscowOptions() { return choices(MOSCOW, MOSCOW_LABEL, this.moscow); },
wsjfParts() {
const wsjf = this.wsjf || {};
return WSJF_PARTS.map(key => {
const value = WSJF_SCALE.includes(wsjf[key]) ? wsjf[key] : null;
return { key, labelKey: WSJF_LABEL[key], value,
options: [{ value: '', text: '-', selected: value === null },
...WSJF_SCALE.map(n => ({ value: String(n), text: String(n), selected: n === value }))] };
});
},
};
['cardFlowBlocked', 'cardFlowClassOfService', 'cardFlowMoscow', 'cardFlowWsjf'].forEach(name => {
Template[name].helpers(helpers);
});
Template.cardFlowBlocked.events({
'change .js-card-flow-blocked'(event, tpl) {
save(tpl.data.card, { blocked: event.currentTarget.checked });
},
'change .js-card-flow-blocked-reason'(event, tpl) {
save(tpl.data.card, { blockedReason: event.currentTarget.value });
},
});
Template.cardFlowClassOfService.events({
'change .js-card-flow-class'(event, tpl) {
save(tpl.data.card, { classOfService: event.currentTarget.value });
},
});
Template.cardFlowMoscow.events({
'change .js-card-flow-moscow'(event, tpl) {
save(tpl.data.card, { moscow: event.currentTarget.value });
},
});
Template.cardFlowWsjf.events({
'change .js-card-flow-wsjf'(event, tpl) {
const value = event.currentTarget.value;
save(tpl.data.card, { wsjf: { [event.currentTarget.dataset.part]: value === '' ? null : Number(value) } });
},
});
+34
View File
@@ -17,6 +17,7 @@ template(name="minicard")
class="{{#if minicardCollapsed}}minicard-collapsed{{/if}}"
class="{{#if hasUnreadComments}}minicard-unread-comments{{/if}}"
class="{{#if hasUnreadChanges}}minicard-unread-changes{{/if}}"
class="{{#if splitDoneHere}}minicard-split-done{{/if}}"
title="{{#if hasUnreadComments}}{{_ 'card-has-unread-comments'}}{{else}}{{#if hasUnreadChanges}}{{_ 'card-has-unread-changes'}}{{/if}}{{/if}}"
style="{{#if showCardColorOnMinicard}}{{colorStyle}}{{/if}}")
if canMoveCard
@@ -30,6 +31,8 @@ template(name="minicard")
if canModifyCard
a.minicard-details-menu-with-handle.js-open-minicard-details-menu(title="{{_ 'cardDetailsActionsPopup-title'}}")
i.fa.fa-bars
//- Done here, in a list split into Doing and Done (listFlowPolicies.jade).
+minicardSplitDone
if showDependencyConnectHandle
a.dependency-connect-handle.js-dependency-connect-handle(title="{{_ 'drag-to-connect'}}")
i.fa.fa-dot-circle-o
@@ -211,6 +214,37 @@ template(name="minicard")
span.badge-icon(style="color:{{dependencyBadge.color}}")
i.fa(class="fa-{{dependencyBadge.icon}}")
span.badge-text {{ dependencyBadge.count }}
//- The flow fields, Show on Minicard (docs/Features/Cards/Flow-Fields.md).
if $eq field "blocked"
if currentBoard.allowsBlockedOnMinicard
with cardFlowOf this
if blocked
.badge.minicard-flow-blocked.js-minicard-flow-blocked(title="{{_ 'card-blocked'}}{{#if blockedReason}}: {{blockedReason}}{{/if}}")
span.badge-icon
i.fa.fa-ban
span.badge-text {{_ 'card-blocked'}}
if $eq field "classOfService"
if currentBoard.allowsClassOfServiceOnMinicard
with cardFlowOf this
if classOfService
.badge.minicard-flow-class(class="flow-class-{{classOfService}}" title="{{_ 'class-of-service'}}: {{_ classLabelKey}}")
span.badge-icon
i.fa.fa-road
span.badge-text {{_ classLabelKey}}
if $eq field "moscow"
if currentBoard.allowsMoscowOnMinicard
with cardFlowOf this
if moscow
.badge.minicard-flow-moscow(class="flow-moscow-{{moscow}}" title="{{_ 'moscow-priority'}}: {{_ moscowLabelKey}}")
span.badge-text {{_ moscowLabelKey}}
if $eq field "wsjf"
if currentBoard.allowsWsjfOnMinicard
with cardFlowOf this
if wsjfScore
.badge.minicard-flow-wsjf(title="{{_ 'wsjf-score'}}")
span.badge-icon
i.fa.fa-balance-scale
span.badge-text {{wsjfScore}}
if $eq field "stickers"
if showStickersOnMinicard
if stickers.length
+6
View File
@@ -180,6 +180,12 @@ Template.minicard.helpers({
// #3984: visual card aging — fade cards that have not been touched recently,
// based on dateLastActivity, when the board has card aging enabled.
// docs/Features/Cards/At-Risk.md
// Done here in a list split into Doing and Done (models/lib/boardFlowPolicies.js).
splitDoneHere() {
const { splitShown } = require('/client/components/lists/listFlowPolicies');
return splitShown(ReactiveCache.getBoard(this.boardId), ReactiveCache.getList(this.listId))
&& require('/models/lib/boardFlowPolicies').isSplitDone(this);
},
atRisk() {
return riskOf(this);
},
+18 -4
View File
@@ -9,7 +9,7 @@
import { ReactiveVar } from 'meteor/reactive-var';
import { TAPi18n } from '/imports/i18n';
import { CSV_IMPORT_FIELDS, csvSeparatorOf, normalizeHeader } from '/models/lib/csvImportMapping';
import { csvGetMembersToMap } from './csvMembersMapper';
import { csvGetMembersToMap, csvMembersFromNames } from './csvMembersMapper';
const Papa = require('papaparse');
@@ -28,7 +28,7 @@ export function parseCsvImportText(text) {
// `excelBase64` for a workbook (read on the server, which answers with the
// first board sheet's header and the sheets it found). `membersStep`: the
// "map members" step follows this one.
export async function startCsvMapping(importTpl, { rows, excelBase64, membersStep = false }) {
export async function startCsvMapping(importTpl, { rows, excelBase64, uploadId, membersStep = false }) {
activeImportTpl = importTpl;
if (!importTpl.csvMappingState) importTpl.csvMappingState = new ReactiveVar(null);
importTpl.csvMapping = null;
@@ -40,6 +40,9 @@ export async function startCsvMapping(importTpl, { rows, excelBase64, membersSte
let preview;
if (excelBase64) {
preview = await Meteor.callAsync('excelImportPreview', excelBase64);
} else if (uploadId) {
// A file streamed to the server's disk (server/lib/importUpload.js).
preview = await Meteor.callAsync('csvUploadPreview', uploadId);
} else {
const header = (rows && rows[0]) || [];
preview = {
@@ -52,7 +55,9 @@ export async function startCsvMapping(importTpl, { rows, excelBase64, membersSte
}
const mapping = {
columns: { ...((preview.mapping && preview.mapping.columns) || {}) },
customFieldColumns: [],
// The guess ticks every column it has no field for, so nothing is left
// behind unless the user unticks it.
customFieldColumns: [...((preview.mapping && preview.mapping.customFieldColumns) || [])],
listName: TAPi18n.__('scrum-category-todo'),
};
importTpl.csvMappingState.set({
@@ -62,6 +67,7 @@ export async function startCsvMapping(importTpl, { rows, excelBase64, membersSte
boards: preview.boards || [],
skipped: preview.skipped || [],
rows: rows || null,
uploadId: uploadId || null,
membersStep,
mapping,
});
@@ -201,7 +207,15 @@ Template.importCsvMapping.events({
...(chosen.columns.list === undefined ? { listName } : {}),
};
const state = tpl.state();
// The people to map are the ones in the columns chosen for people.
// The people to map are the ones in the columns chosen for people - read
// by the server from an uploaded file.
if (state.uploadId && state.membersStep) {
Meteor.callAsync('csvUploadPeople', state.uploadId, chosen.columns).then(names => {
importTpl.membersToMap.set(csvMembersFromNames(names || []));
importTpl.nextStep();
}, error => tpl.mappingError.set((error && error.error) || 'error-csv-schema'));
return;
}
if (state.rows && state.membersStep) {
importTpl.membersToMap.set(csvGetMembersToMap(state.rows, chosen.columns));
}
+15 -51
View File
@@ -1,54 +1,18 @@
import { ReactiveCache } from '/imports/reactiveCache';
import { splitByField, splitPeople } from '/models/lib/csvImportMapping';
import { csvPeopleNames } from '/models/lib/csvPeople';
// The usernames to map. Without `columns`, the ones in a column named
// "Members"; with the columns the mapping step chose, the ones in every
// people column: owner, members, assignees, requested by and assigned by.
export function csvGetMembersToMap(data, columns) {
// we will work on the list itself (an ordered array of objects) when a
// mapping is done, we add a 'wekan' field to the object representing the
// imported member
const membersToMap = [];
const importedMembers = [];
const peopleColumns = [];
if (columns) {
['owner', 'members', 'assignees'].forEach(field => {
if (columns[field] !== undefined) peopleColumns.push({ index: columns[field], split: splitPeople });
});
['requestedBy', 'assignedBy'].forEach(field => {
if (columns[field] !== undefined) peopleColumns.push({ index: columns[field], split: splitByField });
});
} else {
for (let i = 0; i < data[0].length; i++) {
if (String(data[0][i] || '').toLowerCase() === 'members') {
peopleColumns.push({ index: i, split: cell => String(cell).split(' ') });
}
}
}
for (let i = 1; i < data.length; i++) {
for (const { index, split } of peopleColumns) {
if (data[i][index]) {
for (const importedMember of split(data[i][index])) {
if (importedMember && importedMembers.indexOf(importedMember) === -1) {
importedMembers.push(importedMember);
}
}
}
}
}
for (let importedMember of importedMembers) {
importedMember = {
username: importedMember,
id: importedMember,
};
const wekanUser = ReactiveCache.getUser({ username: importedMember.username });
if (wekanUser) importedMember.wekanId = wekanUser._id;
membersToMap.push(importedMember);
}
return membersToMap;
// The people to map, each matched to a WeKan user of the same username when
// there is one. `rows` are the file's rows, or `names` the usernames the
// server read from an uploaded file (csvUploadPeople).
export function csvMembersFromNames(names) {
return names.map(username => {
const member = { username, id: username };
const wekanUser = ReactiveCache.getUser({ username });
if (wekanUser) member.wekanId = wekanUser._id;
return member;
});
}
export function csvGetMembersToMap(data, columns) {
return csvMembersFromNames(csvPeopleNames(data, columns));
}
+13
View File
@@ -280,3 +280,16 @@ a.show-mapping {
.import-report-row {
overflow-wrap: anywhere;
}
/* The Import page's sources by kind (models/lib/toolGroups.js). */
.import-source-list .import-source-group {
margin-top: 0.8em;
font-weight: bold;
font-size: 0.85em;
text-transform: uppercase;
letter-spacing: 0.04em;
color: #6b778c;
}
.import-source-list .import-source-group:first-child {
margin-top: 0;
}
+2
View File
@@ -39,6 +39,8 @@ template(name="import")
h2 {{_ 'import-source-heading'}}
ul.import-source-list
each importSources
if groupHeading
li.import-source-group {{groupHeading}}
li
//- The same green tick every checkbox in the app uses
(`.materialCheckBox`, forms.css) - the one Admin Panel /
+84 -6
View File
@@ -3,7 +3,7 @@ import { trelloGetMembersToMap } from './trelloMembersMapper';
import { FlowRouter } from 'meteor/ostrio:flow-router-extra';
import { wekanGetMembersToMap } from './wekanMembersMapper';
import { csvGetMembersToMap } from './csvMembersMapper';
import { jiraGetMembersToMap } from './jiraMembersMapper';
import { jiraGetMembersToMap } from '/models/lib/jiraMembersMapper';
import getSlug from 'limax';
import { UserSearchIndex } from '/models/users';
import { Utils } from '/client/lib/utils';
@@ -49,6 +49,13 @@ function attachmentAuthData(importTpl) {
return auth ? { attachmentAuth: auth } : {};
}
// The file streamed to the server for this import (postImportUpload), by its
// id; the preview of its people and the import itself both read it.
function uploadData(importTpl) {
return importTpl.upload && importTpl.upload.uploadId
? { uploadId: importTpl.upload.uploadId, ...(importTpl.uploadExtras || {}) } : {};
}
// Helper to find the closest ancestor template instance by name
function findParentTemplateInstance(childTemplateInstance, parentTemplateName) {
let view = childTemplateInstance.view;
@@ -118,6 +125,33 @@ async function postTrelloImport(body, contentType) {
return result;
}
// A chosen file of the generalized importer's sources, streamed to the server
// a part at a time (server/routes/importUpload.js) rather than read here and
// sent whole through the importBoard method: the server writes it to its disk,
// checking the free space and the administrator's import limit, and importBoard
// reads it by the id answered here. Returns { uploadId, size }.
async function postImportUpload(source, file) {
const token =
(window.localStorage && window.localStorage.getItem('Meteor.loginToken')) || '';
const resp = await fetch(`/api/import/upload/${encodeURIComponent(source)}`, {
method: 'POST',
credentials: 'same-origin',
headers: {
'Content-Type': 'application/octet-stream',
...(token ? { Authorization: `Bearer ${token}` } : {}),
},
body: file,
});
let result = {};
try {
result = await resp.json();
} catch (e) {
result = {};
}
if (!resp.ok || result.error || !result.uploadId) throw new Error(result.error || 'import-upload-failed');
return result;
}
// A WeKan .zip export (the document and its attachment files) imported as a
// NEW board: posted as it is to /api/import/zip?newBoard=1 (models/importZip.js),
// which opens it on the server under its limits. Returns the new board's id.
@@ -313,7 +347,19 @@ Template.import.onCreated(function () {
openOrReportImportedBoard(boardId, '');
return;
}
if (file) {
this.upload = null;
this.uploadExtras = null;
// Jira too: its people are read from the uploaded file by the server.
if (file && (spec.creator === 'generalized' || dataSource === 'jira' || dataSource === 'csv')) {
// Streamed to the server's disk, never read into this page whole.
try {
this.upload = await postImportUpload(dataSource, file);
} catch (e) {
this.setError((e && e.message) || 'import-upload-failed');
return;
}
doc = {};
} else if (file) {
doc = documentForFile(dataSource, file.name || '', new Uint8Array(await file.arrayBuffer()));
} else {
const text = (this.find('.js-import-json') || {}).value || '';
@@ -331,6 +377,13 @@ Template.import.onCreated(function () {
// CSV/TSV and Excel: which column is which field comes first
// (csvMapping.js), the people after it for CSV.
if (dataSource === 'csv') {
// An uploaded file: its header, rows and people are read on the server.
if (this.upload) {
this.importedData.set([]);
this.membersToMap.set([]);
await startCsvMapping(this, { uploadId: this.upload.uploadId, membersStep: !skipMapping });
return;
}
if (!Array.isArray(doc) || !doc.length) {
this.setError('error-csv-schema');
return;
@@ -356,6 +409,8 @@ Template.import.onCreated(function () {
const estimateFieldId = this.find('.js-jira-estimate-field')?.value.trim();
if (estimateFieldId) doc.wekanScrumMapping = { estimateFieldId,
estimateUnit: this.find('.js-jira-estimate-unit')?.value.trim() };
// An uploaded file is read on the server: the mapping goes with the call.
if (this.upload && doc.wekanScrumMapping) this.uploadExtras = { wekanScrumMapping: doc.wekanScrumMapping };
}
// Trello: remember the target personal-workspace name for finishImport.
this.workspaceName = '';
@@ -373,6 +428,17 @@ Template.import.onCreated(function () {
await this.mapPeopleOrImport(dataSource, skipMapping);
return;
}
// An uploaded Jira file: its people from the server, read from the file.
if (this.upload && dataSource === 'jira') {
try {
this.membersToMap.set(await Meteor.callAsync('importBoard', {}, { previewPeople: true, ...uploadData(this) }, 'jira', null));
} catch (e) {
this.setError((e && (e.reason || e.error)) || 'error-json-malformed');
return;
}
await advance();
return;
}
this.membersToMap.set(_prepareAdditionalData(doc));
await advance();
};
@@ -393,7 +459,7 @@ Template.import.onCreated(function () {
let people = [];
try {
people = await Meteor.callAsync('importBoard', pruneImportDocument(this.importedData.get(), selectedFields()),
{ previewPeople: true, importFields: selectedFields() }, source, null);
{ previewPeople: true, importFields: selectedFields(), ...uploadData(this) }, source, null);
} catch (e) {
this.setError((e && (e.reason || e.error)) || 'error-json-malformed');
return;
@@ -544,7 +610,10 @@ Template.import.onCreated(function () {
this.membersToMap.set([]);
let settled = false;
const importDocument = pruneImportDocument(importedData, selectedFields());
const timeoutMs = importDeadlineFor(parseInt(window.WEKAN_IMPORT_TIMEOUT_MS, 10) || 120000, importDocument);
// An uploaded file is not in the document: its size gives it time, two
// seconds a megabyte on top of the usual deadline.
const uploadMs = this.upload ? Math.ceil((this.upload.size || 0) / (1024 * 1024)) * 2000 : 0;
const timeoutMs = importDeadlineFor(parseInt(window.WEKAN_IMPORT_TIMEOUT_MS, 10) || 120000, importDocument) + uploadMs;
const watchdog = Meteor.setTimeout(() => {
if (settled) return;
settled = true;
@@ -560,7 +629,7 @@ Template.import.onCreated(function () {
// The selection again, for the parts only a creator can leave out:
// the Scrum planning external parsers find (models/kanboardCreator.js).
{ membersMapping: mappingById, importFields: selectedFields(), membersMode: this.membersMode || 'map', ...csvMappingData(this),
...attachmentAuthData(this),
...attachmentAuthData(this), ...uploadData(this),
...(splitByProject(this.importSource) ? { splitBy: 'swimlane' } : {}) },
this.importSource,
Session.get('fromBoard'),
@@ -614,12 +683,21 @@ Template.import.helpers({
const setting = ReactiveCache.getCurrentSetting();
const product = productNameOrDefault(setting && setting.productName);
const current = Session.get('importSource');
return IMPORT_SOURCES.map(source => ({
// Grouped by kind under headings (models/lib/toolGroups.js), the same
// groups the Export menu uses; WeKan's own is headed by the product name,
// and a company with several products by the company's name.
const { groupTools } = require('/models/lib/toolGroups');
return groupTools(IMPORT_SOURCES.map(source => ({
key: source.key,
// "a previous export of <Product name>", which for an unbranded WeKan is
// "WeKan" and for a rebranded one is whatever it was rebranded to.
name: source.product ? `${product} (JSON, .zip)` : source.name,
selected: source.key === current,
}))).map(source => ({
...source,
groupHeading: source.groupStart
? (source.groupLabelKey ? TAPi18n.__(source.groupLabelKey) : source.groupLabel || product)
: '',
}));
},
hasImportSource() {
@@ -4,7 +4,10 @@ export function trelloGetMembersToMap(data) {
// we will work on the list itself (an ordered array of objects) when a
// mapping is done, we add a 'wekan' field to the object representing the
// imported member
const membersToMap = data.members;
// A Trello file may have no members (an export of a board nobody else is
// on): there is then nobody to map, not an error. Without the fallback the
// forEach below threw and the Import button silently did nothing.
const membersToMap = Array.isArray(data.members) ? data.members : [];
// auto-map based on username
membersToMap.forEach(importedMember => {
const wekanUser = ReactiveCache.getUser({ username: importedMember.username });
@@ -0,0 +1,57 @@
/* The Kanban flow policies of the lists (docs/Features/Lists/Flow-Policies.md). */
.list-policy-mark,
.list-commitment-mark {
display: inline-block;
margin-inline-start: 4px;
opacity: 0.75;
}
.list-policy-mark {
cursor: pointer;
}
.list-commitment-mark {
color: #27ae60;
}
.list-policy-popup textarea {
width: 100%;
box-sizing: border-box;
}
.list-policy-popup .list-policy-text {
white-space: pre-wrap;
}
.board-flow-list-settings .board-flow-setting {
display: flex;
align-items: center;
justify-content: space-between;
gap: 8px;
margin-top: 8px;
}
.board-flow-list-settings .board-flow-setting input,
.board-flow-list-settings .board-flow-setting select {
max-width: 50%;
}
.card-person-wip-over {
color: #c0392b;
margin-bottom: 4px;
}
/* Split Doing / Done lists. */
.list-split-counts {
display: inline-block;
margin-inline-start: 4px;
font-size: 0.85em;
opacity: 0.8;
}
.minicard-split-toggle {
float: inline-end;
margin-inline-start: 4px;
cursor: pointer;
opacity: 0.6;
}
.minicard-split-toggle.is-done {
color: #27ae60;
opacity: 1;
}
.minicard.minicard-split-done {
opacity: 0.6;
border-inline-start: 3px solid #27ae60;
}
@@ -0,0 +1,78 @@
//- The Kanban flow policies of the lists (models/lib/boardFlowPolicies.js,
docs/Features/Lists/Flow-Policies.md). Each is shown only when Admin Panel /
Features offers it; a board admin changes them, others see them disabled.
template(name="boardFlowListSettings")
form.board-flow-list-settings
if allowFeature 'list-policies'
div.check-div
a.flex.js-toggle-list-policies(class="{{#if allowsListPolicies}}is-checked{{/if}}" title="{{_ 'show-list-policies'}}")
i.fa(class="{{#if allowsListPolicies}}fa-check{{else}}fa-square-o{{/if}}")
span
i.fa.fa-gavel
| {{_ 'show-list-policies'}}
if allowFeature 'split-lists'
div.check-div
a.flex.js-toggle-split-lists(class="{{#if allowsSplitLists}}is-checked{{/if}}" title="{{_ 'show-split-lists'}}")
i.fa(class="{{#if allowsSplitLists}}fa-check{{else}}fa-square-o{{/if}}")
span
i.fa.fa-columns
| {{_ 'show-split-lists'}}
if allowFeature 'commitment-point'
label.board-flow-setting
span
i.fa.fa-flag-checkered
| {{_ 'commitment-point'}}
select.js-commitment-list(disabled=notBoardAdmin)
each option in commitmentOptions
option(value=option.value selected=option.selected) {{option.title}}
p.quiet {{_ 'commitment-point-hint'}}
if allowFeature 'person-wip-limit'
label.board-flow-setting
span
i.fa.fa-user-times
| {{_ 'person-wip-limit'}}
input.js-person-wip-limit(type="number" min="1" max="99" value=personWipLimit disabled=notBoardAdmin)
//- At the list header: the policy as an icon whose tooltip is the text, and the
commitment point's flag.
template(name="listFlowMarks")
if showPolicy
a.list-policy-mark.js-open-list-policy(title=policy aria-label="{{_ 'list-policy'}}")
i.fa.fa-gavel
if splitCounts
span.list-split-counts(title="{{_ 'list-split'}}") {{_ 'split-counts' doing=splitCounts.doing done=splitCounts.done}}
if isCommitmentPoint
span.list-commitment-mark(title="{{_ 'commitment-point'}}: {{_ 'commitment-point-hint'}}" aria-label="{{_ 'commitment-point'}}")
i.fa.fa-flag-checkered
template(name="listPolicyPopup")
.list-policy-popup
if canEdit
form.js-list-policy-form
textarea.js-list-policy-text(rows="6" maxlength="2000" placeholder="{{_ 'list-policy-placeholder'}}")= policy
input.primary(type="submit" value="{{_ 'save'}}")
else
if policy
p.list-policy-text= policy
else
p.quiet {{_ 'list-policy-placeholder'}}
//- In the opened card's Members section: each of its people over the board's
WIP limit per person.
template(name="cardPersonWipWarnings")
each warning in warnings
.card-person-wip-over.js-card-person-wip-over
i.fa.fa-user-times
| {{_ 'person-wip-over' user=warning.name count=warning.count limit=warning.limit}}
//- On a minicard of a split list: whether it is Done here, and the toggle for
whoever may change the card.
template(name="minicardSplitDone")
if inSplitList
if canModifyCard
a.minicard-split-toggle.js-minicard-split-done(class="{{#if splitDone}}is-done{{/if}}" title="{{#if splitDone}}{{_ 'split-done'}}{{else}}{{_ 'mark-split-done'}}{{/if}}" aria-pressed="{{#if splitDone}}true{{else}}false{{/if}}")
i.fa(class="{{#if splitDone}}fa-check-circle{{else}}fa-circle-o{{/if}}")
else
if splitDone
span.minicard-split-toggle.is-done(title="{{_ 'split-done'}}")
i.fa.fa-check-circle
+134
View File
@@ -0,0 +1,134 @@
// The Kanban flow policies of the lists (models/lib/boardFlowPolicies.js,
// docs/Features/Lists/Flow-Policies.md): Board Settings / List, the marks at
// a list's header, the list's policy popup and the opened card's warning.
import { Meteor } from 'meteor/meteor';
import { Template } from 'meteor/templating';
import { ReactiveCache } from '/imports/reactiveCache';
import { allowFeature } from '/client/lib/instanceFeatures';
import { TAPi18n } from '/imports/i18n';
import { Utils } from '/client/lib/utils';
import Lists from '/models/lists';
const { normalizePolicy, overPersonWip, isSplitDone, splitCounts } = require('/models/lib/boardFlowPolicies');
// Whether a list of `board` is drawn split into Doing and Done.
const splitShown = (board, list) => Boolean(board?.allowsSplitLists === true && list?.split === true && allowFeature('split-lists'));
export { splitShown };
const board = () => Utils.getCurrentBoard();
const isBoardAdmin = () => Boolean(ReactiveCache.getCurrentUser()?.isBoardAdmin?.());
Template.boardFlowListSettings.helpers({
allowsListPolicies() { return board()?.allowsListPolicies === true; },
allowsSplitLists() { return board()?.allowsSplitLists === true; },
notBoardAdmin() { return !isBoardAdmin(); },
personWipLimit() { return board()?.personWipLimit || ''; },
commitmentOptions() {
const current = board();
if (!current) return [];
const lists = ReactiveCache.getLists({ boardId: current._id, archived: false }, { sort: { sort: 1 } }) || [];
const chosen = current.commitmentListId || '';
return [{ value: '', title: '-', selected: !chosen },
...lists.map(list => ({ value: list._id, title: list.title, selected: list._id === chosen }))];
},
});
Template.boardFlowListSettings.events({
'click .js-toggle-list-policies'(event) {
event.preventDefault();
const current = board();
if (current && isBoardAdmin()) current.setAllowsListPolicies(current.allowsListPolicies !== true);
},
'click .js-toggle-split-lists'(event) {
event.preventDefault();
const current = board();
if (current && isBoardAdmin()) current.setAllowsSplitLists(current.allowsSplitLists !== true);
},
'change .js-commitment-list'(event) {
const current = board();
if (current && isBoardAdmin()) current.setCommitmentListId(event.currentTarget.value);
},
'change .js-person-wip-limit'(event) {
const current = board();
if (!current || !isBoardAdmin()) return;
current.setPersonWipLimit(event.currentTarget.value.trim()).catch(() => {
window.alert(TAPi18n.__('person-wip-limit'));
});
},
'submit .board-flow-list-settings'(event) { event.preventDefault(); },
});
// The list header's marks; the data context is the list.
Template.listFlowMarks.helpers({
showPolicy() {
const current = ReactiveCache.getBoard(this.boardId);
return Boolean(current?.allowsListPolicies === true && this.policy && allowFeature('list-policies'));
},
splitCounts() {
const current = ReactiveCache.getBoard(this.boardId);
if (!splitShown(current, this)) return null;
return splitCounts(ReactiveCache.getCards({ listId: this._id, archived: false }, { fields: { listId: 1, flow: 1, archived: 1 } }) || []);
},
isCommitmentPoint() {
const current = ReactiveCache.getBoard(this.boardId);
return Boolean(current?.commitmentListId && current.commitmentListId === this._id && allowFeature('commitment-point'));
},
});
Template.listFlowMarks.events({
'click .js-open-list-policy': Popup.open('listPolicy'),
});
Template.listPolicyPopup.helpers({
// Whoever may write to the list's board (models/lib/boardRoleCapabilities.js),
// the same as the server's Lists allow rule.
canEdit() {
return Utils.currentUserCan('write', ReactiveCache.getBoard(this.boardId));
},
});
Template.listPolicyPopup.events({
async 'submit .js-list-policy-form'(event, tpl) {
event.preventDefault();
let policy;
try {
policy = normalizePolicy(tpl.find('.js-list-policy-text').value);
} catch (e) {
return;
}
const modifier = policy ? { $set: { policy } } : { $unset: { policy: '' } };
await Lists.updateAsync(this._id, modifier);
Popup.back();
},
});
// The opened card's people over the WIP limit per person; the data is the card.
Template.cardPersonWipWarnings.helpers({
warnings() {
const card = this.card;
const current = card && ReactiveCache.getBoard(card.boardId);
if (!current || !current.personWipLimit || !allowFeature('person-wip-limit')) return [];
const cards = ReactiveCache.getCards({ boardId: card.boardId, archived: false },
{ fields: { assignees: 1, members: 1, dueComplete: 1, archived: 1, type: 1 } }) || [];
return overPersonWip(card, cards, current.personWipLimit).map(row => {
const user = ReactiveCache.getUser(row.userId);
return { ...row, name: (user && (user.profile?.fullname || user.username)) || row.userId };
});
},
});
// The minicard's Done here toggle; the data is the card.
Template.minicardSplitDone.helpers({
inSplitList() {
const card = this;
return splitShown(ReactiveCache.getBoard(card.boardId), ReactiveCache.getList(card.listId));
},
splitDone() { return isSplitDone(this); },
canModifyCard() { return Utils.canModifyCard(this); },
});
Template.minicardSplitDone.events({
'click .js-minicard-split-done'(event) {
event.preventDefault();
event.stopPropagation();
Meteor.callAsync('setCardFlow', this._id, { splitDone: !isSplitDone(this) })
.catch(error => window.alert((error && (error.reason || error.error)) || String(error)));
},
});
+30
View File
@@ -35,6 +35,7 @@ template(name="listHeader")
|&nbsp;(
span(class="{{#if exceededWipLimit}}highlight{{/if}}") {{cardsCountWhole}}
|/#{wipLimit.value})
+listFlowMarks
if showCardsCountForList cardsCountWhole
span.cardCount {{cardsCount containerSwimlaneId}} {{cardsCountForListIsOne cardsCountWhole}}
if hasNumberFieldsSum
@@ -88,6 +89,8 @@ template(name="listHeader")
span(class="{{#if exceededWipLimit}}highlight{{/if}}") {{cardsCountWhole}}
|/#{wipLimit.value})
unless collapsed
//- List policy and commitment point (listFlowPolicies.jade).
+listFlowMarks
if showCardsCountForList cardsCountWhole
span.cardCount {{cardsCount containerSwimlaneId}} {{cardsCountForListIsOne cardsCountWhole}}
if hasNumberFieldsSum
@@ -165,9 +168,13 @@ template(name="editListTitleForm")
i.fa.fa-times-thin
template(name="listActionPopup")
//- Grouped under headings by what the entries act on (2026-11-20); every
entry keeps its own condition, and a heading sits inside the same condition
as its group.
//- Copy link, FIRST and above every permission check - see the swimlane
popup: copying an address is reading, not editing.
models/lib/boardItemUrl.js, docs/Features/General/Board-Item-Links.md
h4.menu-group-heading {{_ 'menu-group-share'}}
ul.pop-over-list
li: a.js-copy-list-link
i.fa.fa-link
@@ -196,6 +203,7 @@ template(name="listActionPopup")
Import WRITES, so it is offered only to somebody who may change the board;
`canImportIntoBoard` is the same question the popup itself asks
(client/components/boards/exportScope.js).
h4.menu-group-heading {{_ 'menu-group-export'}}
ul.pop-over-list
li: a.js-export-list
i.fa.fa-upload
@@ -207,6 +215,7 @@ template(name="listActionPopup")
hr
unless currentUser.isReadOnly
unless currentUser.isReadAssignedOnly
h4.menu-group-heading {{_ 'add'}}
ul.pop-over-list
li
a.js-add-card.list-header-plus-top
@@ -229,6 +238,7 @@ template(name="listActionPopup")
the fixed-width value it used to set is now a board-wide admin toggle
there too - a menu entry for the same thing was a second place to look
for it. client/components/sidebar/sidebar.jade
h4.menu-group-heading {{_ 'watch'}}
ul.pop-over-list
li
a.js-toggle-watch-list
@@ -241,6 +251,7 @@ template(name="listActionPopup")
unless currentUser.isCommentOnly
unless currentUser.isReadOnly
unless currentUser.isReadAssignedOnly
h4.menu-group-heading {{_ 'edit'}}
unless currentUser.isWorker
ul.pop-over-list
li
@@ -258,6 +269,7 @@ template(name="listActionPopup")
a.js-archive-list-cards
i.fa.fa-archive
| {{_ 'list-archive-cards'}}
h4.menu-group-heading {{_ 'settings'}}
if currentUser.isBoardAdmin
ul.pop-over-list
li
@@ -268,6 +280,22 @@ template(name="listActionPopup")
a.js-list-permissions
i.fa.fa-lock
| {{_ 'listPermissionsPopup-title'}}
//- The list's policy, when the board shows list policies
(listFlowPolicies.jade); every member who may edit the list.
if showsListPolicies
ul.pop-over-list
li
a.js-list-policy
i.fa.fa-gavel
| {{_ 'list-policy'}}
//- Split into Doing and Done (listFlowPolicies.jade), when the board
allows split lists.
if showsSplitLists
ul.pop-over-list
li
a.js-toggle-list-split
i.fa(class="{{#if split}}fa-check-square-o{{else}}fa-square-o{{/if}}")
| {{_ 'list-split'}}
//- #3847: board-wide toggle, exposed here per the maintainer's
instruction to reach it from the List hamburger menu. See
models/boards.js's stickyListHeaders and list.css's use of the
@@ -290,6 +318,7 @@ template(name="listActionPopup")
| &nbsp;
i.fa.fa-check-circle(class="{{#if syncSource.enabled}}list-sync-active{{else}}list-sync-paused{{/if}}")
hr
h4.menu-group-heading {{_ 'menu-group-move-copy'}}
ul.pop-over-list
unless currentUser.isWorker
li
@@ -304,6 +333,7 @@ template(name="listActionPopup")
unless currentUser.isWorker
if mayWriteList
hr
h4.menu-group-heading {{_ 'archives'}}
ul.pop-over-list
li
a.js-close-list
+15
View File
@@ -452,6 +452,16 @@ Template.listHeader.events({
});
Template.listActionPopup.helpers({
showsSplitLists() {
const board = ReactiveCache.getBoard(this.boardId);
return board?.allowsSplitLists === true
&& require('/client/lib/instanceFeatures').allowFeature('split-lists');
},
showsListPolicies() {
const board = ReactiveCache.getBoard(this.boardId);
return board?.allowsListPolicies === true
&& require('/client/lib/instanceFeatures').allowFeature('list-policies');
},
isBoardAdmin() {
return ReactiveCache.getCurrentUser()?.isBoardAdmin();
},
@@ -611,6 +621,11 @@ Template.listActionPopup.events({
Popup.back();
},
'click .js-set-wip-limit': Popup.open('setWipLimit'),
'click .js-list-policy': Popup.open('listPolicy'),
async 'click .js-toggle-list-split'(event) {
event.preventDefault();
await Lists.updateAsync(this._id, this.split === true ? { $unset: { split: '' } } : { $set: { split: true } });
},
'click .js-list-permissions': Popup.open('listPermissions'),
'click .js-copy-list': Popup.open('copyList'),
'click .js-move-list': Popup.open('moveList'),
+14
View File
@@ -1543,3 +1543,17 @@ body.mobile-mode .pop-over .content-wrapper {
.pop-over[data-popup='boardCardSettingsPopup'] .content-container > .clearfix {
display: none;
}
/* A heading over a group of a menu's entries (the list, card and swimlane
menus, 2026-11-20): not an entry - nothing to click. */
.pop-over .menu-group-heading {
margin: 0;
padding: 8px 10px 2px;
font-size: 0.8em;
font-weight: bold;
text-transform: uppercase;
letter-spacing: 0.04em;
color: #6b778c;
cursor: default;
pointer-events: none;
}
@@ -160,6 +160,13 @@ template(name="featuresSecurity")
.materialCheckBox(class="{{#if disableAllImport}}is-checked{{/if}}")
span {{_ 'disable-all-import'}}
p.description {{_ 'disable-all-import-description'}}
//- The largest import upload (server/lib/importDiskSpace.js); empty is no
limit, only the free disk space.
li
label.flex
span {{_ 'import-max-megabytes'}}
input.js-import-max-megabytes(type="number" min="0" step="1" value="{{importMaxMegabytes}}" placeholder="{{_ 'import-max-megabytes-none'}}")
p.description {{_ 'import-max-megabytes-description'}}
li
a.flex.js-toggle-disable-all-export
.materialCheckBox(class="{{#if disableAllExport}}is-checked{{/if}}")
@@ -1261,6 +1261,10 @@ const featurePaneHelpers = {
disableAllExport() {
return (ReactiveCache.getCurrentSetting() || {}).disableAllExport;
},
importMaxMegabytes() {
const mb = (ReactiveCache.getCurrentSetting() || {}).importMaxMegabytes;
return mb > 0 ? mb : '';
},
disableImportAvatars() {
return (ReactiveCache.getCurrentSetting() || {}).disableImportAvatars;
},
@@ -1302,6 +1306,14 @@ const featurePaneEvents = {
'click .js-toggle-disable-all-export'() {
toggleSettingField('disableAllExport');
},
// Empty or 0 is no limit; anything else a whole number of megabytes.
'change .js-import-max-megabytes'(event) {
const setting = ReactiveCache.getCurrentSetting();
if (!setting) return;
const mb = Math.floor(Number(event.currentTarget.value));
Settings.update(setting._id, Number.isFinite(mb) && mb > 0
? { $set: { importMaxMegabytes: mb } } : { $unset: { importMaxMegabytes: '' } });
},
'click .js-toggle-disable-import-avatars'() {
toggleSettingField('disableImportAvatars');
},
+31 -26
View File
@@ -1475,34 +1475,47 @@ Template.rolesGeneral.events({
// Feature #3313 "Shared templates": admin view of users' shareable template
// boards, grouped by Organization / Team / email Domain. The three checkboxes
// are LIVE view filters (no Save button) — each toggles a grouping dimension and
// the selection is remembered (persisted in localStorage) so it survives reload.
const SHARED_TEMPLATES_SCOPE_KEY = 'sharedTemplatesScopes';
const SHARED_TEMPLATES_VALID_SCOPES = ['organizations', 'teams', 'domains'];
// write the instance setting Settings.sharedTemplatesScopes at once (no Save
// button, like every checkbox here): it is both which groupings this view lists
// and which group kinds every user may share a template board with
// (models/lib/sharedTemplatesScopes.js). It used to live in this browser's
// localStorage, so it differed per browser and was empty for everyone else.
const sharedScopes = require('/models/lib/sharedTemplatesScopes');
function loadSharedTemplatesScopes() {
try {
const raw = window.localStorage.getItem(SHARED_TEMPLATES_SCOPE_KEY);
const arr = raw ? JSON.parse(raw) : [];
return Array.isArray(arr)
? arr.filter(s => SHARED_TEMPLATES_VALID_SCOPES.includes(s))
: [];
} catch (e) {
return [];
}
return sharedScopes.sharedTemplatesScopes(ReactiveCache.getCurrentSetting());
}
function saveSharedTemplatesScopes(scopes) {
const setting = ReactiveCache.getCurrentSetting();
if (!setting) return;
Settings.update(setting._id, {
$set: { sharedTemplatesScopes: sharedScopes.normalizeScopes(scopes) },
});
}
// An install that has never stored the setting takes over the ticks an admin
// made in this browser while it was localStorage, once; the old key is then
// dropped so it cannot come back.
function carryOverLegacyScopes() {
let legacy = [];
try {
window.localStorage.setItem(SHARED_TEMPLATES_SCOPE_KEY, JSON.stringify(scopes));
const raw = window.localStorage.getItem(sharedScopes.LEGACY_STORAGE_KEY);
legacy = sharedScopes.normalizeScopes(raw ? JSON.parse(raw) : []);
window.localStorage.removeItem(sharedScopes.LEGACY_STORAGE_KEY);
} catch (e) {
// ignore storage errors (e.g. private mode)
return;
}
const setting = ReactiveCache.getCurrentSetting();
if (legacy.length && setting && setting.sharedTemplatesScopes === undefined) {
saveSharedTemplatesScopes(legacy);
}
}
Template.templatesGeneral.onCreated(function () {
// Restore the previously-checked scopes (empty by default → nothing shown).
this.selectedScopes = new ReactiveVar(loadSharedTemplatesScopes());
carryOverLegacyScopes();
// The instance setting, reactively: another admin's change shows here too.
this.selectedScopes = { get: loadSharedTemplatesScopes };
// Raw rows returned by the admin-only method (one entry per user whose
// Templates board is non-empty).
this.sharedTemplates = new ReactiveVar([]);
@@ -1598,15 +1611,7 @@ Template.templatesGeneral.events({
'click a.js-toggle-template-scope'(event, tpl) {
event.preventDefault();
const scope = $(event.currentTarget).data('scope');
const current = tpl.selectedScopes.get().slice();
const idx = current.indexOf(scope);
if (idx >= 0) {
current.splice(idx, 1);
} else {
current.push(scope);
}
tpl.selectedScopes.set(current);
saveSharedTemplatesScopes(current);
saveSharedTemplatesScopes(sharedScopes.toggleScope(tpl.selectedScopes.get(), scope));
},
});
@@ -0,0 +1,20 @@
/* The Scrum meeting helpers (docs/Features/Scrum/Meetings.md). */
.daily-standup {
min-width: 220px;
}
.daily-standup-speaker {
font-size: 1.4em;
margin: 4px 0;
}
.daily-standup-clock {
font-size: 2em;
font-variant-numeric: tabular-nums;
margin: 4px 0;
}
.daily-standup-clock.is-overtime {
color: #c0392b;
}
.daily-standup-order {
margin-block: 4px;
padding-inline-start: 20px;
}
@@ -0,0 +1,26 @@
//- The Scrum meeting helpers of the board menu (models/lib/scrumMeetings.js,
docs/Features/Scrum/Meetings.md).
template(name="dailyStandupPopup")
.daily-standup.js-daily-standup
if running
with view
if done
p.daily-standup-done {{_ 'standup-done' time=(clockOf elapsedSeconds)}}
button.js-standup-reset(type="button") {{_ 'start'}}
else
p.daily-standup-position {{position}} / {{count}}
h3.daily-standup-speaker= speakerName
p.daily-standup-clock(class="{{#if overtime}}is-overtime{{/if}}") {{clockOf remainingSeconds}}
p.quiet {{_ 'standup-total' time=(clockOf elapsedSeconds)}}
button.primary.js-standup-next(type="button") {{_ 'next'}}
button.js-standup-reset(type="button") {{_ 'stop'}}
else
ol.daily-standup-order
each person in order
li= person.name
p
button.js-standup-shuffle(type="button")
i.fa.fa-random
| {{_ 'standup-shuffle'}}
p.quiet {{_ 'standup-minutes'}}: {{minutes}}
button.primary.js-standup-start(type="button" disabled=noPeople) {{_ 'start'}}
@@ -0,0 +1,92 @@
// The Scrum meeting helpers of the board menu (models/lib/scrumMeetings.js,
// docs/Features/Scrum/Meetings.md): the daily standup timer, kept in this
// browser only, and the button that makes a retrospective board.
import { Meteor } from 'meteor/meteor';
import { Template } from 'meteor/templating';
import { ReactiveVar } from 'meteor/reactive-var';
import { FlowRouter } from 'meteor/ostrio:flow-router-extra';
import getSlug from 'limax';
import { ReactiveCache } from '/imports/reactiveCache';
import { TAPi18n } from '/imports/i18n';
import { Utils } from '/client/lib/utils';
import { allowFeature } from '/client/lib/instanceFeatures';
import Lists from '/models/lists';
const meetings = require('/models/lib/scrumMeetings');
const { DEFAULT_SCRUM_SETTINGS } = require('/models/lib/scrum');
const settingsOf = board => ({ ...DEFAULT_SCRUM_SETTINGS, ...(board && board.scrum) });
// Whether the board menu offers each: the instance's feature AND the board's
// Scrum setting.
export function showsStandupTimer(board) {
return Boolean(board) && allowFeature('standup-timer') && settingsOf(board).standupTimer !== false;
}
export function showsRetrospectiveBoard(board) {
return Boolean(board) && allowFeature('retrospective-board') && settingsOf(board).retrospectiveBoard !== false;
}
const nameOf = userId => {
const user = ReactiveCache.getUser(userId);
return (user && (user.profile?.fullname || user.username)) || userId;
};
Template.dailyStandupPopup.onCreated(function () {
const board = Utils.getCurrentBoard();
const people = (board?.activeMembers?.() || board?.members || []).filter(m => m.isActive !== false).map(m => m.userId);
this.order = new ReactiveVar(meetings.shuffle(people));
this.state = new ReactiveVar(null);
this.now = new ReactiveVar(Date.now());
this.minutes = meetings.standupMinutes(settingsOf(board).standupMinutes);
this.timer = Meteor.setInterval(() => this.now.set(Date.now()), 1000);
});
Template.dailyStandupPopup.onDestroyed(function () {
Meteor.clearInterval(this.timer);
});
Template.dailyStandupPopup.helpers({
order() { return Template.instance().order.get().map(userId => ({ userId, name: nameOf(userId) })); },
noPeople() { return !Template.instance().order.get().length; },
minutes() { return Template.instance().minutes; },
running() { return Boolean(Template.instance().state.get()); },
view() {
const tpl = Template.instance();
const view = meetings.standupView(tpl.state.get(), tpl.now.get());
return view && { ...view, speakerName: view.speaker ? nameOf(view.speaker) : '' };
},
clockOf(seconds) { return meetings.clock(seconds); },
});
Template.dailyStandupPopup.events({
'click .js-standup-shuffle'(event, tpl) { tpl.order.set(meetings.shuffle(tpl.order.get())); },
'click .js-standup-start'(event, tpl) {
tpl.now.set(Date.now());
tpl.state.set(meetings.startStandup(tpl.order.get(), tpl.minutes, Date.now()));
},
'click .js-standup-next'(event, tpl) {
tpl.now.set(Date.now());
tpl.state.set(meetings.nextSpeaker(tpl.state.get(), Date.now()));
},
'click .js-standup-reset'(event, tpl) { tpl.state.set(null); },
});
// A new private board of the reader's for one retrospective: its lists Start
// doing, Stop doing, Keep doing and Action items. Board creation is the
// server's (createBoardWithInitialSwimlanes, with its "who may create
// boards" check); the lists are the new board admin's own inserts.
export async function createRetrospectiveBoard(board) {
const plan = meetings.retrospectivePlan(board.title, new Date(), (key, fallback, options) => {
const text = TAPi18n.__(key, options);
return text && text !== key ? text : fallback;
});
const slug = getSlug(plan.title) || 'board';
const boardId = await Meteor.callAsync('createBoardWithInitialSwimlanes', {
title: plan.title, slug, permission: 'private', type: 'board', migrationVersion: 1,
swimlanes: [{ title: TAPi18n.__('default'), sort: 0 }],
});
for (const [sort, title] of plan.lists.entries()) {
await Lists.insertAsync({ title, boardId, sort, swimlaneId: '' });
}
FlowRouter.go('board', { id: boardId, slug });
return boardId;
}
+15
View File
@@ -785,3 +785,18 @@ body.sidebar-resizing-active {
background: var(--wekan-popup-background, #fff);
box-shadow: 0 2px 6px rgba(0, 0, 0, 0.2);
}
/* Board Settings / Board View: the heading over each group of views, as in
the Board View menu (models/lib/boardViewSettings.js BOARD_VIEW_GROUPS). */
.board-view-settings .board-view-settings-group-heading {
padding: 8px 4px 2px;
font-size: 0.8em;
font-weight: bold;
text-transform: uppercase;
letter-spacing: 0.04em;
color: #6b778c;
border-top: 1px solid #dfe1e6;
}
.board-view-settings .board-view-settings-group-heading:first-child {
border-top: 0;
}
+26 -14
View File
@@ -755,24 +755,20 @@ template(name="boardMenuPopup")
a.js-open-board-date-settings(title="{{_ 'date'}}")
i.fa.fa-calendar
| {{_ 'date'}}
//- All Boards Settings: what the All Boards page shows of this board
(card counters, member avatars), card aging, auto-archive and personal
list widths. It was commented out for the #4214 "icons random dance";
the All Boards tiles now read one fetch of getAllBoardsTileData, not
reactive cursors, so the loop it caused cannot return. The popup hides
its own counter and avatar rows when Admin Panel turns those off.
li
a.js-board-info-on-my-boards(title="{{_ 'board-info-on-my-boards'}}")
i.fa.fa-id-card-o
| {{_ 'board-info-on-my-boards'}}
//- "Board backgrounds" was here. It was the list of pictures uploaded to
this board, and that list is drawn inside Change Background Image now -
under the upload that adds to it - so a second entry to the same list
was a second place to look for one thing.
//Bug Board icons random dance https://github.com/wekan/wekan/issues/4214
//if currentUser.isBoardAdmin
//
unless currentSetting.hideBoardMemberList
//
unless currentSetting.hideCardCounterList
//
li
//
a.js-board-info-on-my-boards(title="{{_ 'board-info-on-my-boards'}}")
//
i.fa.fa-id-card-o
//
| {{_ 'board-info-on-my-boards'}}
hr
else if rulesReadable
//- #2217: a member of a board that shows its Rules reads them here; the
@@ -875,6 +871,18 @@ template(name="boardMenuPopup")
| {{_ 'since-last-visit-count' count=sinceVisitCount}}
else
| {{_ 'since-last-visit'}}
//- The Scrum meeting helpers (client/components/boards/scrum/scrumMeetings.jade),
each hidden by its Admin Panel feature and by the board's Scrum settings.
if showsStandupTimer
li
a.js-open-daily-standup
i.fa.fa-hourglass-half
| {{_ 'daily-standup'}}
if showsRetrospectiveBoard
li
a.js-create-retrospective-board
i.fa.fa-refresh
| {{_ 'retrospective-board'}}
unless currentBoard.isTemplatesBoard
if currentUser.isBoardAdmin
// li
@@ -920,6 +928,9 @@ template(name="boardViewSettingsPopup")
h4 {{_ 'description'}}
.board-view-settings-rows.js-board-view-sortable
each boardViewRows
//- The same groups as the Board View menu; only rows are dragged.
if groupLabelKey
.board-view-settings-group-heading {{_ groupLabelKey}}
.board-view-settings-row.js-board-view-row(data-view="{{view}}")
unless ../publicBoardsHidden
.board-view-settings-column
@@ -1001,6 +1012,7 @@ template(name="boardListSettingsPopup")
span
i.fa.fa-columns
| {{_ 'same-width-for-all-lists'}}
+boardFlowListSettings
//- #2489: Board Settings / WIP Limit Groups - a shared WIP limit across two or
more of this board's lists together, on top of the existing per-list
+23 -2
View File
@@ -547,6 +547,17 @@ function openRulesViewFromBoardMenu(mode) {
}
Template.boardMenuPopup.events({
'click .js-open-daily-standup': Popup.open('dailyStandup'),
async 'click .js-create-retrospective-board'() {
const board = Utils.getCurrentBoard();
if (!board) return;
Popup.close();
try {
await require('/client/components/sidebar/scrumMeetings').createRetrospectiveBoard(board);
} catch (error) {
window.alert((error && (error.reason || error.error)) || String(error));
}
},
'click .js-open-rules-list-view'(event) { event.preventDefault(); openRulesViewFromBoardMenu('list'); },
'click .js-open-rules-workflow-view'(event) { event.preventDefault(); openRulesViewFromBoardMenu('workflow'); },
'click .js-open-rules-bots-view'(event) { event.preventDefault(); openRulesViewFromBoardMenu('bots'); },
@@ -780,8 +791,13 @@ Template.boardViewSettingsPopup.helpers({
boardViewRows() {
const board = Utils.getCurrentBoard();
// #6736: views the instance disabled are not rows; their board settings stay.
const ordered = boardViewSettings.orderedBoardViews(board).filter(v => allowBoardView(v.view));
return ordered.map(v => ({
// Grouped as the Board View menu is (BOARD_VIEW_GROUPS): a heading over
// each group, the board's order inside it.
const ordered = boardViewSettings.groupedBoardViews(
boardViewSettings.orderedBoardViews(board).filter(v => allowBoardView(v.view)));
const headingOf = group => (boardViewSettings.BOARD_VIEW_GROUPS.find(g => g.group === group) || {}).labelKey;
return ordered.map((v, i) => ({
groupLabelKey: i === 0 || ordered[i - 1].group !== v.group ? headingOf(v.group) : null,
view: v.view,
labelKey: v.labelKey,
icon: `fa ${v.icon}`,
@@ -993,6 +1009,11 @@ Template.wipLimitGroupsPopup.events({
});
Template.boardMenuPopup.helpers({
// The Scrum meeting helpers (scrumMeetings.js).
showsStandupTimer() { return require('/client/components/sidebar/scrumMeetings').showsStandupTimer(Utils.getCurrentBoard()); },
showsRetrospectiveBoard() {
return require('/client/components/sidebar/scrumMeetings').showsRetrospectiveBoard(Utils.getCurrentBoard());
},
sinceVisitCount() {
return Template.instance().sinceVisitCount.get();
},
@@ -52,6 +52,8 @@ template(name="editSwimlaneTitleForm")
i.fa.fa-times-thin
template(name="swimlaneActionPopup")
//- Grouped under headings (2026-11-20), as the list and card menus are; every
entry keeps its own condition.
if currentUser
//- Copy link, FIRST and above every permission check: a swimlane has an
address now, and copying it is reading, not editing - somebody who may
@@ -59,6 +61,7 @@ template(name="swimlaneActionPopup")
The rows below are all guarded because they change the board.
models/lib/boardItemUrl.js, docs/Features/General/Board-Item-Links.md
ul.pop-over-list
li.menu-group-heading {{_ 'menu-group-share'}}
li: a.js-copy-swimlane-link
i.fa.fa-link
span
@@ -83,6 +86,7 @@ template(name="swimlaneActionPopup")
like copying a link it is READING - so it sits above the rows that change
the board and is not guarded by them.
ul.pop-over-list
li.menu-group-heading {{_ 'menu-group-export'}}
li: a.js-export-swimlane
i.fa.fa-upload
span {{_ 'export'}}
@@ -95,6 +99,7 @@ template(name="swimlaneActionPopup")
unless currentUser.isReadOnly
unless currentUser.isReadAssignedOnly
ul.pop-over-list
li.menu-group-heading {{_ 'add'}}
li: a.js-add-swimlane
i.fa.fa-plus
span
@@ -115,12 +120,14 @@ template(name="swimlaneActionPopup")
if currentUser.isBoardAdmin
hr
ul.pop-over-list
li.menu-group-heading {{_ 'appearance'}}
li: a.js-set-swimlane-color
i.fa.fa-paint-brush
| {{_ 'select-color'}}
unless this.isTemplateContainer
hr
ul.pop-over-list
li.menu-group-heading {{_ 'menu-group-move-copy'}}
li: a.js-copy-swimlane
i.fa.fa-clipboard
| {{_ 'copy-swimlane'}}
@@ -130,6 +137,7 @@ template(name="swimlaneActionPopup")
| {{_ 'move-swimlane'}}
hr
ul.pop-over-list
li.menu-group-heading {{_ 'archives'}}
li: a.js-close-swimlane
i.fa.fa-archive
| {{_ 'archive-swimlane'}}
-6
View File
@@ -237,12 +237,6 @@ template(name="editProfilePopup")
input#anonymizeButton.primary.wide(type="button" value="{{_ 'anonymize-account'}}")
template(name="supportPopup")
ul.pop-over-list
li
+viewer
= currentSetting.supportPopupText
template(name="changePasswordPopup")
+atForm(state='changePwd')
-1
View File
@@ -121,7 +121,6 @@ Template.memberMenuPopup.events({
'click .js-sqrl': Popup.open('sqrl'),
'click .js-hidden-boards': Popup.open('hiddenBoards'),
'click .js-change-language': Popup.open('changeLanguage'),
'click .js-support': Popup.open('support'),
async 'click .js-logout'(event) {
event.preventDefault();
if (Meteor.user()?.authenticationMethod === 'saml') {
+3
View File
@@ -4,6 +4,7 @@ import '/client/components/cards/cardDate.jade';
import '/client/components/cards/cardDescription.jade';
import '/client/components/cards/cardDetails.jade';
import '/client/components/cards/cardFlowtime.jade';
import '/client/components/cards/cardFlow.jade';
import '/client/components/cards/cardPomodoro.jade';
import '/client/components/cards/cardStickers.jade';
import '/client/components/cards/cardTextNotes.jade';
@@ -23,6 +24,7 @@ import '/client/components/cards/cardDetails.js';
import '/client/components/cards/cardAddFields.js';
import '/client/components/cards/cardDrawing.js';
import '/client/components/cards/cardFlowtime.js';
import '/client/components/cards/cardFlow.js';
import '/client/components/cards/cardPomodoro.js';
import '/client/components/cards/cardStickers.js';
import '/client/components/cards/cardTextNotes.js';
@@ -44,6 +46,7 @@ import '/client/components/cards/cardDetails.css';
import '/client/components/cards/cardAddFields.css';
import '/client/components/cards/cardDrawing.css';
import '/client/components/cards/cardFlowtime.css';
import '/client/components/cards/cardFlow.css';
import '/client/components/cards/cardPomodoro.css';
import '/client/components/cards/cardTime.css';
import '/client/components/cards/checklists.css';
+3
View File
@@ -2,12 +2,15 @@ import '/client/components/lists/list.jade';
import '/client/components/lists/listBody.jade';
import '/client/components/lists/listHeader.jade';
import '/client/components/lists/listPermissions.jade';
import '/client/components/lists/listFlowPolicies.jade';
import '/client/components/lists/minilist.jade';
import '/client/components/lists/list.js';
import '/client/components/lists/listBody.js';
import '/client/components/lists/listHeader.js';
import '/client/components/lists/listPermissions.js';
import '/client/components/lists/listFlowPolicies.js';
import '/client/components/lists/list.css';
import '/client/components/lists/listFlowPolicies.css';
+3
View File
@@ -4,6 +4,7 @@ import '/client/components/sidebar/sidebarOriginalPositions.jade';
import '/client/components/sidebar/sidebarCustomFields.jade';
import '/client/components/sidebar/sidebarFilters.jade';
import '/client/components/sidebar/sidebarSearches.jade';
import '/client/components/sidebar/scrumMeetings.jade';
import '/client/components/sidebar/sidebar.js';
import '/client/components/sidebar/sidebarArchives.js';
@@ -13,7 +14,9 @@ import '/client/components/sidebar/sidebarSinceLastVisit.js';
import '/client/components/sidebar/sidebarCustomFields.js';
import '/client/components/sidebar/sidebarFilters.js';
import '/client/components/sidebar/sidebarSearches.js';
import '/client/components/sidebar/scrumMeetings.js';
import '/client/components/sidebar/sidebar.css';
import '/client/components/sidebar/sidebarSearches.css';
import '/client/components/sidebar/scrumMeetings.css';
+3 -1
View File
@@ -380,9 +380,11 @@ FlowRouter.route('/share-target', {
},
});
// No sign-in guard: Admin Panel / Settings / Visibility marks the Support page
// Public or not, and the template says "only for logged-in users" to a signed-out
// visitor of a page that is not public (the publication then sends no text).
FlowRouter.route('/support', {
name: 'support',
triggersEnter: [ensureSignedInUnlessSandstorm],
action() {
Session.set('currentBoard', null);
Session.set('currentList', null);
@@ -44,6 +44,12 @@
],
"handling": "Six visible fields in ordinary/local wrapper Details; sprint and release names require the same board. Internal Scrum snapshots and revisions are excluded."
},
{
"fields": [
"flow"
],
"handling": "The Kanban and Scrum flow fields (models/lib/cardFlow.js: blocked and why, class of service, MoSCoW, WSJF) are not in card emails yet; blockedBy is a user id and is never written into a message."
},
{
"fields": [
"archived",
@@ -21,6 +21,15 @@ here: **Rule suggestions**, **Summary**, **Since your last visit** and
risk, Suggested members, Forecast, Checklist from description and Action
items - are card fields, below.
The Kanban and Scrum helpers are features here too, each also turned on or off
per board: **List policies**, **Commitment point**, **WIP limit per person**
and **Split lists** ([flow policies](../../Lists/Flow-Policies.md), Board
Settings / List), and **Daily standup** and **Retrospective board**
([Scrum meetings](../../Board-Sidebar/Board-Settings/Scrum-Meetings.md), Board
Settings / Scrum). The four flow fields - Blocked, Class of service, MoSCoW
priority and WSJF score ([flow fields](../../Cards/Flow-Fields.md)) - are card
fields, below.
### Card fields
Above the Features **Save** there is one tick per field type of the board right
@@ -25,6 +25,11 @@ Until 2026-11-19 this pane was Admin Panel / Problems / Security;
Jira, Kanboard, NextCloud Deck, OpenProject, GitHub, GitLab, Gitea and Forgejo,
and cloning a board. The menu options are hidden and the server refuses any
import request.
- **Largest import (MB)** - the largest file the Import page accepts. Empty is
no limit: a file may be as large as the free disk space lets the import
finish. Every upload is written to the server's disk a part at a time and an
import that would fill the disk is refused
([Large files](../../Board-Sidebar/Board-Settings/Import-Export/External-Tools.md#large-files)).
- **Disable all export** - every export is off: WeKan JSON, CSV, Excel, Kanboard,
and to NextCloud Deck / OpenProject / GitHub / GitLab / Gitea / Forgejo, and
single-attachment export.
@@ -18,8 +18,12 @@ returns, for the signed-in user:
The page then keeps only the kinds - organizations, teams, domains - that are
ticked as scopes in Admin Panel / People / Shared templates. Those ticks are
read from this browser's `localStorage` (`sharedTemplatesScopes`), where that
pane stores them; a browser in which they were never set offers no targets.
the instance setting `Settings.sharedTemplatesScopes`
(`models/lib/sharedTemplatesScopes.js`), the same for every user in every
browser; with none ticked, no targets are offered. (They used to be read from
the browser's `localStorage`, so they differed per browser; the first time an
admin opens that pane, ticks still stored there are carried over to the
setting when the instance has none yet.)
## Sharing
@@ -7,7 +7,7 @@ the card. For dragging cards to new dates, and for the start, end and received
dates, use the [Calendar](Calendar.md) view.
A site admin can turn the calendar views off in Admin Panel / Settings /
Visibility / Features ("Calendar views").
Features ("Calendar views").
## What it shows
@@ -0,0 +1,43 @@
# Board reports
Twelve reports of the Board View menu, added on 2026-11-20 after comparing
WeKan's charts with the reports of Jira, Azure DevOps, Nave, ActionableAgile and
the Flow Framework. Each opens like the other charts: the **export bar at its
top** (PDF and Excel, the same as every board chart), the chart drawn with
Chart.js, and the data table under it, which is also what the export writes.
The calculations are `models/lib/boardReports.js` (`BOARD_REPORTS`), pure
functions tested by `tests/boardReports.test.cjs`; the server loads only what a
report reads (`server/lib/boardChartData.js` `loadBoardReport`). A card is
**finished** at its end date, else when it was archived - as in the other
charts. Weeks start on Monday (UTC); the weekly reports show the board's weeks,
at most the last 52, and the chart the last 24 of them.
| Report | Board View | Group | What it shows |
| --- | --- | --- | --- |
| Created vs. Resolved | `board-view-created-resolved` | Kanban flow | Cards created and finished per week, and how many were open at the end of each week. The chart is the open count. |
| Net Flow | `board-view-net-flow` | Kanban flow | Finished less created per week. Positive: the board empties; negative: work arrives faster than it leaves. |
| Time in List | `board-view-time-in-list` | Kanban flow | For each list, how many stays cards had in it and their median and 85th percentile in days, from the change history of the cards' moves. A card never moved stayed in its list from its creation. |
| Average Age | `board-view-average-age` | Kanban flow | At the end of each week, the open cards and their mean age in days. |
| Throughput Run Chart | `board-view-throughput-run` | Kanban flow | Cards finished per week, in time order, with the median of the weeks (the Throughput Histogram shows the same counts as a distribution). |
| Due Date Performance | `board-view-due-date-performance` | Kanban flow | Cards finished per week on time, late and without a due date, and the average days late. The chart is the share on time. |
| Release Burndown | `board-view-release-burndown` | Scrum | For each Scrum release, its cards, those done and those left, and the projected finish at the weekly rate of the last four weeks. |
| Epic Progress | `board-view-epic-progress` | Scrum | Every card with subtasks: its subtasks done and open, and the share done - the least finished first. |
| Workload | `board-view-workload` | Overview | The open cards of each person (assignees, else members), and how many are in each list. |
| Distribution | `board-view-distribution` | Overview | Open and finished cards by label, and each label's share of the open ones. |
| Dependency Map | `board-view-dependency-map` | Overview | Every dependency of an open card - the relation, the card it depends on and whether that is done - and the length of the chain of open cards it waits on, the longest first. The dependency graph itself is exported as SVG from Board Settings → Export → Dependencies. |
| Activity Heatmap | `board-view-activity-heatmap` | Overview | The board's changes of the last year by weekday and hour (UTC); the table is the heatmap, the chart each weekday's total. |
## Who sees them
The same as the other charts (`models/lib/exportAccess.js`): a member who may
see only the cards assigned to them gets none of these reports, because each
reads every card of the board. The instance can turn them off with the other
flow charts in Admin Panel → Settings → Features, and a board admin can hide
each in Board Settings → Board View.
## Export
The export bar at the top of each report writes its title and table as PDF or
Excel (`models/exportCharts.js`, `models/lib/chartExportRows.js`). An export
follows Admin Panel → Anonymize export users for the names in Workload.
@@ -4,7 +4,7 @@ Board header → **Board View** → **Table**. The board's cards as a table: one
per card, sortable by every column. A board admin can hide the view in
[Board Settings / Board View](../../Board-Sidebar/Board-Settings/Board-View.md),
and a site admin can turn it off for the whole instance in Admin Panel /
Settings / Visibility / Features ("Table view").
Settings / Features ("Table view").
## What it shows
@@ -4,7 +4,7 @@ Board header → **Board View** → **Time**. The board's time tracking in one
place: how much time is spent, by whom and on which cards. Time is entered on
the cards themselves ([Time tracking](../../Cards/Time-Tracking.md)); this view
only reports it. A site admin can turn it off with "Time views" in Admin Panel /
Settings / Visibility / Features.
Settings / Features.
## What it shows
@@ -3,7 +3,7 @@
Board header → **Board View** → **Timeline**. The board as it was at an earlier
moment. Click a point on the line to see the cards, by list, as they were then;
**Now** returns to the present. A site admin can turn it off with "Time views"
in Admin Panel / Settings / Visibility / Features.
in Admin Panel / Settings / Features.
## What it shows
+12
View File
@@ -82,3 +82,15 @@ Role permissions apply in every view; see
| Chat | `board-view-chat` | `chatView` in `client/components/boards/chatView.jade` | [Chat-View](Board-Views/Chat-View.md) |
| Version Control | `board-view-version-control` | `versionControlView` in `client/components/boards/versionControlView.jade` | [Version-Control-View](Board-Views/Version-Control-View.md) |
| Column sets | `board-view-column-sets` | `columnSetsView` in `client/components/boards/columnSetsView.jade` | [Column-Sets](Board-Views/Column-Sets.md) |
| Created vs. Resolved | `board-view-created-resolved` | `createdResolvedView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Net Flow | `board-view-net-flow` | `netFlowView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Time in List | `board-view-time-in-list` | `timeInListView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Average Age | `board-view-average-age` | `averageAgeView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Throughput Run Chart | `board-view-throughput-run` | `throughputRunView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Due Date Performance | `board-view-due-date-performance` | `dueDatePerformanceView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Release Burndown | `board-view-release-burndown` | `releaseBurndownView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Epic Progress | `board-view-epic-progress` | `epicProgressView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Workload | `board-view-workload` | `workloadView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Distribution | `board-view-distribution` | `distributionView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Dependency Map | `board-view-dependency-map` | `dependencyMapView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
| Activity Heatmap | `board-view-activity-heatmap` | `activityHeatmapView` in `client/components/boards/chartPlaceholderViews.jade` | [Board-Reports](Board-Views/Charts/Board-Reports.md) |
@@ -4,11 +4,11 @@
`boardInfoOnMyBoardsPopup` in `client/components/sidebar/sidebar.jade`, with
its helpers and events in `client/components/sidebar/sidebar.js`.
**It is not in the Board Settings menu at the moment.** The menu entry that
opens it (`a.js-board-info-on-my-boards`, `fa-id-card-o`) is commented out in
`boardMenuPopup`, with the note *Bug Board icons random dance* (#4214). The
popup and its click handler (`'click .js-board-info-on-my-boards'`) are still
in the code, so this page describes what it does when opened.
A board admin opens it from the Board Settings menu, below **Date**
(`a.js-board-info-on-my-boards`, `fa-id-card-o`). The entry was commented out
for a while because of the *Bug Board icons random dance* (#4214), a reactive
re-render loop on All Boards; the board tiles now read one fetch of
`getAllBoardsTileData` instead of reactive cursors, so the entry is back.
## The popup
@@ -7,6 +7,23 @@ board opens in - separately for when the board is **public** and when it is
offer only Roadmap and Gantt and open in Roadmap, while the same board, made
private again, shows its members every view and opens in Swimlanes.
## Groups
The Board View menu and this popup show the views in six groups, each under its
heading (`BOARD_VIEW_GROUPS` in `models/lib/boardViewSettings.js`):
| Group | Views |
| --- | --- |
| Board | Swimlanes, Lists, Table, Column sets, Group by Assignee, Map, Bigboard |
| Calendar and time | Calendar, Calendar Mode, Multi Board Calendar, Time, Timeline, Gantt, Frappe Gantt, DHTMLX Gantt, Roadmap |
| Scrum | Product Backlog, Sprints, Sprint Report, Velocity, Burndown, Burnup, Release Burndown, Epic Progress |
| Kanban flow | Cumulative Flow, Control, Cycle Time, Lead Time, Flow Efficiency, Throughput Histogram, WIP Run, Aging WIP, Blocker Analysis, Monte Carlo, Process Behavior, Size vs. Cycle Time, Created vs. Resolved, Net Flow, Time in List, Average Age, Throughput Run Chart, Due Date Performance |
| Overview | Dashboard, Pulse, Statistics, Workload, Distribution, Dependency Map, Activity Heatmap |
| Communication and code | Email, Chat, Version Control |
The order a board admin drags here decides inside each group; a view stays in
its own group. A group none of whose views is shown has no heading.
## Where to find it
**Board sidebar (hamburger menu) → Board Settings → Board View**, the first
@@ -108,6 +125,18 @@ menu's own order**, with the same translation keys the menu uses:
38. Chat (`board-view-chat`)
39. Version Control (`board-view-version-control`)
40. Column sets (`board-view-column-sets`)
41. Created vs. Resolved (`board-view-created-resolved`)
42. Net Flow (`board-view-net-flow`)
43. Time in List (`board-view-time-in-list`)
44. Average Age (`board-view-average-age`)
45. Throughput Run Chart (`board-view-throughput-run`)
46. Due Date Performance (`board-view-due-date-performance`)
47. Release Burndown (`board-view-release-burndown`)
48. Epic Progress (`board-view-epic-progress`)
49. Workload (`board-view-workload`)
50. Distribution (`board-view-distribution`)
51. Dependency Map (`board-view-dependency-map`)
52. Activity Heatmap (`board-view-activity-heatmap`)
The one list is `BOARD_VIEWS` in `models/lib/boardViewSettings.js`. Both the
popup and the Board View menu (`boardChangeViewPopup` in
@@ -153,6 +153,14 @@ where the helper works:
All are on by default except the minicard's forecast.
## The flow fields
The Card section also has four Kanban and Scrum fields, each a row with its
Show on Minicard and Show on Card checkboxes, off until turned on:
**Blocked** (with a reason), **Class of service**, **MoSCoW priority** and
**WSJF score**. Admin Panel can hide any of them on every board. See
[flow fields](../../Cards/Flow-Fields.md).
## Prerequisites
- Only a board admin can change these settings; only an admin can drag a
@@ -127,6 +127,10 @@ What the current code does (`parseAsana` in `models/lib/externalParsers.js`):
| `gid` | Source reference, for parent and dependency links |
| `name`, `notes` | Card title, description |
| `start_at` / `start_on`, `due_at` / `due_on` | Start date, due date |
| `actual_time_minutes` (time tracking) | Spent time (hours), written back on export |
| `html_notes`, when there are no `notes` | Card description, as text |
| `approval_status` of an approval task (not pending) | Label `approval:approved`, `approval:rejected` or `approval:changes requested` |
| `likes` of a comment story | The comment's 👍 reactions, by who liked it; likes the export does not name are counted in the loss report |
| `completed_at` (when completed) | End date |
| `created_at` | Creation date |
| `assignee` | Card member, when mapped |
@@ -110,7 +110,7 @@ The fetched JSON, which is also what the REST API takes:
| `created_at` | Created date |
| `completed` | Due date marked done; a completed to-do is archived |
| `assignees` | Members: the first as owner, then the others |
| Card `steps` (`title`, `completed`) | Checklist "Steps" |
| Card `steps` (`title`, `completed`, `due_on`, `assignees`) | Checklist "Steps", each item with the step's due date and first assignee |
| Comments (`content`, `creator`, `created_at`) | Comments |
| Card and to-do `id` | Source reference |
@@ -205,7 +205,7 @@ Last activity and Voting are not imported.
| Parent card | The card's parent, by title |
| Spent time, Overtime, Archived | Spent time, overtime, archived |
| `CustomField-...` | Board custom fields and the card's values |
| Other columns ticked in the mapping step | Text custom fields |
| Every other named column | A text custom field of its name: ticked in the mapping step by default, and always when no mapping is sent (a REST import) |
The export writes every column listed under **Export columns**.
@@ -213,8 +213,8 @@ The export writes every column listed under **Export columns**.
On import:
- columns no field uses and that were not ticked as custom fields,
including WeKan's Last activity and Voting columns;
- columns unticked in the mapping step, and WeKan's own Number, Last
activity and Voting columns, which no card field takes;
- members who were not mapped (Requested By and Assigned By keep them as
text);
- label names with spaces or commas in them: those separate two labels;
@@ -129,7 +129,8 @@ From the current code (`models/lib/clickupCsvFormat.js`):
Name, the board is named **Imported ClickUp tasks**.
The export writes the 31 workspace export columns, from **Task ID** to
**Rolled Up Time Text**, then **Checklist**:
**Rolled Up Time Text**, then **Checklist**, then one column per custom field
of the board that is not one of those named above:
- Task ID is the WeKan card id; Parent ID and Subtask IDs link the cards of
the same board;
@@ -162,6 +163,8 @@ The export writes the 31 workspace export columns, from **Task ID** to
| Due date | Due date |
| Start date | Start date |
| Time Spent / Time Tracked | Spent time, in hours |
| Task Link | `Source: <link>` at the end of the description |
| Any other column (a workspace export writes each custom field as one) | A custom field of the column's name |
| Priority | Custom field Priority |
| Task Type (other than task) | Custom field Task Type |
| Task Custom ID | Custom field Custom ID |
@@ -187,11 +190,11 @@ silently:
- a parent that is not in the same import, a Task ID used twice, and a parent
link that would form a cycle.
Other columns, such as Task Link, Rolled Up Time and the `Text` date columns,
are not read and not reported.
ClickUp's own Rolled Up Time and `Text` date columns repeat other columns,
and are not read.
The export leaves out comments, attachments, done state of checklist items,
spent time, archived cards, and custom fields other than those named above.
The export writes the spent hours as Time Spent (milliseconds). It leaves
out comments, attachments, done state of checklist items and archived cards.
## REST API
@@ -0,0 +1,87 @@
# Discord
WeKan imports a Discord channel exported with
[DiscordChatExporter](https://github.com/Tyrrrz/DiscordChatExporter) as a
board for **Board View → Chat**: the channel is a card in its category, the
server its swimlane, and the messages the card's comments.
## How to import
1. Export the channel with DiscordChatExporter in the **JSON** format.
2. In WeKan, go to **All Boards → New → Import → Discord (DiscordChatExporter)**.
3. Choose the `.json` file, or paste its text - or, when DiscordChatExporter
ran with `--media` (the attachments downloaded beside the JSON), zip the
folder with the `.json` and its `_Files` folder and choose the `.zip`.
4. Map the authors to WeKan members, or leave them as they are.
5. Click **Import**.
## How to import many boards at once
1. On the import page, choose **Discord (DiscordChatExporter)**, then under **Import many boards**
choose several files, or one `.zip` that holds them.
2. Each file becomes its own board. The boards are imported without member
mapping; members can be mapped later.
Discord is imported through the generalized importer
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
per project**: each swimlane the import would create becomes its own board.
From a script:
```bash
python3 api.py importboardsfrom discord FILE_OR_DIR ...
```
## How to export
Discord has no import of its own for a file WeKan could write, so WeKan does not export to it. Export the board in another format, for example [WeKan JSON](../WeKan/WeKan.md).
## How to export all boards at once
Discord has no import of its own for a file WeKan could write, so WeKan does not export to it. Export the board in another format, for example [WeKan JSON](../WeKan/WeKan.md).
## Format details
The JSON has `guild`, `channel` (name, category, topic, type) and
`messages` with `author`, `timestamp` and `content`; an array of such exports
imports every channel (`models/lib/chatExportFormats.js`). Ordinary messages and
replies are imported; pins, joins and other system messages are not.
## What is kept
Channel name and topic, category, server, messages with author, nickname and time.
## Replies
A reply, found by its `reference`, is a reply to the comment of the message it answers,
one level deep as WeKan's replies are: a reply to a reply goes under the same
comment. A reply to a message that is not in the file is a comment of its own,
starting with "↳".
## Reactions
A message's reactions become the comment's reactions, read from the emoji itself.
WeKan keeps a reaction by who reacted, so a reaction is kept for each person
mapped to a WeKan user in the members step. The loss report counts the
reactions of people who were not mapped, and those with an emoji WeKan cannot
store: a shortcode WeKan does not know, a server's or a chat's own emoji, or an
emoji of several code points (a skin tone, a flag). See
`models/lib/importedReactions.js`.
## What is not kept
Attachments that are only links (not downloaded with `--media`) and stickers (counted), embeds, a server's own emoji reactions. An attachment the zipped folder carries is an attachment of the channel's card. What was left out is listed in the import's loss report, also in
**Admin Panel → Problems → Recovery**.
## REST API
- Import: `POST /api/boards/import/discord` with the file's text, or a
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
## How it is built and tested
`tests/chatExportFormats.test.cjs` reads a channel with an attachment and a system message, and refuses JSON without a channel and messages.
## Sources
- [DiscordChatExporter](https://github.com/Tyrrrz/DiscordChatExporter)
@@ -0,0 +1,90 @@
# Evernote
WeKan imports Evernote's `.enex` export as a board, and exports a board as
an `.enex` file that Evernote, Joplin and other note apps import. A note is a
card: its text the description, its to-do checkboxes a checklist, its tags
labels and its reminder the due date.
## How to import
1. In Evernote, select the notes or a notebook, choose **Export**, and save
as `.enex`.
2. In WeKan, go to **All Boards → New → Import → Evernote (.enex)**.
3. Choose the `.enex` file, or paste its text.
4. Click **Import**.
## How to import many boards at once
1. On the import page, choose **Evernote (.enex)**, then under **Import many boards**
choose several files, or one `.zip` that holds them.
2. Each file becomes its own board. The boards are imported without member
mapping; members can be mapped later.
Evernote is imported through the generalized importer
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
per project**: each swimlane the import would create becomes its own board.
From a script:
```bash
python3 api.py importboardsfrom evernote FILE_OR_DIR ...
```
## How to export
1. Open the board, then **Board Settings → Export**, and choose **Evernote
(.enex)**. The board downloads as `<board>.enex`.
2. Import it in Evernote (**File → Import → ENEX**) or Joplin (**File →
Import → ENEX**).
Each card is a note: the description as text, each checklist as a heading and
to-do lines, the comments after a line, the labels and the list as tags, the
due date as the reminder (done when the due date is complete) and the creator
as the author.
## How to export all boards at once
1. In WeKan, go to **All Boards**, open the sidebar and choose **Export all
boards**, then **Evernote (.enex)**.
2. One `.zip` downloads, with one `.enex` file per board you can export.
From a script:
```bash
python3 api.py exportallboards enex boards.zip
```
## Format details
ENEX is XML: `<en-export>` with `<note>`s, each with `title`, `content` (ENML,
XHTML in a CDATA section), `created`, `updated`, `tag`s, `note-attributes`
(`reminder-time`, `reminder-done-time`, `author`, `source-url`) and `resource`s.
The server parses it with htmlparser2 (`server/lib/enexImport.js`) and reads
the content's text, a line per block, each `<en-todo>` marked as a checklist
item; scripts, styles, media and encrypted parts are dropped. A note whose
reminder is done goes to **Done**, the others to **Notes**
(`models/lib/enexFormat.js`).
## What is kept
Title, text, to-dos and whether each is done, tags, created date, reminder and its done time, author, source URL.
## What is not kept
Images and attached files (counted), formatting, encrypted text, notebook stacks. What was left out is listed in the import's loss report, also in
**Admin Panel → Problems → Recovery**.
## REST API
- Import: `POST /api/boards/import/evernote` with the file's text, or a
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
- Export: `GET /api/boards/:boardId/export/enex`.
## How it is built and tested
`tests/enexFormat.test.cjs` reads notes with to-dos, tags, reminders, a script and a resource, refuses a file that is not ENEX, and exports a board - with a `]]>` in its text - and reads it back.
## Sources
- [How Evernote's XML export format works](https://evernote.com/blog/how-evernotes-xml-export-format-works)
- [Evernote export DTD](http://xml.evernote.com/pub/evernote-export4.dtd)
@@ -8,6 +8,17 @@ tools. You use them from the existing menus:
text where the format is text.
- **Export**: **Board Settings → Export**. Choose the scope and the fields to
include, then the format.
- Both list the tools under the same headings - WeKan, Kanban and project
tools, Issue trackers and version control, Task and to-do apps,
Spreadsheets and tables, Text and outlines, Mail, calendars, chats and
notes, and Fetched from a service - from one table,
`models/lib/toolGroups.js`, so a tool is in the same group on both.
- A company with more than one product there has a heading of its own, right
after WeKan, and its products are listed under it without the company's
name in front: **37signals** (Basecamp, Fizzy), **Atlassian** (Trello,
Jira), **Google** (Takeout, Tasks, Keep) and **Microsoft** (Planner, To Do,
Excel, GitHub). A company with one product stays under the heading of its
kind.
- **Rules and workflows**: **Board Settings → Rules → Import / Export rules**
(see [Rules](../../../Rules/Rules/Rules.md#import--export)).
@@ -37,6 +48,7 @@ sources of the format.
| [Linear](./Linear/Linear.md) | Issues CSV export | Linear CSV |
| [Notion](./Notion/Notion.md) | *Markdown & CSV* export `.zip`, or one database CSV | Notion database CSV |
| [Redmine](./Redmine/Redmine.md) | Issues list *Also available in: CSV* | Redmine issues CSV |
| [Fizzy](./Fizzy/Fizzy.md) | Account export or personal data export `.zip`, or one card's `.json` | Fizzy account export `.zip` (its account import reads it) |
| [Plane](./Plane/Plane.md) | Workspace Settings → Exports `.zip` (CSV, JSON or XLSX inside), or one file from it | — (Plane has no file import) |
| [Taiga](./Taiga/Taiga.md) | Project export (dump) JSON | Taiga project dump JSON, with sprints |
| [Pivotal Tracker](./Pivotal-Tracker/Pivotal-Tracker.md) | Stories CSV | Pivotal Tracker CSV |
@@ -84,6 +96,24 @@ own API, so the exported file is for a script that calls it.
| [OPML](./OPML/OPML.md) | Outline from Workflowy, Dynalist, OmniOutliner, Logseq and others | OPML (`.opml`) |
| [Leo](./Leo/Leo.md) | Leo outline (`.leo`) | Leo outline |
## Mail, calendars, chats and notes
Mail shows in Board View → Email, chats in Board View → Chat (a channel is a
card, its messages the comments), and dated items in Calendar and Gantt.
| Tool | Import (the file you give WeKan) | Export (the file WeKan writes) |
| --- | --- | --- |
| [Mail (mbox, .eml)](./Mail/Mail.md) | An `.mbox` (Thunderbird, Apple Mail, mutt, Gmail) or one `.eml` message | Mail (mbox) |
| [iCalendar (.ics)](./iCalendar/iCalendar.md) | An `.ics` file: tasks (VTODO) by status, and events | Calendar feed of the board's dates |
| [Google Takeout](./Google-Takeout/Google-Takeout.md) | The Takeout `.zip`: Tasks, Keep, Mail, Calendar and Google Chat | — (Takeout is not imported back into Google) |
| [Slack](./Slack/Slack.md) | The workspace export `.zip` | — |
| [Mattermost](./Mattermost/Mattermost.md) | Bulk export `.jsonl` (`mmctl export create`) | Mattermost bulk import `.jsonl` |
| [Telegram](./Telegram/Telegram.md) | Telegram Desktop's JSON export `result.json` | — |
| [WhatsApp](./WhatsApp/WhatsApp.md) | *Export chat* `.txt` | — |
| [Discord (DiscordChatExporter)](./Discord/Discord.md) | DiscordChatExporter JSON | — |
| [Rocket.Chat](./Rocket-Chat/Rocket-Chat.md) | "Download my data" as JSON `.zip`, one room's `.json`, or a CSV importer `.zip` | Rocket.Chat CSV importer `.zip` |
| [Evernote (.enex)](./Evernote/Evernote.md) | Notes export `.enex` | Evernote (.enex) |
## WeKan's own formats and documents
| Format | Import | Export |
@@ -92,7 +122,6 @@ own API, so the exported file is for a script that calls it.
| [CSV / TSV](./CSV/CSV.md) | Comma, semicolon or tab separated | CSV `,` / CSV `;` / TSV |
| [Excel](./Excel/Excel.md) | WeKan-style `.xlsx` | Excel (`.xlsx`) |
| [PDF](./PDF/PDF.md), [HTML](./HTML/HTML.md) | — | PDF and an HTML archive of the board |
| [iCalendar](./iCalendar/iCalendar.md) | — | Calendar feed of the board's dates |
| [Dependencies](./Dependencies/Dependencies.md) | — | Dependency graph as JSON or SVG |
| [Rules](./Rules/Rules.md) | WeKan rules JSON or CSV, Trello Butler text, n8n and Node-RED workflows, Wrike workflows | WeKan rules JSON or CSV, Wrike workflow |
@@ -119,6 +148,36 @@ at a time, never held whole in memory, and held to the upload limit set in
**Admin Panel → Attachments → Limits**, if one is set
(`server/lib/importAttachmentStream.js`).
## Large files
A file chosen on the Import page for any tool of the generalized importer is
sent to the server a part at a time (`POST /api/import/upload/:source`,
`server/routes/importUpload.js`) and written to `WRITABLE_PATH/import-uploads`,
never held whole in the browser or in the server's memory on the way:
- before the first byte, the size the browser announces is checked against
the largest import the administrator set (Admin Panel → Settings → Security)
and against the free space of that disk, less a reserve
(`IMPORT_DISK_RESERVE_MB`, default 512 MB); while it is written, the space is
checked again every 64 MB. An import that would fill the disk is refused with
that reason, and its partial file is removed;
- with no limit set, an import may be as large as the free disk space lets it
finish;
- a `.zip` export (Slack, Google Takeout, Vikunja, Notion, Plane, Rocket.Chat,
Fizzy) is opened from the disk, its entries read as they are needed, and what they inflate to is
counted against the limit or the free space; a mailbox is read a message at
a time, also inside a Takeout zip;
- JSON is built from the file a chunk at a time (`server/lib/streamJson.js`),
so an export larger than one JavaScript string - about 512 MB - can still be
read; a Mattermost export is read a line at a time;
- a Jira file is uploaded too, and the people of its map-members step are read
from it on the server; a CSV / TSV file's header, sample rows and people come
from the server for its column mapping step;
- the file is removed once it has been read, or after an hour.
`tests/importUpload.test.cjs` covers the limit, the full disk before and during
the upload, an interrupted upload and how each source reads its file.
## Many boards at once
- **Import many boards**: on the import page of any tool, choose several of
@@ -0,0 +1,119 @@
# Fizzy
WeKan imports a board from [Fizzy](https://github.com/basecamp/fizzy), the
kanban tool of 37signals, and exports a board as the account export Fizzy's own
account import reads.
## How to import
1. In Fizzy, export either:
- the whole account: **Account settings → Export** (admins and owners), or
- your own cards: your profile → **Download my data**.
Fizzy e-mails a link to the `.zip`.
2. In WeKan, go to **All Boards → New → Import → Fizzy**.
3. Choose the `.zip`, or one card's `.json` from the personal export, or paste
that file's text.
4. Map the people to WeKan members, or leave them as they are.
5. Click **Import**.
## How to import many boards at once
1. On the import page, choose **Fizzy**, then under **Import many boards**
choose several files.
2. Each file becomes its own board. The boards are imported without member
mapping; members can be mapped later.
Fizzy is imported through the generalized importer
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
per project**: each Fizzy board becomes a WeKan board of its own.
From a script:
```bash
python3 api.py importboardsfrom fizzy FILE_OR_DIR ...
```
## How to export
1. Open the board, then **Board Settings → Export**, and choose **Fizzy**. The
board downloads as `<board>.zip`.
2. In Fizzy, make a new account from the zip with its account import
(**Import** when signing up an account, or `script/import-account` on a
server you run).
Each swimlane is a Fizzy board (a board with one swimlane is one Fizzy board
named after it), each list a column in the board's order, and the lists named
**Maybe?**, **Not now** and **Done** are Fizzy's own places of the same names.
An archived card is closed (Done). The account is named after the board. The
people are users of the new account with no e-mail address, so the import never
joins them to existing accounts; every user can open every board.
## How to export all boards at once
1. In WeKan, go to **All Boards**, open the sidebar and choose **Export all
boards**, then **Fizzy**.
2. One `.zip` downloads, with one Fizzy account export per board you can export.
From a script:
```bash
python3 api.py exportallboards fizzy boards.zip
```
## Format details
The account export (`app/models/account/data_transfer/*` in Fizzy) holds a row
of each table as `data/<table>/<id>.json` with every column of
`db/schema.rb`, `data/account.json`, the users as `data/users/<id>.json`, rich
text as `data/action_text_rich_texts/<id>.json` and the uploaded files as
`storage/<blob key>`. Ids are UUIDv7 written in base36, 25 characters. The
personal data export (`Card::Exportable`) holds `<number>.json` per card -
number, title, board, status, creator, description (HTML), dates and comments -
and its files under `<number>/<blob key>_<filename>`
(`models/lib/fizzyFormat.js`, `server/lib/fizzyArchive.js`).
A Fizzy board becomes a swimlane; its columns become lists in their position
order, after **Maybe?** (cards not yet triaged into a column) and before
**Not now** (postponed) and **Done** (closed) - the status names Fizzy itself
exports.
## What is kept
Boards, columns, cards with title, description, created date and due date,
tags as labels, assignees as the card's members, the creator as "requested by",
steps as the checklist **Steps**, comments by their author at their time, a
golden card as the colour gold, and the files in a description or a comment
(and a card's image) as attachments.
## What is not kept
Drafts never published (counted), reactions, watchers and pins (counted), and
boosts, events, notifications, webhooks and column colours. On export: users'
e-mail addresses, attachments, and a card's other dates. What was left out is
listed in the import's loss report, also in **Admin Panel → Problems →
Recovery**.
## REST API
- Import: `POST /api/boards/import/fizzy` with one card's `.json` text, or a
`.zip` as `{ "zipBase64": "..." }`.
- Export: `GET /api/boards/:boardId/export/fizzy`.
## How it is built and tested
`tests/fizzyFormat.test.cjs` reads an account export with columns out of
order, a triaged, an untriaged, a closed, a postponed and a draft card, tags,
assignments, steps, a comment, an embedded file and a missing one; reads a
personal data export with its files; refuses what is not a Fizzy export and a
file path outside a card's folder; and exports a board, checks every row has
every column Fizzy's import requires, is named by its id and names only users
of the export, and reads it back. The Playwright round trip
(`tests/playwright/specs/export-import-round-trip.e2e.js`) sends it through the
server.
## Sources
- [Fizzy source](https://github.com/basecamp/fizzy)
- [Fizzy account data transfer](https://github.com/basecamp/fizzy/tree/main/app/models/account/data_transfer)
- [Fizzy card export](https://github.com/basecamp/fizzy/blob/main/app/models/card/exportable.rb)
- [Fizzy exports API](https://github.com/basecamp/fizzy/blob/main/docs/api/sections/exports.md)
@@ -129,7 +129,9 @@ metadata and label colors are not imported.
The export (`forgejo` in `models/lib/externalExportFormatters.js`) is the same
as GitHub's: for each card that is not archived, `title`, `body`, `state`
(`closed` when the list name contains done, closed, complete, archiv or
finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
finished, otherwise `open`), `labels` (as `{ "name": ... }`), `due_date`, the
owner as `assignee` (and `assignees`), the creator as `user`, `created_at`,
`closed_at` for a closed issue, and a **Time estimate (hours)** custom field as `time_estimate` (seconds).
## What is kept
@@ -142,6 +144,8 @@ finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
| `state_reason` other than completed | Label `state_reason:...` |
| `milestone.title` | Label `milestone:...` |
| `milestone.due_on`, else `due_date` | Due date |
| `created_at`, and `closed_at` of a closed issue | Created and end dates |
| `time_estimate` (seconds, Gitea 1.23 and later) | Custom field **Time estimate (hours)** |
| First of `assignees` (`assignee`) | Owner, when mapped to a WeKan user |
| Other assignees | Labels `assignee:...` |
| `user.login` | Requested By |
@@ -67,6 +67,7 @@ page or a format in the export menu has no page here.
| [Linear](./Linear/Linear.md) | yes | yes |
| [Notion](./Notion/Notion.md) | yes | yes |
| [Redmine](./Redmine/Redmine.md) | yes | yes |
| [Fizzy](./Fizzy/Fizzy.md) | yes | yes |
| [Plane](./Plane/Plane.md) | yes | — |
| [Taiga](./Taiga/Taiga.md) | yes | yes |
| [Pivotal Tracker](./Pivotal-Tracker/Pivotal-Tracker.md) | yes | yes |
@@ -93,6 +94,15 @@ page or a format in the export menu has no page here.
| [Basecamp](./Basecamp/Basecamp.md) | yes | — |
| [Google Tasks](./Google-Tasks/Google-Tasks.md) | yes | — |
| [Google Keep](./Google-Keep/Google-Keep.md) | yes | — |
| [Mail](./Mail/Mail.md) | yes | yes |
| [Google Takeout](./Google-Takeout/Google-Takeout.md) | yes | — |
| [Slack](./Slack/Slack.md) | yes | — |
| [Mattermost](./Mattermost/Mattermost.md) | yes | yes |
| [Telegram](./Telegram/Telegram.md) | yes | — |
| [WhatsApp](./WhatsApp/WhatsApp.md) | yes | — |
| [Discord](./Discord/Discord.md) | yes | — |
| [Rocket.Chat](./Rocket-Chat/Rocket-Chat.md) | yes | yes |
| [Evernote](./Evernote/Evernote.md) | yes | yes |
The [overview](./External-Tools.md) groups them by kind.
@@ -149,7 +149,9 @@ creation or close dates, relationships or events.
The export (`models/lib/externalExportFormatters.js`, `githubLike`) writes, for
each card that is not archived: `title`, `body` (the description), `state`
(`closed` when the list name contains done, closed, complete, archiv or
finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
finished, otherwise `open`), `labels` (as `{ "name": ... }`), `due_date`, the
owner as `assignee` (and `assignees`), the creator as `user`, `created_at`,
`closed_at` for a closed issue.
GitHub has no `due_date` field; WeKan reads it back when the file is imported
again.
@@ -164,6 +166,8 @@ again.
| `state_reason` other than completed | Label `state_reason:...` |
| `milestone.title` | Label `milestone:...` |
| `milestone.due_on`, else `due_date` | Due date |
| `created_at`, and `closed_at` of a closed issue | Created and end dates |
| `type.name` (GitHub's issue types: Bug, Feature, Task, or the organization's own) | Label `type:<name>` |
| First of `assignees` (`assignee`) | Owner, when mapped to a WeKan user |
| Other assignees | Labels `assignee:...` |
| `user.login` | Requested By |
@@ -167,8 +167,8 @@ each card that is not archived: `title`, `description`, `state` (`closed` when
the list name contains done, closed, complete, archiv or finished, otherwise
`opened`), `labels` (names), `due_date`, and, when the parts are ticked,
`assignees` (owner first), `author`, `created_at`, `closed_at` (closed items
only), comments as `notes`, and the sprint and release as `iteration` and
`milestone`. It writes no `iid`, so importing the file again does not add a
only), comments as `notes`, the spent hours as `time_stats.total_time_spent`
(seconds), and the sprint and release as `iteration` and `milestone`. It writes no `iid`, so importing the file again does not add a
second `Source:` line.
## What is kept
@@ -182,6 +182,8 @@ second `Source:` line.
| `milestone` | Scrum release, and label `milestone:...` |
| `iteration` | Scrum sprint, and label `iteration:...` |
| `issue_type` other than issue | Label `type:...` |
| `health_status` (on_track, needs_attention, at_risk) | Label `health:...` |
| `severity` of an incident (not UNKNOWN) | Label `severity:...` |
| `confidential` | Label `confidential`, and a warning |
| `due_date`, else `milestone.due_date` | Due date |
| `created_at` | Creation date |
@@ -129,7 +129,9 @@ metadata and label colors are not imported.
The export (`gitea` in `models/lib/externalExportFormatters.js`) is the same
as GitHub's: for each card that is not archived, `title`, `body`, `state`
(`closed` when the list name contains done, closed, complete, archiv or
finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
finished, otherwise `open`), `labels` (as `{ "name": ... }`), `due_date`, the
owner as `assignee` (and `assignees`), the creator as `user`, `created_at`,
`closed_at` for a closed issue, and a **Time estimate (hours)** custom field as `time_estimate` (seconds).
## What is kept
@@ -142,6 +144,8 @@ finished, otherwise `open`), `labels` (as `{ "name": ... }`) and `due_date`.
| `state_reason` other than completed | Label `state_reason:...` |
| `milestone.title` | Label `milestone:...` |
| `milestone.due_on`, else `due_date` | Due date |
| `created_at`, and `closed_at` of a closed issue | Created and end dates |
| `time_estimate` (seconds, Gitea 1.23 and later) | Custom field **Time estimate (hours)** |
| First of `assignees` (`assignee`) | Owner, when mapped to a WeKan user |
| Other assignees | Labels `assignee:...` |
| `user.login` | Requested By |
@@ -0,0 +1,85 @@
# Google Takeout
WeKan imports a [Google Takeout](https://takeout.google.com) `.zip` as one
board with a swimlane per Google product: **Mail** for Board View → Email,
**Tasks** and **Keep** as cards with their checklists, **Calendar** events and
tasks with their dates for Calendar and Gantt, and **Google Chat** spaces whose
messages are comments for Board View → Chat.
## How to import
1. At [takeout.google.com](https://takeout.google.com), choose **Tasks**,
**Keep**, **Mail**, **Calendar** and **Google Chat** (any of them), choose
the `.zip` file type, create the export and download it.
2. In WeKan, go to **All Boards → New → Import → Google Takeout**.
3. Choose the `.zip` file.
4. Map the people to WeKan members, or leave them as they are.
5. Click **Import**, and read the loss report: it lists the products in the
zip that have no place on a board.
## How to import many boards at once
1. On the import page, choose **Google Takeout**, then under **Import many boards**
choose several files, or one `.zip` that holds them.
2. Each file becomes its own board. The boards are imported without member
mapping; members can be mapped later.
Google Takeout is imported through the generalized importer
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
per project**: each swimlane the import would create becomes its own board.
From a script:
```bash
python3 api.py importboardsfrom googletakeout FILE_OR_DIR ...
```
## How to export
Google Takeout has no import of its own for a file WeKan could write, so WeKan does not export to it. Export the board in another format, for example [WeKan JSON](../WeKan/WeKan.md).
## How to export all boards at once
Google Takeout has no import of its own for a file WeKan could write, so WeKan does not export to it. Export the board in another format, for example [WeKan JSON](../WeKan/WeKan.md).
## Format details
The products are recognised by what a file is, not by its folder name,
which Takeout writes in the account's language (`server/lib/chatArchives.js`):
- a JSON file of `"kind": "tasks#taskLists"` - **Tasks**: task lists become
lists, tasks cards, with notes, links, due date, completion (tagged `done`)
and the parent of a subtask;
- a JSON file with `textContent` or `listContent` - a **Keep** note: in the
list **Notes** or **Archived**, its checklist, labels, color, *pinned* as a
label; notes in the trash are left out;
- `.mbox` - **Mail**, as [Mail](../Mail/Mail.md) reads it, in **Inbox**, the
board's first list, which the Email view reads;
- `.ics` - **Calendar**, as [iCalendar](../iCalendar/iCalendar.md) reads it;
- `messages.json` and `group_info.json` of a folder - a **Google Chat** space
or direct message (`models/lib/chatExportFormats.js`).
The mapping is `models/lib/googleTakeoutFormat.js`.
## What is kept
Everything the products above carry that a card has: titles, text, dates, checklists, labels, colors, the mail fields of the Email view and the messages of the Chat view.
## What is not kept
Other Google products (YouTube, Drive, Photos and the rest, listed in the loss report), attachments and images, Keep notes in the trash. The zip is read within bounds: at most 128 MB, 50,000 files and 256 MB unpacked. What was left out is listed in the import's loss report, also in
**Admin Panel → Problems → Recovery**.
## REST API
- Import: `POST /api/boards/import/googletakeout` with the file's text, or a
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
## How it is built and tested
`tests/googleTakeoutFormat.test.cjs` builds a Takeout zip with Finnish folder names and every product, reads it with the server's zip reader and checks each swimlane, the Inbox being first, the trash and the skipped products; and refuses a zip with nothing for a board and a file that is not a zip.
## Sources
- [Google Takeout](https://takeout.google.com)
- [Google Tasks API task resource](https://developers.google.com/tasks/reference/rest/v1/tasks)
@@ -90,7 +90,7 @@ The parser (`models/lib/googletasksApiFormat.js`):
| `due` | Due date |
| `status: completed` | Archived card |
| `completed` | End date |
| Subtasks (`parent`) | Checklist "Subtasks", done = completed |
| Subtasks (`parent`) | Checklist "Subtasks", done = completed, with the subtask's due date |
| `position` | Card and checklist item order |
| Hidden (cleared) completed tasks | Archived cards |
@@ -99,8 +99,8 @@ The parser (`models/lib/googletasksApiFormat.js`):
The import reports these on the loss report:
- deleted tasks (`deleted: true`), counted per list;
- the notes, due date and links of a subtask: a checklist item has only a
title and a done mark;
- the notes and links of a subtask: a checklist item has a title, done, a due
date and an assignee;
- a subtask whose parent is missing (it becomes its own card);
- a due date that is not a date;
- a second list with the same title (it is imported as `<title> (2)`);
@@ -94,7 +94,9 @@ What the current code does:
- `responsibleUserId` is the owner and `collaborators` are further
assignees, both by the user's full name (or e-mail without one), mapped to
WeKan members on the members step.
- `subTasks` become a checklist **Subtasks**, `finished` = done.
- `subTasks` become a checklist **Subtasks**, `finished` = done, a subtask's
`dueDate` the item's due date and its `userId` the item's assignee (when
mapped).
- Comments keep their author and date.
- The task id is the source reference.
- Limits: 20,000 tasks; comments are fetched for the first 5,000 tasks
@@ -117,7 +119,7 @@ What the current code does:
| `totalSecondsEstimate` | Custom field "Estimate (hours)" |
| `responsibleUserId` | Card member (owner) |
| `collaborators` | Card members |
| `subTasks` (`name`, `finished`) | Checklist "Subtasks" |
| `subTasks` (`name`, `finished`, `dueDate`, `userId`) | Checklist "Subtasks", with each item's due date and assignee |
| Comments | Comments, with author and date |
## What is not kept
@@ -126,7 +128,7 @@ The import reports these on the loss report:
- the column a due date is tied to (`targetColumnId`): WeKan keeps the date;
- every due date after the first;
- a subtask's own person and due date;
- a subtask due date that is not a date;
- a color that is not one of KanbanFlow's ten;
- a due date that is not a date;
- a task in a column the board does not have, and tasks that are not objects;
@@ -121,8 +121,9 @@ From the [format coverage](../Format-Coverage.md) audit:
creation dates, archive state, colors and source order are kept. Creation
dates survive the schema's `createdAt` autoValue through
`writeImportedEntity`. What has no equivalent is listed in the loss report:
file contents (the JSON carries attachment metadata only), time estimates,
external links, and task links WeKan cannot keep (see below).
file contents (the JSON carries attachment metadata only), a repeat other
than every 1 day, 7 days or 1 month, and task links WeKan cannot keep (see
below).
What the current code does (`parseKanboard` in
`models/lib/externalParsers.js`, `models/kanboardCreator.js`):
@@ -175,8 +176,12 @@ What the current code does (`parseKanboard` in
| `owner_username` (or `assignee_username`, `owner_id`, `owner_name`) | Card member, when mapped |
| `creator_username` (or `creator_name`) | Requested by |
| `tags`, category, `priority` | Board labels |
| `color_id` | Card color |
| `color_id` | Card color, written back on export |
| `time_spent` | Spent time (hours) |
| `time_estimated` | Custom field **Time estimate (hours)** |
| `score`, `reference` | Custom fields **Score** and **Reference** |
| `recurrence_status`, `recurrence_factor`, `recurrence_timeframe`: every 1 day, 7 days or 1 month | The card repeats daily, weekly or monthly |
| `external_links` (`url`, `title`) | A line each at the end of the description |
| `is_active` `0` | Archived card |
| `subtasks` (`title`, `status`) | Checklist **Subtasks** |
| `links` "is a child of" / "is a parent of" | The card's parent card |
@@ -189,7 +194,10 @@ each card: an `id` (1, 2, 3 ... in card order), `title`, `description`,
`column_name`, `swimlane_name`, `date_due`, `date_started`, `date_completed`,
`date_creation`, `owner_username`, `creator_username`, the labels as `tags`,
every checklist item as a `subtasks` entry (status `2` when finished, `0`
otherwise), the comments, and the card's parent and dependencies as `links`
otherwise), the comments, `time_spent`, a repeating open card's
`recurrence_status`, `recurrence_factor` and `recurrence_timeframe`, the
custom fields **Time estimate (hours)**, **Score** and **Reference** as
`time_estimated`, `score` and `reference`, and the card's parent and dependencies as `links`
in the `getAllTaskLinks` shape (`{ "id", "task_id", "label" }`, `task_id`
being the other task). Like Kanboard, each link is written from both tasks,
the second time with the opposite label, and the import folds the two back
@@ -200,10 +208,9 @@ when **Dependencies** is.
The import reports these on the loss report:
- `time_estimated` (WeKan cards have no estimate field; map it to a custom
field by hand);
- `files` (the API export carries metadata, not file contents);
- `external_links` (links to web pages and other systems are not imported);
- a repeat other than every 1 day, 7 days or 1 month (the task is imported
once);
- task links to a task that is not in the file;
- task links whose label is not one of Kanboard's built-in link types
(a link type added in Kanboard's settings);
@@ -93,6 +93,11 @@ What the current code does (`models/lib/leoOutline.js`):
- The outline is the `<v t="gnx">` nodes under `<vnodes>`. A node's body is
the `<t tx="gnx">` under `<tnodes>` with the same id. A node marked in Leo
carries `a="M"`.
- Leo stamps a node's id with the time it was made (`ekr.20260902080910.2`);
that time is the card's creation date. Leo writes it in local time with no
zone, so it is read as UTC.
- Any other attribute of a `<v>` or `<t>` is a Leo plugin's own data (its
"unknown attributes", pickled Python), and is reported.
- A level 3 node with children is a checklist named after it; all its
descendants, at any depth, are the items. Level 3 nodes without children
are the items of one checklist named after the card.
@@ -113,7 +118,8 @@ What the export writes (`models/lib/leoOutlineFormat.js`):
- each list as a top-level node, including lists without cards;
- each card as a child node, with its description as the body, marked when
its list's name looks finished (contains "done", "closed", "complete",
"archiv" or "finished");
"archiv" or "finished"), and its creation time in its id
(`wekan.YYYYMMDDHHMMSS.n`);
- each checklist as a child of the card, with its items as children, marked
when finished.
@@ -128,6 +134,7 @@ Archived cards and archived lists are not exported.
| Level 2 node: headline | Card title |
| Level 2 node: body | Card description |
| Level 2 node marked (`a="M"`) | Card with the label `done` |
| Level 2 node: the time in its id | Creation date |
| Level 3 node with children | Checklist, its descendants the items |
| Level 3 node without children | Item of a checklist named after the card |
| Marked item node | Finished checklist item |
@@ -137,10 +144,12 @@ Archived cards and archived lists are not exported.
The import reports these on the loss report:
- body text of a top-level (list) node: a WeKan list has no text field;
- a Leo plugin's data on a node (an attribute Leo itself does not write);
- nodes deeper than 64 levels.
The Leo export writes only lists, cards, descriptions, the done mark and
checklists. It does not write swimlanes, labels, dates, members, comments,
The Leo export writes only lists, cards, descriptions, the done mark, the
creation date and checklists. It does not write swimlanes, labels, other
dates, members, comments,
custom fields or attachments.
## REST API
@@ -97,10 +97,16 @@ What the import covers:
- `, `-separated labels;
- the created, started, completed (or canceled) and due dates;
- Archived as an archived card;
- Priority, Estimate, Project and Cycle (and Canceled) as custom fields.
- Priority, Estimate, Project and Cycle (and Canceled) as custom fields;
- with Scrum ticked in the import, each cycle as a Scrum sprint with its Cycle
Start and Cycle End, one per team (a cycle number is its team's), and each
project milestone as a Scrum release. The CSV gives a cycle no state: one
whose issues are all done is finished and not imported, as no commitment or
close snapshot is in the export, and any other is imported as planned. A
milestone has no dates in the CSV. Both are noted in the loss report.
Reported: Updated, Triaged, the cycle's dates, Initiatives, milestones, SLA
Status, dates that are not ISO 8601, and unknown priorities. The export writes
Reported: Updated, Triaged, Initiatives, SLA Status, dates that are not ISO
8601, and unknown priorities. The export writes
Linear's columns in its order, with the formula guard.
From the current code (`models/lib/linearCsvFormat.js`):
@@ -0,0 +1,106 @@
# Mail
WeKan imports mail as a board for **Board View → Email**, and exports a
board as an `.mbox` file. The import reads an **mbox** (RFC 4155) - the file
Thunderbird, Apple Mail, mutt and Gmail through Google Takeout write - or a
single **.eml** message (RFC 5322 / MIME). Each conversation becomes one card
in the list **Inbox**, with its sender, recipients and subject, so it is mail in
the Email view; the replies become the card's comments.
## How to import
1. Get the file: in Thunderbird, save the folder with an add-on such as
ImportExportTools NG as `.mbox`, or save one message as `.eml`; in Apple
Mail, **Mailbox → Export Mailbox**; from Gmail, use
[Google Takeout](../Google-Takeout/Google-Takeout.md) (**Mail**) and take the
`.mbox` from the zip; mutt and other Unix mail programs keep mbox files
already.
2. In WeKan, go to **All Boards → New → Import → Mail (mbox, .eml)**.
3. Choose the `.mbox` or `.eml` file, or paste its text.
4. Map the senders to WeKan members, or leave them as they are: a sender who
is not mapped is named at the start of the comment.
5. Click **Import**, and read the loss report.
## How to import many boards at once
1. On the import page, choose **Mail (mbox, .eml)**, then under **Import many boards**
choose several files, or one `.zip` that holds them.
2. Each file becomes its own board. The boards are imported without member
mapping; members can be mapped later.
Mail is imported through the generalized importer
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
per project**: each swimlane the import would create becomes its own board.
From a script:
```bash
python3 api.py importboardsfrom mail FILE_OR_DIR ...
```
## How to export
1. Open the board, then **Board Settings → Export**.
2. Under the tools, choose **Mail (mbox)**. The board downloads as
`<board>.mbox`.
3. Open it in Thunderbird (ImportExportTools NG), Apple Mail (**File → Import
Mailboxes**) or mutt.
Each card is a message from its creator, with the title as the subject and the
description as the text; its comments follow as replies (`In-Reply-To`). A card
that came from mail keeps its sender, recipients and Message-ID - unless Admin
Panel anonymizes exports, which leaves them out because they name people.
## How to export all boards at once
1. In WeKan, go to **All Boards**, open the sidebar and choose **Export all
boards**, then **Mail (mbox)**.
2. One `.zip` downloads, with one `.mbox` file per board you can export.
From a script:
```bash
python3 api.py exportallboards mbox boards.zip
```
## Format details
- **mbox**: messages separated by a `From ` line; a body line starting `From `
is escaped as `>From ` (mboxrd) and unescaped when read
(`models/lib/mboxSplit.js`).
- **MIME** is decoded on the server with mailparser
(`server/lib/mailImport.js`): encoded words, quoted-printable, base64,
multipart. An HTML-only message is read as its text with htmlparser2;
scripts and styles are dropped and no markup is kept.
- **Threads** join by `Message-ID`, `In-Reply-To` and `References`
(`models/lib/mailFormat.js`). The first message is the card, the later ones
its comments, oldest first.
- **Gmail labels** (`X-Gmail-Labels`) become labels; Inbox, Unread, Opened,
Important, Starred, Sent, Spam, Trash and the categories are mail state, not
labels. A conversation labelled **Sent** is outgoing mail, in the Email view's
Sent folder.
## What is kept
Subject, text, sender, To and Cc, date (the received date), Message-IDs of the thread (so a later reply sent to the board joins it), Gmail labels, replies as comments by their sender.
## What is not kept
Attachments (counted in the loss report), Bcc, HTML formatting, and mail headers other than the ones above. At most 20,000 messages are read from one file. What was left out is listed in the import's loss report, also in
**Admin Panel → Problems → Recovery**.
## REST API
- Import: `POST /api/boards/import/mail` with the file's text, or a
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
- Export: `GET /api/boards/:boardId/export/mbox`.
## How it is built and tested
`tests/mailFormat.test.cjs` decodes an mbox with a thread, an encoded subject, Gmail labels and an HTML-only message with mailparser, checks that a malformed sender or a header injection does not become mail, sends the result through the import sanitizer, and exports a board to `.mbox` and reads it back.
## Sources
- [RFC 4155 - the application/mbox media type](https://www.rfc-editor.org/rfc/rfc4155)
- [RFC 5322 - Internet Message Format](https://www.rfc-editor.org/rfc/rfc5322)
- [mailparser](https://nodemailer.com/extras/mailparser/)
@@ -95,8 +95,14 @@ What the current code does (`parseMarkdownKanban` in
list called "Imported".
- A line starting with `- ` or `* `, with or without `[ ]`, `[x]` or `[X]`,
is a card. `[x]` adds the label `done`.
- A line that starts with white space, under a card, is added to that card's
description. Indented bullets therefore also become description lines.
- On a card line, `#tag` words are labels (a word that starts with a letter,
so `#1234` and `C#` stay in the title), and `@{2026-12-24}` with an optional
`@@{14:30}` (Obsidian Kanban), `📅 2026-12-24` (Obsidian Tasks) or
`due:2026-12-24` (todo.txt) is the due date. A due day that is no date is
reported.
- An indented `- [ ]` / `- [x]` line under a card is an item of its checklist.
Any other line that starts with white space is added to the card's
description; `\- [ ]` there is a description line, not an item.
- Other headings (`#`, `###` and deeper, or a second `#` line) are skipped.
Any other non-blank line is reported.
- Every card goes to the swimlane Default.
@@ -108,8 +114,12 @@ What the export writes (`formatMarkdownKanban` in
lists without cards are left out.
- Each card as `- [ ] <title>`, or `- [x] <title>` when its list's name looks
finished: it contains "done", "closed", "complete", "archiv" or
"finished" (case does not matter).
- Each non-blank line of the description, indented two spaces.
"finished" (case does not matter); then its labels as `#tags` (a space
written as `-`) and its due date as `@{day}`, with `@@{time}` when it has
one.
- Each non-blank line of the description, indented two spaces, a line that
looks like a checklist item escaped as `\- [ ]`.
- Each checklist item as an indented `- [ ]` / `- [x]` line.
- Archived cards and archived lists are not exported.
## What is kept
@@ -121,6 +131,9 @@ What the export writes (`formatMarkdownKanban` in
| `- [ ] Item`, `- Item`, `* Item` | Card |
| `- [x] Item` | Card with the label `done` |
| Indented lines under an item | Card description |
| `#tag` on an item | Label |
| `@{day}` `@@{time}`, `📅 day`, `due:day` | Due date |
| Indented `- [ ]` / `- [x]` under an item | Checklist item |
## What is not kept
@@ -129,10 +142,12 @@ heading, a card or an indented line under a card (for example a numbered list
item, or text before the first card). Headings other than the first `#` line
and the `##` lines are skipped.
The Markdown export writes only lists, card titles and descriptions. It does
not write swimlanes, labels (including `done`; the checkbox comes from the
list name), dates, members, comments, checklists, custom fields,
attachments, blank lines inside a description, or lists without cards.
The Markdown export writes lists, card titles, descriptions, labels, the due
date and checklist items. It does not write swimlanes, the `done` label (the
checkbox comes from the list name), a label that does not start with a
letter, other dates, members, comments, custom fields, attachments, blank
lines inside a description, or lists without cards. A card's checklists come
back as one checklist.
## REST API
@@ -0,0 +1,104 @@
# Mattermost
WeKan imports a Mattermost bulk export as a board for **Board View →
Chat**, and exports a board as a bulk import file Mattermost reads. A channel
is a card and its posts are the card's comments.
## How to import
1. On the Mattermost server, run `mmctl export create`, then
`mmctl export download` and take the `.jsonl` file from the zip.
2. In WeKan, go to **All Boards → New → Import → Mattermost**.
3. Choose the `.jsonl` file, or paste its text.
4. Map the users to WeKan members, or leave them as they are.
5. Click **Import**.
## How to import many boards at once
1. On the import page, choose **Mattermost**, then under **Import many boards**
choose several files, or one `.zip` that holds them.
2. Each file becomes its own board. The boards are imported without member
mapping; members can be mapped later.
Mattermost is imported through the generalized importer
(`models/kanboardCreator.js`), so the page also has the checkbox **One board
per project**: each swimlane the import would create becomes its own board.
From a script:
```bash
python3 api.py importboardsfrom mattermost FILE_OR_DIR ...
```
## How to export
1. Open the board, then **Board Settings → Export**, and choose **Mattermost**.
The board downloads as `<board>.jsonl`.
2. Zip it and import it on the Mattermost server with `mmctl import upload`
and `mmctl import process`.
The file has one team named after the board, a public channel per card (its
list as the purpose), the card's description and comments as posts, and a user
per author with the address `<username>@wekan.invalid`, so the import never
joins them to existing accounts by e-mail.
## How to export all boards at once
1. In WeKan, go to **All Boards**, open the sidebar and choose **Export all
boards**, then **Mattermost**.
2. One `.zip` downloads, with one `.jsonl` file per board you can export.
From a script:
```bash
python3 api.py exportallboards mattermost boards.zip
```
## Format details
Bulk export JSONL: a `version` line, then `team`, `channel`, `user`, `post`
and `direct_channel` / `direct_post` lines; a post carries its `replies`
(`models/lib/chatExportFormats.js`). Teams become swimlanes, public channels
the list **Channels**, private ones **Groups**, direct messages **Direct
messages**; a reply starts with `↳`.
## What is kept
Channels with header and purpose, posts and replies with author and time, teams.
## Replies
A reply, found by the post it is nested in, is a reply to the comment of the message it answers,
one level deep as WeKan's replies are: a reply to a reply goes under the same
comment. A reply to a message that is not in the file is a comment of its own,
starting with "↳".
## Reactions
A message's reactions become the comment's reactions, read from Mattermost's `emoji_name`, such as `+1` or `tada`.
WeKan keeps a reaction by who reacted, so a reaction is kept for each person
mapped to a WeKan user in the members step. The loss report counts the
reactions of people who were not mapped, and those with an emoji WeKan cannot
store: a shortcode WeKan does not know, a server's or a chat's own emoji, or an
emoji of several code points (a skin tone, a flag). See
`models/lib/importedReactions.js`.
## What is not kept
Attachments (counted), custom emoji, users' profiles and preferences. What was left out is listed in the import's loss report, also in
**Admin Panel → Problems → Recovery**.
## REST API
- Import: `POST /api/boards/import/mattermost` with the file's text, or a
`.zip` as `{ "zipBase64": "..." }`, as for every source of the import page.
- Export: `GET /api/boards/:boardId/export/mattermost`.
## How it is built and tested
`tests/chatExportFormats.test.cjs` reads a bulk export with a team, a channel, a reply and a direct post, refuses a file without a version line and a line that is not JSON, and exports a board and reads it back.
## Sources
- [Mattermost bulk export](https://docs.mattermost.com/manage/bulk-export-tool.html)
- [Mattermost bulk loading data](https://docs.mattermost.com/onboard/bulk-loading-data.html)
@@ -89,7 +89,10 @@ writes:
Columns are matched by name. The layout follows a real export: the test data
of the [plannr](https://github.com/program--/plannr) package, copied to
`tests/fixtures/planner/`.
`tests/fixtures/planner/`. The newer Planner's **Export as Excel** is described by
Microsoft's [Export a plan to Excel](https://support.microsoft.com/en-us/planner/export-a-plan-to-excel)
with Status, Task title and Assignments; those names are read as Progress,
Task Name and Assigned To.
What the import covers:
@@ -100,7 +100,8 @@ What the current code does (`parseNextcloudDeck` in
mark a card done with a timestamp). Either form, a date or Deck's REST API's
plain `true`, marks the card's due date done. A card without a due date has
no due date to mark, so `true` alone is not kept for it.
- Label colors are not read: labels are created black.
- A label keeps its color (Deck's hex `color`, such as `0082c9`); a label
without one is created black.
## What is kept
@@ -116,12 +117,13 @@ What the current code does (`parseNextcloudDeck` in
| `archived: true` | Archived card |
| `assignedUsers` | Card members, when mapped |
| `owner` | Requested by |
| `labels` (title) | Board labels |
| `labels` (`title`, `color`) | Board labels, with their colors |
| `comments` (`message`, `actorId`, `creationDateTime`) | Comments |
The export writes the board `title` and a stack per list, in order. Each card
has `title`, `description`, `duedate`, the labels as `{ title }`, `createdAt`,
the end date as `done`, the owner and further people as `assignedUsers`, the
the end date as `done` (or `done: true` for a due date ticked done without an
end date), the owner and further people as `assignedUsers`, the
creator as `owner` and the comments.
## Attachment files
@@ -118,7 +118,9 @@ them:
and a range `A → B`. WeKan also reads `YYYY-MM-DD`, `MM/DD/YYYY` and a
`(GMT+3)` style zone at the end. A time without a zone is taken as UTC.
- Checkboxes are `Yes` and `No`.
- Relations are the related page's title and its encoded path or URL.
- Relations are the related page's title and its encoded path or URL. A
related page that is one row of the export, in any of its databases, is a
"related to" dependency between the two cards.
- A row's page file starts with `# Title`, a blank line, one
`Property: value` line per non-empty property, a blank line, then the page
body.
@@ -262,7 +264,8 @@ The export writes, per card:
The import reports these on the loss report, rather than dropping them
silently:
- relation columns (links to other pages);
- a relation to a page that is not a row of the export, or to a title that
two rows share (it is not guessed which one);
- a **Last edited time** column;
- date columns after the ones above; they are kept as text fields, and the
report says which column was the due date;
@@ -97,7 +97,12 @@ What the import must cover:
- deeper outlines become checklists, with their descendants as items
(completed = finished);
- the head title becomes the board title;
- a list's note and `url` / `htmlUrl` / `xmlUrl` links are reported.
- on a card, OPML 2.0's `created` becomes the creation date and `category`
the labels, a `url` / `htmlUrl` / `xmlUrl` link goes at the end of the
description, and any other attribute (OmniOutliner writes its columns this
way) becomes a custom field;
- a list's note, and an attribute of a list or a checklist item, are
reported.
The export writes the same, with Workflowy's attribute names. Line breaks in
notes survive as `&#10;`. The file is parsed on the server only, and DTDs and
@@ -122,9 +127,10 @@ What the export writes (`models/lib/opmlOutlineFormat.js`):
- `<opml version="2.0">` with the board title in `<head><title>`;
- each list as a top-level `<outline text="…">`, including lists without
cards;
- each card as a child outline, with its description as `_note` and
- each card as a child outline, with its description as `_note`,
`_complete="true"` when its list's name looks finished (contains "done",
"closed", "complete", "archiv" or "finished");
"closed", "complete", "archiv" or "finished"), its creation date as
`created` (RFC 822) and its labels as `category`;
- each checklist as a child of the card, with its items as children,
`_complete="true"` when finished.
@@ -140,6 +146,10 @@ reader gives them back. Archived cards and archived lists are not exported.
| Level 2 outline: `text` (or `title`) | Card title |
| Level 2 outline: `_note` | Card description |
| Level 2 outline: `_complete` / `complete` = true | Card with the label `done` |
| Level 2 outline: `created` | Creation date |
| Level 2 outline: `category` (comma-separated, leading `/` taken off) | Labels |
| Level 2 outline: `url`, `htmlUrl`, `xmlUrl` | A link at the end of the description |
| Level 2 outline: any other attribute | Custom field of that name (a leading `_` taken off) |
| Level 3 outline with children | Checklist, its descendants the items |
| Level 3 outline without children | Item of a checklist named after the card |
| Completed item | Finished checklist item |
@@ -149,14 +159,17 @@ reader gives them back. Archived cards and archived lists are not exported.
The import reports these on the loss report:
- a `_note` on a top-level (list) outline;
- `url`, `htmlUrl` and `xmlUrl` attributes, on any outline;
- an attribute of a list or a checklist item other than its text and
complete state;
- a `created` that is not a date;
- outlines deeper than 64 levels.
Other attributes, such as `created`, are not read.
`type`, `isComment` and `isBreakpoint` only say how an outliner draws a row,
and are not read.
The OPML export writes only lists, cards, notes, the complete state and
checklists. It does not write swimlanes, labels, dates, members, comments,
custom fields or attachments.
The OPML export writes lists, cards, notes, the complete state, the creation
date, labels and checklists. It does not write swimlanes, other dates,
members, comments, custom fields or attachments.
## REST API
@@ -133,9 +133,11 @@ What the current code does (`parseOpenProject` in
(`_embedded.schemas`, or a work package's `_embedded.schema`); without a
schema the field keeps the name `customFieldN`. Values are read from the
work package (`raw` for formatted text) and from `_links` (the title).
- `estimatedTime` (ISO 8601 duration) becomes the custom field **Estimated
time (hours)**, and `percentageDone` the custom field **Progress (%)**.
`spentTime` becomes the card's spent hours.
- `estimatedTime` and `remainingTime` (ISO 8601 durations) become the custom
fields **Estimated time (hours)** and **Remaining time (hours)**, and
`percentageDone` the custom field **Progress (%)**. `spentTime` becomes the
card's spent hours, and the export writes a card's spent hours back as
`spentTime` (`PT1.5H`).
- Relations embedded on a work package are kept from their `from` side:
`blocks`, `blocked` (is blocked by), `duplicates`, `duplicated`; any other
type is kept as related-to.
@@ -161,7 +163,7 @@ What the current code does (`parseOpenProject` in
| Embedded `relations` | Dependencies |
| Embedded `watchers` | Card watchers, when mapped to a board member |
| Type, priority, category, version | Labels |
| `customFieldN`, `estimatedTime`, `percentageDone` | Custom fields |
| `customFieldN`, `estimatedTime`, `remainingTime`, `percentageDone` | Custom fields |
| `storyPoints` | Number field **Story points**, the Scrum estimate |
| `version`, `sprint`, `position` | Scrum release, sprint, backlog rank |
| Embedded comment activities | Comments |
@@ -3,8 +3,9 @@
WeKan imports and exports a board as an [Org mode](https://orgmode.org/manual/)
outline: the `.org` text file that Emacs, Orgzly, Beorg and organice write.
Top-level headings are lists and second-level headings are cards. TODO
keywords, priorities, tags, SCHEDULED, DEADLINE and CLOSED dates, the
`:CREATED:` property, body text and checkboxes are kept.
keywords, priorities, tags, SCHEDULED, DEADLINE and CLOSED dates and their
daily, weekly or monthly repeaters, properties, clocked time, body text and
checkboxes are kept.
## How to import
@@ -86,16 +87,21 @@ What the import must cover:
keyword as the `done` label);
- priorities become `priority:A` labels, and tags become labels;
- SCHEDULED / DEADLINE / CLOSED become the start, due and end dates;
- `:CREATED:` becomes the creation date;
- `:CREATED:` becomes the creation date, `:ID:` (or `:CUSTOM_ID:`) the card's
source reference, and every other property a custom field of that name;
- the closed `CLOCK:` lines of the `:LOGBOOK:` drawer add up to the spent
time;
- a `+1d`, `+1w` or `+1m` repeater (also `++` and `.+`) makes the card repeat
daily, weekly or monthly;
- body text becomes the description;
- checkboxes and level-3 headings without children become the card's
checklist, and level-3 headings with children become checklists of their
own;
- `#+TITLE` becomes the board title.
Timestamps have no zone in Org, and are read and written as UTC. Repeaters
and warning delays, text under a list heading and text before the first
heading are reported. Comments have no place in Org and are not exported.
Timestamps have no zone in Org, and are read and written as UTC. Other
repeaters and warning delays, other drawers, open clocks, text under a list
heading and text before the first heading are reported. Comments have no place in Org and are not exported.
What the current code does (`models/lib/orgModeFormat.js`):
@@ -107,8 +113,10 @@ What the current code does (`models/lib/orgModeFormat.js`):
- A planning line (SCHEDULED, DEADLINE, CLOSED) is read when it comes before
the body text. A timestamp may be active `<…>` or inactive `[…]`, with or
without a time.
- Of the property drawer, only `:CREATED:` is read. Other drawers (such as
`:LOGBOOK:`) are skipped.
- The property drawer is read whole: `:CREATED:`, `:ID:` / `:CUSTOM_ID:`, and
every other property as a custom field (a `:NAME+:` line appends to it). The
`:LOGBOOK:` drawer gives the spent time; its state-change notes are history
and are not kept. Any other drawer is reported.
- `- [ ]`, `+ [ ]` and numbered checkbox lines in the body become the first
checklist, named after the card, together with level-3 headings that have
no children. A level-3 heading with children is a checklist named after it,
@@ -129,7 +137,9 @@ What the export writes (`formatOrgMode` in the same module):
Org does not allow in a tag become `_`);
- `SCHEDULED:` (start date), `DEADLINE:` (due date) and, for a done card,
`CLOSED:` (end date);
- the creation date as `:CREATED:` in a property drawer;
- the creation date as `:CREATED:` and the custom fields as properties in a
property drawer (a space in a field name is written as `_`);
- a repeating card's repeater on its DEADLINE (`+1d`, `+1w`, `+1m`);
- the description, indented three spaces;
- each checklist as `*** <checklist>` with `**** TODO` / `**** DONE` items.
@@ -149,6 +159,10 @@ Archived cards and archived lists are not exported.
| DEADLINE | Due date |
| CLOSED | End date |
| `:CREATED:` property | Creation date |
| `:ID:` / `:CUSTOM_ID:` property | Source reference |
| Any other property | Custom field |
| `CLOCK:` lines in `:LOGBOOK:` | Spent time |
| `+1d` / `+1w` / `+1m` repeater | Daily / weekly / monthly recurrence |
| Body text | Card description |
| `- [ ]` / `- [X]` checkboxes, level-3 headings without children | Checklist named after the card |
| Level-3 heading with children | Checklist, its descendants the items |
@@ -159,14 +173,14 @@ The import reports these on the loss report:
- text before the first heading (other than `#+` lines);
- text under a level-1 (list) heading;
- a repeater (`+1w`) or warning delay (`-2d`) on a planning timestamp: the
date is kept, the repeat is not;
- a SCHEDULED, DEADLINE or CLOSED value that is not a date.
- a repeater other than every 1 day, week or month (`+2w`), or a warning
delay (`-2d`): the date is kept, the repeat is not;
- a SCHEDULED, DEADLINE or CLOSED value that is not a date, and a `:CREATED:`
that is not one;
- a property line that is not `:NAME: value`, an open clock (no end), and any
drawer other than PROPERTIES and LOGBOOK.
Properties other than `:CREATED:` and other drawers are skipped without a
report.
The Org mode export does not write swimlanes, members, comments, custom fields
The Org mode export does not write swimlanes, members, comments, spent time
or attachments.
## REST API
@@ -89,6 +89,8 @@ Limit: 20,000 cards. Every card goes to the swimlane Default.
| Planka | WeKan |
| --- | --- |
| Board `name` | Board title |
| v2 `customFieldValues` (`content`), named by `customFields` and `customFieldGroups` | Custom fields of the field's name (`Group: Field` when two groups have a field of that name) |
| Card `stopwatch.total` (seconds) | Spent time (hours) |
| Lists (`active`, `closed`) | Lists, in order |
| Card `name` | Card title |
| `description` | Card description |
@@ -108,8 +110,7 @@ The import reports these on the loss report:
- cards in the Planka trash;
- attachments: they are files on the Planka server;
- custom field values;
- the stopwatch time;
- a custom field value of a field the export does not name;
- a due date that is not a date;
- a second list with the same name (it is imported as `<name> (2)`);
- a card whose list is not on the board;
Loaded 100 of 619 files, more files were not shown because too many files have changed in this diff. Show more