Sorting cards in stacks

Description

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.

Example

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:

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.

Parameters

• 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:

• CardsPlugin Sorting cards in stacks
• TicketsBoardPlugin Whiteboard vision of ongoing tickets
• TracKanbanBoardMacro Trac Kanban Board
• WhiteboardPlugin Whiteboard for tickets

Bugs/Feature Requests

Existing bugs and feature requests for CardsPlugin are here.

If you have any issues, create a new ticket.

defect	3 / 3
enhancement	3 / 5
task	1 / 1

Download

Download the zipped source from here.

Source

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

Installation

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

1. Install as follows:
   • Trac >=1.4: $ easy_install https://trac-hacks.org/svn/cardsplugin/trunk.
   • Trac >=1.2: $ easy_install https://trac-hacks.org/svn/cardsplugin/tags/cardsplugin-1.3.
   • Trac 1.0: $ easy_install https://trac-hacks.org/svn/cardsplugin/tags/cardsplugin-1.2.
2. Enable the plugin in Trac's plugin admin page or in your trac.ini file:

   [components]
   cards.* = enabled
   

3. Update database: trac-admin path/to/trac/environment upgrade.

Configuration

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:

[cards]
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.

(more)

Author/Contributors

Author: psuter
Maintainer: Peter Suter
Contributors: