Sorting cards in stacks


This macro [[Cards(...)]] shows a whiteboard containing index cards organized in stacks. Adding new cards interactively by clicking a button, move cards by drag-and-drop and double-click cards for editing or deleting.

Cards are stored in a new table in the Trac database.


The following code in the Trac wiki page:

[[Cards(stack=todo|wip|done,label=To Do|Work in Progress|Done, width=800)]]

will produce the following capabilities:

Example screenshot

Collaboration support

  • Edit conflicts are detected automatically.
  • A refresh button allows manually reloading the cards at any time.
  • The cards are automatically reloaded every ten seconds while they are in view.

Known Limitations

  • There is no history or undo functionality.
  • There is no tracking of users. Everyone with CARDS_ADMIN permission can freely edit any card.


  • stack: |-separated list of stack names. (required)
  • label: |-separated list of stack labels shown instead of the stack names. (Defaults to the stack names.)
  • width: Width of the whiteboard. (Defaults to 400.)

Bugs/Feature Requests

Existing bugs and feature requests for CardsPlugin are here.

If you have any issues, create a new ticket.


2 / 2


0 / 1


Download the zipped source from here.


You can check out CardsPlugin from here using Subversion, or browse the source with Trac.


General instructions on installing Trac plugins can be found on the TracPlugins page.

  1. Install as follows: $ easy_install
  2. Enable the plugin in Trac's plugin admin page or in your trac.ini file:
    cards.* = enabled
  3. Update database: trac-admin path/to/trac/environment upgrade.
  4. Assign the CARDS_ADMIN permission to the users who need this plugin's functionality, for example in permission admin panel.


Optionally, some trac.ini options can be changed from the defaults:

auto_refresh = True
auto_refresh_interval = 10

Recent Changes

14840 by psuter on 2015-07-21 16:02:28
CardsPlugin: Fix rank ordering of cards.

  • Pause auto-refresh timer during editing etc.
  • Added config options for disabling / tuning auto-refresh.

(fix #12454)

14811 by psuter on 2015-07-17 17:11:32
CardsPlugin: Support for collaborative editing.

  • Conflict detection mechanism.
  • DB upgrade.
  • Refresh button.
  • Auto-refresh every 10 seconds when the cards are visible.
  • Bump version to 1.2

(fix #12428)

14782 by psuter on 2015-07-02 22:47:01
CardsPlugin: Avoid SQL injection
Bump version to 1.1
(see #12423)


Author: psuter
Maintainer: psuter

Last modified 7 months ago Last modified on Mar 23, 2016, 7:15:30 PM

Attachments (1)

Download all attachments as: .zip