Installing and configuring the Checklist items plugin
- Copy the redmine_advanced_checklists plugin folder to the plugins/ folder. The current version does not support operation if redmine is installed in a subdirectory (for example http://example.com/redmine /). It is necessary that redmine is installed at the root (for example http://redmine.example.com / or on a separate port http://example.com:8080 /).
- Run the migration in the Redmine root folder.
- Stop and start Redmine.
- In some redmine installations (for example, when working in docker), it is important to stop and start the redmine server, and not restart it. Sometimes the checklists are not displayed when restarting.
Customization:
- Configure user roles in Administration -> Roles.
- Enable the «Checklists» module for projects in the settings of each project or in Administration -> Checklists.
- Check and change other plugin settings in Administration -> Checklists
API Checklists
- Get all checklist and items for issue
curl 'https://demo.redmine-kanban.com/questionlist/__ISSUE_ID__' \
-H 'X-redmine-API-Key: __API_KEY__' \
-H 'Content-Type: application/json' \
-X GET - Add checklist to issue
curl 'https://demo.redmine-kanban.com/questionlist/__ISSUE_ID__' \
-H 'X-redmine-API-Key: __API_KEY__' \
-H 'Content-Type: application/json' \
-X POST \
-d '{"list_type":"Usual", "title":"new checklist"}' - Add item to checklist (parameters "assigned_to_id", "done", "due_date" not required)
curl 'https://demo.redmine-kanban.com/question/__CHECKLIST_ID__' \
-H 'X-redmine-API-Key: __API_KEY__' \
-H 'Content-Type: application/json' \
-X POST \
-d '{"title":"new item title ", "assigned_to_id":__USER_ID__, "due_date":"2024-08-01", "done": false}' - Delete item from checklist
curl 'https://demo.redmine-kanban.com/question/__ITEM_ID__' \
-H 'x-redmine-api-key: __API_KEY__' \
-X 'PATCH' \
-H 'Content-Type: application/json' \
-d '{"data":{"action": "question.delete","updated_at":" 2024-08-16T12:37:56.000Z"}}' - Change item (set done, rename, assign, change due date)
curl 'https://demo.redmine-kanban.com/question/__ITEM_ID__' \
-H 'x-redmine-api-key: __API_KEY__' \
-X 'PATCH' \
-H 'Content-Type: application/json' \
-d '{"data":{"action":__ACTION_NAME__,"updated_at":__UPDATED_AT__, "value":__NEW_VALUE__}}'
Description | __ACTION_NAME__ | Example of Value | Type |
---|---|---|---|
Delete | question.delete | - | - |
Set done/undone | question.complete | true/false | bool |
Rename | question.set_title | "new name" | string |
Assign | question.set_assigned_to | 1 | integer (user_id) or null |
Set due date | question.set_due_date | "2024-08-01" | string |
Change sort order | question.set_order | 1 | integer (item) |
Personal checklists
Notes on editing personal checklists
- Personal checklists can be edited by: author, assignee and person with the role “edit any personal checklists”
- Personal checklist's author can edit items added to his checklist by other users
If you have any problems or questions, write us an email [email protected]