brouwers/shortcodes

Wordpress like shortcodes for Laravel 4.2

Laravel-Shortcodes

Wordpress like shortcodes for Laravel 4.2., _(*1)

[b class="bold"]Bold text[/b]

[tabs]
  [tab]Tab 1[/tab]
  [tab]Tab 2[/tab]
[/tabs]

[user id="1" display="name"]

If you are looking for BBcodes, see: https://github.com/patrickbrouwers/Laravel-BBcodes, _(*2)

, _(*3)

Installation

Require this package in your composer.json and update composer., _(*4)

"brouwers/shortcodes": "1.*"

After updating composer, add the ServiceProvider to the providers array in app/config/app.php, _(*5)

'Brouwers\Shortcodes\ShortcodesServiceProvider',

You can use the facade for shorter code. Add this to your aliases:, _(*6)

'Shortcode' => 'Brouwers\Shortcodes\Facades\Shortcode',

The class is bound to the ioC as shortcode, _(*7)

$shortcode = App::make('shortcode');

Usage

View compiling

By default shortcode compiling is set to false inside the config., _(*8)

withShortcodes()

To enable the view compiling features:, _(*9)

return View::make('view')->withShortcodes();

This will enable shortcode rendering for that view only., _(*10)

Config

Enabeling the shortcodes through config shortcodes::enabled will enable shortcoding rendering for all views., _(*11)

Enable through class

Shortcode::enable();

Disable through class

Shortcode::disable();

Disabeling some views from shortcode compiling

With the config set to true, you can disable the compiling per view., _(*12)

return View::make('view')->withoutShortcodes();

Default compiling

To use default compiling:, _(*13)

Shortcode::compile($contents);

Registering new shortcodes

Inside a file or service provider you can register the shortcodes. (E.g. app/start/shortcodes.php or App/Services/ShortcodeServiceProvider.php), _(*14)

Callback

Shortcodes can be registered like Laravel macro's with a callback:, _(*15)

Shortcode::register('b', function($shortcode, $content, $compiler, $name)
{
  return '<strong class="'. $shortcode->class .'">' . $content . '</strong>';
});

Default class

class BoldShortcode {

  public function register($shortcode, $content, $compiler, $name)
  {
    return '<strong class="'. $shortcode->class .'">' . $content . '</strong>';
  }
}

Shortcode::register('b', 'BoldShortcode');

Class with custom method

class BoldShortcode {

  public function custom($shortcode, $content, $compiler, $name)
  {
    return '<strong class="'. $shortcode->class .'">' . $content . '</strong>';
  }
}

Shortcode::register('b', 'BoldShortcode@custom');

Register helpers

If you only want to show the html attribute when the attribute is provided in the shortcode, you can use $shortcode->get($attributeKey, $fallbackValue = null), _(*16)

class BoldShortcode {

  public function register($shortcode, $content, $compiler, $name)
  {
    return '<strong '. $shortcode->get('class', 'default') .'>' . $content . '</strong>';
  }
}