FAQ How to

show Changed

Changed

Visitor's book Site map pmwiki-2.3.37

• login

Messages Replacement

(redirected from Cookbook.MessagesReplacement)

Questions answered by this extension

Can I display selected debugging messages from $MessagesFmt from only one, or from selected, named message sources?
Can I make the messages from each named message source hidden until shown on user demand?

Description

A drop in replacement for the PmWiki (:messages key= :) directive. Based on code from PITS:01368.

The global variable $MessagesFmt is written to by PmWiki extensions and recipes with debug and similar information. By convention the array has two dimensions, the first a string identifying the source of the message, and the optional second dimension, a string with the debug message itself.

• $MessagesFmt ['sourcename'] = $string; # concatenated lines
• $MessagesFmt ['sourcename'][] = $string; # multiple lines

Differences are:

• comma or space separated name parameters, with wildcards, can be supplied to select the groups of messages displayed
• only messages for specified name parameters are displayed
• name parameters are case insensitive
• directive does not have to start at the beginning of a line
• the output is placed within a HTML section of class=messages
• groups of messages can be rolled up by using the detail=show | hide parameter

Installation

• download messagesreplacement-2024-09-15.zip
• extract the directory /messagesreplacement/ (recommended)
• copy to the /extensions/ directory as /messagesreplacement/
• administer from SiteAdmin.ExtensionHub

Usage

Place the directive, as described below, in your PmWiki page.

This extension provides a page variable {$MessagesReplacementVersion} which contains the current version, and page variable $@MessagesReplacement for a (:if enabled MessagesReplacement:) extension installation check.

Configuration

(:messages optional,list of names with,wildcards* keys="names,with,*wildcards" detail=hide :)

Parameters are optional and case-insensitive:

• names can include wild cards
• key= a comma separated list of names which can include wild cards
• detail='show' or detail='hide' provides a clickable name for each group of messages with initial value of show or hide

Change log / Release notes

See also

• PITS:01368 add parameter to (:messages:) page directive
• PmWiki (:messages:) directive.
• $MessagesFmt

Contributors

Special thanks to Petko

Comments

See discussion at MessagesReplacement-Talk