popov/zfc-block

Create separatly custom template bock with html, css, js etc.

ZF Block Helper

Create separately custom template bock with html, css, js etc., _(*1)

Usage

For Expressive: register ZfcBlock module in config/config.php with Popov\ZfcBlock\ConfigProvider::class., _(*2)

For MVC: register with Popov\ZfcBlock in your configuration., _(*3)

Create new Block class in your module with name LoginBlock, _(*4)

// src/Your/Module/src/Block/LoginBlock.php

namespace Stagem\Visitor\Block;

use Popov\ZfcBlock\Block\Core;
use Popov\ZfcUser\Form\LoginForm;

class LoginBlock extends Core
{
    /**
     * @var LoginForm
     */
    protected $loginForm;

    public function __construct(LoginForm $loginForm)
    {
        $this->loginForm = $loginForm;
    }

    public function getLoginForm()
    {
        return $this->loginForm;
    }
}

This class must extend Popov\ZfcBlock\Block\Core for allow usage basic functionality such as translate, check permission and other auxiliary opportunities., _(*5)

Next step you can: * create Factory for this block; * use ReflectionFactory, this will be convenient if project is under development. Register factory in your config/autoload/dependencies.global.php php return [ // ... 'block_plugins' => [ 'abstract_factories' => [ Zend\ServiceManager\AbstractFactory\ReflectionBasedAbstractFactory::class ], ] ];, _(*6)

If you decide use ReflectionFactory then minimum bare you need add alias for your block to configuration, _(*7)

// src/Stagem/Visitor/config/module.config.php
return [
    // ...
    'block_plugins' => [
        'aliases' => [
            'VisitorLogin' => \Your\Module\Block\LoginBlock::class,
        ],
    ],
    'block_plugin_config' => [
        'default' => [
            \Your\Module\Block\LoginBlock::class => [
                'template' => 'visitor::login'
            ],
        ],
    ],
];

Be aware. Don't use ReflactionFactory on production, create real Factory for your block class., _(*8)

After that your can call your block in any template with, _(*9)

<div>    
    <?= $this->block()->render('VisitorLogin') ?>
</div>

Or the same example with advanced usage, _(*10)

<div> 
    <?php $loginBlock = $this->block('VisitorLogin'); ?>   
    <?= $this->block()->render($loginBlock) ?>
</div>      

Advanced usage can be useful for set additional parameters., _(*11)

For example, block template can have next view, _(*12)

// src/Your/Module/view/visitor/login.phtml
<?php
$form = $block->getLoginForm();
$form->setAttribute('action', $this->url('default', [
    'controller' => 'visitor',
    'action' => 'login',
]));
$form->prepare();
?>
<?= $this->form()->openTag($form) ?>
    <div class="modal-content">
        <div class="right-side">
            <div class="form-group">
                <label for="user"><?= $form->get('email')->getLabel() ?>:</label>
                <?= $this->formElement($form->get('email')) ?>
            </div>
            <div class="form-group">
                <label for="password"><?= $form->get('password')->getLabel() ?>:</label>
                <?= $this->formRow($form->get('password')) ?>
            </div>
        </div>
    </div>
<?= $this->form()->closeTag() ?>

Configuration

block_plugin_config in config file is used for set some specific configuration for Block. All config parameters will be set with setter., _(*13)

• default key sets general configuration for Block
• also configuration can be set per resource/action, where resource in most cases is controller or module taken from URL.

return [
    // ...
    'block_plugins' => [
        'aliases' => [
            'VisitorLogin' => \Your\Module\Block\LoginBlock::class,
        ],
    ],
    'block_plugin_config' => [
        'visitor/login' => [
            \Your\Module\Block\LoginBlock::class => [
                'template' => 'visitor::login'
            ],
        ],
    ],
];

If you need some complex parameters in your Block use Factory for this purpose., _(*14)

Types

• list (roster)

In action:, _(*15)

public function process(\Psr\Http\Message\ServerRequestInterface $request)
{
    $viewModel = (new ViewModel())->setTemplate('block::list')
        ->addChild($viewModelOne, 'one')
        ->addChild($viewModelTwo, 'two')
        ->addChild($viewModelThree, 'three');

    return $viewModel;
}

All your blocks will be rendered automatically one by one., _(*16)