mirror of
https://github.com/wekan/wekan.git
synced 2026-11-07 02:52:33 -05:00
Lauri Ojansivu
7595727917
A board can let every signed-in user edit it, when Admin Panel / Settings / Visibility allows it: a non-member then comments, edits and moves cards like a Normal member, and their first edit makes them one. Board-wide settings stay members-only. Lists can allow or refuse editing and commenting per role (list menu, board admins): built-in roles, custom roles and, on an open board, everyone signed in. The server applies it to card, checklist, attachment and comment writes and to moves into the list; the REST API honours a list's refusal on every per-list card route. A direct client write of the setting is refused and shown in Admin Panel / Problems. Every board has a key, unique in the instance, suggested from its title and set for existing boards at startup; card numbers show as KEY-7 and searching for KEY-7 finds the card. Shared labels in Admin Panel / Labels, for every board or an organization's or team's boards; a board uses them beside its own, and a rename or colour change reaches every board that uses it. New strings translated in all languages. Low confidence: chr, tlh, wal, ay, ace, nah, gn, iu, zgh, rup, wo, se, ff, tig, vo, bm, kl, bua, nap, mai, to, ks, qu, bo, fj, haw, om, ss, ts, ve-PP, lld, scn. Thanks to Meeques, justinr1234, tiFabGrinch, ejlkemper and xet7 ! Fixes #4575, Fixes #4527, Fixes #2449, Fixes #2450, Fixes #2761, Fixes #4698.
55 lines
2.5 KiB
JavaScript
55 lines
2.5 KiB
JavaScript
'use strict';
|
|
|
|
// Shared labels (#2761, #4698; decided 2026-10-14): an instance-wide catalog
|
|
// in the Admin Panel, plus catalogs per organization and per team. A board uses
|
|
// shared labels beside its own.
|
|
//
|
|
// A shared label is used on a board by COPYING it into board.labels, linked by
|
|
// `sharedLabelId`. Everything that already works on board labels - filters,
|
|
// rules, exports, imports, the minicard - then works on shared ones too, with
|
|
// nothing to learn. Renaming or recolouring a shared label updates every copy;
|
|
// deleting it leaves the copies as the boards' own labels.
|
|
// Pure: tests/sharedLabels.test.cjs.
|
|
|
|
const SCOPES = ['instance', 'org', 'team'];
|
|
const NAME_MAX = 100;
|
|
|
|
function activeIds(list, idField) {
|
|
return new Set((Array.isArray(list) ? list : []).filter(x => x && x.isActive !== false && x[idField]).map(x => x[idField]));
|
|
}
|
|
|
|
/** May this shared label be used on this board? */
|
|
function availableOn(label, board) {
|
|
if (!label || !board) return false;
|
|
if (label.scope === 'instance') return true;
|
|
if (label.scope === 'org') return activeIds(board.orgs, 'orgId').has(label.scopeId);
|
|
if (label.scope === 'team') return activeIds(board.teams, 'teamId').has(label.scopeId);
|
|
return false;
|
|
}
|
|
|
|
/** The shared labels a board may use that it does not have yet. */
|
|
function offeredTo(board, sharedLabels) {
|
|
const have = new Set((board && board.labels || []).map(l => l && l.sharedLabelId).filter(Boolean));
|
|
return (Array.isArray(sharedLabels) ? sharedLabels : []).filter(l => availableOn(l, board) && !have.has(l._id));
|
|
}
|
|
|
|
/** The board's copy of a shared label. `newId` makes the board-label id. */
|
|
function boardCopyOf(label, newId) {
|
|
return { _id: newId, name: label.name || '', color: label.color, sharedLabelId: label._id };
|
|
}
|
|
|
|
/** A label to save, cleaned and checked; throws a message key when it is not. */
|
|
function cleanSharedLabel(input, isAllowedColor) {
|
|
const name = String(input && input.name || '').trim();
|
|
const color = String(input && input.color || '').trim();
|
|
const scope = String(input && input.scope || '');
|
|
const scopeId = scope === 'instance' ? null : String(input && input.scopeId || '');
|
|
if (name.length > NAME_MAX) throw new Error('shared-label-name-too-long');
|
|
if (!isAllowedColor(color)) throw new Error('shared-label-color');
|
|
if (!SCOPES.includes(scope)) throw new Error('shared-label-scope');
|
|
if (scope !== 'instance' && !scopeId) throw new Error('shared-label-scope');
|
|
return { name, color, scope, scopeId };
|
|
}
|
|
|
|
module.exports = { SCOPES, NAME_MAX, availableOn, offeredTo, boardCopyOf, cleanSharedLabel };
|