Kwiki::Attachments - Kwiki Page Attachments Plugin
Kwiki::Attachments gives a Kwiki wiki the ability to upload, store and manage file attachments on any page. By default, if you have an image creation module such as Imager or Image::Magick installed, then a thumbnail will be created for every supported image file type that is uploaded. Thumbnails are displayed on the attachments page, and can also be displayed on wiki pages via the wafl directives described in the next paragraph. The thumbnail files have "thumb_" prepended to the original filename and are not displayed separately in the attachment page or widget. For this reason, you cannot upload files beginning with "thumb_".
This module provides 3 wafl tags which can be used to link to or display attachments in a Kwiki page.
{file:[page/]filename} creates a link to attachment filename.
{file:[page/]filename}
{img:[page/]filename} displays attachment filename.
{img:[page/]filename}
{thumb:[page/]filename} displays the thumbnail for attachment filename.
{thumb:[page/]filename}
[kwiki_base_dir]/config/attachments.yaml
attachments_skip: [regular_expression]
Kwiki::Attachments may be configured to reject the upload of files with names matched by the given regular expression. By default, it is set to reject files beginning with "thumb_" or "." and those ending with "~" or ".bak".
make_thumbnails: [on|off]
This flag controls whether thumbnails are created from uploaded image files. It is set to 'on' by default.
im_override: [on|off]
If both Imager.pm and Image::Magick.pm are available, Kwiki::Attachments uses Imager, unless im_override is set to 'on'. This parameter has no effect if only one of the two image manipulation modules is installed. It is set to 'off' by default.
Sue Spence <sue_cpan@pennine.com>
This module is based almost entirely on work by Eric Lowry <eric@clubyo.com> and Brian Ingerson <INGY@cpan.org>
Copyright (c) 2005. Sue Spence. All rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
See http://www.perl.com/perl/misc/Artistic.html
1 POD Error
The following errors were encountered while parsing the POD:
You forgot a '=back' before '=head1'
To install Kwiki::Attachments, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Kwiki::Attachments
CPAN shell
perl -MCPAN -e shell install Kwiki::Attachments
For more information on module installation, please visit the detailed CPAN module installation guide.