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.