FAQ How to

show

Changed

Visitor's book Site map pmwiki-2.3.32

• login

Messages Replacement

Questions answered by this recipe

Can I display selected debugging messages from $MessagesFmt from only one message source.

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 identifying the source of the message, and the second the debug message itself.

Differences are:

• comma or space separated parameters, with wildcards, can be supplied to limit 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
• placed within a HTML section of class=messages
• groups of messages are separated by a blank line

Installation

• download messagesreplacement-2022-12-02.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 :)

• parameters are optional and case-insensitive.
• names can include wild cards

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