layershifter / cakephp-twig-view
Twig for CakePHP 1.3
Requires
- twig/extensions: ~1.2
- twig/twig: ~1.16
README
This plugin for the CakePHP Framework allows you to use the Twig, the flexible, fast, and secure template engine for PHP.
Apart from enabling you to use most of Twig's features the plugin is tightly integrated with the CakePHP view renderer giving you full access to helpers, objects and elements.
New in this version
- Using Composer for dependency management
Installation
via Archive
Download the current version as ZIP, unzip it and rename the extracted folder to twig
. Then put the twig
folder inside your plugins
and you are done.
via GitHub
Just clone the repository directly into your plugins
folder as twig
.
$ git clone https://github.com/m3nt0r/cakephp-twig-view.git twig
Twig Version Support
This plugin now uses Composer to manage dependencies. Simply running "composer install" will fetch the required libraries.
Enabling the View
Inside your app_controller.php
add the following:
class AppController extends Controller { public $view = 'Twig.Twig'; // use twig }
Now start by creating twig templates using the .tpl
extension.
Fallback / Upgrading exsiting apps
By default the view will render any existing .ctp
like always but
will prefer the .tpl
version if present. This means that, for example,
the index.ctp
is used until you create a index.tpl
at the same location.
That way you can upgrade existing views one at a time instead of having to rework all files at once.
Documentation
Check the wiki for more details on features and usage.
Version History
This version was written on CakePHP 1.3.
v0.8
- Replaced "TWIG_DIR" method with composer.
- Removed included Twig library
- Minor refactoring
v0.7.1
- Added TWIG_DIR so you can define the full Twig root-directory name
- Deprecated TWIG_VERSION because it lost its purpose due to this change
- Added fabpot/Twig as a submodule of this git repository
v0.7
- Complete rewrite
- Latest Twig (v1.8.3 atm)
- Easy to upgrade
- Easy to install
- Easy to migrate
- Extendable (see wiki)
- More CakePHP Filters
CakePHP 2
Support for 2.x may be limited to non-existant. If you run on 2.x i suggest that you check out the fork of predominant.
License
MIT License
Copyright (c) 2010-2014, Kjell Bublitz.