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.