Class: MF_Widget_calendar extends MF_Widget
- Package: saf.MailForm
- Author: John Luxford <lux@simian.ca>
- Copyright: Copyright (C) 2001-2003, Simian Systems Inc.
- License: http://www.sitellite.org/index/license Simian Open Software License
- Version: 1.2, 2003-11-06, $Id: Calendar.php,v 1.4 2007/10/06 00:06:30 lux Exp $
- Access: public
Calendar widget. Displays a text box with a Javascript calendar popup
to select dates. The format of the date can also be specified, but the
default is YYYY-MM-DD.
The Javascript from this widget is based on the DHTML Calendar project
at http://students.infoiasi.ro/~mishoo/site/calendar.epl
New in 1.2:
- Updated to work with the DHTML Calendar version 0.9.4 and up.
Usage Example
<?php
$widget = new MF_Widget_calendar ('name');
$widget->setFormat ('y/m/d');
echo $widget->display ();
?>
Properties
$invalid_field = ''
- Access: public
Contains the name of the widget that did not validate during
the last call to the invalid () method.
$method
- Access: public
The value of the method attribute of the HTML form tag.
$method is actually an alias for $_attrs['method'].
$action
- Access: public
The value of the action attribute of the HTML form tag.
$action is actually an alias for $_attrs['action'].
$widgets = array ()
- Access: public
An array of form widgets.
$template
- Access: public
The optional template file or data used to customize the look
of the form.
$title
- Access: public
The title to be displayed at the top of the form.
$message
- Access: public
The initial message to be displayed at the top of the form.
$extra = ''
- Access: public
A way to pass extra parameters to the HTML form tag, for
example 'enctype="multipart/formdata"'.
$error_message
- Access: public
Contains the message from any internal errors.
$error_mode = 'single'
- Access: public
Determines the way in which error messages are displayed.
The default ('single') is to display the error message for the first
invalid field only. The other ('all') is to display a list of all
invalid fields with their corresponding error messages. Please note
that $error_mode 'all' assumes that a custom error message is provided
for every rule.
$invalid = array ()
- Access: public
A list of all invalid fields in the form, and their corresponding
error messages.
$submitted = false
- Access: private
Contains a true or false value as to whether the form has been
submitted successfully or not. An invalid form will contain false.
This value is used internally by the setValues() method.
$name
- Access: public
The name of the widget.
$_attrs = array ()
- Access: private
This contains a list of attributes of the HTML form tag.
$sendTo
- Access: public
The email address to send the form to in the default handler.
$sendFrom = ''
- Access: public
The email address to send the form from in the default handler.
$sendExtra = ''
- Access: public
Any extra parameters for the mail() function in the default handler.
$sendSubject = 'Mail Form'
- Access: public
The subject line of the email to send from the default handler.
$screenReply = 'Thank you. Your form has been sent.'
- Access: public
The response to return upon a successfully submitted form in the
default handler. Defaults to "Thank you. Your form has been sent."
$handler
- Access: public
The function or object method to use to handle the submitted form.
This function or method will be called by the run() method. Use the
setHandler() method to change this setting.
$uploadFiles = true
- Access: public
Whether to upload files automatically or to leave them for a custom
saving mechanism.
$verify_sender = false
- Access: public
Whether to verify the REQUEST_METHOD and HTTP_REFERER headers to make
it more difficult (although not impossible) for spammers to abuse your
form. Note that this can be enabled in a form's settings file under
the [Form] block via: verify_sender = yes
$clean_input = false
- Access: public
Whether to strip all HTML and PHP tags/code from all input parameters.
This is off by default because it would break forms with the Xed editor
by default, so it must be enabled as needed. Note that this can be
enabled in a form's settings file under the [Form] block via:
clean_input = yes
$blacklist = true
- Access: public
Whether to verify the remote address of the form submitter against
a list of invalid IP addresses in the database table
sitellite_form_blacklist so as to prevent repeated abuse from a single
source.
$verify_session = true
- Access: public
Whether to verify that the submitter can accept session data, which
helps ensure they are a legitimate human user. Passing session
verification requires cookies to be enabled for the submitter, which
may help prevent abuse in combination with the other abuse-prevention
techniques because a spambot may ignore the cookie, however this
restricts forms for legitimate visitors who have cookies disabled
in their browser (only a very small number of users disable cookies,
but some do). To disable for a single form, add verify_session = no
to its settings.php form.
$autosave = false
- Access: public
Whether this form should tie into Sitellite's autosave capabilities.
Please note that the autosave handler is only available to authenticated
users and not to anonymous forms.
$context = false
The context of the form. If this is set to 'action' then the title of
the form will be set by calling page_title() instead of outputting an
<h1> tag.
$rule
- Access: public
The original unmodified rule definition.
$msg
- Access: public
The error message for this rule.
$type = 'calendar'
- Access: public
This is the short name for this widget. The short name is
the class name minus the 'MF_Widget_' prefix.
$value
- Access: public
The rule value. This corresponds to the part of the rule
in double quotes (ie. type "value").
$negated = false
- Access: public
If a 'not' is present at the start of the rule, this will be
set to true, otherwise false.
$allowed = array ()
- Access: public
The access levels the user is allowed to access.
$nullable
- Access: public
Determines whether this widget can be set to null in the database.
$tables = array ()
- Access: public
The list of elements that are to be displayed.
$allow_all_text = 'Allow All'
- Access: public
The text to display for the first element, which defaults to 'Allow All'.
$size = 3
- Access: public
Sets the size attribute of the select box that displays
the current attachments. Defaults to 3.
$addLink = 'addAttachment.php'
- Access: public
This is the link to send the 'Add' button to. Defaults to
'addAttachment.php'.
$removeLink = 'removeAttachment.php'
- Access: public
This is the link to send the 'Remove' button to. Defaults to
'removeAttachment.php'.
$format = '%Y-%m-%d'
- Access: public
This determines the format of the date stored in the hidden
field, and also the format submitted by the form widget.
$displayFormat = '%a, %e %b, %Y'
- Access: public
This determines the format of the date displayed to the user.
$lang = 'en'
- Access: public
This determines the language file to load for the calendar
user interface. See the folder /js/calendar/lang for a list
of available languages.
$style = 'sitellite'
- Access: public
This determines the stylesheet to load for the calendar
user interface. See the CSS files in the folder /js/calendar
for a list of available stylesheets, or information on
writing your own.
$showsTime = false
- Access: public
Determines whether to show the time selection options under the
calendar.
$timeFormat = '12'
- Access: public
Sets the display time to 24 hours, or 12 hours with AM/PM option.
The default is 12 hours.
Methods
MF_Widget_calendar ($name)
- Access: public
Constructor Method.
displayValue ()
js2phpFormat ($date)
display ($generate_html = 0)
- Access: public
- Return: string
Returns the display HTML for this widget. The optional
parameter determines whether or not to automatically display the widget
nicely, or whether to simply return the widget (for use in a template).