ps24love/widget

laravel4 widget system

Simple Widget System - Laravel 4.*

Simple widget system for create awesome feature on blade templating Laravel 4, _(*1)

Installation

Open your composer.json file, and add the new required package., _(*2)

  "Ps24love/widget": "dev-master" 

Next, open a terminal and run., _(*3)

  composer update 

After the composer updated. Add new service provider and alias in app/config/app.php., _(*4)

  'Ps24love\Widget\WidgetServiceProvider'

  'Widget' => 'Ps24love\Widget\Facades\Widget'

Done., _(*5)

Example

Registering your widget

To register your widget, simply create a file widgets.php in your app folder and put your widgets code in that file. Like this., _(*6)

laravel/
|-- app/
    |-- commands/
    ...
    |-- views/
    |-- filters.php
    |-- routes.php
    |-- widgets.php
|-- bootstrap/
|-- vendor/

Simple Widget :, _(*7)

Widget::register('awesome', function(){

    return View::make('awesome');

});

Widgets with one or more parameters:, _(*8)

Widget::register('hello', function($name){

    return "Hello, $name !";

});

Widget::register('box', function($title, $description){

    return View::make('widgets.box', compact('title', 'description'));

});

Widget grouping of widgets that have previously been defined., _(*9)

// First, you must registering one or more widget

Widget::register('categories', function(){
    return View::make('widgets.categories');
});

Widget::register('latestPost', function(){
    return View::make('widgets.latestPost');
});

// Next, you can group some widgets like this:

Widget::group('sidebar', array('categories', 'latestPost'));

Widget::group('footer', array('hello', 'box'));

Calling your widget

Globally calling the widget just like below:, _(*10)

Widget::awesome();

Widget::hello('John');

Widget::box('Latest News', 'This is a description of latest news');

// calling widget group just like below
// Widget::$name();
Widget::sidebar();

// calling widget group which parameters just like below
// Widget::$name($params1, $params2, $params3, ....);
Widget::box(array('name'), array('My Tweets', '.....Latest Tweets'));

simple calling widget on view :, _(*11)

@awesome

@hello('John')

//calling group widget

@sidebar()

@box(array('name'), array('My Tweets', '.....Latest Tweets'))

License

This package is open-sourced software licensed under the MIT license, _(*12)