Browse history interactively

Meryam Sahin (talk | contribs)

12 user groups
4,137 edits
VisualWikitext
Meryam Sahin (talk | contribs)
Interface administrators, Administrators, wiki_FIN_reader, wiki_HR_editor, wiki_HR_reader, wiki_IIT_reader, wiki_IMS_editor, wiki_IMS_reader, wiki_MnS_reader, wiki_RnD_editor, wiki_RnD_reader, wiki__global_admin
4,137 edits
Created page with "{{BSVersion|bsvFrom=4.4|bsvFeature=SimpleTasks}} 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 u..."
 
Meryam Sahin (talk | contribs)
Interface administrators, Administrators, wiki_FIN_reader, wiki_HR_editor, wiki_HR_reader, wiki_IIT_reader, wiki_IMS_editor, wiki_IMS_reader, wiki_MnS_reader, wiki_RnD_editor, wiki_RnD_reader, wiki__global_admin
4,137 edits
No edit summary
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{BSVersion|bsvFrom=4.4|bsvFeature=SimpleTasks}}
<status color="green" light="true">done</status><br>
 
Tasks are checklist items that can be checked or unchecked to indicate whether a task is open or completed. '''SimpleTasks''' also supports assigning tasks to users and adding due dates.
[[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.)]]
{{Textbox|boxtype=important|header=Note|text=Each task description must be unique because the task ID is generated from the task description.|icon=yes}}
== What are tasks? ==
== Create a simple task ==
Tasks are checklist items that can be checked on or off to indicate if the task is open or completed.
A simple task consists of a checkbox and a task description.
{{Textbox|boxtype=important|text=Each task description needs to be unique, since the task ID is created from the description.|header=}}
[[File:simpletasks-task-item.png|alt=Unchecked task checkbox with task description|center|thumb|Task item|350x350px]]
===Simple tasks===
=== Create a task in the editor ===
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 a line and enter the task description directly after the checkbox.
'''To add a simple task:'''
# Press Enter.
 
# The line is automatically converted into a checklist item.
# '''Type''' <code>[]</code> at the beginning of the line and then add text directly after the checkbox.
=== Create a task with the Tasklist Content Droplet ===
# '''Press''' Enter. The line is automatically converted into a checklist item.
To add a simple task with the '''Content Droplet''':
 
# Select the '''Content Droplet''' icon in the editor toolbar.
'''To add a simple task as Content Droplet:'''
# Select '''Tasklist'''. A checkbox is inserted.
 
# Add the task description next to the checkbox.
#'''Click''' the Content Droplet icon in the editor toolbar.
# Repeat the previous two steps to add more tasks. Alternatively, copy the first task line to new lines and change the individual task descriptions. <br>
#'''Select''' the Tasklist droplet. This inserts a checkbox.
Each task can be checked or unchecked. Each change to a checkbox creates an entry in the page version history.
#'''Add''' the task description next to the checkbox.
[[File:simpletasks-task-history.png|alt=Page version history showing changes to task checkbox states|center|thumb|Task changes in the page history|650x650px]]
#'''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.
== Create a combined task ==
 
A combined task can contain three elements:
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.
* a task checkbox with a task description
[[File: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]]
* an assignee
 
* an optional due date <br>
===Combined tasks===
When these elements are added consecutively, they are recognized as a single task item. The order of the elements is flexible. <br>
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 create a combined task:
 
# Add a task item as described in [[#Create a simple task|Create a simple task]].
#'''Add''' your task list item as described above.
# Add a [[Extension/AtMentions|mention]] immediately after the task description to assign the task to a user.
#'''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 to add a due date. This step is optional.
#'''Add''' a ''Date'' Content Droplet immediately after the user mention (optional).
# Copy the complete task line and paste it on a new line to create another task item.
#'''Copy''' the entire task line and paste it on a new line to create the next task item.
# Change the task description, assignee, and date as needed.
 
== View and manage assigned tasks ==
=== My Tasks ===
Assigned users can view their open tasks in the [[Reference:UnifiedTaskOverview|task list]]. <br>
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.
When an assigned task is created, the assigned user receives a notification in the wiki. An email notification is also sent when email is available in the system. <br>
 
Notification settings can be adjusted in the user's [[Preferences|notification preferences]].
Users can modify their [[Manual:Preferences|notification preferences]] as needed.
== Create a task report ==
 
All tasks in the wiki can be displayed in a table using the '''Task report''' Content Droplet.
== Task report ==
[[File:simpletasks-task-report-parameters.png|thumb|300x300px|alt=Parameters dialog for the Task report|Task report parameters]]
[[File: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]].
To insert a task report:
 
# Select the '''Content Droplet''' icon in the editor toolbar.
The following optional filters are available:
# Select '''Task report'''.
 
# Configure the optional filters as needed.
* Assignees
# Select '''Insert'''. <br>
* Namespaces
The following filters are available:
* Due until (date)
{| class="wikitable"
* Status (open, done)
! Filter
 
! Description
 
|-
Click Insert to display the report.
| Assignees
{{Textbox|boxtype=|header=|text=|icon=}}
| Filters the report by assigned users.
[[File:Manual Extension SimpleTasks 1747822282310.png|alt=Filterable task report with one open task|center|thumb|650x650px|Task report]]
|-
 
| Namespaces
== Querying tasks ==
| Filters the report by namespace.
If you are familiar with [[Reference:Semantic MediaWiki|Semantic MediaWiki]], you can query the task items.
|-
 
| Due until
{{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}}
| Filters tasks by their due date.
 
|-
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:
| State
 
| Filters tasks by their current state, such as open or done.
* Property:Task/Desc
|}
* Property:Task/Due date
[[File:simpletasks-task-report.png|alt=Task report showing an open task with filter options|center|thumb|Task report|650x650px]]
* Property:Task/User
* Property:Task/Status
{{translation}}

Latest revision as of 13:58, 31 August 2026

done
Tasks are checklist items that can be checked or unchecked to indicate whether a task is open or completed. SimpleTasks also supports assigning tasks to users and adding due dates.

NoteEach task description must be unique because the task ID is generated from the task description.

Create a simple task

A simple task consists of a checkbox and a task description.

Unchecked task checkbox with task description
Task item

Create a task in the editor

To add a simple task:

  1. Type [] at the beginning of a line and enter the task description directly after the checkbox.
  2. Press Enter.
  3. The line is automatically converted into a checklist item.

Create a task with the Tasklist Content Droplet

To add a simple task with the Content Droplet:

  1. Select the Content Droplet icon in the editor toolbar.
  2. Select Tasklist. A checkbox is inserted.
  3. Add the task description next to the checkbox.
  4. Repeat the previous two steps to add more tasks. Alternatively, copy the first task line to new lines and change the individual task descriptions.

Each task can be checked or unchecked. Each change to a checkbox creates an entry in the page version history.

Page version history showing changes to task checkbox states
Task changes in the page history

Create a combined task

A combined task can contain three elements:

  • a task checkbox with a task description
  • an assignee
  • an optional due date

When these elements are added consecutively, they are recognized as a single task item. The order of the elements is flexible.
To create a combined task:

  1. Add a task item as described in Create a simple task.
  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 to add a due date. This step is optional.
  4. Copy the complete task line and paste it on a new line to create another task item.
  5. Change the task description, assignee, and date as needed.

View and manage assigned tasks

Assigned users can view their open tasks in the task list.
When an assigned task is created, the assigned user receives a notification in the wiki. An email notification is also sent when email is available in the system.
Notification settings can be adjusted in the user's notification preferences.

Create a task report

All tasks in the wiki can be displayed in a table using the Task report Content Droplet.

Parameters dialog for the Task report
Task report parameters

To insert a task report:

  1. Select the Content Droplet icon in the editor toolbar.
  2. Select Task report.
  3. Configure the optional filters as needed.
  4. Select Insert.

The following filters are available:

Filter Description
Assignees Filters the report by assigned users.
Namespaces Filters the report by namespace.
Due until Filters tasks by their due date.
State Filters tasks by their current state, such as open or done.
Task report showing an open task with filter options
Task report

Retrieved from "https://galaxy.demo.bluespice.com/Helpdesk/index.php?title=Extension/SimpleTasks&oldid=12723"