CGI::FormBuilder::Messages(3pm) | User Contributed Perl Documentation | CGI::FormBuilder::Messages(3pm) |
CGI::FormBuilder::Messages - Localized message support for FormBuilder
use CGI::FormBuilder::Messages; my $mesg = CGI::FormBuilder::Messages->new( $file || \%hash || ':locale' ); print $mesg->js_invalid_text;
This module handles localization for FormBuilder. It is invoked by specifying the "messages" option to FormBuilder's "new()" method. Currently included with FormBuilder are several different locales:
English (default) en_US Danish da_DK German/Deutsch de_DE Spanish/Espanol es_ES Japanese ja_JP Norwegian/Norvegian no_NO Turkish tr_TR Russian ru_RU
To enable automatic localization that will detect the client's locale and use one of these included locales, simply turn on "auto" messages:
my $form = CGI::FormBuilder->new(messages => 'auto');
Or, to use a specific locale, specify it as ":locale"
# Force Danish messages my $form = CGI::FormBuilder->new(messages => ':da_DK');
In addition to these included locales, you can completely customize your own messages. Each message that FormBuilder outputs is given a unique key. You can selectively override FormBuilder messages by specifying a different message string for a given message key.
To do so, first create a file and give it a unique name. In this example we will use a shortened locale as the suffix:
# messages.en # FormBuilder messages for "en" locale js_invalid_start %s error(s) were found in your form:\n js_invalid_end Fix these fields and try again! js_invalid_select - You must choose an option for the "%s" field\n
Then, specify this file to "new()".
my $form = CGI::FormBuilder->new(messages => 'messages.en');
Alternatively, you could specify this directly as a hashref:
my $form = CGI::FormBuilder->new( messages => { js_invalid_start => '%s error(s) were found in your form:\n', js_invalid_end => 'Fix these fields and try again!', js_invalid_select => '- Choose an option from the "%s" list\n', } );
Although in practice this is rarely useful, unless you just want to tweak one or two things.
This system is easy, and there are many many messages that can be customized. Here is a list of messages, along with their default values:
form_invalid_input Invalid entry form_invalid_checkbox Check one or more options form_invalid_file Invalid filename form_invalid_password Invalid entry form_invalid_radio Choose an option form_invalid_select Select an option from this list form_invalid_textarea Please fill this in form_invalid_default Invalid entry form_invalid_text %s error(s) were encountered with your submission. Please correct the fields %shighlighted%s below. form_required_text Fields that are %shighlighted%s are required. form_confirm_text Success! Your submission has been received %s. form_select_default -select- form_grow_default Additional %s form_other_default Other: form_reset_default Reset form_submit_default Submit js_noscript Please enable JavaScript or use a newer browser. js_invalid_start %s error(s) were encountered with your submission: js_invalid_end Please correct these fields and try again. js_invalid_checkbox - Check one or more of the "%s" options js_invalid_default - Invalid entry for the "%s" field js_invalid_file - Invalid filename for the "%s" field js_invalid_input - Invalid entry for the "%s" field js_invalid_multiple - Select one or more options from the "%s" list js_invalid_password - Invalid entry for the "%s" field js_invalid_radio - Choose one of the "%s" options js_invalid_select - Select an option from the "%s" list js_invalid_textarea - Please fill in the "%s" field mail_confirm_subject %s Submission Confirmation mail_confirm_text Your submission has been received %s, and will be processed shortly. mail_results_subject %s Submission Results
The "js_" tags are used in JavaScript alerts, whereas the "form_" tags are used in HTML and templates managed by FormBuilder.
In some of the messages, you will notice a %s "printf" format. This is because these messages will include certain details for you. For example, the "js_invalid_start" tag will print the number of errors if you include the %s format tag. Of course, this is optional, and you can leave it out.
The best way to get an idea of how these work is to experiment a little. It should become obvious really quickly.
Foreign language translations were contributed by the following people:
Thanks!
CGI::FormBuilder
$Id: Messages.pm 100 2007-03-02 18:13:13Z nwiger $
Copyright (c) Nate Wiger <http://nateware.com>. All Rights Reserved.
This module is free software; you may copy this under the terms of the GNU General Public License, or the Artistic License, copies of which should have accompanied your Perl kit.
2019-01-19 | perl v5.28.1 |