You are here: start » en » Internal Documentation » DokuWiki extensions (WvdS) » Boards » Quickstart: move the first card on a board

Quickstart: move the first card on a board

The shortest way from “the plugin is installed” to “a card has moved, and the change is in the work item's history”. Three steps, about five minutes.

Prerequisites

  • wkdoboards, wkdoworkitems, wkdocore, wkdostorage and wkcore are installed and enabled.
  • A project with at least one work item. A board is a view of items; an empty project shows an empty board and says so: No work items in this project yet.
  • Your account holds a role in that project which permits editing.

There is nothing to set up. The board keeps no state of its own beside the work items; a column is a field value, not a place.

Step 1: open the board

Open the project's Boards hub:

/doku.php?id=en:projects:acme:boards&do=wkdoboards

Step 2: move a card

Select a card, choose a target column under Move to, and submit.

Dragging works too — it is a layer on top that fills in the same command. The command itself is a visible control and reachable without a pointer. That is deliberate: the accessibility guidance has no drag-and-drop pattern, and an explicit move command is the accepted substitute.

Step 3: change the axis

Switch at the top from State to Type or Assignee. The same items regroup.

Your choice is remembered; the board opens on the same cut next time. That preference is also the only thing the board itself stores.

Check the result

  • The message Card moved. appears and the card sits in the new column.
  • Open the work item: under History the change stands as a state change with actor and timestamp. Moving the card was an ordinary work-item edit — attributable, audited, visible.
  • Counter-check on the state machine: on the State axis, attempt a transition your workflow does not permit. It is refused, by the same machine the editor uses. The offered targets come from the machine, not from the column list — a board that allowed what the editor forbids would be a second, disagreeing definition of the workflow.
  • On the Type and Assignee axes that restriction does not exist: those are values, not states, and every target is reachable.

Next step

  • wkdoworkitems — the items the board shows.
  • wkdoqueries — the same set as a filterable grid instead of columns.
  • wkdoboards (German) — the package page: the grouping model.
en/wiki/dwe/wkdoboards/quickstart.txt · Last modified: by 0.0.0.0