Download the PHP package artgris/page-bundle without Composer

Artgris Page

Installation:

composer require artgris/page-bundle

php bin/console doctrine:schema:update --force 

Configuration:

in config/packages

configure KnpLabs/DoctrineBehaviors: https://github.com/KnpLabs/DoctrineBehaviors

• Add locale parameter in services.yaml:

• Add to AppKernel:

• Add to DashboardController.php :

add a2lix_translation_form.yaml

ex:

add artgris_page.yaml

not required, no minimal configuration

[1] Default form types list:

Usage:

1 - Create a page and add blocks

2 - Edit the content of the blocks

3 - Retrieve a simple block by tag

{{ blok('title') }}

=> return "My website"

use the debugging bar to easily find all blocks by route. (click on block tag to copy/paste code)

Retrieve all blocks of the current page or not linked to a page

bloks()

ex:

{% for blok in bloks() %}
    {{ blok }} <br>
{% endfor %}

Retrieve all blocks by page tag

page('page-tag')

ex:

{% for blok in page('homepage') %}
    {{ blok }} <br>
{% endfor %}

Retrieve blocks with a regular expression

in an array

regex_array_blok('regex-expression')

ex:

{% for blok in regex_array_blok('^sidebar-*') %}
    {{ blok }} <br>
{% endfor %}

implode in a string

regex_blok('regex-expression')

ex:

{{ regex_blok('^sidebar-*') }}  

Tips:

custom block rendering

create a form type that implements PageFromInterface:

namespace App\Form;

use Artgris\Bundle\PageBundle\Form\Type\PageFromInterface;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\TextareaType;
use Symfony\Component\OptionsResolver\OptionsResolver;

class CustomType extends AbstractType implements PageFromInterface
{

    public function configureOptions(OptionsResolver $resolver)
    {
        $resolver->setDefaults([
            'attr' => [
                'class' => 'custom',
            ],
            'required' => false,
        ]);
    }

    public function getParent()
    {
        return TextareaType::class;
    }

    public static function getRenderType($value)
    {
        return $value. '<hr>';
    }
}

Edit the rendering as you wish using the getRenderType method.

Commands

Export database model (no values) in a file ("/pages/model.yaml")

php bin/console artgris:page:export

/pages/model.yaml extract:

Import model ("/pages/model.yaml") in database

php bin/console artgris:page:import

add --remove-deviants to delete the content of types that have changed (ex: text type in yaml but integer type in bd)

php bin/console artgris:page:import --remove-deviants

add --ignore-names to ignore page and bloc names that have changed

php bin/console artgris:page:import --ignore-names

Remove extra pages/blocks (in database but not in model.yaml)

php bin/console artgris:page:remove:extra

Tutorials

• How to create a TinyMCE Type

Cache Infos

All blocks of the current page or not linked to a page are cached (and present in the debug bar) after calling one of these twig functions:

• bloks()
• blok('block-linked-to-the-current-page') => via route selector in page configuration
• blok('block-linked-to-any-page') => route selector left empty

content added to the cache after the first call:

• blok('block-of-another-page')

not in cache, required new db call after each call:

• page('page-tag')
• regex_array_blok('regex-expression')
• regex_blok('regex-expression')