symfony Forms Book update

February 24, 2009 · Published by Avatar of Fabien Potencier Fabien Potencier

Today, I have added more than 40 pages in two new appendices to the symfony forms book: one about form widgets and the other about validators. These appendices describe all built-in widgets and validators, and also widgets and validators from sfPropelPlugin, sfDoctrinePlugin and sfFormExtraPlugin.

For each widget or validator, you will find a full description, all available options and configuration settings, and useful examples to illustrate the usage when needed.

You can already read these appendices online. But as they are also meant to act as a day-to-day reference, feel free to also download them as a PDF file.

Published in #Documentation

Help the Symfony project!

As with any Open-Source project, contributing code or documentation is the most common way to help, but we also have a wide range of sponsoring opportunities.

Comments

Avatar of Björn Ahlers
Björn Ahlers said on Feb 24, 2009
Great! Thanks!
Avatar of Dreur
Dreur said on Feb 24, 2009
Now you are talking :)
Thanks
Avatar of Massimiliano Arione
Massimiliano Arione said on Feb 24, 2009
Nice job! We (Italian community) are already working for translation.
Just a little bug I noticed: in appendix A, there's a render bug in sfWidgetFormSchema "caution" box.
Avatar of saganxis
saganxis said on Feb 24, 2009
Really great news!thanks for your work
Avatar of Markus.Staab
Markus.Staab said on Feb 24, 2009
would be nice to see a prefix like "Appendix A" and "Appendix B" on http://www.symfony-project.org/book/forms/1_2/en/
Avatar of Kardie
Kardie said on Feb 24, 2009
That's great, I really appreciate the hard work you guys put into documenting the framework.

Maybe it's a good time then to ask, whether or not there are plans to complete the missing chapters of the Forms Book in the nearest future?
Avatar of phpleo
phpleo said on Feb 24, 2009
Awesome, Thanks!
Avatar of Fabian
Fabian said on Feb 24, 2009
Kardie, well i would say its a bad moment to ask for more when you just recieved a lot. Chapters will be added. If they wouldnt be numbered as they are people wouldnt ask so much.
Avatar of Fabien
Fabien said on Feb 24, 2009
@Massimiliano Arione: fixed (this is a bug in the Markdown converter - the fix is to uppercase the first letter of the table tag, not nice, but it works)

@Markus.Staab: fixed
Avatar of Scott
Scott said on Feb 24, 2009
Thank you Fabien. We truly appreciate all of your time and effort, the documentation for symfony is the best of it's kind and keeps getting better!
Avatar of Tomasz Ignatiuk
Tomasz Ignatiuk said on Feb 24, 2009
This is great!!!
Thank you very much. This is something that was missing. It is very nice that you answer for users requests. Thank you again. God job!!!
Avatar of dereck
dereck said on Feb 24, 2009
thank you, guys
Avatar of Kardie
Kardie said on Feb 25, 2009
@Fabian

Please take a note of the difference between asking, whether or not there are plans to complete the chapters anytime soon (I would take "yes, they will be completed next year" for an aswer) and demanding attitude like "GIMME THAT DOCS NOW!! MOAR!!" ;)
Avatar of Fabien
Fabien said on Feb 25, 2009
@Kardie: The only missing chapter is the one about nested forms. It will take a bit more time to write, but be reassured that we are working on it.
Avatar of Kardie
Kardie said on Feb 25, 2009
That's good to hear. Thank you, Fabien.
Avatar of John
John said on Feb 26, 2009
Great work on the book. However I still face the same problem that I have reported in bug #4993.

Although the sfValidatorPropelUnique works fine when inserting new records, it will have problems in updating existing records if there is more than one unique column.

I am using symfony 1.2.2 and the problem still persists and there is no mention this is fixed elsewhere.

Is there anyone else here who is encountering the same issue?
Avatar of halfer
halfer said on Feb 26, 2009
@John - this isn't the best place for bug discussion. If there is no action on the ticket for a while, but it is a confirmed bug, then raise it on the devs list and, if you can, offer to create a test case if necessary.

Hope that helps :)
Avatar of jL
jL said on Mar 24, 2009
Are there plans to publish the forms book via Lulu, as well, when the last of the chapters have been added?

If not, please allow me to +1 the idea ;-)

Comments are closed.

To ensure that comments stay relevant, they are closed for old posts.