No edit summary |
No edit summary |
||
| (8 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:Tasks}} | {{DISPLAYTITLE:Tasks}} | ||
{{ | <bookshelf src="Book:User manual" /> | ||
{{BSVersion|bsvFrom=4.4|bsvFeature=SimpleTasks}} | |||
__TOC__ | |||
== What are tasks? == | == What are tasks? == | ||
Tasks are checklist items that can be checked on or off to indicate if the task is open or completed. | Tasks are checklist items that can be checked on or off to indicate if the task is open or completed. | ||
{{Textbox|boxtype=important|text=Each task description needs to be unique, since the task ID is created from the description.|header=}} | {{Textbox|boxtype=important|text=Each task description needs to be unique, since the task ID is created from the description.|header=}} | ||
===Simple tasks=== | ===Simple tasks=== | ||
Simple tasks show a checkbox with a task description. | Simple tasks show a checkbox with a task description. [[File:droplet-task-item.png|alt=unchecked task checkbox with description|center|thumb|Task item|350x350px]] | ||
To add a simple task: | '''To add a simple task:''' | ||
# '''Type''' <code>[]</code> at the beginning of the line and then add text directly after the checkbox. | |||
# '''Press''' Enter. The line is automatically converted into a checklist item. | |||
'''To add a simple task as Content Droplet:''' | |||
#'''Click''' the Content Droplet icon in the editor toolbar. | #'''Click''' the Content Droplet icon in the editor toolbar. | ||
#'''Select''' the Tasklist droplet. This inserts a checkbox. | #'''Select''' the Tasklist droplet. This inserts a checkbox. | ||
#'''Add''' the task description next to the checkbox. | #'''Add''' the task description next to the checkbox. | ||
#'''Repeat''' steps 2 and 3 to add more tasks. Alternatively, copy the first task line and paste it onto new lines. Then change the individual task descriptions. | #'''Repeat''' steps 2 and 3 to add more tasks. Alternatively, copy the first task line and paste it onto new lines. Then change the individual task descriptions. | ||
You can now check the items of your list. Everytime a checkbox is checked or unchecked, the version history of the page creates an entry. | You can now check the items of your list. Everytime a checkbox is checked or unchecked, the version history of the page creates an entry. | ||
[[File:Manual:droplet-task-history.png|alt=version history of the page with comments showing versions with checkbox status changes|center|thumb| | [[File:Manual:droplet-task-history.png|alt=version history of the page with comments showing versions with checkbox status changes|center|thumb|650x650px|Checkbox changes in the page history]] | ||
===Combined tasks=== | ===Combined tasks=== | ||
Tasks can have three elements: (1) A task checkbox with label, (2) an assignee, and (3) an optional date. When these elements are added to the page consecutively (the order of these elements is flexible), a single task item is created. | Tasks can have three elements: (1) A task checkbox with label, (2) an assignee, and (3) an optional date. When these elements are added to the page consecutively (the order of these elements is flexible), a single task item is created. [[File:Pagedraft:mentionswithtasks.png|alt=Task list with 4 tasks that have a description, mention and date|center|thumb|650x650px|Finished task list]]To add a combined task item: | ||
To add a combined task item: | |||
#'''Add''' your task list item as described above. | #'''Add''' your task list item as described above. | ||
#'''Add''' a mention | #'''Add''' a [[Manual:Extension/AtMentions|mention]] immediately after the task description to assign the task to a user. | ||
#'''Add''' a ''Date'' Content Droplet immediately after the user mention (optional). | #'''Add''' a ''Date'' Content Droplet immediately after the user mention (optional). | ||
#'''Copy''' the entire task line and paste it on a new line to create the next task item. | #'''Copy''' the entire task line and paste it on a new line to create the next task item. | ||
=== My Tasks === | === My Tasks === | ||
Users can see all their open tasks on their [[Reference:UnifiedTaskOverview|task list]]. | Users can see all their open tasks on their [[Reference:UnifiedTaskOverview|task list]]. Every time a task is created, the assigned user is notified in e-mail and in the wiki about the new task. | ||
Users can modify their [[Manual:Preferences|notification preferences]] as needed. | |||
== Querying tasks == | |||
If you are familiar with [[Reference:Semantic MediaWiki|Semantic MediaWiki]], you can query the task items. They are added as [https://www.semantic-mediawiki.org/wiki/Help:Subobjects_and_queries semantic subobjects] with the following properties: | If you are familiar with [[Reference:Semantic MediaWiki|Semantic MediaWiki]], you can query the task items. They are added as [https://www.semantic-mediawiki.org/wiki/Help:Subobjects_and_queries semantic subobjects] with the following properties: | ||
| Line 37: | Line 43: | ||
* Property:Task/Due date | * Property:Task/Due date | ||
* Property:Task/User | * Property:Task/User | ||
* Property:Task/Status | |||
{{translation}} | |||
Latest revision as of 13:47, 2 April 2024
SimpleTasks is available from BlueSpice 4.4.
What are tasks?
Tasks are checklist items that can be checked on or off to indicate if the task is open or completed.
Each task description needs to be unique, since the task ID is created from the description.
Simple tasks
Simple tasks show a checkbox with a task description.
To add a simple task:
- Type
[]at the beginning of the line and then add text directly after the checkbox. - Press Enter. The line is automatically converted into a checklist item.
To add a simple task as Content Droplet:
- Click the Content Droplet icon in the editor toolbar.
- Select the Tasklist droplet. This inserts a checkbox.
- Add the task description next to the checkbox.
- Repeat steps 2 and 3 to add more tasks. Alternatively, copy the first task line and paste it onto new lines. Then change the individual task descriptions.
You can now check the items of your list. Everytime a checkbox is checked or unchecked, the version history of the page creates an entry.
Combined tasks
Tasks can have three elements: (1) A task checkbox with label, (2) an assignee, and (3) an optional date. When these elements are added to the page consecutively (the order of these elements is flexible), a single task item is created.
To add a combined task item:
- Add your task list item as described above.
- Add a mention immediately after the task description to assign the task to a user.
- Add a Date Content Droplet immediately after the user mention (optional).
- Copy the entire task line and paste it on a new line to create the next task item.
My Tasks
Users can see all their open tasks on their task list. Every time a task is created, the assigned user is notified in e-mail and in the wiki about the new task.
Users can modify their notification preferences as needed.
Querying tasks
If you are familiar with Semantic MediaWiki, you can query the task items. They are added as semantic subobjects with the following properties:
- Property:Task/Desc
- Property:Task/Due date
- Property:Task/User
- Property:Task/Status
