Nextcloud Deck

You can import tasks from your Nextcloud Deck instance using the deck service name.

This service requires deck to be installed in a Nextcloud installation and available to bugwarrior.

Example Service

Here’s an example of a Nextcloud Deck target:

ini

[my_nextcloud_deck]
service = deck
deck.base_uri = https://nextcloud.example.com
deck.username = my_user
deck.password = my-nextcloud-app-password

toml

[my_nextcloud_deck]
service = "deck"
base_uri = "https://nextcloud.example.com"
username = "my_user"
password = "my-nextcloud-app-password"

The above example is the minimum required to import issues from Deck. You can also feel free to use any of the configuration options described in Common Service Configuration Options or described in Service Features below.

The base_uri should point to the location of your Nextcloud installation. username should be the username of the user that has access to the Deck boards you are interested in. password should be an app-password (or the real password, although that is not recommended) of the user.

Service Features

Import Labels as Tags

The Deck allows you to attach labels to cards. To use those labels as tags, you can use the import_labels_as_tags option:

ini

deck.import_labels_as_tags = True

toml

import_labels_as_tags = true

Also, if you would like to control how these labels are created, you can specify a template used for converting the Deck label into a Taskwarrior tag.

For example, to prefix all incoming labels with the string ‘deck_’ (perhaps to differentiate them from any existing tags you might have), you could add the following configuration option:

ini

deck.label_template = deck_{{label}}

toml

label_template = "deck_{{label}}"

In addition to the context variable {{label}}, you also have access to all fields on the Taskwarrior task if needed.

Note

See Field Templates for more details regarding how templates are processed.

Only if assigned

You can filter for cards assigned to a specific user:

ini

deck.only_if_assigned = my_user

toml

only_if_assigned = "my_user"

Note

only_if_assigned can be set to a username, then only issues assigned to that user will be taken into account. Attention, deck can assign multiple users, and this plugin has no support for multiple assignees - it will always only take the first assignee into account.

Exclude / include board IDs

You can explicitly exclude or include specific boards:

ini

deck.exclude_board_ids = 5,6
deck.include_board_ids = 4

toml

exclude_board_ids = ["5", "6"]
include_board_ids = ["4"]

Note

include_board_ids can explicitly include specific boards from importing; exclude_board_ids can explicitly exclude specific boards from importing. Use them to filter what cards you want to have imported. If both are defined, include_board_ids will be used.

Provided UDA Fields

Field Name	Description	Type
nextclouddeckassignee	Nextcloud Deck Assignee(s)	Text (string)
nextclouddeckauthor	Nextcloud Deck Issue Author	Text (string)
nextclouddeckboardid	Nextcloud Deck Board ID	Number (numeric)
nextclouddeckboardtitle	Nextcloud Deck Board Title	Text (string)
nextclouddeckcardid	Nextcloud Deck Card ID	Number (numeric)
nextclouddeckcardtitle	Nextcloud Deck Card Title	Text (string)
nextclouddeckdescription	Nextcloud Deck Card Description	Text (string)
nextclouddeckorder	Nextcloud Deck Order	Number (numeric)
nextclouddeckstackid	Nextcloud Deck Stack ID	Number (numeric)
nextclouddeckstacktitle	Nextcloud Deck Stack Title	Text (string)