TerrificComposerBundle

The TerrificComposer bundle makes it easy to develop frontends based on the Terrific Concept. It provides you several helpers and tools to streamline your frontend development.

The TerrificComposer bundle depends on the TerrificCoreBundle. For installation of the TerrificCoreBundle, please follow the instructions there.

Installation

// app/autoload.php
$loader->registerNamespaces(array(
    // ...
   'Terrific'         => __DIR__.'/../vendor/bundles',
));

// app/AppKernel.php
public function registerBundles()
{
    return array(
        // ...
        new Terrific\ComposerBundle\TerrificComposerBundle(),
    );
}

TerrificComposer creates a bundle for each of your Terrific module. To have them registered automatically, extend app/AppKernel.php:

// register all terrific modules
$dir = __DIR__.'/../src/Terrific/Module/';

$finder = new Finder();
$finder->directories()->in($dir)->depth('== 0');

foreach ($finder as $file) {
    $filename = $file->getFilename();
    $module = 'Terrific\Module\\'.$filename.'\TerrificModule'.$filename;
    $bundles[] = new $module();
}

Import the routing definition in routing.yml:

# app/config/routing.yml
TerrificComposerBundle:
    resource: "@TerrificComposerBundle/Controller/"
    type:     annotation
    prefix:   /terrific/composer

Enable the bundle's configuration in app/config/config.yml:

# app/config/config.yml
terrific_composer:
   composition_bundles: [@TerrificComposition] # the bundles where the controllers for your frontend lie
   module_layout: @TerrificComposition::base.html.twig # the layout to take for the separate module view

# app/config/config_dev.yml
terrific_composer:
    toolbar: true # enables the composer toolbar in the dev environment

Usage

To see the TerrificComposerBundle in action, download the Terrific Composer Distribution and play around with the included examples. For more information about the Terrific Concept, please have a look at http://terrifically.org

After that, the below should be pretty straight forward ;-)

Terrific Composer Toolbar

The Toolbar provides you some useful helpers that helps you to streamline your frontend development.

Module / Skin Creation

Create module bundles (with or without skin) under /src/Terrific/Module/.

Notice: If you don't use the Terrific Composer Distribution, you have to register them manually in app/AppKernel.php

The generated module structure contains the skeleton of the LESS/JavaScript files in Terrific manner, so that you can start right away.

Open Resources

The open dialog provides you quick access to your modules and pages. By clicking on a module you are able to implement and test it isolated from the rest of your page. Furthermore you can play with different widths, templates and skins.

Inspect Mode

The inspect mode shows you the used modules on the current page.

The Composer() annotation

The bundle provides an Composer() annotation for your controllers:

<?php

namespace Terrific\Composition\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Terrific\ComposerBundle\Annotation\Composer;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;

class DefaultController extends Controller
{
    /**
     * @Composer("Welcome")
     * @Route("/", name="home")
     * @Template()
     */
    public function indexAction()
    {
        return array();
    }

    /**
     * @Composer("Examples Overview")
     * @Route("/examples", name="examples")
     * @Template()
     */
    public function examplesAction()
    {
        return array();
    }
}

The Composer annotation is used to enrich the open dialog with meaningful page names.

That's it… Enjoy!

jordillonch / TerrificComposerBundle