force/shortcode

The Shortcode Component for creating shortcodes.

Shortcode Component

, _(*1)

The Shortcode Component is a simple regex based parser that allows you to replace simple bbcode-like tags within a HTMLText or HTMLVarchar field when rendered into a content., _(*2)

Installation

composer require flextype-components/shortcode

Usage

use Flextype\Component\Shortcode\Shortcode;

Examples of shortcode tags:, _(*3)

{{shortcode}}
{{shortcode parameter="value"}}

Example of escaping shortcodes:, _(*4)

{{{shortcode}}}

Add new shortcode

Your shorcode function:, _(*5)

function returnSiteUrl() {
   return 'http://example.org';
}

Add shortcode, _(*6)

Shortcode::add('site_url', 'returnSiteUrl');

Add new shortcode with Variables

Your shorcode function:, _(*7)

function foo($attributes) {
    // Extract attributes
    extract($attributes);

    // text
    if (isset($text)) $text = $text; else $text = '';

    // return
    return $text;
}

Add shortcode {foo text="Hello World"}, _(*8)

Shortcode::add('foo', 'foo');

Usage:, _(*9)

{foo text="Hello World"}

Result:, _(*10)

Hello World

Add new shortcode with Variables and Content

Your shorcode function:, _(*11)

function foo($attributes, $content) {
    // Extract attributes
    extract($attributes);

    // text
    if (isset($color)) $color = $color; else $color = 'black';

    // return
    return '<span style="color:'.$color.'">'.$content.'</span>';
}

Add shortcode {foo color="red"}, _(*12)

Shortcode::add('foo', 'foo');

Usage:, _(*13)

{foo color="red"}Hello World{/foo}

Result:, _(*14)

<span style="color: red">Hello World</span>  

Check if a shortcode has been registered.

if (Shortcode::exists('foo')) {
    // do something...
}

Remove a specific registered shortcode.

Shortcode::delete('foo');

Remove all registered shortcodes.

Shortcode::clear();

Braces

The shortcode parser does not accept braces within attributes. Thus the following will fail:, _(*15)

{foo attribute="{Some value}"}Hello World{/foo}

License

See LICENSE, _(*16)