Extension Hub -
To do
- change skiwi
- remove this comment
PmWikiPlus version 2026-07-20
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
{(testargp)} Test argp
{(testargs)} Test args
{(testp)} Test params
{(txtfltr)} Text filter
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 - insert new line
SP - insert space
NBSP - insert non-breaking space.
Keywords insert the special character in the string at the position they are encountered.
Single and Double Quotes are nested and properly terminated at the end of the string.
e.g. {(cc QUOTED {$Action} SP 'is not available')}
txtfltr text filter
{(txctfltr filter ...strings)}
Strings are concatenated, filtered, and returned.
The Filter keywords are
PAGE - filter by page name characters,
UPLOAD - filter by upload name characters,
TAGS - filter out tags using PHP's strip_tags{} function
SP - remove spaces
- a string of 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. {(txtfltr 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
