sfUIPlugin

A plugin for constructing data_grids. Improvements will be made.

Installation

Run the following command:

symfony plugin-install http://plugins.symfony-project.com/sfUIPlugin

Usage

Simple example:

<?php
echo object_data_grid(
                       $users,  // $users => [id=10, name=John; id=20, name=Peter]
                       array("ID" => "1", "NAME" => "1", "ACTIONS" => "2"),
                       array("getId", "getName"),
                       array("/user/show?id={getId}"),
                       array("Edit"  => "@edit?id={getId}",   // @edit => /user/edit
                             "Delete" => "@delete?id={getId}+Are you sure you want to delete {getNome}?"),   // @delete => /user/delete
                       array("30%", "70%", "")
                     );
?>

Displays something like this:

<table border="1">
    <tr>
        <th colspan="1" width="30%">ID</th>
        <th colspan="1" width="70%">NAME</th>
        <th colspan="2">ACTIONS</th>
    </tr>
    <tr>
        <td><?php echo link_to("10", "/user/show?id=10") ?></td>
        <td>John</td>
        <td><?php echo link_to("Edit", "/user/edit?id=10") ?></td>
        <td><?php echo link_to("Delete", "/user/delete?id=10", array("confirm" => "Are you sure you want to delete John?")) ?></td>
    </tr>
    <tr>
        <td><?php echo link_to("20", "/user/show?id=20") ?></td>
        <td>Peter</td>
        <td><?php echo link_to("Edit", "/user/edit?id=20") ?></td>
        <td><?php echo link_to("Delete", "/user/delete?id=20", array("confirm" => "Are you sure you want to delete Peter?")) ?></td>
    </tr>
</table>

For more information, see the function comment below:

<?php
/**
 * This function create an object table list.
 *
 * @param  array    $objects       Listed objects as an array.
 * @param  array    $headers       Associative array where the keys are the text and
 *                                      the values are the number of colspan.
 * @param  array    $values        Array with the methods used as values in the cells.
 *                                         One entry for each column.
 * @param  array    $links         Array with possible links. One string for each cell. If you don't want a
 *                                         link, keep it empty string or null. If you put something between curly
 *                                      brackets, it'll be parsed as a object method.
 * @param  array    $actions       Array of actions you want, where the key is the action and
 *                                         the value is the link for the action. It has the same rules as $links
 *                                         for curly bracktes.
 * @param  array    $sizes         Array with the size of each column. One entry for each column.
 * @param  string   $header_class  CSS class for the header.
 * @param  string   $class1        CSS class for odd rows.
 * @param  string   $class2        CSS class for even rows.
 * @return string   $empty_text    The text it'll appear if the object array is empty
 */
function object_data_grid($objects, $headers, $values, $links = array(), $actions = array(), $sizes = array(), $header_class = null, $class1 = null, $class2 = null, $empty_text = "Empty")
?>