BBCode

, _(*1)

BBCode parser from or to HTML., _(*2)

Installation

PHP 7.1+ is required., _(*3)

To get the latest version of BBCode, simply require the project using Composer:, _(*4)

$ composer require genert/bbcode

Usage

`convertFromHtml(string $text)`

Convert BBCode to HTML and returns parsed text as string., _(*5)

Example:, _(*6)

use Genert\BBCode\BBCode;

$bbCode = new BBCode();

// Output: '[b]Hello word![/b]'
$bbCode->convertFromHtml('<strong>Hello word!</strong>');

`convertToHtml(string $text, [$caseSensitive])`

Convert HTML to BBCode and returns parsed text as string., _(*7)

Example:, _(*8)

use Genert\BBCode\BBCode;

$bbCode = new BBCode();

// Output: '<strong>Hello word!</strong>'
$bbCode->convertToHtml('[b]Hello word![/b]');

This function also supports case sensitive BBCode parsing by optional parameter., _(*9)

To enable this, simply pass BBCode::CASE_SENSITIVE as second argument:, _(*10)

// Output: '<strong><i><u>Ran<strong>d</strong>om text</u></i></strong>'
$bbCode->convertToHtml('[B][I][U]Ran[b]d[/b]om text[/u][/I][/b]', BBCode::CASE_SENSITIVE);

`stripBBCodeTags(string $text)`

Strips BBCode tags from text and returns output as string., _(*11)

Example:, _(*12)

use Genert\BBCode\BBCode;

$bbCode = new BBCode();

// Output: 'Hello word!'
$bbCode->stripBBCodeTags('[b]Hello word![/b]');

`only(array list or ...args)`

Sets parser to only convert set BBCode tags., _(*13)

Example:, _(*14)

use Genert\BBCode\BBCode;

$bbCode = new BBCode();

// Output: '<strong>Bold</strong> [i]italic[/i]'
$bbCode->only('bold')->convertToHtml('[b]Bold[/b] [i]italic[/i]');

// Or as array
$bbCode->only(['bold'])->convertToHtml('[b]Bold[/b] [i]italic[/i]');

`except(array list or ...args)`

Sets parser to only convert all BBCode tags except listed., _(*15)

Example:, _(*16)

use Genert\BBCode\BBCode;

$bbCode = new BBCode();

// Output: '[b]Bold[/b] <i>italic</i>'
$bbCode->except('bold')->convertToHtml('[b]Bold[/b] [i]italic[/i]');

// Or as array
$bbCode->except(['bold'])->convertToHtml('[b]Bold[/b] [i]italic[/i]');

`addParser(string $name, string $pattern, string $replace, string $content)`

Add regex based BBCode parser to translate found pattern to desired one., _(*17)

Example:, _(*18)

use Genert\BBCode\BBCode;

$bbCode = new BBCode();

// Add "[link target=http://example.com]Example[/link]" parser.
$bbCode->addParser(
    'custom-link',
    '/\[link target\=(.*?)\](.*?)\[\/link\]/s',
    '<a href="$1">$2</a>',
    '$1'
);

// Output: '<a href="www.yourlinkhere.com">Text to be displayed</a>.'
$bbCode->convertToHtml('[link target=www.yourlinkhere.com]Text to be displayed[/link].');

`addHtmlParser(string $name, string $pattern, string $replace, string $content)`

Add HTML parser to translate pattern to desired one., _(*19)

See addParser for example code., _(*20)

`addLinebreakParser()`

Adds linebreak parser to BBCode parsers list to convert newlines to <br /> in HTML., _(*21)

Laravel installation

Once BBCode is installed, you need to register the service provider. Open up config/app.php and add the following to the providers key., _(*22)

\Genert\BBCode\BBCodeServiceProvider::class,

You can register facades in the aliases key of your config/app.php file if you like., _(*23)

'BBCode' => \Genert\BBCode\Facades\BBCode::class,

With registered facade, you can use library's functionality as following:, _(*24)

// Output: '<strong>Laravel wins</strong>'
echo BBCode::convertToHtml('[b]Laravel wins[/b]');

// Output: '[b]Do Symphony or not[/b]'
echo BBCode::convertFromHtml('<strong>Do Symphony or not</strong>');

// Output: '<strong>What does<strong> [i]fox say[/i]'
echo BBCode::only('bold')->convertToHtml('[b]What does[/b] [i]fox say[/i]');