dflydev/theme-twig-extension

Twig Extension for Theme

Theme Twig Extension

A Theme extension for Twig., _(*1)

Installation

Through Composer as dflydev/theme-twig-extension., _(*2)

Usage

The following examples use the Symfony Routing implementation of ResourceUrlGeneratorInterface., _(*3)

<?php
use Dflydev\Theme\ResourceUrlGenerator\SymfonyRoutingResourceUrlGenerator;
use Dflydev\Twig\Extension\Theme\ThemeTwigExtension;

// Assumes $themeProvider, $pathMapper, $urlGenerator, and $twig
// are already created and ready to be used.

$resourceUrlGenerator = new SymfonyRoutingResourceUrlGenerator(
    $themeProvider,
    $pathMapper,
    $urlGenerator
);

$themeTwigExtension = new ThemeTwigExtension(
    $resourceUrlGenerator
);

$twig->addExtension($themeTwigExtension);

Once enabled, Theme resources can be referenced by:, _(*4)

{{ theme_resource('css/main.css') }}

If css/main.css is accessible directly via the Theme instances docroot (as determined by the PathMapperInterface) then a URL to the public resource will be used., _(*5)

If css/main.css is not accessible directly, the UrlGeneratorInterface implementation will be used to generate a URL to the embedded Theme controllers., _(*6)

All implementations of ResourceUrlGeneratorInterface should follow the pattern of:, _(*7)

1. Checking to see if the resource is available publicly and using that if available.
2. Generating a fallback URL to expose non-public resources.

Controller Requirements Example (Silex + Symfony Routing)

• _dflydev_typed_theme_handler: Expects three params, type, name, and the resource. Name can be changed by calling setTypedRouteName()., _(*8)

  Example:, _(*9)

  <?php
  $app->get('/_theme_typed/{type}/{name}/resources/{resource}', function($type, $name, $resource) use ($app)  {
     // do something to handle the theme request and return the
     // contents of the theme resource manually.
  })
  ->assert('name', '.+')
  ->assert('resource', '.+')
  ->bind('_dflydev_typed_theme_handler');
  

• _dflydev_theme_handler: Expects two params, name and the resource. Name can be changed by calling setTypedRouteName()., _(*10)

  Example:, _(*11)

  <?php
  $app->get('/_theme/{name}/resources/{resource}', function($name, $resource) use ($app) {
     // do something to handle the theme request and return the
     // contents of the theme resource manually.
  })
  ->assert('name', '.+')
  ->assert('resource', '.+')
  ->bind('_dflydev_theme_handler');
  

License

MIT, see LICENSE., _(*12)

Community

If you have questions or want to help out, join us in the [#dflydev, ¹] channel on irc.freenode.net., _(*13)