Menu
▾
▴
[FormMagick-devel] CVS: formmagick/doc FormMagick-FAQ.html,1.1,1.2
|
From: Kirrily R. <sk...@us...> - 2001-02-28 22:00:20
|
Update of /cvsroot/formmagick/formmagick/doc
In directory usw-pr-cvs1:/tmp/cvs-serv31047
Modified Files:
FormMagick-FAQ.html
Log Message:
Regenerated FAQ from POD.
Index: FormMagick-FAQ.html
===================================================================
RCS file: /cvsroot/formmagick/formmagick/doc/FormMagick-FAQ.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -r1.1 -r1.2
*** FormMagick-FAQ.html 2000/12/11 23:28:13 1.1
--- FormMagick-FAQ.html 2001/02/28 22:01:39 1.2
***************
*** 2,50 ****
<HEAD>
<TITLE>FAQ - Frequently asked questions about FormMagick</TITLE>
! <LINK REV="made" HREF="mailto:none">
</HEAD>
<BODY>
<!-- INDEX BEGIN -->
<UL>
! <LI><A HREF="#NAME">NAME</A>
! <LI><A HREF="#TROUBLESHOOTING">TROUBLESHOOTING</A>
<UL>
! <LI><A HREF="#Why_isn_t_my_data_preserved_from">Why isn't my data preserved from one page to the next?</A>
</UL>
</UL>
<!-- INDEX END -->
<HR>
- <P>
- <H1><A NAME="NAME">NAME</A></H1>
<P>
! FormMagick FAQ - Frequently asked questions about FormMagick
!
<P>
<HR>
! <H1><A NAME="TROUBLESHOOTING">TROUBLESHOOTING</A></H1>
<P>
! <HR>
! <H2><A NAME="Why_isn_t_my_data_preserved_from">Why isn't my data preserved from one page to the next?</A></H2>
<P>
! You probably need to make your <CODE>session-tokens</CODE> directory writable and executable by the web server. Either:
!
<P>
! <PRE> chown www session-tokens
! (assuming your webserver runs as the www user)
! chmod 700 session-tokens
! </PRE>
<P>
! Or...
- <P>
- <PRE> chown 777 session-tokens
- </PRE>
</BODY>
--- 2,116 ----
<HEAD>
<TITLE>FAQ - Frequently asked questions about FormMagick</TITLE>
! <LINK REV="made" HREF="mailto:sk...@ta...">
</HEAD>
<BODY>
+ <A NAME="__index__"></A>
<!-- INDEX BEGIN -->
<UL>
! <LI><A HREF="#name">NAME</A></LI>
! <LI><A HREF="#how do i...">HOW DO I...</A></LI>
<UL>
! <LI><A HREF="#how do i check that my xml is valid">How do I check that my XML is valid?</A></LI>
! <LI><A HREF="#how do i customise the look and feel of my forms">How do I customise the look and feel of my forms?</A></LI>
! <LI><A HREF="#how do i make my own validation routines">How do I make my own validation routines?</A></LI>
! <LI><A HREF="#how do i add translations into another language">How do I add translations into another language?</A></LI>
! <LI><A HREF="#how do i do extra processing when a user clicks next">How do I do extra processing when a user clicks ``Next''?</A></LI>
! <LI><A HREF="#how do i choose which page to go to based on user input">How do I choose which page to go to based on user input?</A></LI>
</UL>
+ <LI><A HREF="#troubleshooting">TROUBLESHOOTING</A></LI>
+ <UL>
+
+ <LI><A HREF="#general troubleshooting tips">General troubleshooting tips</A></LI>
+ <LI><A HREF="#why isn't my data preserved from one page to the next">Why isn't my data preserved from one page to the next?</A></LI>
+ </UL>
+
</UL>
<!-- INDEX END -->
<HR>
<P>
! <H1><A NAME="name">NAME</A></H1>
! <P>FormMagick FAQ - Frequently asked questions about FormMagick</P>
<P>
<HR>
! <H1><A NAME="how do i...">HOW DO I...</A></H1>
<P>
! <H2><A NAME="how do i check that my xml is valid">How do I check that my XML is valid?</A></H2>
<P>
! <H2><A NAME="how do i customise the look and feel of my forms">How do I customise the look and feel of my forms?</A></H2>
! <P>Use cascading style sheets. Take a look at the HTML source output by
! FormMagick, and you'll see that most things have a ``label'' attribute to
! make CSS easier.</P>
! <P>
! <H2><A NAME="how do i make my own validation routines">How do I make my own validation routines?</A></H2>
! <P>Simply create a routine in your CGI script which accepts the data to
! validate as an argument. Have it return ``OK'' on success or a detailed
! error message on failure.</P>
! <PRE>
! sub my_validation {
! my $data = shift;
! if ($data =~ /$some_pattern/) {
! return "OK";
! } else {
! return "That looks wrong to me.";
! }
! }</PRE>
! <P>
! <H2><A NAME="how do i add translations into another language">How do I add translations into another language?</A></H2>
! <P>Use the <CODE>add_lexicon()</CODE> method:</P>
! <PRE>
! $f->add_lexicon("fr", { "Yes" => "Oui", "No" => "Non" });</PRE>
! <P>
! <H2><A NAME="how do i do extra processing when a user clicks next">How do I do extra processing when a user clicks ``Next''?</A></H2>
! <P>Use a POST-EVENT on the PAGE element. Create a subroutine that does
! what you want:</P>
! <PRE>
! sub process_credit_card {
! my $cgi = shift;
! my $cardnum = $cgi->param("cardnum");
! my $response = do_processing($cardnum);
! print "<p>$response</p>";
! }</PRE>
! <P>
! <H2><A NAME="how do i choose which page to go to based on user input">How do I choose which page to go to based on user input?</A></H2>
! <P>Use a PAGE POST-EVENT and set the value of the ``wherenext'' CGI
! parameter:</P>
! <PRE>
! sub my_post_page_event {
! my $cgi = shift;
! if ($cgi->param("foo") eq "bar") {
! $cgi->param(-name => "wherenext", -value => "GoToThisPageName")
! } elsif ($cgi->param("had_enough") eq "Yes") {
! $cgi->param(-name => "wherenext", -value => "Finish")
! }
! }</PRE>
<P>
! <HR>
! <H1><A NAME="troubleshooting">TROUBLESHOOTING</A></H1>
<P>
! <H2><A NAME="general troubleshooting tips">General troubleshooting tips</A></H2>
! <P>Try turning on debugging when you invoke FormMagick:
! </P>
! <PRE>
!
! my $f = new CGI::FormMagick( DEBUG => 1 );</PRE>
! <P>
! <H2><A NAME="why isn't my data preserved from one page to the next">Why isn't my data preserved from one page to the next?</A></H2>
! <P>You probably need to make your <CODE>session-tokens</CODE> directory writable and
! executable by the web server. Either:</P>
! <PRE>
! chown www session-tokens
! (assuming your webserver runs as the www user)
! chmod 700 session-tokens</PRE>
! <P>Or...</P>
! <PRE>
! chown 777 session-tokens</PRE>
</BODY>
|