NAME

HTML::BBCode - Perl extension for converting BBcode to HTML.

SYNOPSIS

  use HTML::BBCode;

  my $bbc  = HTML::BBCode->new( \%options );
  my $html = $bbc->parse($bbcode);

  # Input
  print $bbc->{bbcode};

  # Output
  print $bbc->{html};

DESCRIPTION

HTML::BBCode converts BBCode -as used on the phpBB bulletin boards- to its HTML equivalent.

METHODS

The following methods can be used

new

   my $bbc = HTML::BBCode->new({
      allowed_tags => [ @bbcode_tags ],
      stripscripts => 1,
      linebreaks   => 1,
   });

new creates a new HTML::BBCode object using the configuration passed to it. The object's default configuration allows all BBCode to be converted to the default HTML.

options

parse

   my $html = $bbc->parse($bbcode);

Parses text supplied as a single scalar string and returns the HTML as a single scalar string.

CAVEAT: API CHANGES

Please do note that the html_tags, no_html, no_jslink options in the new method have been removed since version 2.0 due to the XSS protection (provided by HTML::StripScripts::Parser). This will most likely break your current scripts (if you used the html_tags option).

SEE ALSO

BUGS

Bugs? Impossible!. Please report bugs to http://rt.cpan.org/Ticket/Create.html?Queue=HTML-BBCode.

AUTHOR

M. Blom, <blom@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2004-2008 by M. Blom

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