kohana-phamlp
kohana-phamlp copied to clipboard
This module is a bridge between the Kohana PHP framework (http://kohanaframework.org/) and the PHamlP library (http://code.google.com/p/phamlp/).
This project has been dropped in favor of kohana3-haml.
Looks like HamlPHP still needs a lot of work. Project is bringed back until bugs in HamlPHP are fixed.
Kohana PHamlP Module
This module is a bridge between the Kohana PHP framework and the PHamlP library.
Compatibility
This module is for Kohana 3.0+.
Installation
- Download the source code, extract it and put it in your Kohana's modules directory.
- Download phamlp and put it into vendor/ directory (https://github.com/d4rky-pl/phamlp is recommended over the original version, but you can find other forks on github)
- Enable the module in your bootstrap file (
bootstrap.phpunder yourapplicationdirectory). - Copy and paste the configuration file (
config/phamlp.php) to your application's config directory. - Make necessary changes to the configuration file to suit your needs.
- Copy and paste the controller file (
classes/controller/haml.php) to your controller directory if you want to customise it.
Haml
Usage
Prerequesites
- By default the view files have
.hamlas the file extension.
If you would like to take advantage of the Haml controller shipped with this module, simply:
- Make sure the layout file exists (configurable by setting
$this->$templatein the controller). - Make sure the view files exist. View files follow the
controller_name/action_nameconvention.
If you would like to take control of the view rendering yourself, you can:
- Either don't inherit from
Controller_Haml, or set$this->auto_renderto false. - Call
Haml::factory()instead ofView::factory(), e.g.Haml::factory($view_file, $view_data, $haml_options).
Configuration Options
- Default Haml options are configured in
config/phamlp.phpfile - these apply to all Haml templates generated. - Optionally, you may set per controller or per action Haml options via
$this->haml_optionsin your controller actions. These overrides the default options.
Assigning Variables
- Assign view variables to
$this->view_data, e.g.$this->view_data['title'] = 'My Website';. - You may use either
View::set_global()/View::bind_global()orHaml::set_global()/Haml::bind_global()to set global view variables. Haml::factory()returns aViewobject, so you may usebind(),set()and magic getter/setters on it.
Todo
- Sass support.
Author
Copyright (c) 2010 Fred Wu (http://fredwu.me), released under the MIT license.
Brought to you by Wuit - http://wuit.com.
Currently maintained by Michał Matyas (http://github.com/d4rky-pl)