For those who don’t know, Symfony is an MVC web framework built on PHP. Symfony is a great tool to use for custom development, and is very similar to the als0-opensource MVC framework Ruby on Rails. The Symfony Admin Generator is a tool connected to a command-line task that allows you to easily spin up editable interfaces for your website’s administrators. Do you have a table for contacts in your database? Type a single command into your terminal…

$: php symfony doctrine:generate-admin backend Contacts

…and presto! Your users can filter, sort, view, edit, and create new contacts! Yes, it really is that simple. There are a variety of customizations available (some of which could use healthier documentation, which extends beyond the scope of this post), and you can read about those here.

Problem: Client demands additional functionality for administrative purposes.

example: “We want to easily export data from the tables in our database. We want to customize exported fields per export, change column labels, and make other fields unable to be exported”.

Mediocre Solution: Override the generated admin module with code to export.

explanation: While not a terrible alternative, this is certainly not the best one. The admin generator places most of the generated code in cache, so a good way to customize it is to override the generated files. This is great for small customizations, but not optimal for potentially reusable code! Allowing for any table in your application to be exported is a pretty tempting solution, yes? Think about it. What if you could do this?

$: php symfony doctrine:generate-admin backend Contacts --theme=export

And have a fully generated export interface at your disposal? Pretty slick, I’d say. Which brings us to the:

Better Solution: Customize the admin generator itself (as opposed to the generated code).

That’s right! We get to write code that writes code! Nervous? Scared? Envisioning tiny software bugs slowly infecting every part of your application? Don’t be! It’s easy. Now I know you’re salivating.

The admin generator is contained in Symfony core. I used the doctrine version, because we’re pulling directly from the database. In the sfDoctrinePlugin, copy the files in data/generator/sfDoctrineModule/admin into your own data directory (I used the path data/generator/sfDoctrineModule/export in my project’s root directory. The directory after sfDoctrineModule is the name of your theme). There are three directories: parts, skeleton, and templates. Skeleton is what gets generated outside of cache into the project itself. Template is what is generated INTO cache. Parts contains all your files you do NOT want to copy over into cache or the project, but you need for organizational purposes.

I chose to override the sfModelGeneratorConfiguration class to give myself more flexibility when customizing. The sfModelGeneratorConfiguration class parses the generator.yml file, which is what allows the developers to tweak the generated code to their specifications without having to copy over/write new code. In my admin generator, a user can customize their export fields via the generator.yml file.

We now have a flexible admin generator on demand that not only exports the fields of a database table, but allows our user to customize which fields are appropriate to show to the end user. On top of this, the system allows the user to declare fields to export that don’t even exist on the object! Lets say we want to have a field exported called “timespan”, which symbolizes the duration the user has been in the system. This is going to be a calculation of the current date minus the date the user was added to the system. All we need to do is add “timespan” to the fields option in generator.yml, and add a method to our Contact model called getTimespan() that returns the appropriate string. If you still haven’t salivated, then maybe this will help: The export interface feeds off the sorting/filtering applied by the user in the main view, and allows the users to rename columns and deselect unwanted columns appropriately for their export.

We now have an out-of-the-box exporting solution for the following deliverables for our end-user:

• Filtering for Export result set
• Sorting for Export result set
• Exported column naming
• Exported column selection

And the following deliverables for our developers:

• Customization of available fields for exporting
• Customizing of filters/sorting capability (pulls from existing admin-generator functionality)
• Addition of non-real export fields
• Easy extension of the admin generator
• all of this functionality is object-oriented, normalized, and easily overridden or extended.
• Extended admin generator functionality
  The export admin generator adds several helpful methods such as hasExport and isFiltered to the classic admin generator. It also adds a flash message “Your results are currently filtered, click HERE to unfilter them” to any list view.

You can find all of this code here. Now go forth, and EXTEND THY ADMIN GENERATOR!!

Doctrine 2.0 was also discussed.  We are hoping for a more complete presentation from Jon Wage next month.  Keep your fingers crossed!

The solution I ended up with was to use something similar to serialization techniques.  This allowed me to configure dynamic forms, add options, and keep the whole thing in a single database field.  The solution has worked great, and has only required a few extra lines of code to my form.  With tweaking, I hope to turn this code into a widget, to allow it to be added quickly to any Symfony form.

If you are interested in implementing this kind of functionality, you can see my code here, or you can check out the code for csDoctrineSlideshowPlugin and see it in action.

1) csDoctrineActAsAttachablePlugin – associates various uploads with multiple models, and includes an AJAX uploading client interface.

2) csDoctrineActAsCategorizablePlugin – associates models into nestable categories and category groups.

3) csDoctrineActAsGeolocatablePlugin – integrate your model with the Google Maps API to pull in geocodes based on record fields.  Supports radius and proximity searches.

4) csDoctrineActAsSortablePlugin – adds a sortable behavior to your models

5) csDoctrineSlideshowPlugin – add and configure slideshows in your project.

6) csFormTransformPlugin -  give your forms a web 2.0 look within a few easy steps.

7) csGlossaryPlugin – group your models alphabetically in glossary/directory format

8) csSEOToolkitPlugin – A toolkit to improve your website’s search engine optimization.

9) sfSympalSlideshowPlugin – An advanced slideshow used for the Sympal Content Management Framework.

You can check out my plugin list here.  If you are interested in using these plugins, or have any suggestions for addition useful symfony plugins, please contact me or any of the developers here at CentreSource.