mediawiki / semantic-tasks
Fund package maintenance!
Open Collective
www.semantic-mediawiki.org/wiki/Sponsorship
Installs: 940
Dependents: 0
Suggesters: 0
Security: 0
Stars: 7
Watchers: 11
Forks: 6
Open Issues: 10
Type:mediawiki-extension
Requires
Requires (Dev)
- dev-master
- 2.0.1
- 2.0.0
- dev-dependabot/npm_and_yarn/minimist-and-mkdirp-1.2.8
- dev-dependabot/npm_and_yarn/minimatch-3.0.8
- dev-dependabot/npm_and_yarn/getobject-and-grunt-1.0.2
- dev-dependabot/npm_and_yarn/shelljs-and-grunt-contrib-jshint--removed
- dev-dependabot/npm_and_yarn/grunt-1.5.3
- dev-dependabot/npm_and_yarn/path-parse-1.0.7
- dev-dependabot/npm_and_yarn/lodash-4.17.21
- dev-dependabot/npm_and_yarn/hosted-git-info-2.8.9
This package is auto-updated.
Last update: 2024-09-18 12:27:47 UTC
README
Semantic Tasks (a.k.a. ST) is a Semantic Mediawiki extension that provides task notification and reminder emails with the help of semantic annotations.
In contrast to the built in notification systems in MediaWiki (watching pages), this extension can be used to trigger notifications without user interaction with the MediaWiki system, e. g. by filling in a form (using the PageForms extension) where a user name is entered in a form and in the resulting template the respective properties are set to trigger a email notification (see below).
Requirements
- PHP 7.3 or later
- MediaWiki 1.35 or later
- Semantic MediaWiki 3.2 or later
Installation
The recommended way to install Semantic Tasks is using Composer with MediaWiki's built-in support for Composer.
Note that the required extension Semantic MediaWiki must be installed first according to the installation instructions provided.
Step 1
Change to the base directory of your MediaWiki installation. If you do not have a "composer.local.json" file yet, create one and add the following content to it:
{
"require": {
"mediawiki/semantic-tasks": "~2.0"
}
}
If you already have a "composer.local.json" file add the following line to the end of the "require" section in your file:
"mediawiki/semantic-tasks": "~2.0"
Remember to add a comma to the end of the preceding line in this section.
Step 2
Run the following command in your shell:
php composer.phar update --no-dev
Note if you have Git installed on your system add the --prefer-source
flag to the above command.
Step 3
Add the following line to the end of your "LocalSettings.php" file:
wfLoadExtension( 'SemanticTasks' );
Step 4
You must run a cron job e.g. once a day to trigger the reminders to be sent by e-mail. To do so add the following line to your crontab to execute the respective script every day at 12:
0 12 * * * php /path/to/SemanticTasks/maintenance/checkForReminders.php
Step 5
It is possible to adapt the names of the properties for your wiki via configuration in the "LocalSettings.php" file. This is an optional step if you would like to use different property names. This is the list of default settings:
$stgPropertyAssignedTo = 'Assigned to';
$stgPropertyCarbonCopy = 'Carbon copy';
$stgPropertyTargetDate = 'Target date';
$stgPropertyReminderAt = 'Reminder at';
$stgPropertyStatus = 'Status';
$stgPropertyAssignedToGroup = 'Assigned to group';
$stgPropertyHasAssignee = 'Has assignee';
Configuration
SemanticTasksNotifyIfUnassigned
- (default:false
) If set totrue
will notify users being unassigned from tasks$stgNotificationFromSystemAddress
- (default:false
) If set totrue
will use$wgSiteName
and$wgPasswordSender
for notification emails From field
Usage
Notification emails
They are sent as soon a page is saved. The system looks for the [[Assigned to::*]]
, [[Carbon copy::*]]
and/or [[Assigned to group::*]]
properties.
Groups
Create a group page with properties [[Has assignee::*]]
and then assign the group to the task with [[Assigned to group::*]]
property.
Status
Set Status to [[Status::Closed]]
to inform assignees that the task has been closed and to disable notifications and reminders.
Reminder emails
Once the script execution is triggered via cron the software looks for the [[Reminder at::*]]
and the [[Target date::*]]
property. It then sends reminders to all the assignees.
Contribution and support
If you want to contribute work to the project please subscribe to the developers mailing list and have a look at the contribution guideline.
- File an issue
- Submit a pull request
- Ask a question on the mailing list
Version history
See release notes.
Credits
Semantic Tasks was initially created by Steren Giannini for Creative Commons. Later it was sponsored by KDZ - Centre for Public Administration Research, with most upgrade work done by Peter Grassberger. Currently it is sponsored by KM-A Knowledge Management Associates, with most upgrade work done by thomas-topway-it.
License
GNU General Public License, version 2 or later, see COPYING file.