# Get the form that the :FormConfig attribute saved in the stash
my $form = $c->stash->{form};
- # Check if the form as been submitted (vs. displaying the initial
- # form) and if the data based validation. "submitted_and_valid"
+ # Check if the form has been submitted (vs. displaying the initial
+ # form) and if the data passed validation. "submitted_and_valid"
# is shorthand for "$form->submitted && !$form->has_errors"
if ($form->submitted_and_valid) {
# Create a new book
name: submit
value: Submit
+B<NOTE:> Copying and pasting YAML from perl documentation is sometimes
+tricky. See the L<Config::General Config for this tutorial> section of
+this document for a more foolproof config format.
+
=head2 Update the CSS
[%# Render the HTML::FormFu Form %]
[% form %]
- <p><a href="[% Catalyst.uri_for('list') %]">Return to book list</a></p>
+ <p><a href="[% c.uri_for('list') %]">Return to book list</a></p>
=head2 Add Links for Create and Update via C<HTML::FormFu>
<p>
HTML::FormFu:
- <a href="[% Catalyst.uri_for('formfu_create') %]">Create</a>
+ <a href="[% c.uri_for('formfu_create') %]">Create</a>
</p>
This adds a new link to the bottom of the book list page that we can
$ script/myapp_server.pl
-Login as C<test01>. Once at the Book List page, click the new
-HTML::FormFu "Create" link at the bottom to display the form. Fill in
-the following values: Title = "Internetworking with TCP/IP Vol. II",
-Rating = "4", and Author = "Comer". Click Submit, and you will be
-returned to the Book List page with a "Book created" status message
-displayed.
+Login as C<test01> (password: mypass). Once at the Book List page,
+click the new HTML::FormFu "Create" link at the bottom to display the
+form. Fill in the following values: Title = "Internetworking with
+TCP/IP Vol. II", Rating = "4", and Author = "Comer". Click Submit,
+and you will be returned to the Book List page with a "Book created"
+status message displayed.
Also note that this implementation allows you to can create books with
bogus information. Although we have constrained the authors with the
# The user cannot leave any fields blank
- Required
+B<NOTE:> Copying and pasting YAML from perl documentation is sometimes
+tricky. See the L<Config::General Config for this tutorial> section of
+this document for a more foolproof config format.
+
The main changes are:
=over 4
# Get the form that the :FormConfig attribute saved in the stash
my $form = $c->stash->{form};
- # Check if the form as been submitted (vs. displaying the initial
- # form) and if the data based validation. "submitted_and_valid"
+ # Check if the form has been submitted (vs. displaying the initial
+ # form) and if the data passed validation. "submitted_and_valid"
# is shorthand for "$form->submitted && !$form->has_errors"
if ($form->submitted_and_valid) {
# Save the form data for the book
<td>
[% # Add a link to delete a book %]
- <a href="[% Catalyst.uri_for('delete', book.id) %]">Delete</a>
+ <a href="[% c.uri_for('delete', book.id) %]">Delete</a>
[% # Add a link to edit a book %]
- <a href="[% Catalyst.uri_for('formfu_edit', book.id) %]">Edit</a>
+ <a href="[% c.uri_for('formfu_edit', book.id) %]">Edit</a>
</td>
green. Experiment with other edits to various books.
+=head2 Config::General Config for this tutorial
+
+If you are having difficulty with YAML config above, please save the
+below into the file C<formfu_create.conf> and delete the
+C<formfu_create.yml> file. The below is in
+L<Config::General|Config::General> format which follows the syntax of
+Apache config files.
+
+ constraints Required
+ <elements>
+ constraints SingleValue
+ <constraints>
+ min 5
+ max 40
+ type Length
+ message Length must be between 5 and 40 characters
+ </constraints>
+ filter TrimEdges
+ filter HTMLEscape
+ name title
+ type Text
+ label Title
+ <attributes>
+ title Enter a book title here
+ </attributes>
+ </elements>
+ <elements>
+ constraints SingleValue
+ constraints Integer
+ filter TrimEdges
+ filter NonNumeric
+ name rating
+ type Text
+ label Rating
+ <attributes>
+ title Enter a rating between 1 and 5 here
+ </attributes>
+ </elements>
+ <elements>
+ constraints Integer
+ filter TrimEdges
+ filter HTMLEscape
+ name authors
+ type Select
+ label Author
+ multiple 1
+ size 3
+ </elements>
+ <elements>
+ value Submit
+ name submit
+ type Submit
+ </elements>
+ indicator submit
+
+
+
=head1 AUTHOR
Kennedy Clark, C<hkclark@gmail.com>
Copyright 20066-2008, Kennedy Clark, under Creative Commons License
(L<http://creativecommons.org/licenses/by-nc-sa/2.5/>).
-
\ No newline at end of file
+