thelia / short-code-module

3.0.2 2026-08-27 14:03 UTC

Requires

• thelia/installer: ^1.6

GPL-3.0-or-later

Published on Packagist.org on 2026-08-27 14:03 UTC

README

Implementation of Wordpress' Shortcode syntax in Thelia.
This module scan the Thelia response at the research of registred short code (in DB), if a short code is find the module dispatch the associated event.

Installation

Manually

• Copy the module into <thelia_root>/local/modules/ directory and be sure that the name of the module is ShortCode.
• Activate it in your thelia administration panel

Composer

Add it in your main thelia composer.json file

composer require thelia/shortcode-module:~1.0

Usage

This module https://github.com/thelia-modules/ShortCodeMeta is a good example of how to use ShortCode.

1. Register your short codes

You can do this at the post activation of your module. The best way to do this is to use the module method : ShortCode::createNewShortCodeIfNotExist the first parameter is the name you will use to call the short code in your templates (like this `[my_shortcode_name], second parameter is the event dispatched when the short code is detected.

2. Add short codes to your templates

The short codes syntax is as follows:

[shortcode] - No content, no attributes   
[shortcode]My Content[/shortcode] - Short code with content  
[shortcode attribute=value foo=bar] - Short code with attributes  
[shortcode attribute=value foo=bar]My Content[/shortcode] - Short code with content and attributes  

3. Listen events associated to your short codes

When a short code is detected in response a ShortCodeEvent is dispatched with the event name given at the creation. So if you want replace your short code by something you have to listen this event. In this event you have 3 properties :

• content (string) The content between your tags it will be My Content for the example above.
• attributes (array) The array of all attributes passed to your short code ['attribute'=>'value', 'foo'=>'bar'] for the example above.
• result (string) Your short code will be replaced by this value in response (equal to content by default)

Tests

The parser has no Thelia dependency, so its tests run without a kernel or a database:

vendor/bin/phpunit vendor/thelia/modules/ShortCode/Tests

Third-party code

Parser/ShortcodeParser.php and Parser/ShortcodeRenderer.php are derived from maiorano84/shortcodes v2.0.0-beta, Copyright (c) Matt Maiorano, released under the GNU General Public License version 2 or later. The regular expressions they use come from WordPress, released under the same license. Both files carry that notice in their header.