Dynamic Variables | Multi-Language & Multi-Channel Content Placeholders for CMS

Installation

1. Upload the plugin via Plugin Manager or install via Composer
2. Activate the plugin in the Plugin Manager
3. Clear the cache

Plugin Settings

Navigate to Extensions → My extensions → Dynamic Variables in the admin sidebar to configure:

• Enable CMS Pages (default: on) — Replace variables in CMS page content
• Enable CMS Preview (default: on) — Show live variable preview in the CMS text editor
• Enable Products (default: off) — Replace variables in product names, descriptions, and meta fields
• Enable Categories (default: off) — Replace variables in category names, descriptions, meta fields, and breadcrumbs

Creating a Variable

1. Go to Content → Dynamic Variables in the admin sidebar
2. Click Add Variable
3. Fill in the required fields:
   • Key — Unique identifier used as placeholder, e.g. promotionText (used as {promotionText} in content)
   • Active — Enable or disable the variable
4. Optionally set Scopes:
   • Leave empty for the variable to work everywhere
   • Select CMS Page, Product, and/or Category to restrict where the variable is replaced
5. Add Values:
   • Click Add channel value to create a new value entry
   • Sales Channel — Leave empty for a global value, or select a specific channel
   • Value — The replacement content (supports rich text / HTML, translatable per language)
   • CSS styles — Optional custom CSS injected when this variable is used (translatable)
   • JavaScript — Optional JavaScript injected when this variable is used (translatable)
6. Save the variable

Using Variables in Content

Method 1: Variable Picker (Recommended)

1. Open any CMS text editor (e.g., text block, HTML block)
2. Click the Dynamic Variables button in the editor toolbar
3. Browse or search available variables
4. Click a variable to insert it at cursor position

Method 2: Manual Entry

Simply type the variable key wrapped in curly braces: {variableName}

In Products and Categories

Use the same {variableName} syntax directly in product or category fields (name, description, meta fields). Make sure the corresponding scope is enabled in plugin settings and on the variable itself.

Built-In Variables

These variables are available immediately without any configuration:

• {shopName} — Store name from Settings → Basic Information
• {shopEmail} — Store email from Settings → Basic Information
• {shopAddress} — Store address from Settings → Basic Information
• {shopBankAccount} — Bank account from Settings → Basic Information

Multi-Channel Setup

To display different content per sales channel:

1. Add a value with no sales channel selected — this is the global fallback
2. Add additional values with specific sales channels selected
3. The plugin will use the channel-specific value when available, otherwise fall back to the global value

Multi-Language Setup

Variable values are translatable. Switch languages in the admin panel and enter different content for each language. The plugin will automatically display the value matching the current storefront language.

Nested Variables

Variables can reference other variables within their values. For example, if you have a variable {companyInfo} with the value {shopName} - {shopAddress}, it will resolve both inner variables. Nesting works one level deep to prevent circular references.

Tips

• Use the live preview in the CMS editor to verify variable replacement before publishing
• Start with built-in variables to test the feature before creating custom ones
• Keep variable keys short and descriptive (e.g., promoText, footerDisclaimer)
• Use scopes to limit variables to relevant content types and improve performance
• Attach CSS/JS only when needed — they are only injected on pages where the variable is actually used