NAME

App::ZofCMS::Test::Plugin - test module for testing ZofCMS plugins

SYNOPSIS

#!/usr/bin/env perl

use strict;
use warnings;

use Test::More;

eval "use App::ZofCMS::Test::Plugin;";
plan skip_all
=> "App::ZofCMS::Test::Plugin required for testing plugin"
    if $@;

plugin_ok(
    'PlugName',  # plugin's name
    { input => 'Foo' }, # plugin takes input via first level 'input' key
    { foo => 'bar'   }, # query parameters
);

DESCRIPTION

The module provides some basic test for ZofCMS plugins. See SYNOPSYS for usage. That would be in one of your t/test.t files.

plugin_ok

plugin_ok(
    'PlugName',  # plugin's name
    { input => 'Foo' }, # plugin takes input via first level 'input' key
    { foo => 'bar'   }, # query parameters
);

Takes three arguments, second and third one are optional. First argument is the name of your plugin with the App::ZofCMS::Plugin:: part stripped off (i.e. the name that you would use in ZofCMS template to include the plugin). Second parameter is optional, it must be a hashref which would represent the input from your plugin. In the example above the plugin takes input via first level key input in ZofCMS template. This is basically to check that any first level keys used by the plugin are deleted by the plugin. Third parameter is optional and is also a hashref which represents query parameters with keys being parameters names and values being parameters' values. Use this if your plugin depends on some query parameters.

AUTHOR

Zoffix Znet, <zoffix at cpan.org> (http://zoffix.com, http://haslayout.net)

BUGS

Please report any bugs or feature requests to bug-app-zofcms-test-plugin at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=App-ZofCMS-Test-Plugin. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc App::ZofCMS::Test::Plugin

You can also look for information at:

COPYRIGHT & LICENSE

Copyright 2008 Zoffix Znet, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.