joeytrapp/partials

A CakePHP Partial Helper

Partial Helper

Installation

Download the repository into the the Plugin directory, _(*1)

cd Plugin
git clone git://github.com:joeytrapp/partials.git Partials

Add the CakePlugin::load() in the application bootstrap.php., _(*2)

echo "CakePlugin::load("Partials");" >> Config/bootstrap.php

Load the helper so it will be available in views, _(*3)

public $helpers = array("Html", "Form", "Partials.Partial");

Methods

PartialHelper::render(string $name, array $data, array $options)

Renders an element relative to the View::viewPath instead of View/Elements. Assumes the element file begins with an underscore., _(*4)

<?php echo $this->Partial->render("form"); ?>

Will look for _form.ctp in the View::viewPath (for /posts/add it would be View/Posts/_form.ctp)., _(*5)

The $data and $options params are passed on to View::element() method. An additional option is "collection". If "collection" is an array, then the View::element() will be called for each iteration of the "collection" array. The value of the current iteration is merged in the data array under the element name (without the underscore) key., _(*6)

<?php echo $this->Partial->render("post", array(), array("collection" => $posts)); ?>

This will render the _post.ctp element for each value in $posts, and set a the value in $posts for this iteration to the "post" key in the data array., _(*7)