|
|
Line 1: |
Line 1: |
| {{Manual:Extension/AtMentions}} | | {{BSVersion|bsvFrom=4.4|bsvFeature=The feature set ''AtMentions'', ''Task list'' (content droplet) and ''Date'' (content droplet) }} |
|
| |
|
| == What are tasks? ==
| | 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 [[Manual:Extension/SimpleTasks|in combination with a task and date]] to create a task item for the mentioned user. |
| Tasks are checklist items that can be checked on or off to indicate if the task is open or completed.
| | ==What are mentions?== |
| {{Textbox|boxtype=important|text=Each task description needs to be unique, since the task ID is created from the description.|header=}}
| | If you mention a user on a page, the user's name is inserted as a mention-item. |
| ===Simple tasks=== | |
| Simple tasks show a checkbox with a task description.
| |
|
| |
|
| To add a simple task: | | '''To mention a user:''' |
| | | #'''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]] |
| #'''Click''' the Content Droplet icon in the editor toolbar.
| | #'''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.]] |
| #'''Select''' the Tasklist droplet. This inserts a checkbox. | | The user is notified of the mention, because it creates a link to the user's profile page. Users can change their notification settings for mentions in their preference. By default, users get in-wiki notifications, but no e-mail notifications.[[File:mention-notification-setting.png|alt=Checked checkbox for in-wiki notifications and unchecked e-mail notifications in the users preferences|center|thumb|Notification setting for mentions]] |
| #'''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. | |
| | |
| 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|550x550px|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.
| |
| | |
| To add a combined task item:
| |
| | |
| #'''Add''' your task list item as described above.
| |
| #'''Add''' a mention (as described above) 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.[[File:Pagedraft:mentionswithtasks.png|alt=Task list with 4 tasks that have a description, mention and date|center|thumb|650x650px|Finished task list]]
| |
| | |
| === My Tasks ===
| |
| Users can see all their open tasks on their [[Reference:UnifiedTaskOverview|task list]].
| |
| | |
| === 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:
| |
| | |
| * Property:Task/Desc
| |
| * Property:Task/Due date
| |
| * Property:Task/User
| |
The feature set AtMentions, Task list (content droplet) and Date (content droplet) is available from BlueSpice 4.4.
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 mentioned user.
What are mentions?
If you mention a user on a page, the user's name is inserted as a mention-item.
To mention a user:
- Select the Mention menu item in the editor toolbar.
- Enter a user name. The mention is added to the page.
User mention on the page.
The user is notified of the mention, because it creates a link to the user's profile page. Users can change their notification settings for mentions in their preference. By default, users get in-wiki notifications, but no e-mail notifications.
Notification setting for mentions