OrganonTweaks/README.md

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.