Laravel-Shortcodes

WordPress-like shortcodes for Laravel 11, 12, and 13 (PHP 8.2+).

Documentation last updated: 2026-04-22

[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 Laravel 4.2, see: https://github.com/patrickbrouwers/Laravel-Shortcodes

Install

Via Composer:

composer require webwizo/laravel-shortcodes

Laravel 11+ discovers the package automatically. On older setups, register Webwizo\Shortcodes\ShortcodesServiceProvider in config/app.php (or bootstrap/providers.php where applicable).

Service provider (manual registration)

Webwizo\Shortcodes\ShortcodesServiceProvider::class,

You can use the facade for shorter code. Add this to your aliases (optional):

'Shortcode' => Webwizo\Shortcodes\Facades\Shortcode::class,

The class is bound to the ioC as shortcode

$shortcode = app('shortcode');

Usage

withShortcodes()

To enable the view compiling features:

return view('view')->withShortcodes();

This will enable shortcode rendering for that view only.

withShortcodes() in Mailables

You can also enable shortcode compilation for a mailable view:

Available since: v1.0.31

use Illuminate\Mail\Mailable;

class NewsletterMail extends Mailable
{
    public function build()
    {
        return $this
            ->subject('Weekly newsletter')
            ->view('emails.newsletter', [
                'content' => 'Mail content',
            ])
            ->withShortcodes();
    }
}

emails/newsletter.blade.php

[b class="mail"]{{ $content }}[/b]

The shortcode tags in that mailable view will be compiled during rendering.

Enable through class

Shortcode::enable();

Disable through class

Shortcode::disable();

Disabling some views from shortcode compiling

With the config set to true, you can disable the compiling per view.

return view('view')->withoutShortcodes();

Default compiling

To use default compiling:

Shortcode::compile($contents);

Strip shortcodes from rendered view.

return view('view')->withStripShortcodes();

Strip shortcode through class

Shortcode::strip($contents);

Shortcode syntax and parser

The compiler scans templates left to right. Behaviour relevant to authoring tags:

| Topic | Behaviour | |--------|------------| | Attributes | Quoted values may contain spaces. Keys may include hyphens (e.g. data-size="large"). Parsing follows the same general rules as WordPress shortcode attributes. | | Void / self-closing | A tag such as [alert type="info"] with no matching [/alert] is treated as self-closing (no inner body). Use explicit [/tag] when you need wrapping content. | | Nested same-name tags | Nested tags with the same name (e.g. [div]…[div]…[/div]…[/div]) are matched using balanced opening/closing pairs, innermost structure preserved. | | Unknown [ text | Text in square brackets that does not start with a registered shortcode name is left unchanged (so prose like [I agree …] is not eaten). | | Escaping | Use doubled brackets to output a literal shortcode: [[b]] → [b]. |

PHPUnit regression tests for these cases live under tests/GitHubIssue*.php.

Registering new shortcodes

Create a new ServiceProvider where you can register all the shortcodes.

php artisan make:provider ShortcodesServiceProvider

After defining shortcodes, add the ServiceProvider to the providers array in config/app.php (or bootstrap/providers.php).

Example: register your shortcodes provider

App\Providers\ShortcodesServiceProvider::class,

Callback

Shortcodes can be registered within ShortcodesServiceProvider with a callback:

php artisan make:provider ShortcodesServiceProvider

ShortcodesServiceProvider.php Class File

<?php namespace App\Providers;

use App\Shortcodes\BoldShortcode;
use Illuminate\Support\ServiceProvider;
use Shortcode;

class ShortcodesServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap the application services.
     *
     * @return void
     */
    public function boot()
    {
        //
    }

    /**
     * Register the application services.
     *
     * @return void
     */
    public function register()
    {
        Shortcode::register('b', BoldShortcode::class);
        Shortcode::register('i', 'App\Shortcodes\ItalicShortcode@custom');
    }
}

Default class for BoldShortcode

You can store each shortcode within their class app/Shortcodes/BoldShortcode.php

namespace App\Shortcodes;

class BoldShortcode {

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

}

Class with custom method

You can store each shortcode within their class app/Shortcodes/ItalicShortcode.php

namespace App\Shortcodes;

class ItalicShortcode {

  public function custom($shortcode, $content, $compiler, $name, $viewData)
  {
    return sprintf('<i class="%s">%s</i>', $shortcode->class, $content);
  }

}

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)

class BoldShortcode {

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

}

Shortcode Artisan Generator Command

This package provides an Artisan command to quickly generate shortcode classes:

php artisan make:shortcode YourShortcodeName

• By default, this creates a new class in app/Shortcodes/YourShortcodeNameShortcode.php.
• If the file already exists, use the --force option to overwrite:

php artisan make:shortcode YourShortcodeName --force

Customizing the Stub

You can publish the stub file to customize the generated class:

php artisan vendor:publish --tag=shortcode-stubs

This will copy the stub to resources/stubs/shortcode.stub in your Laravel app. Edit this file to change the template for new shortcode classes.

Testing

From the package root (after composer install):

composer test
# or
vendor/bin/phpunit

Change log

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING and CONDUCT for details.

Security

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

Credits

• Asif Iqbal
• All Contributors

Support me

License

The MIT License (MIT). Please see License File for more information.