Upgrade to 4.2.8

[usit-rt.git] / share / html / Widgets / Form / String

%# BEGIN BPS TAGGED BLOCK {{{
%#
%# COPYRIGHT:
%#
%# This software is Copyright (c) 1996-2014 Best Practical Solutions, LLC
%#                                          <sales@bestpractical.com>
%#
%# (Except where explicitly superseded by other copyright notices)
%#
%#
%# LICENSE:
%#
%# This work is made available to you under the terms of Version 2 of
%# the GNU General Public License. A copy of that license should have
%# been provided with this software, but in any event can be snarfed
%# from www.gnu.org.
%#
%# This work is distributed in the hope that it will be useful, but
%# WITHOUT ANY WARRANTY; without even the implied warranty of
%# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
%# General Public License for more details.
%#
%# You should have received a copy of the GNU General Public License
%# along with this program; if not, write to the Free Software
%# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
%# 02110-1301 or visit their web page on the internet at
%# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.
%#
%#
%# CONTRIBUTION SUBMISSION POLICY:
%#
%# (The following paragraph is not intended to limit the rights granted
%# to you to modify and distribute this software under the terms of
%# the GNU General Public License and is only of importance to you if
%# you choose to contribute your changes and enhancements to the
%# community by submitting them to Best Practical Solutions, LLC.)
%#
%# By intentionally submitting any modifications, corrections or
%# derivatives to this work, or any other work intended for use with
%# Request Tracker, to Best Practical Solutions, LLC, you confirm that
%# you are the copyright holder for those contributions and you grant
%# Best Practical Solutions,  LLC a nonexclusive, worldwide, irrevocable,
%# royalty-free, perpetual, license to use, copy, create derivative
%# works based on those contributions, and sublicense and distribute
%# those contributions and any derivatives thereof.
%#
%# END BPS TAGGED BLOCK }}}
<%DOC>
see docs/extending/using_forms_widgets.pod
</%DOC>
<div id="form-box-<% lc $Name %>" class="widget">
<span class="description label"><% $Description %></span>
<span class="value"><& SELF:InputOnly, %ARGS &></span>
% if ( $Default ) {
<span class="comment"><% $DefaultLabel %></span>
% }
<span class="hints"><% $Hints %></span>
</div>
<%ARGS>
$Name

$Description  => undef,
$Hints        => ''

$CurrentValue => '',

$Default        => 0,
$DefaultValue   => '',
$DefaultLabel   => loc( 'Default: [_1]', $DefaultValue ),
</%ARGS>

<%METHOD InputOnly>
<input type="<% $Type %>" name="<% $Name %>" value="<% $CurrentValue || '' %>" />\
<%ARGS>
$Name
$CurrentValue => '',
$Type => 'text'
</%ARGS>
</%METHOD>

<%METHOD Process>
<%ARGS>
$Name

$Arguments    => {},

$Default      => 0,
$DefaultValue => '',
</%ARGS>
<%INIT>
my $value = $Arguments->{ $Name };
$value = '' unless defined $value;

# canonicalize: delete leading and trailing spaces, replaces newlines
# with one space and then replace all continuouse spaces with one ' '
# (including tabs and other fancy things)
$value =~ s/^\s+//;
$value =~ s/\s+$//;
$value =~ s/\r*\n/ /g;
$value =~ s/\s+$/ /g;

if ( $value eq '' ) {
    return $DefaultValue unless $Default;
    return undef;
}
return $value;
</%INIT>
</%METHOD>