harentius/widgets-bundle

Symfony Bundle for easy creating and managing client-side widgets

Widgets Bundle

Symfony Bundle for easy creating and managing client-side widgets. Has SonataAdminBundle dependency and provide management., _(*1)

Installation

1), _(*2)

$ composer.phar require harentius/widgets-bundle

2) Enable bundle in the kernel:, _(*3)

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Harentius\WidgetsBundle\HarentiusWidgetsBundle(),
    );

    // ...
}

3) Include configuration:, _(*4)

imports:
    ....
    - { resource: "@HarentiusWidgetsBundle/Resources/config/config.yml" }

4) Configure:, _(*5)

harentius_widgets:
    # List of routes, where widgets can be placed
    routes:
        acme_homepage:
            # User-friendly name for displaying in admin section (sonata)
            name: Homepage
        acme_blog_show:
            name: Article
            # Parameters, present in route
            parameters:
                slug:
                    # Source (Now only entity supported)
                    source:
                        class: HarentiusBlogBundle:Article
                        # Value to be passed to the route 
                        field: slug
                        # Value to be shown in admin section
                        identity: title
    # Registering widgets: key used in templates (look behind), value - shown in admin section
    widgets:
        widgets_block_sidebar: Sidebar
        widgets_block_bottom_left: Bottom left
        widgets_block_bottom_right: Bottom right

5) Place in templates where you want:, _(*6)

    {{ harentius_widget('widgets_block_sidebar') }}
    ....
    {{ harentius_widget('widgets_block_bottom_left') }}
    ....
    {{ harentius_widget('widgets_block_bottom_right') }}