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, changing color 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.)

See also:

Bugs/Feature Requests

Existing bugs and feature requests for CardsPlugin are here.

If you have any issues, create a new ticket.


3 / 3


3 / 5


1 / 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:
    • Trac >=1.4: $ easy_install
    • Trac >=1.2: $ easy_install
    • Trac 1.0: $ 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.


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

17667 by psuter on 2020-01-26 15:49:22
CardsPlugin: Python3 compatibility.
(fix #13735)
17465 by psuter on 2019-08-25 15:07:23
CardsPlugin: Support Trac 1.5.1+ using Jinja templates.
Bump version to 1.4
(see #13592)
17464 by psuter on 2019-08-25 15:05:09
CardsPlugin: tag version 1.3

Version 1.3 is compatible with Trac 1.2.

Refs #13592.



Author: psuter
Maintainer: Peter Suter

Last modified 2 years ago Last modified on Apr 27, 2022, 7:28:27 AM

Attachments (1)

Download all attachments as: .zip