FAQ How to

show

Changed

Visitor's book Site map pmwiki-2.3.33

• login

Messages Replacement

Questions answered by this recipe

Can I display selected debugging messages from $MessagesFmt from only one, or from selected, message sources.

Description

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

The global variable $MessagesFmt is written to by PmWiki 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 second a string with the debug message itself.

Differences are:

• comma or space separated parameters, with wildcards, can be supplied to select the messages displayed
• only messages for specified parameters are displayed
• 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 are separated by a blank line
• groups of messages can be rolled up by using the display=details parameter

Installation

• download messagesreplacement-2024-04-27.php Δ
• copy to the /cookbook/ directory as messagesreplacement.php
• add to config.php the line
  include_once ($FarmD/cookbook/messagesreplacement.php);

Usage

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

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

Configuration

(:messages optional,list of names with,wildcards* display=details :)

• parameters are optional and case-insensitive.
• names can include wild cards
• details=show||hide provides a clickable name for each group of messages with initial value of show or hide

config.php settings

You can change the following in config.php. For example

Change log / Release notes

See also

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

Contributors

Special thanks to Petko

Comments

See discussion at MessagesReplacement-Talk