OmniCenter can link to your own documentation archive stored on a separate MediaWiki server. OmniCenter uses the native MediaWiki API to connect to the server and can even manage user accounts for you, acting as a gateway to your documentation content from directly within OmniCenter.
To enable MediaWiki connectivity in OmniCenter, turn on “External KB integration” on the System Preferences page (Administration → System → Preferences).
The API URL field should be set to the path to your MediaWiki API installation.
OmniCenter will create accounts on the wiki when user accounts are created in OmniCenter or permissions are changed. In order to accomplish this, along with editing the pages within OmniCenter, you must provide a username and password for OmniCenter to use as a “master API user.” This user must be granted permissions to edit and create pages, add and modify user permissions, as well as the “writeapi” permission, which is not on by default. See the MediaWiki User Rights documentation for details on how to configure this on your MediaWiki installation.
MediaWiki Settings Requirements
It is highly recommended that you set your $wgScriptPath to ‘/wiki’ as specified below. OmniCenter does not support script paths longer than a single directory (i.e., ‘/something/path/to/wiki’ is not supported).
Developed and Tested on MediaWiki version 1.25.2
The following parameters need to be set in LocalSettings.php on the MediaWiki server.
$wgEnableAPI = true; $wgEnableWriteAPI = true; $wgEnableUploads = true; $wgHashedUploadDirectory = false;
If you wish to allow OmniCenter to export all Wiki content into PDF format, the following additional settings are required.
$wgExportFromNamespaces = true; $wpExportTemplates = true; $wgExportAllowAll = true; $wgExportMaxLinkDepth = 0; $wgExportAllowListContributors = true; $wgExportMaxHistory = 1;
Linking Content to OmniCenter
OmniCenter will look for articles on the wiki formatted as Entity::Name. For example, Device::Router1 or Site::Netreo_HQ. The complete list of supported entities is below.
|OmniCenter Entity to Link||Page Name Format|
|Web Application Synthetic Check||Application::AppName|
|Email Application Synthetic Check||Email::EmailCheckName|
OmniCenter will create accounts on the wiki when user accounts are created in OmniCenter or permissions are changed. If the OmniCenter user has admin rights, they will also have admin rights to the Wiki.
|OmniCenter Permissions||Wiki Permissions|
|User||Read only access, can comment on pages (discussion).|
|Power User||Read only access, can comment on pages (discussion).|
|Admin||Can edit pages directly on wiki, can comment, can rollback, can view change history.|
|Super Admin||Can edit pages directly on wiki, can comment, can rollback, can view change history.|