Merge pull request #5 from smartive/feature/remove-non-standard-helpers

Feature: Remove non standard helpers

DependencyInjection/SmartiveHandlebarsExtension.php

@@ -25,8 +25,6 @@ public function load(array $configs, ContainerBuilder $container)
         $config = $this->processConfiguration($configuration, $configs);
         $loader = new Loader\XmlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
 
-        $loader->load('helpers.xml');
-
         foreach ($config as $serviceName => $serviceConfig) {
             if ($this->isConfigEnabled($container, $serviceConfig)) {
                 $this->loadService($serviceName, $serviceConfig, $container, $loader);

README.md

@@ -20,7 +20,7 @@ Require the `smartive/handlebars-bundle` package in your composer.json and updat
 
 Register the bundle and in `app/AppKernel.php`:
 
-``` php
+```php
 // app/AppKernel.php
 public function registerBundles()
 {
@@ -86,3 +86,25 @@ The `smartive_handlebars.templating.renderer` service offers a `render($template
 
 ### Twig
 To render Handlebars templates in Twig you can use the Twig function `handlebars(templateName, data)`.
+
+## Custom Handlebars helpers
+You can add you own Handlebars helpers as tagged services by extending from `Handlebars\Helper`. To find out more about how to write custom helpers please have a look at the [built-in helpers by xamin/handlebars.php](https://github.com/XaminProject/handlebars.php/tree/master/src/Handlebars/Helper).
+
+Once you've implemented your own helper you have to register it as a service using the `smartive_handlebars.helper` tag and an appropriate alias:
+
+```
+# app/config/services.yml
+services:
+    demo_bundle.my_demo_helper:
+        class: DemoBundle\Helpers\MyDemoHelper
+        tags:
+            - { name: smartive_handlebars.helper, alias: myDemo }
+```
+
+You now can use your custom Handlebars helper inside your templates as follows:
+
+```handlebars
+{{#myDemo parameter}}
+    {{!-- do stuff --}}
+{{/myDemo}}
+```