2017 © Pedro Peláez
 

library zfc-twig

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

image

zf-commons/zfc-twig

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  • Saturday, April 16, 2016
  • by SpiffyJr
  • Repository
  • 15 Watchers
  • 102 Stars
  • 346,443 Installations
  • PHP
  • 20 Dependents
  • 1 Suggesters
  • 61 Forks
  • 24 Open issues
  • 16 Versions
  • 4 % Grown

The README.md

ZfcTwig Module for Zend Framework 2 Master Branch Build Status

ZfcTwig is a module that integrates the Twig templating engine with Zend Framework 2., (*1)

Installation

  1. Add "zf-commons/zfc-twig": "dev-master" to your composer.json file and run php composer.phar update.
  2. Add ZfcTwig to your config/application.config.php file under the modules key.

Configuration

ZfcTwig has sane defaults out of the box but offers optional configuration via the zfctwig configuration key. For detailed information on all available options see the module config file class., (*2)

Documentation

Setting up Twig extensions

Extensions can be registered with Twig by adding the FQCN to the extensions configuration key which is exactly how the ZfcTwig extension is registered., (*3)

// in module configuration or autoload override
return array(
    'zfctwig' => array(
        'extensions' => array(
            // an extension that uses no key
            'My\Custom\Extension',

            // an extension with a key so that you can remove it from another module
            'my_custom_extension' => 'My\Custom\Extension'
        )
    )
);

Configuring Twig loaders

By default, ZfcTwig uses a Twig_Loader_Chain so that loaders can be chained together. A convenient default is setup using a filesystem loader with the path set to module/Application/view which should work out of the box for most instances. If you wish to add additional loaders to the chain you can register them by adding the service manager alias to the loaders configuration key., (*4)

// in module configuration or autoload override
return array(
    'zfctwig' => array(
        'loaders' => array(
            'MyTwigFilesystemLoader'
        )
    )
);

// in some module
public function getServiceConfiguration()
{
    return array(
        'factories' => array(
            'MyTwigFilesystemLoader' => function($sm) {
                return new \Twig_Loader_Filesystem('my/custom/twig/path');
            }
        )
    );
}

Using ZF2 View Helpers

Using ZF2 view helpers is supported through the ZfcTwig\Twig\FallbackFunction function., (*5)

{# Simple view helper echo #}
{{ docType() }}

{# Echo with additional methods #}
{{ headTitle('My Company').setSeparator('-') }}

{# Using a view helper without an echo #}
{% do headTitle().setSeparator('-') %}

{# Combining view helpers #}
{% set url = ( url('my/custom/route') ) %}

Examples

Example .twig files for the skeleton application can be found in the examples folder., (*6)

Gotchas

ZF2 does not support multiple renderers with view helpers very well. As a workaround, ZfcTwig registers its own HelperPluginManager that extends the default Zend\View\HelperPluginManager and adds the default as a peering manager. This let's ZfcTwig register its own renderer with view helpers that require it and fallback to the default manager for view helpers that do not require one., (*7)

As a caveat, you must register view helpers that require a renderer with ZfcTwig. An example can be seen in config/module.config.php where the HelperConfig for the default navigation helpers is registered with ZfcTwig., (*8)

The Versions

16/04 2016

dev-master

9999999-dev http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

The Development Requires

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

29/04 2014

1.2.2

1.2.2.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

The Development Requires

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

05/03 2014

1.2.1

1.2.1.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

The Development Requires

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

05/03 2014

dev-develop

dev-develop http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

The Development Requires

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

24/01 2014

1.2

1.2.0.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

The Development Requires

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

24/06 2013

1.1.5

1.1.5.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

20/06 2013

1.1.4

1.1.4.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

10/06 2013

1.1.3

1.1.3.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

19/04 2013

1.1.2

1.1.2.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

18/04 2013

1.1.1

1.1.1.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

16/04 2013

1.1.0

1.1.0.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

08/02 2013

1.0.3

1.0.3.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

16/01 2013

1.0.2

1.0.2.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

11/12 2012

1.0.1

1.0.1.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

29/11 2012

1.0

1.0.0.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module

13/11 2012

0.1

0.1.0.0 http://www.github.com/ZF-Commons/ZfcTwig/

Zend Framework 2 Module that provides a Twig rendering strategy and extensions to render actions or trigger events from your templates

  Sources   Download

The Requires

 

by Kyle Spraggs
by Cosmin Harangus

twig zf2 module