# ChillDev ViewHelpers bundle **ChillDevViewHelpersBundle** is a **Symfony2 bundle** that brings set of useful view helpers for PHP templating engine. [![Build Status](https://travis-ci.org/chilloutdevelopment/ChillDevViewHelpersBundle.png)](https://travis-ci.org/chilloutdevelopment/ChillDevViewHelpersBundle) [![Scrutinizer Quality Score](https://scrutinizer-ci.com/g/chilloutdevelopment/ChillDevViewHelpersBundle/badges/quality-score.png?s=5439cd972d4be9b0b306f0671c1a2e04fd4bf43e)](https://scrutinizer-ci.com/g/chilloutdevelopment/ChillDevViewHelpersBundle/) [![Coverage Status](https://coveralls.io/repos/chilloutdevelopment/ChillDevViewHelpersBundle/badge.png?branch=develop)](https://coveralls.io/r/chilloutdevelopment/ChillDevViewHelpersBundle) [![Dependency Status](https://www.versioneye.com/php/chilldev:view-helpers-bundle/badge.png)](https://www.versioneye.com/php/chilldev:view-helpers-bundle) [![SensioLabsInsight](https://insight.sensiolabs.com/projects/0c6422d8-2857-4a18-a252-b297486304ea/mini.png)](https://insight.sensiolabs.com/projects/0c6422d8-2857-4a18-a252-b297486304ea) Because not everyone uses Twig… # Installation This bundle is provided as [Composer package](https://packagist.org/packages/chilldev/view-helpers-bundle). To install it simply add following dependency definition to your `composer.json` file: ``` "chilldev/view-helpers-bundle": "dev-master" ``` Replace `dev-master` with different constraint if you want to use specific version. **Note:** This bundle requires **PHP 5.4**. # Configuration All you need to do in order to use this bundle's goods is to load it in your kernel: ```php `, `` etc. Here is sample usage: In your view file: ```php extend('::layout.html.php'); ?> append($page->getName()); ?> getMetaName('keywords')->append($page->getKeywords()); ?> setMetaName('description', \strip_tags($page->getDescription())); ?> setProperty('og:title', $page->getName()); ?> add('http://example.com/page-2-slug.html', 'next'); ?> add('/javascript/prototype.js'); ?>

truncate($text, 255); ?>

``` In your layout file: ```php > output('_content') ?> ``` For more advanced aspects see [advanced usage documentation](https://github.com/chilloutdevelopment/ChillDevViewHelpersBundle/tree/master/Resources/doc/usage.md) or even [internals description](https://github.com/chilloutdevelopment/ChillDevViewHelpersBundle/tree/master/Resources/doc/internals.md). # Extras There are also some [extra resources](https://github.com/chilloutdevelopment/ChillDevViewHelpersBundle/tree/master/Resources/doc/extras.md) included in this bundle that can be useful for your PHP-templates-based project. [KnpPaginatorBundle](https://github.com/KnpLabs/KnpPaginatorBundle) supports PHP templating, but lacks default template for paginator helper. You can use one from this bundle with just following one setting in your application configuration: ```yaml # KNP paginator configuration knp_paginator: template: pagination: "ChillDevViewHelpersBundle:Pagination:sliding.html.php" ``` Another additional enchantment to PHP templating engine provided by this bundle is possibility to define global templating variables. This feature is available out of the box for Twig templating engine in Symfony (with *TwigBundle*), but there is no equivalent for native PHP templates. Now, with our bundle you can do: ```yaml chilldev_viewheleprs: globals: values: slogan: "The best page ever!" services: sms: "your.sms.service" ``` And use it directly in templates: ```php

getGatewayNumber(); ?>

``` # Resources - [Source documentation](https://github.com/chilloutdevelopment/ChillDevViewHelpersBundle/tree/master/Resources/doc/index.md) - [GitHub page with API documentation](http://chilloutdevelopment.github.io/ChillDevViewHelpersBundle) - [Issues tracker](https://github.com/chilloutdevelopment/ChillDevViewHelpersBundle/issues) - [Packagist package](https://packagist.org/packages/chilldev/view-helpers-bundle) - [Chillout Development @ GitHub](https://github.com/chilloutdevelopment) - [Chillout Development @ Facebook](http://www.facebook.com/chilldev) - [Post on Wrzasq.pl](http://wrzasq.pl/blog/chilldevviewhelpersbundle-php-templating-helpers-for-symfony-2.html) # Contributing Do you want to help improving this project? Simply *fork* it and post a pull request. You can do everything on your own, you don't need to ask if you can, just do all the awesome things you want! This project is published under [MIT license](https://github.com/chilloutdevelopment/ChillDevViewHelpersBundle/tree/master/LICENSE). # Authors **ChillDevViewHelpersBundle** is brought to you by [Chillout Development](http://chilldev.pl). List of contributors: - [Rafał "Wrzasq" Wrzeszcz](https://github.com/rafalwrzeszcz) ([wrzasq.pl](http://wrzasq.pl)).