Compare commits

...
83 Commits
Author SHA1 Message Date
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
525 changed files with 42299 additions and 2072 deletions

No files matched your search

+150
View File
@@ -0,0 +1,150 @@
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.
#
# It runs after every "Release All Platforms" run, and by hand from the
# Actions tab for any release, snap names and channels.
#
# 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_run:
workflows: ['Release All Platforms']
types: [completed]
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: ${{ github.event.inputs.tag }}
INPUT_SNAPS: ${{ github.event.inputs.snaps }}
INPUT_CHANNELS: ${{ github.event.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
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
gh release download "$TAG" --repo "$GITHUB_REPOSITORY" --dir snaps --pattern "${SNAP}_*.snap"
ls -l snaps
if ! ls snaps/"${SNAP}"_*.snap >/dev/null 2>&1; then
echo "::error::Release $TAG has no ${SNAP}_*.snap to push."
exit 1
fi
- 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
+646 -633
View File
File diff suppressed because it is too large. Load diff
+15 -12
View File
@@ -5,6 +5,21 @@ each one changed and the project status are in
Written by `node releases/changelog-short.mjs` from CHANGELOG-big.md:
make changes there.
# 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
@@ -40,15 +55,3 @@ 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.21
ARG DEBIAN_FRONTEND=noninteractive
COPY --chmod=755 releases/check-telemetry.py /tmp/check-telemetry.py
+15 -4
View File
@@ -45,7 +45,10 @@ that by providing one-click installation on various platforms.
- 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
- 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, 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
- 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.21.0"
files:
userUploads:
- README.md
+39 -23
View File
@@ -20,28 +20,44 @@ 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
## Import and Export of everything each tool has
- 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.
Asked on 2026-11-20: check and fix that everything each tool with a WeKan
import or export can hold comes across, whether a whole export is read or
written at once or only a part of it (a board, a project, some lists, a date
range), and check each tool's newest features - what its current version
exports and imports - so their data has a place in WeKan too. For every tool,
compare its newest export file, documentation and changelog with the parser
and the formatter here, record what is lost in the import loss report
(`unsupported`), and add what has a place in WeKan.
Done so far: `tests/playwright/specs/export-import-round-trip.e2e.js` exports
a board in each of the 41 formats WeKan both writes and reads and imports the
file back; every one brings the card back, and its KEEPS table holds each
format to what its file keeps of the description, the checklist and the
comment, so a format that loses more fails. The Trello export imports back
with checklists, comments, members, custom fields and archived cards and
lists, and a Trello .zip export carries the attachment files; the GitHub,
Gitea and Forgejo exports carry the comments. What is left below is per tool: the
tool's newest features against its parser and formatter.
- WeKan's own JSON and .zip: every field of the current schema, attachments
and their versions, custom fields, rules, templates, Scrum data, and a part
of a board as well as all of it.
- Kanban and project tools: Kanboard, Nextcloud Deck, OpenProject, Asana,
Zenkit, Planner, monday.com, Wrike, Teamwork, Businessmap, ClickUp, Notion,
Plane, Taiga, Focalboard, Nullboard, Kanri, Obsidian Kanban, MeisterTask,
Quire, Planka, KanbanFlow, Basecamp - sub-items, dependencies, time
tracking, custom fields, comments, attachments and their newer views.
- Issue trackers: Jira, GitHub, GitLab, Gitea, Forgejo, Redmine, Linear,
Pivotal - epics, sprints, versions and milestones, links between issues,
work logs, reactions, and fields added in their newest releases.
- Task tools: Todoist, TickTick, Tasks.org, Super Productivity, todo.txt,
Taskwarrior, Vikunja, Microsoft To Do, Google Tasks, Google Keep -
recurrence, reminders, priorities, sub-tasks and sections.
- Spreadsheets, text and outlines: CSV / TSV, Excel, Markdown, Leo, OPML,
Org mode - every column, and every Org property and timestamp.
- Mail, calendars and chats: mail, mbox, iCalendar, Google Takeout, Slack,
Mattermost, Telegram, WhatsApp, Discord, Evernote .enex - threads, replies,
reactions, recurring events and the attached files that are now only
counted.
+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'}
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'}
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');
+21 -1
View File
@@ -238,11 +238,17 @@ 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: '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 },
@@ -316,7 +322,21 @@ 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".
.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) : 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);
},
+15 -3
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 = {
@@ -62,6 +65,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 +205,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 /
+81 -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,18 @@ 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.
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) : 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
@@ -0,0 +1,68 @@
# 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.
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.
## What is not kept
Attachments and stickers (counted), embeds, reactions. 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,11 @@ 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.
- **Rules and workflows**: **Board Settings → Rules → Import / Export rules**
(see [Rules](../../../Rules/Rules/Rules.md#import--export)).
@@ -84,6 +89,23 @@ 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 | — |
| [Evernote (.enex)](./Evernote/Evernote.md) | Notes export `.enex` | Evernote (.enex) |
## WeKan's own formats and documents
| Format | Import | Export |
@@ -92,7 +114,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 +140,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) 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
@@ -93,6 +93,14 @@ 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 | — |
| [Evernote](./Evernote/Evernote.md) | yes | yes |
The [overview](./External-Tools.md) groups them by kind.
@@ -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)
@@ -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/)
@@ -0,0 +1,87 @@
# 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.
## What is not kept
Attachments (counted), reactions, 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)
@@ -0,0 +1,74 @@
# Slack
WeKan imports a Slack workspace export `.zip` as a board for **Board View →
Chat**: each channel is a card, and its messages and thread replies are the
card's comments, by their author and time.
## How to import
1. In Slack, open the workspace settings, choose **Import/Export Data →
Export**, start the export and download the `.zip` when Slack mails the
link.
2. In WeKan, go to **All Boards → New → Import → Slack**.
3. Choose the `.zip` file.
4. Map the Slack users to WeKan members, or leave them as they are.
5. Click **Import**, and open the board in **Board View → Chat**.
## How to import many boards at once
1. On the import page, choose **Slack**, 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.
Slack 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 slack FILE_OR_DIR ...
```
## How to export
Slack 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
Slack 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 export has `users.json`, `channels.json` (and `groups.json`, `dms.json`,
`mpims.json` when the export holds them) and each conversation's days as
`<channel>/<YYYY-MM-DD>.json` (`server/lib/chatArchives.js`). Public channels
go to the list **Channels**, private ones and group messages to **Groups**,
direct messages to **Direct messages** (`models/lib/chatExportFormats.js`).
Mentions `<@U123>` become `@name`, channel links `#name`, links their text with
the address; a thread reply starts with `↳`. Join and leave messages are left
out.
## What is kept
Channels with their topic and purpose, every message and thread reply with its author and time.
## What is not kept
Files and images (counted in the loss report), reactions, edits and pins. The zip is read within the same bounds as the other zip imports. 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/slack` 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` builds a Slack export zip with two days, a thread reply, a file, a join message and mentions, and refuses a zip that is not a Slack export.
## Sources
- [Slack: Export your workspace data](https://slack.com/help/articles/201658943)
- [Slack: How to read Slack data exports](https://slack.com/help/articles/220556107)
@@ -0,0 +1,71 @@
# Telegram
WeKan imports Telegram Desktop's JSON export as a board for **Board View →
Chat**: each chat is a card and its messages are the card's comments.
## How to import
1. In Telegram Desktop, open **Settings → Advanced → Export Telegram data**
(or a chat's menu → **Export chat history**), choose the format
**Machine-readable JSON**, and export.
2. In WeKan, go to **All Boards → New → Import → Telegram**.
3. Choose `result.json`, or paste its 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 **Telegram**, 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.
Telegram 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 telegram FILE_OR_DIR ...
```
## How to export
Telegram 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
Telegram 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
One chat's export is `{ name, type, messages }`; the whole account's has
`chats.list` (`models/lib/chatExportFormats.js`). Personal and bot chats and
Saved Messages go to **Direct messages**, groups and supergroups to
**Groups**, channels to **Channels**. A message's text, a string or a list of
text parts and entities, is joined into plain text; its time is
`date_unixtime`. Service messages (a member joined, a title changed) are left
out.
## What is kept
Chats, message text, author and time.
## What is not kept
Photos, files, stickers and voice messages (counted), reactions, edits, replies as links. 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/telegram` 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 one chat with text entities, a service message and a photo, and an account export with two chats, and refuses JSON that is neither.
## Sources
- [Telegram Desktop](https://desktop.telegram.org/)
@@ -128,6 +128,22 @@ label. WeKan's Trello import turns those labels back into swimlanes.
The file is read by WeKan's Trello import and by other tools that import
Trello exports.
The file has the cards with their checklists, comments (as `commentCard`
actions), members, custom fields and dates, and the archived cards and lists
as closed ones. WeKan's Trello import reads all of it back.
### As a Trello .zip, with the attachments
1. In WeKan, open the board, then **Board Settings → Export**.
2. Choose **Trello .zip Attachments**. The download is `trello.zip`: the
Trello JSON as `board.json`, and each card's attachments as files under
`attachments/`, named `<id>_<file name>`.
3. Import it into another WeKan with **Import → Trello**, choosing the `.zip`:
the attachments come back with the cards.
The `.zip` is written a page of cards at a time, and the files are streamed
from storage, so a large board does not have to fit in memory.
## How to export all boards at once
1. **All Boards → sidebar → Export all boards**, then choose **Trello**.
@@ -0,0 +1,71 @@
# WhatsApp
WeKan imports a WhatsApp chat export `.txt` as a board for **Board View →
Chat**: the chat is a card and its messages are the card's comments.
## How to import
1. In WhatsApp, open the chat, then **⋮ → More → Export chat** (iPhone:
the chat's name → **Export Chat**), choose **Without media**, and save the
`.txt` file.
2. In WeKan, go to **All Boards → New → Import → WhatsApp**.
3. Choose the `.txt` file, or paste its text.
4. Map the senders 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 **WhatsApp**, 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.
WhatsApp 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 whatsapp FILE_OR_DIR ...
```
## How to export
WhatsApp 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
WhatsApp 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
One line per message in the phone's date format: Android
`16/11/2026, 10:00 - Name: text`, iPhone `[16/11/2026, 10:00:00] Name: text`,
with dots or slashes, 12- or 24-hour time, and Finnish `klo`
(`models/lib/chatExportFormats.js`). A line without a date continues the
message above it. Day and month are read day first unless a day number over 12
shows the month comes first. The times have no time zone in the file and are
read as UTC. A chat of more than two people goes to **Groups**.
## What is kept
Every message with its sender and time, multi-line messages.
## What is not kept
Media (`<Media omitted>`, attached files - counted), system lines such as the encryption notice. 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/whatsapp` 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 Android, US (AM/PM) and iPhone lines, multi-line messages, system lines and media, and refuses text with no dated line.
## Sources
- [WhatsApp Help: How to export your chat history](https://faq.whatsapp.com/1180414079177245)
@@ -9,8 +9,16 @@ not create a board, and it has no entry on the import page.
## How to import
The `.ics` import is available through the REST API and `api.py`, not on the
import page.
On the import page: **All Boards → New → Import → iCalendar (.ics)**, then
choose the `.ics` file or paste its text. A new board is made: tasks (`VTODO`)
go to **To Do**, **In Progress**, **Done** or **Cancelled** by their `STATUS`,
events (`VEVENT`) to **Events**, with their start, due and completion dates;
`CATEGORIES` and `PRIORITY` become labels, a subtask (`RELATED-TO`) keeps its
parent, and the calendar's name is the board's title. A repeating item
(`RRULE`) is imported once, and that is in the loss report
(`models/lib/icalendarFormat.js`, `tests/icalendarFormat.test.cjs`).
Into an existing list of a board, through the REST API and `api.py`:
1. Get the `.ics` file from the calendar app. In Google Calendar on a
computer: under **My calendars**, point at the calendar, click **More →
@@ -7,3 +7,17 @@ lists. The same-width setting applies a common width to the board's lists.
These switches moved from header controls into this popup. The list menu no
longer has a **Set width** entry. See [Lists](../../Lists/Lists.md) for creation,
multiline names, collapse state and list actions.
## Flow policies
Below the width switches, a board administrator turns on the Kanban flow
policies of the board's lists, each also a feature of Admin Panel / Settings /
Features:
- **Show list policies**: each list's policy (when a card may come in, and when
it is done there) is written from the list menu and shown at its header.
- **Allow lists split into Doing and Done**: a list is then split from its menu.
- **Commitment point**: the list from which work is committed to.
- **WIP limit per person**: how many open cards one person may hold.
See [flow policies](../../Lists/Flow-Policies.md).
@@ -17,11 +17,12 @@ entries.
| Board announcement | [A message shown to everyone on the board](Board-Announcement.md) | Board admin |
| Change Background Image | [Upload and choose a background](Background-Image.md) | Board admin |
| Date | [Board date override and week numbers](Date.md) | Board admin for the format |
| All Boards Settings | [What the All Boards tile shows, card aging, auto-archive, list widths](All-Boards-Settings.md) | Board admin |
| Board View | [Visible views, defaults and menu order](Board-View.md) | Board admin |
| Swimlane | [Height resize lock and WIP Limit Groups](Swimlane.md) | Board admin |
| List | [Width resize lock and same width for all lists](List.md) | Board admin |
| Card | [Field visibility and order](Card.md) | Board admin; personal Labels text remains available to members |
| Export | [Export board content](Import-Export.md) | Export must be enabled |
| List | [Width resize lock, same width for all lists, and the flow policies: list policies, split lists, commitment point, WIP limit per person](List.md) | Board admin |
| Card | [Field visibility and order, including the flow fields Blocked, Class of service, MoSCoW and WSJF](Card.md) | Board admin; personal Labels text remains available to members |
| Export | [Export board content](Import-Export.md), in WeKan's own formats and some sixty other tools' - every format written a page of cards at a time | Export must be enabled |
| Import | [Import into the board](Import-Export.md) | Write access; import must be enabled |
| Notifications | [Board delivery defaults](Notifications.md) | Board admin |
| Outgoing Webhooks | [Send events to integrations](Outgoing-Webhooks/Discord/Outgoing-Webhook-to-Discord.md) | Board admin |
@@ -29,16 +30,18 @@ entries.
| Original positions | [Where swimlanes, lists and cards were made, and what moved](../../General/Original-Positions/Original-Positions.md) | Everyone who can see the board |
| Summary | [The board at a glance](../../General/Summary/Summary.md) | Everyone who can see the board; hidden by its switch in Admin Panel / Settings / Features |
| Since your last visit | [What changed since you were here](../../General/Since-Last-Visit/Since-Last-Visit.md) | Everyone who can see the board; hidden by its switch in Admin Panel / Settings / Features |
| Daily standup | [A timer giving each member the same timebox](Scrum-Meetings.md) | Everyone who can see the board; hidden by the board's Scrum settings or Admin Panel / Settings / Features |
| Retrospective board | [A new board with Start / Stop / Keep doing and Action items](Scrum-Meetings.md) | Whoever may create boards; hidden by the board's Scrum settings or Admin Panel / Settings / Features |
| Save as Template | [Copy the board into your board templates](../../All-Boards/Templates.md#d-save-an-existing-board-as-a-board-template) | Board admin; not on a template board |
| Move Board to Archive | [Archive the board](../Archive/Archive-and-Delete.md) | Board admin; unavailable on the templates board |
The groups are: Rules and its views; Scrum settings; Change Color to Date (the
board's look); Board View to Card; Export to Outgoing Webhooks; and Archive to
The groups are: Rules and its views; Scrum settings; Change Color to All Boards
Settings (the board's look); Board View to Card; Export to Outgoing Webhooks; and Archive to
Move Board to Archive.
[All Boards Settings](All-Boards-Settings.md) (what the board's tile shows on
All Boards, card aging, auto-archive and personal list widths) has a popup in
the code, but its menu entry is commented out and not shown.
All Boards, card aging, auto-archive and personal list widths) is below Date,
for board admins.
Custom Fields are reached from an opened card's menu, then the settings cog.
Subtasks settings are behind the menu beside an opened card's **Subtasks**
@@ -0,0 +1,33 @@
# Scrum meetings: daily standup timer, retrospective board
Two helpers in the board menu, offline and with no AI
([models/lib/scrumMeetings.js](../../../../models/lib/scrumMeetings.js)). Every
member of the board sees them, next to Summary and Since your last visit.
## Daily standup
**Board menu / Daily standup** lists the board's active members in a shuffled
order (**Shuffle** draws another one). **Start** gives the first person the
timebox - *Minutes per person* in the Scrum settings, 2 by default, 1-15 - and
counts it down; past the timebox the clock turns red and counts on. **Next**
hands over to the next person, and after the last the popup says how long the
standup took. The timer runs in the browser that opened it and writes nothing.
## Retrospective board
**Board menu / Retrospective board** makes a new private board, titled with
this board's name and the day, with the lists of a Start / Stop / Continue
retrospective: **Start doing**, **Stop doing**, **Keep doing** and **Action
items**, and opens it. It is the reader's own board, made through the same
server path as Add Board, so Admin Panel's "who may create boards" applies; the
team is invited the usual way.
## Hiding them
- For one board: the **Scrum settings** (Board menu / Scrum settings) have a
checkbox for each, *Daily standup* and *Retrospective board*, both on.
- For the instance: **Admin Panel / Settings / Features**,
*Daily standup timer* and *Retrospective board*. Feature profiles can hide
them for some users only.
Tests: `tests/scrumMeetings.test.cjs`, `tests/playwright/specs/scrum-meetings.e2e.js`.
@@ -17,11 +17,14 @@ drawn when the server says the user is a board admin (`canAdmin`):
| --- | --- |
| Enable Scrum planning | Whether Scrum planning is on for this board. |
| Product Goal | Free text. |
| Definition of Done | Free text. |
| Definition of Ready | Free text: when a backlog item may be taken into a sprint. Shown to every member in the Scrum views once written. |
| Definition of Done | Free text. Shown to every member in the Scrum views once written. |
| Product Owner | One active board member, or none. |
| Scrum Master | One active board member, or none. |
| Developers | Any number of active board members. |
| Working days | One or more of Monday to Sunday (required). |
| Daily standup, Minutes per person | Whether the board menu offers the [daily standup timer](Scrum-Meetings.md), and each member's timebox. |
| Retrospective board | Whether the board menu offers making a [retrospective board](Scrum-Meetings.md). |
| Estimate source | **Planning poker estimate** or **Numeric custom field**. |
| Custom Fields | The custom field to read estimates from, or none. |
| Estimate unit | Free text, up to 80 characters. |
+1 -1
View File
@@ -24,7 +24,7 @@ board; otherwise the name stays in the title.
## Hiding it
Board Settings / Card row **Action items** (*Show on Card*). A site admin hides
it on every board from Admin Panel / Settings / Visibility / Features / Card
it on every board from Admin Panel / Settings / Features / Card
fields.
## Implementation
+1 -1
View File
@@ -23,7 +23,7 @@ parts"*.
Board Settings / Card row **At risk**: *Show on Minicard* is the triangle,
*Show on Card* the line in the opened card. A site admin hides both on every
board from Admin Panel / Settings / Visibility / Features / Card fields.
board from Admin Panel / Settings / Features / Card fields.
## Implementation
+2 -2
View File
@@ -20,7 +20,7 @@ one place, [Card Settings](Card-Settings.md) - **Board Settings / Card**.
| In which section, and where in it | the row's section, and its place among that section's rows there |
| In what order the sections are | the order of the sections in the Show on Card pane |
| Whether a whole section (Date, Members, ...) is shown on them | the section's own checkbox, left of its title |
| Whether the administrator offers the field at all | Admin Panel / Settings / Visibility / Features |
| Whether the administrator offers the field at all | Admin Panel / Settings / Features |
## The card's sections
@@ -121,7 +121,7 @@ and so on). The opened card and each of its section templates get their own
`CARD_FIELD_TEMPLATES`): the board as its cards see it
(`models/lib/cardShownFields.js` `boardForCard`), whose flags read false for
the rows of a section hidden whole on Show on Card - the same overlay as Admin
Panel / Visibility / Features (`models/lib/cardFieldVisibility.js`), one level
Panel / Settings / Features (`models/lib/cardFieldVisibility.js`), one level
down. It is the same for every card of the board: it does not depend on what
the card holds. The minicard has its own (`boardForMinicard`,
`client/components/cards/minicard.js`). The board itself is never changed. The
@@ -52,7 +52,7 @@ Without a time the due date gets the due date picker's default time, 17:00.
| Show on Card | renaming the title in the opened card |
Both are on by default. A site admin hides it everywhere from Admin Panel /
Settings / Visibility / Features / Card fields. See
Settings / Features / Card fields. See
[Helpers that need no AI](../../General/Assistants/Assistants.md).
## Implementation
+1 -1
View File
@@ -23,7 +23,7 @@ The minicard can show the 85 % date in its dates line, off by default.
Board Settings / Card row **Forecast**: *Show on Card* is the line in the opened
card (on by default), *Show on Minicard* the date in the minicard (off by
default). A site admin hides both on every board from Admin Panel / Settings /
Visibility / Features / Card fields.
Features / Card fields.
## Implementation
+33
View File
@@ -0,0 +1,33 @@
# Flow fields: Blocked, Class of service, MoSCoW, WSJF
Four Kanban and Scrum practices other tools have, as fields of a card. They
need no AI and no network, and are stored on the card (`card.flow`,
[models/lib/cardFlow.js](../../../models/lib/cardFlow.js)).
| Field | What it is |
| --- | --- |
| **Blocked** | The card is impeded. Tick it and say why; WeKan keeps who marked it and since when. The minicard shows a red **Blocked** badge, with the reason as its tooltip. This is the Kanban impediment, kept on the card that waits. |
| **Class of service** | Standard, Fixed date, Expedite or Intangible (the Kanban Method's classes). **Expedite** has a WIP limit of one: only one open card of a board can be Expedite at a time, and a second one is refused until the first is done or archived. |
| **MoSCoW priority** | Must have, Should have, Could have, Won't have. |
| **WSJF score** | Weighted Shortest Job First: business value, time criticality and risk reduction - the cost of delay - divided by the job size, each scored 1, 2, 3, 5, 8, 13 or 20. The score is shown once every part is set. |
## Showing and hiding them
All four are **off until a board turns them on**:
- **Board Settings / Card**, section **Card**: each field has a row with its
*Show on Minicard* and *Show on Card* checkboxes, after Dependencies, and is
moved within the section like any other row.
- **Admin Panel / Settings / Features / Card fields**: unticking
a field hides it on every board of the instance, whatever the boards chose.
Nothing is deleted - ticking it again shows every card as it was.
## Who may change them
Whoever may edit the card. An assigned-only member changes them only on a card
assigned to them. A linked card shows, and changes, the flow of its source
card. The values are written by the server method `setCardFlow`, which checks
the values; a direct client write of `flow` is refused, so who blocked a card
and when are always the server's.
Tests: `tests/cardFlow.test.cjs`.
+1
View File
@@ -25,6 +25,7 @@ opened card and on the minicard, is [Card Settings](Card-Settings.md) -
| Due date typed in the title | [Due date from the title](Dates/Due-Date-From-Title.md) |
| Similar cards | [Similar cards and possible duplicates](Similar-Cards.md) |
| At risk mark | [At risk](At-Risk.md) |
| Blocked, Class of service, MoSCoW, WSJF | [Flow fields](Flow-Fields.md) |
| Members and Assignees popups | [Suggested members](Suggested-Members.md) |
| Forecast done date | [Forecast](Dates/Forecast.md) |
| Checklists → From description | [Checklist or subtasks from the description](Checklist-From-Description.md) |
+7
View File
@@ -72,3 +72,10 @@ purpose-built "sprint" or "story points" object, velocity chart, or
sprint-close/rollover action. If your team needs one of those built in
rather than assembled this way, please open a feature request describing
the exact workflow.
## Meetings
The board menu's [Daily standup timer and Retrospective board](../Board-Sidebar/Board-Settings/Scrum-Meetings.md)
help with the daily standup and the sprint retrospective, and the
[flow policies](../Lists/Flow-Policies.md) page describes the Definition of
Ready beside the Definition of Done.
+1 -1
View File
@@ -22,7 +22,7 @@ suggestion adds the person, as clicking them in the full list does.
## Hiding it
Board Settings / Card row **Suggested members** (*Show on Card*). A site admin
hides it on every board from Admin Panel / Settings / Visibility / Features /
hides it on every board from Admin Panel / Settings / Features /
Card fields.
## Implementation
+1 -1
View File
@@ -42,7 +42,7 @@ lines and a line at most 5,000 points.
Board Settings / Card row **Drawing** (*Show on Card*) - it was called
Whiteboard. A site admin hides it
on every board from Admin Panel / Settings / Visibility / Features / Card
on every board from Admin Panel / Settings / Features / Card
fields. The drawing popup works as before when the whiteboard is hidden.
## Implementation
+2 -2
View File
@@ -22,8 +22,8 @@ visibility depends on your role, the board and the site's settings.
## Newest features
[September 2026 feature guide](Newest-Features.md) links the month's additions
and the current Upcoming features to their instructions. For release status,
[Newest features](Newest-Features.md) links the November and September 2026
additions, including the Upcoming release, to their instructions. For release status,
fixes and version details, use the [changelog](../../CHANGELOG.md).
## Shared reference guides
+37
View File
@@ -0,0 +1,37 @@
# Flow policies: list policies, split lists, commitment point, WIP limit per person
Three Kanban practices for a board's lists, offline and with no AI
([models/lib/boardFlowPolicies.js](../../../models/lib/boardFlowPolicies.js)).
They are taken from the Kanban Guide's practices *make policies explicit* and
*limit work in progress*.
| Practice | What it does |
| --- | --- |
| **List policy** | Each list's own policy: when a card may come into it and when it is done there. Written from the list menu, **List policy**; shown as a gavel at the list header, its tooltip the text. Any member who may edit lists may write it. |
| **Commitment point** | The list from which work is committed to; the lists before it are options. That list's header carries a green flag. |
| **Split list** | A list split into **Doing** and **Done**: a card of it marked *Done here* (the circle at its minicard's corner) waits, dimmed and edged green, to be pulled into the next list, and the header counts *Doing n · Done m*. Turned on for a list in its menu, **Split into Doing and Done**. The mark belongs to the list it was made in, so a card moved on is in Doing of its new list. |
| **WIP limit per person** | How many open cards (not done, not archived) one person may hold on the board, counting a card's assignees, or its members when nobody is assigned. An opened card names each of its people over the limit, in its Members section. |
## Turning them on, and hiding them
All four are **off until a board admin turns them on**, in **Board Settings /
List**: *Show list policies*, *Allow lists split into Doing and Done*,
*Commitment point* (a list, or none) and *WIP limit per person* (1-99, empty
for none).
Each is also a feature of **Admin Panel / Settings / Features**:
*List policies*, *Split lists*, *Commitment point*, *WIP limit per person*. Turned off there,
it is not offered in Board Settings and not drawn on any board; nothing a board
set is deleted, so turning it on again shows every board as it was. Feature
profiles can hide them for some users only.
## Definition of Ready
Beside the Definition of Done, the **Scrum settings** have a **Definition of
Ready**: when a backlog item may be taken into a sprint. Both are shown to
every member in the Scrum views once written, and nothing is drawn while they
are empty; Admin Panel / Features / Scrum views hides them with the views.
Tests: `tests/boardFlowPolicies.test.cjs`,
`tests/playwright/specs/list-flow-policies.e2e.js`,
`tests/playwright/specs/scrum-definition-of-ready.e2e.js`.
+1
View File
@@ -5,6 +5,7 @@ A list's header and its hamburger menu (`client/components/lists/listHeader.jade
- [Lists](Lists.md) — the list header, collapsing and list width
- [List permissions](List-Permissions.md)
- [WIP limits](WipLimit/WipLimit.md) and [WIP limit groups](WipLimit/WIP-Limit-Groups.md)
- [Flow policies](Flow-Policies.md) — list policies, commitment point, WIP limit per person
## List menu
+25 -8
View File
@@ -1,9 +1,27 @@
# September 2026 feature guide
# Newest features
This guide follows the current menus and September's
[changelog](../../CHANGELOG.md). The multiline-creation feature is currently
in **Upcoming**; the remaining topics describe features available in the
current source. Check your installed release before expecting the newest UI.
This guide follows the current menus and the
[changelog](../../CHANGELOG.md). The November 2026 features are in the
**Upcoming** release until it is published; check your installed release
before expecting the newest UI. For all menus, use [Features](Features.md).
## November 2026
| Feature | Where to find it | Instructions |
| --- | --- | --- |
| Twelve more reports: Created vs. Resolved, Net Flow, Time in List and the rest, each with its export bar | Board header / Board View, Reports group | [Board reports](Board-Header/Board-Views/Charts/Board-Reports.md) and [report charts](Board-Header/Board-Views/Charts/Board-Report-Charts.md) |
| Menus grouped under headings | Board View menu; list, card and swimlane menus; Import and Export | [Board View](Board-Sidebar/Board-Settings/Board-View.md) and [formats](Board-Sidebar/Board-Settings/Import-Export/Format-Coverage.md) |
| Kanban and Scrum flow fields: Blocked, Class of service, MoSCoW priority, WSJF score | Board Settings / Card; Admin Panel / Settings / Features / Card fields | [Flow fields](Cards/Flow-Fields.md) |
| List policies, Definition of Ready, commitment point, WIP limit per person | Board Settings / List and Scrum; Admin Panel / Settings / Features | [Flow policies](Lists/Flow-Policies.md) |
| Lists split into Doing and Done | Board Settings / List; the list header | [Flow policies](Lists/Flow-Policies.md) |
| Daily standup timer and retrospective board | Board menu, turned on in Board Settings / Scrum | [Scrum meetings](Board-Sidebar/Board-Settings/Scrum-Meetings.md) and [Scrum settings](Board-Sidebar/Board-Settings/Scrum-Settings.md) |
| Import mail, calendars, chats and notes | Add Board / Import | [Mail](Board-Sidebar/Board-Settings/Import-Export/Mail/Mail.md), [iCalendar](Board-Sidebar/Board-Settings/Import-Export/iCalendar/iCalendar.md), [WhatsApp](Board-Sidebar/Board-Settings/Import-Export/WhatsApp/WhatsApp.md), [Discord](Board-Sidebar/Board-Settings/Import-Export/Discord/Discord.md), [Google Keep](Board-Sidebar/Board-Settings/Import-Export/Google-Keep/Google-Keep.md) |
| Trello export as a .zip with attachments; Trello custom fields and archived items | Board Settings / Export; Add Board / Import | [Trello](Board-Sidebar/Board-Settings/Import-Export/Trello/Trello.md) |
| Every export written a page of cards at a time; large imports streamed to disk within its free space | Board Settings / Export; Add Board / Import | [External tools](Board-Sidebar/Board-Settings/Import-Export/External-Tools.md) and [WeKan](Board-Sidebar/Board-Settings/Import-Export/WeKan/WeKan.md) |
| What each tool's files keep, round-tripped tool by tool | - | [Format coverage](Board-Sidebar/Board-Settings/Import-Export/Format-Coverage.md) |
| Admin Panel Features as a pane of its own | Admin Panel / Settings / Features | [Features](Admin-Panel/Settings/Features.md) |
## September 2026
| Feature | Where to find it | Instructions |
| --- | --- | --- |
@@ -29,6 +47,5 @@ current source. Check your installed release before expecting the newest UI.
| Offices and login-address reporting | Admin Panel / Problems / Offices | [Offices](Admin-Panel/Problems/Offices.md) |
| Per-pane Admin URLs and recovery reports | Admin Panel | [URLs](Admin-Panel/Admin-Panel-URLs.md) and [Problems](Admin-Panel/Problems/README.md) |
For all menus, use [Features](Features.md). Build-system changes, dependency
updates and security fixes are recorded in the changelog; platform installation
instructions remain under [Platforms](../Platforms).
Build-system changes, dependency updates and security fixes are recorded in the
changelog; platform installation instructions remain under [Platforms](../Platforms).
@@ -10,7 +10,7 @@ This is without container (without Docker or Snap).
Right click and download files 1-4:
1. [wekan-13.20-win64.zip](https://github.com/wekan/wekan/releases/download/v13.20/wekan-13.20-win64.zip) or newest available at https://github.com/wekan/wekan/releases/
1. [wekan-13.21-win64.zip](https://github.com/wekan/wekan/releases/download/v13.21/wekan-13.21-win64.zip) or newest available at https://github.com/wekan/wekan/releases/
2. [node.exe](https://nodejs.org/dist/latest-v26.x/win-x64/node.exe)
@@ -22,7 +22,7 @@ Right click and download files 1-4:
6. Double click `mongodb-windows-x86_64-7.0.34-signed.msi` . In installer, uncheck downloading MongoDB compass.
7. Unzip `wekan-13.20-win64.zip` , inside it is directory `bundle`, to it copy other files:
7. Unzip `wekan-13.21-win64.zip` , inside it is directory `bundle`, to it copy other files:
```
bundle (directory)
Loaded 100 of 525 files, more files were not shown because too many files have changed in this diff. Show more