Ce plugin à l'origine développer par David ZELLER a pour but de vous faciliter la création de tableaux Ajax.
Pour la partie création des tableaux vous trouverez toutes la doc sur http://symfony.swisscenter.com/datagrid
J'ai participé à ce plugin en ajoutant la partie AdminGenérator, vous trouverez la doc ci-apres.
Cet AdminGénérator permet la création de toutes les fonctions de l'admin Générator de symfony 1.2 en ce qui concernent la partie création / edition, seul la liste diffère à première vue. Car vous allez voir que l'édition propose aussi des méthodes simples pour changer la présentations de vos formulaires.
list: sort: [ votre_champ, desc ] #ou sort: [ votre_champ, asc ]
list: display: [ votre_champ, votre_champ2 ] #ou hide: [ id ]
list: row_action: show
Les fonctions à venir sont les options de choix des filtres et les object_actions.
Pour choisir le type de champs qui est affichés pour le formulaire, voici la méthode utilisée par le datagrid.
La champ est une foreignKey ? => Liste déroulante
Le champ est une date ? => Un date range Du - Au et un case date nulle si le champ peux etre nulle
Le champ est un boolean => Un select avec les options : ( '', oui, non )
Sinon un champ de texte simple.
En plus de vous permettre d'utiliser les fonction simple de sfPropelAdminGenerator ce plugin vous propose un outils pour agencer plus rapidements les champs de votre formulaire :
l'option layout.
edit:
layout:
row_1: [ champ, champ ]
row_2: [ champ, champ ]Ceci aura pour effet de présenter le formulaires avec les champs en div floattante le template est _edit_form_layout.php
Le titre e new peut etre différent si vous le sohaitez
new: title: Titre pour un nouveau