View source for CGI::FormMagick::Utils

From SME Server

You do not have permission to edit this page, for the following reason:

The action you have requested is limited to users in the group: Users.

You can view and copy the source of this page.

{{Level|Developer}}
=== NAME ===
       CGI::FormMagick::Utils - utility routines for FormMagick
In a root terminal you can do the command below if you want to display the up-to-date content 
 perldoc CGI::FormMagick::Utils
=== SYNOPSIS ===
         use CGI::FormMagick;

=== DESCRIPTION ===
==== debug_msg($msg) ====

The debug method prints out a nicely formatted debug message.  It can be called from your script as "$f-"debug_msg($msg)>

==== $fm->get_page_by_name($name) ====
get a page given the name attribute.  Returns the numeric index of the page, suitable for $wherenext.

==== $fm->get_page_by_number($page_index) ====

Given a page index, return a hashref containing the page’s data.  This is just a convenience function.

==== pop_page_stack($self) ====

pops the last page off the stack of pages a user’s visited... used when the user clicks "Previous"
removes the last element from the stack (modifying it in place in $self->{page_stack}) and returns the element it removed.  eg:

           # if the CGI "pagestack" parameter is "1,2,3,5"...
           my $page = $self->pop_page_stack();
           $self->{page_stack} will be 1,2,3
           $page will be 5

==== push_page_stack($newpage) ====

push a new page onto the page stack that keeps track of where a user has been.

==== $fm->parse_template($filename) ====

parses a Text::Template file and returns the result.  Will return undef if the filename is invalid.

==== is_last_page() ====
Figures out whether or not we’re on the last page.  Used by print_buttons() in particular to tell whether to print a Finish button, and to tell whether to do the form post-event.

==== is_first_page() ====

Figures out whether or not we’re on the first page.  Used mostly to figure out whether we want to do the form pre-event.

==== just_starting() ====

Like is_first_page, but also checks for the absence of a "page" parameter in the CGI, which would indicate that this is the very first page we’ve looked at.

==== finished ====

Figures out whether the user’s finished.  This could be because they clicked "Finish" or it could be because they were on the last page and hit enter.

This bears the same relationship to is_last_page as just_starting does to is_first_page.

==== user_pressed_enter() ====

A weirdness in the HTML spec and/or browser implementations thereof means that hitting "enter" on a single-text-field form will submit the form without any value being passed.  Worse yet, at least one browser is reported to automatically choose the first submit button on the form, in our case "Previous", which is just WRONG but I can’t see any way to work around that.
So this routine tells you if the user just hit enter.  Returns 1 if they did, or 0 otherwise.

==== $fm->form() ====

Gets the form we’re dealing with.  With no args, returns an hashref to the form data structure.

==== $fm->page() ====

Gets the current page we’re dealing with, as a hashref.

==== get_page_enctype ====

Returns the appropriate encoding type for this page. A page that uses FILE fields must also use the multipart/form-data encoding type. Any other page may use either, but the default is to use the older and more compatible application/x-www-urlencoded.

==== $self->clear_navigation_params() ====

Clear out the nagivation params Next, Previous, Finish and wherenext. Otherwise they stick around in CGI::Persistent and cause havoc next time you try to navigate.

=== SEE ALSO ===
       [http://wiki.contribs.org/CGI::FormMagick CGI::FormMagick]

[[Category:SME Server Development Framework]]
[[Category:Development Tools]]

Templates used on this page:

Template:Ibox (view source) (protected)
Template:Level (view source)

Return to CGI::FormMagick::Utils.

Retrieved from "https://wiki.koozali.org/CGI::FormMagick::Utils"

View source for CGI::FormMagick::Utils

Navigation menu

Page actions

Page actions

Personal tools

Koozali SME Server

Recent activities

Koozali resources

Koozali SME Server wiki

Tools

Search