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.

Always show the comment icon

Kanboard shows the comment icon on a board card only once it has at least one comment, so adding the first comment means opening the card and finding the sidebar link. With this tweak on, a card with no comments shows a comment bubble with a "+" that opens the same comment modal, letting you add the first comment straight from the board. Cards that already have comments keep showing the count as before.

• Rendered by the template:board:task:icons hook (Template/board/task_comment_icon.php), only when the card has no comments and the user may create one (so it does not show for read-only viewers).
• On by default. Toggle it under "Settings -> Organon Tweaks".

Settings

Global (per Kanboard instance) and admin-only, under "Settings -> Organon Tweaks":

• Always show the comment icon on board cards -- default on.

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.