# TweakDrag -- board drag, touch and column-gap tweaks

A Kanboard plugin that groups board dragging and spacing tweaks. This first version
provides two options, both configurable under "Settings -> Tweak Drag":

- **Drag the board background to scroll** (desktop) -- click and drag on the empty board
  background to scroll the columns sideways, like the Trello board canvas.
- **Widen the gap between columns** -- spread the columns further apart, easier to tell
  apart and to touch.

These options were originally part of the ShrinkVertically plugin and moved here so that
drag/touch behaviour can grow on its own (planned: mobile drag-to-move cards, and a drag
movement threshold so ending a drag does not open the task) without bloating that plugin.

## How it works

- **Drag to scroll**: a small script (`Asset/js/drag-scroll.js`, loaded only when the
  option is on) starts a horizontal pan on `#board-container` only when the press lands on
  empty background -- pressing a task card, a drag handle or any control is ignored, so
  Kanboard's own card and column drag-and-drop keep working unchanged.
- **Column gap**: the board is a table, so the gap is set with `border-spacing` (injected
  in the page head from `Template/layout/variable.php` only when the option is on), sized
  by the `--td-column-gap` CSS variable. This spreads the columns without shrinking the
  cards and keeps each column header aligned with its list. It also adds some spacing at
  the left and right edges of the board.

## Requirements

- Kanboard >= 1.2.0

## Installation

Copy this folder into your Kanboard installation as `plugins/TweakDrag/`. The directory
name must be exactly `TweakDrag` (Kanboard derives the plugin namespace from the folder
name). No build step and no database migration.

## Settings

These settings are global (per Kanboard instance) and admin-only. Go to
"Settings -> Tweak Drag":

- **Column gap in pixels** -- width of the column gap (`--td-column-gap`). Default: 25.
- **Widen the gap between columns** -- toggles the wider gap. Default: on.
- **Drag the board background to scroll horizontally** -- toggles the Trello-style
  click-and-drag panning. Desktop (mouse) for now. Default: on.

## License

AGPL-3.0. See LICENSE.