38 lines
1.5 KiB
Markdown
38 lines
1.5 KiB
Markdown
# OrganonTweaks -- umbrella plugin for small Kanboard tweaks
|
|
|
|
A home for small, unrelated Kanboard adjustments that are not big enough to deserve their
|
|
own plugin. Each tweak is self-contained; more will be added over time. If a tweak grows
|
|
into a real subsystem it graduates into its own plugin (see PLAN-organon-tweaks-plugin.md).
|
|
|
|
## Tweaks
|
|
|
|
### Remove an empty column
|
|
|
|
Adds a **Remove this Column** entry (trash icon) to a board column's header dropdown, next
|
|
to the other column actions. It appears only when the column is completely empty -- no
|
|
tasks, open or closed -- because Kanboard's column removal is a plain delete and a non-empty
|
|
column would orphan its tasks. Clicking it asks for confirmation, then removes the column
|
|
and returns to the board.
|
|
|
|
- The menu entry is rendered by the `template:board:column:dropdown` hook (which sits
|
|
outside the native menu list), then moved into the menu by `Asset/js/relocate.js`.
|
|
- The empty check counts open and closed tasks via a helper
|
|
(`Helper/OrganonColumnHelper.php`, `taskFinderModel->countByColumnId(...)`), since the
|
|
board's own count is open-only.
|
|
- Only users allowed to manage columns see it, and the controller re-checks both the
|
|
permission and the emptiness before deleting.
|
|
|
|
## Requirements
|
|
|
|
- Kanboard >= 1.2.0
|
|
|
|
## Installation
|
|
|
|
Copy this folder into your Kanboard installation as `plugins/OrganonTweaks/`. The directory
|
|
name must be exactly `OrganonTweaks` (Kanboard derives the plugin namespace from the folder
|
|
name). No build step and no database migration.
|
|
|
|
## License
|
|
|
|
AGPL-3.0. See LICENSE.
|