use Error;

...

throw TWiki::OopsException( 'bathplugin',
                            def => 'toestuck',
                            web => $web,
                            topic => $topic,
                            params => [ 'bigtoe', 'hot tap' ] );

• template is the name of an oops template. e.g. 'bathplugin' refers to templates/oopsbathplugin.tmpl

• keep - if set, the exception handler should try its damnedest to retain parameter values from the query.

NOTE: parameter values are automatically and unconditionally entity-encoded

ObjectMethod redirect ($twiki)

Generate a redirect to an 'oops' script for this exception.

If the 'keep' parameter is set in the exception, it saves parameter values into the query as well. This is needed if the query string might get lost during a passthrough, due to a POST being redirected to a GET.

ObjectMethod stringify ([$session]) -> $string

Package TWiki::OopsException

Exception used to raise a request to redirect to an Oops URL. An OopsException thrown anywhere in the code will redirect the browser to a url based on the oops script. oops requires a template parameter, that is the name of a template file from the templates directory. This file will be expanded and the parameter values passed to the exception instantiated. The result will be shown in the browser.

ClassMethod new ($template,...)

• template is the name of an oops template

• web will be used as the web for the oops
• topic will be used as the topic for the oops
• def - is the (optional) name of a TMPL:DEF within the template
• keep - if set, the exception handler should try it's damndest to retain parameter values from the query.
• params is a reference to an array of parameters. These will be substituted for %PARAM1%, %PARAM2% ... %PARAMn% in the template.

ObjectMethod stringify () -> $string

Generates a string representation for the object, mainly for debugging.