The Cognitive Process Designer extension supports the creation of BPMN (Business Process Model and Notation) processes by using an intuitive GUI (graphical user interface).

It is based on bpmn.io, an open source project by Camunda. Bpmn.io is an JavaScript renderer that allows to model BPMN processes and to check the syntax.

• The extension introduces a dedicated content type CPD.
• Processes are stored in a decicated process namespace (PROC, 1530).
• A linter checks for errors before the diagram can be saved.
• When saving the diagram, users can decide to create description pages for each task shape in the diagram. They are created as subpages of the diagram.
• The generated task pages have a built-in navigation between process steps.
• The BPMN diagrams can be embedded in any wiki page via the tag <bpmn process="..." />.

• Download and move the extracted CognitiveProcessDesigner folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:

  cdextensions/
  gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/CognitiveProcessDesigner
  

• Only when installing from Git, run Composer to install PHP dependencies, by issuing composer install --no-dev in the extension directory. (See T173141 for potential complications.)
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'CognitiveProcessDesigner' );
  

• For REL1_35 and upper branches - setup of processRunner.php is needed. See note below for the details.
• 👁 Yes
  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

• Add the repo url (https://github.com/wikimedia/mediawiki-extensions-CognitiveProcessDesigner.git) as a "vcs repository" and the package name (mediawiki/CognitiveProcessDesigner) and version to the require section of your composer.local.json. Example:

{
"repositories":[
{
"type":"vcs",
"url":"https://github.com/wikimedia/mediawiki-extensions-CognitiveProcessDesigner.git"
}
],
"require":{
"mediawiki/CognitiveProcessDesigner":"dev-REL1_43"
}
}

• Run the following command in your MediaWiki installation path

composer update --no-dev

• Add the following code at the bottom of your LocalSettings.php file:

wfLoadExtension( 'CognitiveProcessDesigner' );

• 👁 Yes
  Done Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To create a diagram, simply create a new page in the Process namespace:

Process:MyNewDiagram

The visual editing mode opens the BPMN editor.

More extensive documentation on how to use this extension:

• Technical reference (check this page for possible extension dependencies)
• Extension user help