Redaktion (talk | contribs)
No edit summary
Tag: 2017 source edit
No edit summary
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{BSVersion|bsvFrom=4.4|bsvFeature="Mentions and Tasks"}}
{{BSVersion|bsvFrom=4.4|bsvFeature=SimpleTasks}}


To directly address a user on a page, you can mention that user. A mention is then shown as a specially formatted name. It can be used in combination with a task and date to create a task item for the mentionned user.
[[File:SMWCon2023-Mentions-and-Tasks-thumb.png|alt=Link to YouTube video. To see example checklist|thumb|280x280px|[[File:youtube-icon.png|left|22x22px]][https://www.youtube.com/watch?v=ZBRDZR2b4EI Mentions and tasks] (4:39 min.)]]
== What are tasks? ==
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=}}
===Simple tasks===
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:'''
 
# '''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.
#'''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.
[[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===
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:


== What are mentions? ==
#'''Add''' your task list item as described above.
If you mention a user on a page, the user's name is inserted as a mention-item. The user  is notified of the mention, because it creates a link to the user's profile page.
#'''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).
#'''Copy''' the entire task line and paste it on a new line to create the next task item.


'''To mention a user:'''
=== My Tasks ===
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.


# '''Select''' the ''Mention'' menu item in the editor toolbar.[[File:Manual:droplet-mention-VE.png|alt=visual editor menu bar with mention item selected|center|thumb|The "mention"  menu item]]
Users can modify their [[Manual:Preferences|notification preferences]] as needed.
# '''Enter''' a user name. The mention is added to the page.[[File:Manual:mention-example.png|alt=Example of a formatted user mention|center|thumb|User mention on the page.]]


== What are tasks? ==
== Task report ==
Tasks are  checklist items that can be checked on or off to indicate if the task is open or completed.
[[File:Manual:Manual Extension SimpleTasks 1747821827754.png|thumb|300x300px|alt=Parameter dialogue for the task report|Insert report]]All tasks that exist in the wiki can be displayed together in a table. To do this, insert the Task report [[Manual:Extension/ContentDroplets|content droplet]].
{{Textbox|boxtype=important|text=Each task description needs to be unique, since the task ID is created from the description.|header=}}


=== Simple tasks ===
The following optional filters are available:
Simple tasks show a checkbox with a task description.


To add a simple task:
* Assignees
* Namespaces
* Due until (date)
* Status (open, done)


# '''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.[[File:droplet-task-item.png|alt=unchecked task checkbox with description|center|thumb|Task item]]
# '''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.


Click Insert to display the report.
{{Textbox|boxtype=|header=|text=|icon=}}
[[File:Manual:Manual Extension SimpleTasks 1747822282310.png|alt=Filterable task report with one open task|center|thumb|650x650px|Task report]]


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.
== Querying tasks ==
[[File:Manual:droplet-task-history.png|alt=version history of the page with comments showing versions with checkbox status changes|center|thumb|550x550px|Checkbox changes in the page history]]
If you are familiar with [[Reference:Semantic MediaWiki|Semantic MediaWiki]], you can query the task items.


=== Combined tasks ===
{{Textbox|boxtype=important|header=Wichtig!|text=Semantic properties for tasks are only generated if the checklist entry has an assigned user! Checklists that are created in the namespace "User" cannot be queried.|icon=yes}}
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, a single task item is created.  


To add a combined task item:
Tasks with an assigned user are stored as subobjects [https://www.semantic-mediawiki.org/wiki/Help:Subobjects_and_queries semantic subobjects] with the following properties:


# '''Add''' your task list item as described above.
* Property:Task/Desc
# '''Add''' a mention (as described above) immediately after the task description to assign the task to a user.
* Property:Task/Due date
# '''Add''' a ''Date'' Content Droplet immediately after the user mention (optional).[[File:droplet-date-inspector.png|alt=Date inspector with Insert-button|center|thumb|350x350px|The "Date" Content Droplet]]
* Property:Task/User
# '''Copy''' the entire task line and paste it on a new line to create the next task item.[[File:Pagedraft:mentionswithtasks.png|alt=Task list with 4 tasks that have a description, mention and date|center|thumb|650x650px|Finished task list]]
* Property:Task/Status
{{translation}}

Latest revision as of 10:12, 21 May 2025

SimpleTasks is available from BlueSpice 4.4.


Link to YouTube video. To see example checklist
Mentions and tasks (4:39 min.)

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.

unchecked task checkbox with description
Task item

To add a simple task:

  1. Type [] at the beginning of the line and then add text directly after the checkbox.
  2. Press Enter. The line is automatically converted into a checklist item.

To add a simple task as Content Droplet:

  1. Click the Content Droplet icon in the editor toolbar.
  2. Select the Tasklist droplet. This inserts a checkbox.
  3. Add the task description next to the checkbox.
  4. 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.

version history of the page with comments showing versions with checkbox status changes
Checkbox changes in the page history

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.

Task list with 4 tasks that have a description, mention and date
Finished task list

To add a combined task item:

  1. Add your task list item as described above.
  2. Add a mention immediately after the task description to assign the task to a user.
  3. Add a Date Content Droplet immediately after the user mention (optional).
  4. 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.

Task report

Parameter dialogue for the task report
Insert report

All tasks that exist in the wiki can be displayed together in a table. To do this, insert the Task report content droplet.

The following optional filters are available:

  • Assignees
  • Namespaces
  • Due until (date)
  • Status (open, done)


Click Insert to display the report.

Filterable task report with one open task
Task report

Querying tasks

If you are familiar with Semantic MediaWiki, you can query the task items.

Wichtig! Semantic properties for tasks are only generated if the checklist entry has an assigned user! Checklists that are created in the namespace "User" cannot be queried.


Tasks with an assigned user are stored as subobjects semantic subobjects with the following properties:

  • Property:Task/Desc
  • Property:Task/Due date
  • Property:Task/User
  • Property:Task/Status



PDF exclude - start

To submit feedback about this documentation, visit our community forum.

PDF exclude - end