MojoMojo::Formatter::File(3pm)

MojoMojo::Formatter::File3pm

Format file as xhtml

Overview

This formatter will format the file argument as XHTML.

Usage: {{file TYPE filename}}

       {{file Text uploads/Files/test.txt}}

TYPE is a plugin present in Formatter/File/ directory.

Currently there are only three: Pod, DocBook and Text

The plugin TYPE format only the file which the extension match with 'can_format' method. Respectively pod, xml and txt for existing plugins.

For security reasons the path of file must be include in 'whitelisting' directory. You can use path_to(DIR) to describe directory in mojomojo.conf:

Just an example to view the test pod file t/var/files/test.pod :

Add this to mojomojo.conf :

<Formatter::Dir>
prefix_url /myfiles
whitelisting __path_to(t/var/files)__ </Formatter::Dir>

To see the pod content formatted in xhtml, write in the text area:

{{file Pod path_to(t/var/files)test.pod}}

To show recursively all files of directory see script/util/dir2mojomojo.pl script. To test it:

# start mojomojo

./script/mojomojo_server.pl

# run dir2mojomojo script

./script/util/dir2mojomojo.pl --dir=~/dev/mojomojo/t/var/files/ --url=/myfiles

Connect to http://server:3000/myfiles/

Methods

format_content_order

Format order can be 1-99. The File formatter runs on 92.

format_content

Calls the formatter. Takes a ref to the content as well as the context object.

plugin

Return the plugin to use with file attachment

format

Return the content formatted

checkplugin

Return 0 if plugin exist

checkfile

Directory must be include in whitelisting

Releases

5 releases since Debian 6.0 (Squeeze); the text changed 4 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10

Authors

Daniel Brosseau <[email protected]>

License

This module is licensed under the same terms as Perl itself.

From libmojomojo-perl 1.12+dfsg-1 in Debian 10 (Buster). Parsed by carta from the page's man source.