File: system/dependencies/codedepp/bbcode/README.md

Recommend this page to a friend!

system/dependencies/codedepp/bbcode/README.md

File:	`system/dependencies/codedepp/bbcode/README.md`
Role:	Documentation
Content type:	`text/markdown`
Description:	Documentation
Class:	dFramework Framework to build PHP applications
Author:	By Dimitri Sitchet
Last change:
Date:	4 years ago
Size:	`4,571 bytes`

Download

BBCode

> BBCode parser from or to HTML.

Installation

PHP 7.1+ is required.

To get the latest version of BBCode, simply require the project using Composer:

$ composer require codedepp/bbcode

Usage

`convertFromHtml(string $text)`

Convert BBCode to HTML and returns parsed text as string.

Example:

use Codedepp\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.

Example:

use Codedepp\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.

To enable this, simply pass BBCode::CASE_SENSITIVE as second argument:

// 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.

Example:

use Codedepp\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.

Example:

use Codedepp\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.

Example:

use Codedepp\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.

Example:

use Codedepp\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.

See addParser for example code.

`addLinebreakParser()`

Adds linebreak parser to BBCode parsers list to convert newlines to <br /> in HTML.

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.

`\Codedepp\BBCode\BBCodeServiceProvider::class,`

You can register facades in the aliases key of your config/app.php file if you like.

`'BBCode' => \Codedepp\BBCode\Facades\BBCode::class,`

With registered facade, you can use library's functionality as following:

// 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]');