view release on metacpan or  search on metacpan

lib/CGI/Application/Util/Diff.pm  view on Meta::CPAN

If the logging class cannot be loaded (with 'require'), the error is ignored, and no logging takes place,
but a message is written to the web-server's log with C<Carp::carp>.

=head1 Distributions

This module is available as a Unix-style distro (*.tgz).

See http://savage.net.au/Perl-modules/html/installing-a-module.html for
help on unpacking and installing distros.

=head1 Installation

At the very least, you will need to patch .htutil.diff.conf, since that's where C<HTML::Template>'s
tmpl_path is stored, if using another path.

Config file options are documented in the config file itself.

Also, you may want to edit .htutil.logger.conf and .htutil.diff.actions.conf.

=head2 Install the module

Note: I<Build.PL> and I<Makefile.PL> refer to C<FCGI::ProcManager>. If you are not going to use
the fancy script, you don't need C<FCGI::ProcManager>.

Install C<CGI::Application::Util::Diff> as you would for any C<Perl> module:

Run I<cpan>: shell>sudo cpan CGI::Application::Util::Diff

or unpack the distro, and then either:

	perl Build.PL
	./Build
	./Build test
	sudo ./Build install

or:

	perl Makefile.PL
	make (or dmake)
	make test
	make install

=head2 Install the C<HTML::Template> files.

Copy the distro's htdocs/assets/ directory to your doc root.

=head2 Install the trivial instance script

Copy the distro's httpd/cgi-bin/util.diff.cgi to your cgi-bin/ directory,
and make I<util.diff.cgi> executable.

=head2 Install the fancy instance script

Copy the distro's htdocs/local/ directory to your doc root, and make I<util.diff> executable.

=head2 Configure C<Apache> to use /local/util.diff

If in fancy mode, add these to C<Apache>'s httpd.conf:

	LoadModule fcgid_module modules/mod_fcgid.so

and:

	<Location /local>
		SetHandler fcgid-script
		Options ExecCGI
		Order deny,allow
		Deny from all
		Allow from 127.0.0.1
	</Location>

Of course, use of '/local' is not mandatory; you could use any URL fragment there.

And don't forget to restart C<Apache> after editing it's httpd.conf.

=head2 Start testing

Point your broswer at http://127.0.0.1/cgi-bin/util.diff.cgi (trivial script), or
http://127.0.0.1/local/util.diff (fancy script).

=head1 FAQ

=over 4

=item The command did nothing!

What you mean is that it did not perform according to your false expectations, and/or you did not read
the section called Actions.

The user running the web server is the user who runs these actions, and hence their limited permissions
means the actions are limited in what they are allowed to do.

=item The log always contains the word 'message'!

Right! The log is a database table, and the column heading you refer to I<should> be there.

=back

=head1 Author

C<CGI::Application::Util::Diff> was written by Ron Savage I<E<lt>ron@savage.net.auE<gt>> in 2009.

Home page: http://savage.net.au/index.html

=head1 Copyright

Australian copyright (c) 2009, Ron Savage.
	All Programs of mine are 'OSI Certified Open Source Software';
	you can redistribute them and/or modify them under the terms of
	The Artistic License, a copy of which is available at:
	http://www.opensource.org/licenses/index.html

=cut