derek/li3_hui

Lithium ui plugin

dev-master 2013-12-24 10:47 UTC

Requires

• php: >=5.3
• composer/installers: *
• joseym/li3_installer: master

Suggests

• UnionOfRAD/lithium: Lithium is required for this plugin.

MIT

• Derek

• jquery
• css
• lithium
• li3
• huement
• hui
• li3-hui

README

Installation

Checkout the code to your library directory:

cd libraries
git clone [e-mail]:/johnny13/li3_hui.git

Include the library in in your /app/config/bootstrap/libraries.php

Libraries::add('li3_hui');
define('HUI_PATH', dirname(LITHIUM_APP_PATH) . '/libraries/li3_hui' );

The li3_hui (li3_hui) plugin provides a straightforward interface for displaying status messages to the user, a number of html builders, and stuff and thangs.

Integration

<?php

// config/bootstrap/libraries.php:

Libraries::add('li3_hui');
define('HUI_PATH', dirname(LITHIUM_APP_PATH) . '/libraries/li3_hui' );
?>

Custom Views

Once you have the library installed and included, you probably want to use it. Calling custom layouts from libraries can be tricky. It basically requires you setup each controller. There needs to be an init() where you define the library's path.

Your Controller Should have this Function

<?php

public function _init() {
    parent::_init();
    $this->controller = $this->request->controller;
    $this->library = $this->request->library;

    $this->_render['paths'] = array(
            'template' => array(
                    LITHIUM_APP_PATH . '/views/{:controller}/{:template}.{:type}.php',
                    HUI_PATH . '/views/{:controller}/{:template}.{:type}.php',
                    '{:library}/views/{:controller}/{:template}.{:type}.php',
            ),
            'layout' => array(
                    LITHIUM_APP_PATH . '/views/layouts/{:layout}.{:type}.php',
                    HUI_PATH . '/views/layouts/{:layout}.{:type}.php',
                    '{:library}/views/layouts/{:layout}.{:type}.php',
            ),
            'element' => array(
                    LITHIUM_APP_PATH . '/views/elements/{:template}.{:type}.php',
                    HUI_PATH . '/views/elements/{:template}.{:type}.php',
                    '{:library}/views/elements/{:template}.{:type}.php',
            ),
    );
}

?>

Then later in the SAME Controller you would render a view like this

<?php

public function index() {
	$title = "whatevah";
	$this->set(array('title' => $title));
	return $this->render(array('layout' => 'hui', 'library' => 'li3_hui'));
}

?>