Extension Hub -
To do
- change skiwi
- remove this comment
PmWikiPlus version 2026-07-10
Summary: A PmWiki extension to assist with configuring PmWiki
Version: 2026-05-31
Status: Alpha
Questions answered by PmWikiPlus
How can I enable the built-in PmWiki recipes and scripts?
How can I enable additional PmWiki markup?
How can I configure additional PmWiki settings?
How can I do less configuration in config.php?
PmWikiPlus description
PmWikiPlus provides a single screen to configure some aspects of PmWiki.
Install PmWikiPlus as a PmWiki extension
PmWikiPlus usage
Use the SiteAdmin.Extension Hub for this extension to apply the configuration to PmWiki.
Important: Before enabling these recipes here they must be removed from config.php
Important: This Extension can only enable recipes on pages on which it itself is enabled.
Note: Configuration in PmWikiPlus will override settings in config.php
The extension provides a page variable {$PmWikiPlusVersion} which contains the current version, and page variable {$PmWikiPlus} for a (:if enabled PmWikiPlus:) check.
PmWikiPlus configuration
The following strings can be internationalised:
PmWikiPlus details
PmWikiPlus capabilities
These built-in recipe scripts can be enabled by PmWikiPlus:
These settings can be adjusted by PmWikiPlus:
These additional markups can be enabled by PmWikiPlus:
[[\\]] Line Break. PmWiki has two markups for line break, [[<<]] for Line Break with "clear:both"; \\ which only works at the end of a line.
This new markup for line break works inside a line.
[[<]] Line Break with "clear:left"
[[>]] Line Break with "clear:right"
'* *' Bold
'~ ~' Italic
These additional markup expressionss can be enabled by PmWikiPlus:
{(cc)} Concatenate
{(chrfltr)} Character filter
{(testargp)} Test argp
{(testargs)} Test args
{(testp)} Test params
Markup Expressions
Two Markup Expressions can be enabled:
cc carbon copy
{(cc ...keywords ...strings)}
Strings are concatenated and returned.
The optional keywords are QUOTES - single quote, QUOTED - double quote, NL - new line, SP - space, and NBSP - non-breaking space.
Keywords insert the special character in the string at the position they are encountered.
Quotes are nested and properly terminated at the end of the string.
e.g. {(cc QUOTE {$Action} SP 'is not available')}
chrfltr character filter
{(chrfltr filter ...strings)}
Strings are concatenated, filtered, and returned.
Filter is keywords are PAGE - filter by page name characters,
UPLOAD - filter by upload name characters,
SP - remove spaces,
or a string containing characters that are used to create a regular expression character class to remove everything except the characters defined.
If the string is prefixed by a hyphen ("-") the characters removed will be removed.
Not all aspects of character classes are supported. The caller does not know to know character class syntax or escape meta characters.
e.g. {(chrfltr PAGE {$Summary} )}
Change log / Release notes
2026-05-31 Save and display previous configurations
2026-05-11 Add settings, made more robust, capture error and action messages
2026-04-25 First release
2024-08-18 Initial version
PmWikiPlus is configured to run early during PmWiki initialisation.
Priority is set to 101, meaning it runs after local/config.php, local/Group.Page.php, and local/Group.php, at the beginning of scripts/stdconfig.php.
This means PmWikiPlus will override settings in config.ptp.
Testing
Tested on two instances of PmWiki.
To look into the internals of PmWikiPlus the directive ((:pmwikiplus argument:) is available.
PmWikiPlus arguments are "show", "form", "saved", "dump", "plus", "conf" or "?"
See also
