contextualcode/ezplatform-content-variables

eZ Platform bundle which provides dynamic content variables and UI to manage them

v3.2.1 2021-09-01 11:26 UTC

Requires

• php: >=7.3
• doctrine/migrations: ^3.0
• doctrine/orm: ^2.6
• ezsystems/ezplatform-admin-ui: ^2.2
• ezsystems/ezplatform-kernel: ^1.2
• ezsystems/ezplatform-richtext: ^2.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^2.17

GPL-2.0-only

• Serhey Dolgushev

• ezplatform

README

This bundle provides a way to manage content variables. Basically, those are placeholders you can use anywhere in your content (in any field types). And they will be replaced with actual values during the page rendering.

Installation

1. Require contextualcode/ezplatform-content-variables via composer:

   composer require contextualcode/ezplatform-content-variables
   

2. Update routes in config/routes.yaml:

    content_variables:
        resource: "@EzPlatformContentVariablesBundle/Resources/config/routing.yaml"
   

3. Run the migrations:

   php bin/console doctrine:migrations:migrate --configuration=vendor/contextualcode/ezplatform-content-variables/src/bundle/Resources/config/doctrine_migrations.yaml --no-interaction
   

Usage

All the content variables are grouped in the collections. So first you would need to define those collections. To do so, open an eZ Platform admin interface and go to "Content > Variables". And create a first content variables collection.

After the collection is created, you would need to add some variables. Click on the collection name and add a few content variables. You would need to specify the following parameters for each variable:

• Name
• Identifier
• Value

There are two types of content variables: static and callback. No default callbacks are provided out of the box, but it is very easy to create a new one:

1. Create a new AppBundle\ContentVariables\Random service (src/AppBundle/ContentVariables/Random.php), which extends ContextualCode\EzPlatformContentVariables\Variable\Value\Callback.

    <?php
       
    namespace AppBundle\ContentVariables;
       
    use ContextualCode\EzPlatformContentVariables\Variable\Value\Callback;
       
    class Random extends Callback
    {
        protected $identifier = 'random';
       
        public function getValue(): string
        {
            return random_int(0, 100);
        }
    }
   

2. In the AppBundle\ContentVariables\Random service you need to:

   • Define $identifier property, it need to be unique in the scope of your project
   • Implement getValue function, it does not take any arguments and should return a string value. You can use any injected services in this function.

3. Tag AppBundle\ContentVariables\Random with content_variables.value.callback:

    AppBundle\ContentVariables\Random:
        tags: [content_variables.value.callback]
   

Thats all, now when you add/edit any content variable you would be able to choose random callback for it.

After some content variables are created, you can use them in any content fields. To do so, please use a variable identifier wrapped with # sign. For example, if you have a variable with random_var identifier, try to add #random_var# to some pages content. And check edited content on the front-end siteaccess. An actual random number should be shown instead of #random_var#.