JS Calendar Contrib

<--
   Contributions to this contrib package are appreciated. Please update this page at
   http://twiki.org/cgi-bin/view/Plugins/JSCalendarContrib or provide feedback at
   http://twiki.org/cgi-bin/view/Plugins/JSCalendarContribDev.
   If you are a TWiki contributor please update the extension in the SVN repository.
-->

Page contents

• Introduction
• Using the Calendar in TWikiForms
• Using the Calendar in user forms
• Detailed Documentation
  • renderDateForEdit
  • addHEAD
• Installation Instructions
• Contrib Info

Introduction

This module packages the Mishoo JSCalendar, a DHTML pop-up calendar in a form suitable for use in TWiki forms and TWiki applications.

Using the Calendar in TWikiForms

This package adds a date type to TWikiForms:

Example form definition:

Using the Calendar in user forms

You can also use the calendar directly in your own hand-built forms, without having to write any code. Just add this inline in the topic text:

%INCLUDE{"%SYSTEMWEB%.JSCalendarContribInline"}%

<input type="text" id="cal_val_here" />
<input type="image" src="%PUBURL%/%SYSTEMWEB%/JSCalendarContrib/img.gif" onclick="javascript: return showCalendar('cal_val_here','%Y-%m-%d')" />

Detailed Documentation

Read the Mishoo documentation or visit the demo page for detailed information on using the calendar widget.

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the functions:

renderDateForEdit

TWiki::Contrib::JSCalendarContrib::renderDateForEdit($name, $value, $format [, \%cssClass]) -> $html

This is the simplest way to use calendars from a plugin.

• $name is the name of the CGI parameter for the calendar (it should be unique),
• $value is the current value of the parameter (may be undef)
• $format is the format to use (optional; the default is set in configure). The HTML returned will display a date field and a drop-down calendar.
• \%options is an optional hash containing base options for the textfield.

use TWiki::Contrib::JSCalendarContrib;
...
my $fromDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'from', '1 April 1999');
my $toDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'to', undef, '%Y');

addHEAD

TWiki::Contrib::JSCalendarContrib::addHEAD($setup)

This function will automatically add the headers for the calendar to the page being rendered. It's intended for use when you want more control over the formatting of your calendars than renderDateForEdit affords. $setup is the name of the calendar setup module; it can either be omitted, in which case the method described in the Mishoo documentation can be used to create calendars, or it can be 'twiki', in which case a Javascript helper function called 'showCalendar' is added that simplifies using calendars to set a value in a text field. For example, say we wanted to display the date with the calendar icon before the text field, using the format %Y %b %e

# Add styles and javascript for the calendar
use TWiki::Contrib::JSCalendarContrib;
...

sub commonTagsHandler {
  ....
  # Enable 'showCalendar'
  TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );

  my $cal = CGI::image_button(
      -name => 'img_datefield',
      -onclick =>
       "return showCalendar('id_datefield','%Y %b %e')",
      -src=> TWiki::Func::getPubUrlPath() . '/' .
             TWiki::Func::getTwikiWebname() .
             '/JSCalendarContrib/img.gif',
      -alt => 'Calendar',
      -align => 'middle' )
    . CGI::textfield(
      { name => 'date', id => "id_datefield" });
  ....
}

All available date specifiers:

%a - abbreviated weekday name 
%A - full weekday name 
%b - abbreviated month name 
%B - full month name 
%C - century number 
%d - the day of the month ( 00 .. 31 ) 
%e - the day of the month ( 0 .. 31 ) 
%H - hour ( 00 .. 23 ) 
%I - hour ( 01 .. 12 ) 
%j - day of the year ( 000 .. 366 ) 
%k - hour ( 0 .. 23 ) 
%l - hour ( 1 .. 12 ) 
%m - month ( 01 .. 12 ) 
%M - minute ( 00 .. 59 ) 
%n - a newline character 
%p - "PM" or "AM"
%P - "pm" or "am"
%S - second ( 00 .. 59 ) 
%s - number of seconds since Epoch (since Jan 01 1970 00:00:00 UTC) 
%t - a tab character 
%U, %W, %V - the week number
   The week 01 is the week that has the Thursday in the current year,
   which is equivalent to the week that contains the fourth day of January. 
   Weeks start on Monday.
%u - the day of the week ( 1 .. 7, 1 = MON ) 
%w - the day of the week ( 0 .. 6, 0 = SUN ) 
%y - year without the century ( 00 .. 99 ) 
%Y - year including the century ( ex. 1979 ) 
%% - a literal % character 

addHEAD can be called from commonTagsHandler for adding the header to all pages, or from beforeEditHandler just for edit pages etc.

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server where TWiki is running.

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

• If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • See the installation supplement on TWiki.org for more information.
• If you have any problems, then you can still install manually from the command-line:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your TWiki installation.
  3. Run the installer script ( perl <module>_installer )
  4. Run configure and enable the module, if it is a plugin.
  5. Repeat for any missing dependencies.
• If you are still having problems, then instead of running the installer script:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

• An administrator can customize the appearance of the calendar by modifying {JSCalendarContrib} settings in the "JSCalendarContrib Settings" section of the configure:

  Setting	Default
  $TWiki::cfg{JSCalendarContrib}{format}	'%Y-%m-%d'
  $TWiki::cfg{JSCalendarContrib}{lang}	'en'
  $TWiki::cfg{JSCalendarContrib}{style}	'blue'

Contrib Info

• Set SHORTDESCRIPTION = Mishoo JSCalendar: A pop-up calendar for use in TWiki forms and TWiki applications

<-- versions below in reverse order -->

Related Topics: TWikiPreferences, TWikiForms

JS Calendar Contrib

<--
   Contributions to this contrib package are appreciated. Please update this page at
   http://twiki.org/cgi-bin/view/Plugins/JSCalendarContrib or provide feedback at
   http://twiki.org/cgi-bin/view/Plugins/JSCalendarContribDev.
   If you are a TWiki contributor please update the extension in the SVN repository.
-->

Page contents

• Introduction
• Using the Calendar in TWikiForms
• Using the Calendar in user forms
• Detailed Documentation
  • renderDateForEdit
  • addHEAD
• Installation Instructions
• Contrib Info

Introduction

This module packages the Mishoo JSCalendar, a DHTML pop-up calendar in a form suitable for use in TWiki forms and TWiki applications.

Using the Calendar in TWikiForms

This package adds a date type to TWikiForms:

Example form definition:

Using the Calendar in user forms

You can also use the calendar directly in your own hand-built forms, without having to write any code. Just add this inline in the topic text:

%INCLUDE{"%SYSTEMWEB%.JSCalendarContribInline"}%

<input type="text" id="cal_val_here" />
<input type="image" src="%PUBURL%/%SYSTEMWEB%/JSCalendarContrib/img.gif" onclick="javascript: return showCalendar('cal_val_here','%Y-%m-%d')" />

Detailed Documentation

Read the Mishoo documentation or visit the demo page for detailed information on using the calendar widget.

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the functions:

renderDateForEdit

TWiki::Contrib::JSCalendarContrib::renderDateForEdit($name, $value, $format [, \%cssClass]) -> $html

This is the simplest way to use calendars from a plugin.

• $name is the name of the CGI parameter for the calendar (it should be unique),
• $value is the current value of the parameter (may be undef)
• $format is the format to use (optional; the default is set in configure). The HTML returned will display a date field and a drop-down calendar.
• \%options is an optional hash containing base options for the textfield.

use TWiki::Contrib::JSCalendarContrib;
...
my $fromDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'from', '1 April 1999');
my $toDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'to', undef, '%Y');

addHEAD

TWiki::Contrib::JSCalendarContrib::addHEAD($setup)

This function will automatically add the headers for the calendar to the page being rendered. It's intended for use when you want more control over the formatting of your calendars than renderDateForEdit affords. $setup is the name of the calendar setup module; it can either be omitted, in which case the method described in the Mishoo documentation can be used to create calendars, or it can be 'twiki', in which case a Javascript helper function called 'showCalendar' is added that simplifies using calendars to set a value in a text field. For example, say we wanted to display the date with the calendar icon before the text field, using the format %Y %b %e

# Add styles and javascript for the calendar
use TWiki::Contrib::JSCalendarContrib;
...

sub commonTagsHandler {
  ....
  # Enable 'showCalendar'
  TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );

  my $cal = CGI::image_button(
      -name => 'img_datefield',
      -onclick =>
       "return showCalendar('id_datefield','%Y %b %e')",
      -src=> TWiki::Func::getPubUrlPath() . '/' .
             TWiki::Func::getTwikiWebname() .
             '/JSCalendarContrib/img.gif',
      -alt => 'Calendar',
      -align => 'middle' )
    . CGI::textfield(
      { name => 'date', id => "id_datefield" });
  ....
}

All available date specifiers:

%a - abbreviated weekday name 
%A - full weekday name 
%b - abbreviated month name 
%B - full month name 
%C - century number 
%d - the day of the month ( 00 .. 31 ) 
%e - the day of the month ( 0 .. 31 ) 
%H - hour ( 00 .. 23 ) 
%I - hour ( 01 .. 12 ) 
%j - day of the year ( 000 .. 366 ) 
%k - hour ( 0 .. 23 ) 
%l - hour ( 1 .. 12 ) 
%m - month ( 01 .. 12 ) 
%M - minute ( 00 .. 59 ) 
%n - a newline character 
%p - "PM" or "AM"
%P - "pm" or "am"
%S - second ( 00 .. 59 ) 
%s - number of seconds since Epoch (since Jan 01 1970 00:00:00 UTC) 
%t - a tab character 
%U, %W, %V - the week number
   The week 01 is the week that has the Thursday in the current year,
   which is equivalent to the week that contains the fourth day of January. 
   Weeks start on Monday.
%u - the day of the week ( 1 .. 7, 1 = MON ) 
%w - the day of the week ( 0 .. 6, 0 = SUN ) 
%y - year without the century ( 00 .. 99 ) 
%Y - year including the century ( ex. 1979 ) 
%% - a literal % character 

addHEAD can be called from commonTagsHandler for adding the header to all pages, or from beforeEditHandler just for edit pages etc.

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server where TWiki is running.

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

• If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • See the installation supplement on TWiki.org for more information.
• If you have any problems, then you can still install manually from the command-line:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your TWiki installation.
  3. Run the installer script ( perl <module>_installer )
  4. Run configure and enable the module, if it is a plugin.
  5. Repeat for any missing dependencies.
• If you are still having problems, then instead of running the installer script:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

• An administrator can customize the appearance of the calendar by modifying {JSCalendarContrib} settings in the "JSCalendarContrib Settings" section of the configure:

  Setting	Default
  $TWiki::cfg{JSCalendarContrib}{format}	'%Y-%m-%d'
  $TWiki::cfg{JSCalendarContrib}{lang}	'en'
  $TWiki::cfg{JSCalendarContrib}{style}	'blue'

Contrib Info

• Set SHORTDESCRIPTION = Mishoo JSCalendar: A pop-up calendar for use in TWiki forms and TWiki applications

Related Topics: TWikiPreferences, TWikiForms

JS Calendar Contrib

<--
   Contributions to this contrib package are appreciated. Please update this page at
   http://twiki.org/cgi-bin/view/Plugins/JSCalendarContrib or provide feedback at
   http://twiki.org/cgi-bin/view/Plugins/JSCalendarContribDev.
   If you are a TWiki contributor please update the extension in the SVN repository.
-->

Introduction

This module packages the Mishoo JSCalendar, a DHTML pop-up calendar in a form suitable for use in TWiki forms and TWiki applications.

Using the Calendar in user forms

You can also use the calendar directly in your own hand-built forms, without having to write any code. Just add this inline in the topic text:

%INCLUDE{"%SYSTEMWEB%.JSCalendarContribInline"}%

<input type="text" id="cal_val_here" />
<input type="image" src="%PUBURL%/%SYSTEMWEB%/JSCalendarContrib/img.gif" onclick="javascript: return showCalendar('cal_val_here','%Y-%m-%d')" />

Detailed Documentation

Read the Mishoo documentation or visit the demo page for detailed information on using the calendar widget.

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the functions:

renderDateForEdit

TWiki::Contrib::JSCalendarContrib::renderDateForEdit($name, $value, $format [, \%cssClass]) -> $html

This is the simplest way to use calendars from a plugin.

• $name is the name of the CGI parameter for the calendar (it should be unique),
• $value is the current value of the parameter (may be undef)
• $format is the format to use (optional; the default is set in configure). The HTML returned will display a date field and a drop-down calendar.
• \%options is an optional hash containing base options for the textfield.

use TWiki::Contrib::JSCalendarContrib;
...
my $fromDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'from', '1 April 1999');
my $toDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'to', undef, '%Y');

addHEAD

TWiki::Contrib::JSCalendarContrib::addHEAD($setup)

This function will automatically add the headers for the calendar to the page being rendered. It's intended for use when you want more control over the formatting of your calendars than renderDateForEdit affords. $setup is the name of the calendar setup module; it can either be omitted, in which case the method described in the Mishoo documentation can be used to create calendars, or it can be 'twiki', in which case a Javascript helper function called 'showCalendar' is added that simplifies using calendars to set a value in a text field. For example, say we wanted to display the date with the calendar icon before the text field, using the format %Y %b %e

# Add styles and javascript for the calendar
use TWiki::Contrib::JSCalendarContrib;
...

sub commonTagsHandler {
  ....
  # Enable 'showCalendar'
  TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );

  my $cal = CGI::image_button(
      -name => 'img_datefield',
      -onclick =>
       "return showCalendar('id_datefield','%Y %b %e')",
      -src=> TWiki::Func::getPubUrlPath() . '/' .
             TWiki::Func::getTwikiWebname() .
             '/JSCalendarContrib/img.gif',
      -alt => 'Calendar',
      -align => 'middle' )
    . CGI::textfield(
      { name => 'date', id => "id_datefield" });
  ....
}

All available date specifiers:

%a - abbreviated weekday name 
%A - full weekday name 
%b - abbreviated month name 
%B - full month name 
%C - century number 
%d - the day of the month ( 00 .. 31 ) 
%e - the day of the month ( 0 .. 31 ) 
%H - hour ( 00 .. 23 ) 
%I - hour ( 01 .. 12 ) 
%j - day of the year ( 000 .. 366 ) 
%k - hour ( 0 .. 23 ) 
%l - hour ( 1 .. 12 ) 
%m - month ( 01 .. 12 ) 
%M - minute ( 00 .. 59 ) 
%n - a newline character 
%p - "PM" or "AM"
%P - "pm" or "am"
%S - second ( 00 .. 59 ) 
%s - number of seconds since Epoch (since Jan 01 1970 00:00:00 UTC) 
%t - a tab character 
%U, %W, %V - the week number
   The week 01 is the week that has the Thursday in the current year,
   which is equivalent to the week that contains the fourth day of January. 
   Weeks start on Monday.
%u - the day of the week ( 1 .. 7, 1 = MON ) 
%w - the day of the week ( 0 .. 6, 0 = SUN ) 
%y - year without the century ( 00 .. 99 ) 
%Y - year including the century ( ex. 1979 ) 
%% - a literal % character 

addHEAD can be called from commonTagsHandler for adding the header to all pages, or from beforeEditHandler just for edit pages etc.

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server where TWiki is running.

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

• If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • See the installation supplement on TWiki.org for more information.
• If you have any problems, then you can still install manually from the command-line:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your TWiki installation.
  3. Run the installer script ( perl <module>_installer )
  4. Run configure and enable the module, if it is a plugin.
  5. Repeat for any missing dependencies.
• If you are still having problems, then instead of running the installer script:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

• An administrator can customize the appearance of the calendar by modifying {JSCalendarContrib} settings in the "JSCalendarContrib Settings" section of the configure:

  Setting	Default
  $TWiki::cfg{JSCalendarContrib}{format}	'%Y-%m-%d'
  $TWiki::cfg{JSCalendarContrib}{lang}	'en'
  $TWiki::cfg{JSCalendarContrib}{style}	'blue'

Contrib Info

• Set SHORTDESCRIPTION = Mishoo JSCalendar: A pop-up calendar for use in TWiki forms and TWiki applications

Related Topics: TWikiPreferences, TWikiForms

Using the Calendar in user forms

You can also use the calendar directly in your own hand-built forms, without having to write any code. Just add this inline in the topic text:

%INCLUDE{"%SYSTEMWEB%.JSCalendarContribInline"}%

<input type="text" id="cal_val_here" />
<input type="image" src="%PUBURL%/%SYSTEMWEB%/JSCalendarContrib/img.gif" onclick="javascript: return showCalendar('cal_val_here','%Y-%m-%d')" />

Detailed Documentation

Read the Mishoo documentation or visit the demo page for detailed information on using the calendar widget.

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the functions:

• $name is the name of the CGI parameter for the calendar (it should be unique),
• $value is the current value of the parameter (may be undef)
• $format is the format to use (optional; the default is set in configure). The HTML returned will display a date field and a drop-down calendar.
• \%options is an optional hash containing base options for the textfield.

use TWiki::Contrib::JSCalendarContrib;
...
my $fromDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'from', '1 April 1999');
my $toDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'to', undef, '%Y');

# Add styles and javascript for the calendar
use TWiki::Contrib::JSCalendarContrib;
...

sub commonTagsHandler {
  ....
  # Enable 'showCalendar'
  TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );

  my $cal = CGI::image_button(
      -name => 'img_datefield',
      -onclick =>
       "return showCalendar('id_datefield','%Y %b %e')",
      -src=> TWiki::Func::getPubUrlPath() . '/' .
             TWiki::Func::getTwikiWebname() .
             '/JSCalendarContrib/img.gif',
      -alt => 'Calendar',
      -align => 'middle' )
    . CGI::textfield(
      { name => 'date', id => "id_datefield" });
  ....
}

All available date specifiers:

%a - abbreviated weekday name 
%A - full weekday name 
%b - abbreviated month name 
%B - full month name 
%C - century number 
%d - the day of the month ( 00 .. 31 ) 
%e - the day of the month ( 0 .. 31 ) 
%H - hour ( 00 .. 23 ) 
%I - hour ( 01 .. 12 ) 
%j - day of the year ( 000 .. 366 ) 
%k - hour ( 0 .. 23 ) 
%l - hour ( 1 .. 12 ) 
%m - month ( 01 .. 12 ) 
%M - minute ( 00 .. 59 ) 
%n - a newline character 
%p - "PM" or "AM"
%P - "pm" or "am"
%S - second ( 00 .. 59 ) 
%s - number of seconds since Epoch (since Jan 01 1970 00:00:00 UTC) 
%t - a tab character 
%U, %W, %V - the week number
   The week 01 is the week that has the Thursday in the current year,
   which is equivalent to the week that contains the fourth day of January. 
   Weeks start on Monday.
%u - the day of the week ( 1 .. 7, 1 = MON ) 
%w - the day of the week ( 0 .. 6, 0 = SUN ) 
%y - year without the century ( 00 .. 99 ) 
%Y - year including the century ( ex. 1979 ) 
%% - a literal % character 

addHEAD can be called from commonTagsHandler for adding the header to all pages, or from beforeEditHandler just for edit pages etc.

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server where TWiki is running.

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

• If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • See the installation supplement on TWiki.org for more information.
• If you have any problems, then you can still install manually from the command-line:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your TWiki installation.
  3. Run the installer script ( perl <module>_installer )
  4. Run configure and enable the module, if it is a plugin.
  5. Repeat for any missing dependencies.
• If you are still having problems, then instead of running the installer script:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

• An administrator can customize the appearance of the calendar by modifying {JSCalendarContrib} settings in the "JSCalendarContrib Settings" section of the configure:

  Setting	Default
  $TWiki::cfg{JSCalendarContrib}{format}	'%Y-%m-%d'
  $TWiki::cfg{JSCalendarContrib}{lang}	'en'
  $TWiki::cfg{JSCalendarContrib}{style}	'blue'

Contrib Info

• Set SHORTDESCRIPTION = Mishoo JSCalendar: A pop-up calendar for use in TWiki forms and TWiki applications

Related Topics: TWikiPreferences, TWikiForms

<--
   Contributions to this contrib package are appreciated. Please update this page
   at http://twiki.org/cgi-bin/view/Plugins/JSCalendarContrib or provide feedback
   at http://twiki.org/cgi-bin/view/Plugins/JSCalendarContribDev.
   If you are a TWiki contributor please update the extension in the SVN repository.
-->

JS Calendar Contrib

Using the Calendar in user forms

You can also use the calendar directly in your own hand-built forms, without having to write any code. Just add this inline in the topic text:

%INCLUDE{"%SYSTEMWEB%.JSCalendarContribInline"}%

<input type="text" id="cal_val_here" />
<input type="image" src="%PUBURL%/%SYSTEMWEB%/JSCalendarContrib/img.gif" onclick="javascript: return showCalendar('cal_val_here','%Y-%m-%d')" />

Detailed Documentation

Read the Mishoo documentation or visit the demo page for detailed information on using the calendar widget.

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the functions:

TWiki::Contrib::JSCalendarContrib::renderDateForEdit($name, $value, $format [, \%cssClass]) -> $html

This is the simplest way to use calendars from a plugin.

• $name is the name of the CGI parameter for the calendar (it should be unique),
• $value is the current value of the parameter (may be undef)
• $format is the format to use (optional; the default is set in configure). The HTML returned will display a date field and a drop-down calendar.
• \%options is an optional hash containing base options for the textfield.

use TWiki::Contrib::JSCalendarContrib;
...
my $fromDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'from', '1 April 1999');
my $toDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'to', undef, '%Y');

TWiki::Contrib::JSCalendarContrib::addHEAD($setup)

This function will automatically add the headers for the calendar to the page being rendered. It's intended for use when you want more control over the formatting of your calendars than renderDateForEdit affords. $setup is the name of the calendar setup module; it can either be omitted, in which case the method described in the Mishoo documentation can be used to create calendars, or it can be 'twiki', in which case a Javascript helper function called 'showCalendar' is added that simplifies using calendars to set a value in a text field. For example, say we wanted to display the date with the calendar icon before the text field, using the format %Y %b %e

# Add styles and javascript for the calendar
use TWiki::Contrib::JSCalendarContrib;
...

sub commonTagsHandler {
  ....
  # Enable 'showCalendar'
  TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );

  my $cal = CGI::image_button(
      -name => 'img_datefield',
      -onclick =>
       "return showCalendar('id_datefield','%Y %b %e')",
      -src=> TWiki::Func::getPubUrlPath() . '/' .
             TWiki::Func::getTwikiWebname() .
             '/JSCalendarContrib/img.gif',
      -alt => 'Calendar',
      -align => 'middle' )
    . CGI::textfield(
      { name => 'date', id => "id_datefield" });
  ....
}

All available date specifiers:

%a - abbreviated weekday name 
%A - full weekday name 
%b - abbreviated month name 
%B - full month name 
%C - century number 
%d - the day of the month ( 00 .. 31 ) 
%e - the day of the month ( 0 .. 31 ) 
%H - hour ( 00 .. 23 ) 
%I - hour ( 01 .. 12 ) 
%j - day of the year ( 000 .. 366 ) 
%k - hour ( 0 .. 23 ) 
%l - hour ( 1 .. 12 ) 
%m - month ( 01 .. 12 ) 
%M - minute ( 00 .. 59 ) 
%n - a newline character 
%p - "PM" or "AM"
%P - "pm" or "am"
%S - second ( 00 .. 59 ) 
%s - number of seconds since Epoch (since Jan 01 1970 00:00:00 UTC) 
%t - a tab character 
%U, %W, %V - the week number
   The week 01 is the week that has the Thursday in the current year,
   which is equivalent to the week that contains the fourth day of January. 
   Weeks start on Monday.
%u - the day of the week ( 1 .. 7, 1 = MON ) 
%w - the day of the week ( 0 .. 6, 0 = SUN ) 
%y - year without the century ( 00 .. 99 ) 
%Y - year including the century ( ex. 1979 ) 
%% - a literal % character 

addHEAD can be called from commonTagsHandler for adding the header to all pages, or from beforeEditHandler just for edit pages etc.

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server where TWiki is running.

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

• If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • See the installation supplement on TWiki.org for more information.
• If you have any problems, then you can still install manually from the command-line:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your TWiki installation.
  3. Run the installer script ( perl <module>_installer )
  4. Run configure and enable the module, if it is a plugin.
  5. Repeat for any missing dependencies.
• If you are still having problems, then instead of running the installer script:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

• An administrator can customize the appearance of the calendar by modifying {JSCalendarContrib} settings in the "JSCalendarContrib Settings" section of the configure:

  Setting	Default
  $TWiki::cfg{JSCalendarContrib}{format}	'%Y-%m-%d'
  $TWiki::cfg{JSCalendarContrib}{lang}	'en'
  $TWiki::cfg{JSCalendarContrib}{style}	'blue'

Contrib Info

• Set SHORTDESCRIPTION = Mishoo JSCalendar: A pop-up calendar for use in TWiki forms and TWiki applications

Related Topics: TWikiPreferences, TWikiForms

Detailed Documentation

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the functions:

TWiki::Contrib::JSCalendarContrib::renderDateForEdit($name, $value, $format [, \%cssClass]) -> $html

This is the simplest way to use calendars from a plugin.

• $name is the name of the CGI parameter for the calendar (it should be unique),
• $value is the current value of the parameter (may be undef)
• $format is the format to use (optional; the default is set in configure). The HTML returned will display a date field and a drop-down calendar.
• \%options is an optional hash containing base options for the textfield.

use TWiki::Contrib::JSCalendarContrib;
...
my $fromDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'from', '1 April 1999');
my $toDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'to', undef, '%Y');

TWiki::Contrib::JSCalendarContrib::addHEAD($setup)

This function will automatically add the headers for the calendar to the page being rendered. It's intended for use when you want more control over the formatting of your calendars than renderDateForEdit affords. $setup is the name of the calendar setup module; it can either be omitted, in which case the method described in the Mishoo documentation can be used to create calendars, or it can be 'twiki', in which case a Javascript helper function called 'showCalendar' is added that simplifies using calendars to set a value in a text field. For example, say we wanted to display the date with the calendar icon before the text field, using the format %Y %b %e

# Add styles and javascript for the calendar
use TWiki::Contrib::JSCalendarContrib;
...

sub commonTagsHandler {
  ....
  # Enable 'showCalendar'
  TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );

  my $cal = CGI::image_button(
      -name => 'img_datefield',
      -onclick =>
       "return showCalendar('id_datefield','%Y %b %e')",
      -src=> TWiki::Func::getPubUrlPath() . '/' .
             TWiki::Func::getTwikiWebname() .
             '/JSCalendarContrib/img.gif',
      -alt => 'Calendar',
      -align => 'middle' )
    . CGI::textfield(
      { name => 'date', id => "id_datefield" });
  ....
}

All available date specifiers:

%a - abbreviated weekday name 
%A - full weekday name 
%b - abbreviated month name 
%B - full month name 
%C - century number 
%d - the day of the month ( 00 .. 31 ) 
%e - the day of the month ( 0 .. 31 ) 
%H - hour ( 00 .. 23 ) 
%I - hour ( 01 .. 12 ) 
%j - day of the year ( 000 .. 366 ) 
%k - hour ( 0 .. 23 ) 
%l - hour ( 1 .. 12 ) 
%m - month ( 01 .. 12 ) 
%M - minute ( 00 .. 59 ) 
%n - a newline character 
%p - "PM" or "AM"
%P - "pm" or "am"
%S - second ( 00 .. 59 ) 
%s - number of seconds since Epoch (since Jan 01 1970 00:00:00 UTC) 
%t - a tab character 
%U, %W, %V - the week number
   The week 01 is the week that has the Thursday in the current year,
   which is equivalent to the week that contains the fourth day of January. 
   Weeks start on Monday.
%u - the day of the week ( 1 .. 7, 1 = MON ) 
%w - the day of the week ( 0 .. 6, 0 = SUN ) 
%y - year without the century ( 00 .. 99 ) 
%Y - year including the century ( ex. 1979 ) 
%% - a literal % character 

addHEAD can be called from commonTagsHandler for adding the header to all pages, or from beforeEditHandler just for edit pages etc.

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

• If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • See the installation supplement on TWiki.org for more information.
• If you have any problems, then you can still install manually from the command-line:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your TWiki installation.
  3. Run the installer script ( perl <module>_installer )
  4. Run configure and enable the module, if it is a plugin.
  5. Repeat for any missing dependencies.
• If you are still having problems, then instead of running the installer script:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

JSCalendarContrib

Mishoo JSCalendar: A pop-up calendar for use in TWiki forms and TWiki applications

<--

   PLEASE DO NOT EDIT THIS TOPIC

   It is automatically generated from the subversion repository, and any changes
   you make will simply be overwritten the next time a release is generated.

   Instead, you could check your fix in, raise a bug in the Bugs web, or mail thge author.
-->

Summary of Contents

Detailed Documentation

Read the Mishoo documentation or visit the demo page for detailed information on using the calendar widget.

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the functions:

TWiki::Contrib::JSCalendarContrib::renderDateForEdit($name, $value, $format [, \%cssClass]) -> $html

This is the simplest way to use calendars from a plugin.

• $name is the name of the CGI parameter for the calendar (it should be unique),
• $value is the current value of the parameter (may be undef)
• $format is the format to use (optional; the default is set in configure). The HTML returned will display a date field and a drop-down calendar.
• \%options is an optional hash containing base options for the textfield.

use TWiki::Contrib::JSCalendarContrib;
...
my $fromDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'from', '1 April 1999');
my $toDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'to', undef, '%Y');

TWiki::Contrib::JSCalendarContrib::addHEAD($setup)

This function will automatically add the headers for the calendar to the page being rendered. It's intended for use when you want more control over the formatting of your calendars than renderDateForEdit affords. $setup is the name of the calendar setup module; it can either be omitted, in which case the method described in the Mishoo documentation can be used to create calendars, or it can be 'twiki', in which case a Javascript helper function called 'showCalendar' is added that simplifies using calendars to set a value in a text field. For example, say we wanted to display the date with the calendar icon before the text field, using the format %Y %b %e

# Add styles and javascript for the calendar
use TWiki::Contrib::JSCalendarContrib;
...

sub commonTagsHandler {
  ....
  # Enable 'showCalendar'
  TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );

  my $cal = CGI::image_button(
      -name => 'img_datefield',
      -onclick =>
       "return showCalendar('id_datefield','%Y %b %e')",
      -src=> TWiki::Func::getPubUrlPath() . '/' .
             TWiki::Func::getTwikiWebname() .
             '/JSCalendarContrib/img.gif',
      -alt => 'Calendar',
      -align => 'middle' )
    . CGI::textfield(
      { name => 'date', id => "id_datefield" });
  ....
}

All available date specifiers:

%a - abbreviated weekday name 
%A - full weekday name 
%b - abbreviated month name 
%B - full month name 
%C - century number 
%d - the day of the month ( 00 .. 31 ) 
%e - the day of the month ( 0 .. 31 ) 
%H - hour ( 00 .. 23 ) 
%I - hour ( 01 .. 12 ) 
%j - day of the year ( 000 .. 366 ) 
%k - hour ( 0 .. 23 ) 
%l - hour ( 1 .. 12 ) 
%m - month ( 01 .. 12 ) 
%M - minute ( 00 .. 59 ) 
%n - a newline character 
%p - "PM" or "AM"
%P - "pm" or "am"
%S - second ( 00 .. 59 ) 
%s - number of seconds since Epoch (since Jan 01 1970 00:00:00 UTC) 
%t - a tab character 
%U, %W, %V - the week number
   The week 01 is the week that has the Thursday in the current year,
   which is equivalent to the week that contains the fourth day of January. 
   Weeks start on Monday.
%u - the day of the week ( 1 .. 7, 1 = MON ) 
%w - the day of the week ( 0 .. 6, 0 = SUN ) 
%y - year without the century ( 00 .. 99 ) 
%Y - year including the century ( ex. 1979 ) 
%% - a literal % character 

addHEAD can be called from commonTagsHandler for adding the header to all pages, or from beforeEditHandler just for edit pages etc.

Using the Calendar in user forms

%INCLUDE{"%TWIKIWEB%/JSCalendarContribInline"}%

<input type="text" id="cal_val_here" />
<input type="image" src="%PUBURL%/%TWIKIWEB%/JSCalendarContrib/img.gif" onclick="javascript: return showCalendar('cal_val_here','%e %B %Y')" />

<-- 

 Set SHORTDESCRIPTION = Mishoo JSCalendar, packaged for use by plugins, skins and add-ons.
 
-->

Installation Instructions

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

• If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • See the installation supplement on TWiki.org for more information.
• If you have any problems, then you can still install manually from the command-line:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your TWiki installation.
  3. Run the installer script ( perl <module>_installer )
  4. Run configure and enable the module, if it is a plugin.
  5. Repeat for any missing dependencies.
• If you are still having problems, then instead of running the installer script:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

• An administrator can customize the appearance of the calendar by setting the following in LocalSite.cfg

  Setting	Default
  $TWiki::cfg{JSCalendarContrib}{style}	'blue'
  $TWiki::cfg{JSCalendarContrib}{lang}	'en'
  $TWiki::cfg{JSCalendarContrib}{format}	'%e %b %Y'

Contrib Info

Another great TWiki extension from the WikiRing - working together to improve your wiki experience!

Related Topics: TWikiPreferences

JSCalendarContrib

Mishoo JSCalendar: A pop-up calendar for use in TWiki forms and TWiki applications

<--

   PLEASE DO NOT EDIT THIS TOPIC

   It is automatically generated from the subversion repository, and any changes
   you make will simply be overwritten the next time a release is generated.

   Instead, you could check your fix in, raise a bug in the Bugs web, or mail thge author.
-->

Summary of Contents

Detailed Documentation

Read the Mishoo documentation or visit the demo page for detailed information on using the calendar widget.

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the functions:

TWiki::Contrib::JSCalendarContrib::renderDateForEdit($name, $value, $format [, \%cssClass]) -> $html

This is the simplest way to use calendars from a plugin.

• $name is the name of the CGI parameter for the calendar (it should be unique),
• $value is the current value of the parameter (may be undef)
• $format is the format to use (optional; the default is set in configure). The HTML returned will display a date field and a drop-down calendar.
• \%options is an optional hash containing base options for the textfield.

use TWiki::Contrib::JSCalendarContrib;
...
my $fromDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'from', '1 April 1999');
my $toDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'to', undef, '%Y');

TWiki::Contrib::JSCalendarContrib::addHEAD($setup)

This function will automatically add the headers for the calendar to the page being rendered. It's intended for use when you want more control over the formatting of your calendars than renderDateForEdit affords. $setup is the name of the calendar setup module; it can either be omitted, in which case the method described in the Mishoo documentation can be used to create calendars, or it can be 'twiki', in which case a Javascript helper function called 'showCalendar' is added that simplifies using calendars to set a value in a text field. For example, say we wanted to display the date with the calendar icon before the text field, using the format %Y %b %e

# Add styles and javascript for the calendar
use TWiki::Contrib::JSCalendarContrib;
...

sub commonTagsHandler {
  ....
  # Enable 'showCalendar'
  TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );

  my $cal = CGI::image_button(
      -name => 'img_datefield',
      -onclick =>
       "return showCalendar('id_datefield','%Y %b %e')",
      -src=> TWiki::Func::getPubUrlPath() . '/' .
             TWiki::Func::getTwikiWebname() .
             '/JSCalendarContrib/img.gif',
      -alt => 'Calendar',
      -align => 'middle' )
    . CGI::textfield(
      { name => 'date', id => "id_datefield" });
  ....
}

All available date specifiers:

%a - abbreviated weekday name 
%A - full weekday name 
%b - abbreviated month name 
%B - full month name 
%C - century number 
%d - the day of the month ( 00 .. 31 ) 
%e - the day of the month ( 0 .. 31 ) 
%H - hour ( 00 .. 23 ) 
%I - hour ( 01 .. 12 ) 
%j - day of the year ( 000 .. 366 ) 
%k - hour ( 0 .. 23 ) 
%l - hour ( 1 .. 12 ) 
%m - month ( 01 .. 12 ) 
%M - minute ( 00 .. 59 ) 
%n - a newline character 
%p - "PM" or "AM"
%P - "pm" or "am"
%S - second ( 00 .. 59 ) 
%s - number of seconds since Epoch (since Jan 01 1970 00:00:00 UTC) 
%t - a tab character 
%U, %W, %V - the week number
   The week 01 is the week that has the Thursday in the current year,
   which is equivalent to the week that contains the fourth day of January. 
   Weeks start on Monday.
%u - the day of the week ( 1 .. 7, 1 = MON ) 
%w - the day of the week ( 0 .. 6, 0 = SUN ) 
%y - year without the century ( 00 .. 99 ) 
%Y - year including the century ( ex. 1979 ) 
%% - a literal % character 

addHEAD can be called from commonTagsHandler for adding the header to all pages, or from beforeEditHandler just for edit pages etc.

Using the Calendar in user forms

<input type="text" id="cal_val_here" />

<-- 

 Set SHORTDESCRIPTION = Mishoo JSCalendar, packaged for use by plugins, skins and add-ons.
 
-->

Installation Instructions

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

• If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • See the installation supplement on TWiki.org for more information.
• If you have any problems, then you can still install manually from the command-line:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your TWiki installation.
  3. Run the installer script ( perl <module>_installer )
  4. Run configure and enable the module, if it is a plugin.
  5. Repeat for any missing dependencies.
• If you are still having problems, then instead of running the installer script:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

• An administrator can customize the appearance of the calendar by setting the following in LocalSite.cfg

  Setting	Default
  $TWiki::cfg{JSCalendarContrib}{style}	'blue'
  $TWiki::cfg{JSCalendarContrib}{lang}	'en'
  $TWiki::cfg{JSCalendarContrib}{format}	'%e %b %Y'

Contrib Info

Another great TWiki extension from the WikiRing - working together to improve your wiki experience!

JSCalendarContrib

Mishoo JSCalendar: A pop-up calendar for use in TWiki forms and TWiki applications

<--

   PLEASE DO NOT EDIT THIS TOPIC

   It is automatically generated from the subversion repository, and any changes
   you make will simply be overwritten the next time a release is generated.

   Instead, you could check your fix in, raise a bug in the Bugs web, or mail thge author.
-->

Summary of Contents

Detailed Documentation

Read the Mishoo documentation or visit the demo page for detailed information on using the calendar widget.

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the functions:

TWiki::Contrib::JSCalendarContrib::renderDateForEdit($name, $value, $format [, \%cssClass]) -> $html

This is the simplest way to use calendars from a plugin.

• $name is the name of the CGI parameter for the calendar (it should be unique),
• $value is the current value of the parameter (may be undef)
• $format is the format to use (optional; the default is set in configure). The HTML returned will display a date field and a drop-down calendar.
• \%options is an optional hash containing base options for the textfield.

use TWiki::Contrib::JSCalendarContrib;
...
my $fromDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'from', '1 April 1999');
my $toDate = TWiki::Contrib::JSCalendarContrib::renderDateForEdit(
   'to', undef, '%Y');

TWiki::Contrib::JSCalendarContrib::addHEAD($setup)

This function will automatically add the headers for the calendar to the page being rendered. It's intended for use when you want more control over the formatting of your calendars than renderDateForEdit affords. $setup is the name of the calendar setup module; it can either be omitted, in which case the method described in the Mishoo documentation can be used to create calendars, or it can be 'twiki', in which case a Javascript helper function called 'showCalendar' is added that simplifies using calendars to set a value in a text field. For example, say we wanted to display the date with the calendar icon before the text field, using the format %Y %b %e

# Add styles and javascript for the calendar
use TWiki::Contrib::JSCalendarContrib;
...

sub commonTagsHandler {
  ....
  # Enable 'showCalendar'
  TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );

  my $cal = CGI::image_button(
      -name => 'img_datefield',
      -onclick =>
       "return showCalendar('id_datefield','%Y %b %e')",
      -src=> TWiki::Func::getPubUrlPath() . '/' .
             TWiki::Func::getTwikiWebname() .
             '/JSCalendarContrib/img.gif',
      -alt => 'Calendar',
      -align => 'middle' )
    . CGI::textfield(
      { name => 'date', id => "id_datefield" });
  ....
}

Using the Calendar in user forms

%INCLUDE{"%SYSTEMWEB%/JSCalendarContribInline"}%

<input type="text" id="cal_val_here" />
<input type="image" src="%PUBURL%/%SYSTEMWEB%/JSCalendarContrib/img.gif" onclick="javascript: return showCalendar('cal_val_here','%e %B %Y')" />

<-- 

 Set SHORTDESCRIPTION = Mishoo JSCalendar, packaged for use by plugins, skins and add-ons.
 
-->

Installation Instructions

Like many other TWiki extensions, this module is shipped with a fully automatic installer script written using the BuildContrib.

• If you have TWiki 4.2 or later, you can install from the configure interface (Go to Plugins->Find More Extensions)
  • See the installation supplement on TWiki.org for more information.
• If you have any problems, then you can still install manually from the command-line:
  1. Download one of the .zip or .tgz archives
  2. Unpack the archive in the root directory of your TWiki installation.
  3. Run the installer script ( perl <module>_installer )
  4. Run configure and enable the module, if it is a plugin.
  5. Repeat for any missing dependencies.
• If you are still having problems, then instead of running the installer script:
  1. Make sure that the file permissions allow the webserver user to access all files.
  2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
  3. Manually edit LocalSite.cfg to set any configuration variables.

• An administrator can customize the appearance of the calendar by setting the following in LocalSite.cfg

  Setting	Default
  $TWiki::cfg{JSCalendarContrib}{style}	'blue'
  $TWiki::cfg{JSCalendarContrib}{lang}	'en'
  $TWiki::cfg{JSCalendarContrib}{format}	'%e %b %Y'

Contrib Info

Another great TWiki extension from the WikiRing - working together to improve your wiki experience!

Related Topics: TWikiPreferences

JSCalendarContrib

<--

   PLEASE DO NOT EDIT THIS TOPIC

   It is automatically generated from the subversion repository, and any changes
   you make will simply be overwritten the next time a release is generated.

   Instead, you could check your fix in, raise a bug in the Bugs web, or mail thge author.
-->

Summary of Contents

Detailed Documentation

Installation Instructions

• An administrator can customize the appearance of the calendar by setting the following in LocalSite.cfg

  Setting	Default
  $TWiki::cfg{JSCalendarContrib}{style}	'blue'
  $TWiki::cfg{JSCalendarContrib}{lang}	'en'
  $TWiki::cfg{JSCalendarContrib}{format}	'%e %b %Y'

Contrib Info

JSCalendarContrib

Mishoo JSCalendar, packaged for use by plugins, skins and add-ons.

<--

   PLEASE DO NOT EDIT THIS TOPIC

   It is automatically generated from the subversion repository, and any changes
   you make will simply be overwritten the next time a release is generated.

   Instead, you could check your fix in, raise a bug in the Bugs web, or mail thge author.
-->

Summary of Contents

Detailed Documentation

addHEAD( $setup )

    # Add styles and javascript for the calendar
    require TWiki::Contrib::JSCalendarContrib;
    if( $@ || !$TWiki::Contrib::JSCalendarContrib::VERSION ||
        $TWiki::Contrib::JSCalendarContrib::VERSION < 0.961 ) {
        TWiki::Func::writeWarning('JSCalendarContrib >=0.961 not found '.$@);
    } else {
        TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );
    }

    $html .= CGI::textfield(
        { name => 'datefield',
          id => "id_datefield" });
    $html .=
          CGI::image_button(
                      -name => 'datefield_calendar',
                      -onclick =>
                          "return showCalendar('id_datefield','%e %B %Y')",
                      -src=> TWiki::Func::getPubUrlPath() . '/' .
                        TWiki::Func::getTwikiWebname() .
                            '/JSCalendarContrib/img.gif',
                      -alt => 'Calendar',
                      -align => 'MIDDLE' );
            }
        }

Note that the header will only be added once, regardless of the number of times that addHEAD is called.

addHEAD can be called from commonTagsHandler for adding the header to all pages, or to beforeEditHandler just for edit pages etc.

Settings

• Name of the perl package
  • Set STUB = TWiki::Contrib::JSCalendarContrib
• What do I do
  • Set SHORTDESCRIPTION = Mishoo JSCalendar, packaged for use by plugins, skins and add-ons.

Installation Instructions

• Download the archive from the Plugins web (see below)
• Unpack it in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/JSCalendarContrib.txt
  lib/TWiki/Contrib/JSCalendarContrib.pm
  pub/TWiki/JSCalendarContrib/twiki.js
  pub/TWiki/JSCalendarContrib/bugtest-hidden-selects.html
  pub/TWiki/JSCalendarContrib/calendar-blue2.css
  pub/TWiki/JSCalendarContrib/calendar-blue.css
  pub/TWiki/JSCalendarContrib/calendar-brown.css
  pub/TWiki/JSCalendarContrib/calendar-green.css
  pub/TWiki/JSCalendarContrib/calendar.js
  pub/TWiki/JSCalendarContrib/calendar.php
  pub/TWiki/JSCalendarContrib/calendar-setup.js
  pub/TWiki/JSCalendarContrib/calendar-setup_stripped.js
  pub/TWiki/JSCalendarContrib/calendar_stripped.js
  pub/TWiki/JSCalendarContrib/calendar-system.css
  pub/TWiki/JSCalendarContrib/calendar-tas.css
  pub/TWiki/JSCalendarContrib/calendar-win2k-1.css
  pub/TWiki/JSCalendarContrib/calendar-win2k-2.css
  pub/TWiki/JSCalendarContrib/calendar-win2k-cold-1.css
  pub/TWiki/JSCalendarContrib/calendar-win2k-cold-2.css
  pub/TWiki/JSCalendarContrib/ChangeLog
  pub/TWiki/JSCalendarContrib/dayinfo.html
  pub/TWiki/JSCalendarContrib/doc/html/field-button.jpg
  pub/TWiki/JSCalendarContrib/doc/html/reference.css
  pub/TWiki/JSCalendarContrib/doc/html/reference.html
  pub/TWiki/JSCalendarContrib/doc/html/reference-Z-S.css
  pub/TWiki/JSCalendarContrib/doc/reference.pdf
  pub/TWiki/JSCalendarContrib/img.gif
  pub/TWiki/JSCalendarContrib/index.html
  pub/TWiki/JSCalendarContrib/lang/calendar-af.js
  pub/TWiki/JSCalendarContrib/lang/calendar-al.js
  pub/TWiki/JSCalendarContrib/lang/calendar-bg.js
  pub/TWiki/JSCalendarContrib/lang/calendar-big5.js
  pub/TWiki/JSCalendarContrib/lang/calendar-big5-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-br.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ca.js
  pub/TWiki/JSCalendarContrib/lang/calendar-cs-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-cs-win.js
  pub/TWiki/JSCalendarContrib/lang/calendar-da.js
  pub/TWiki/JSCalendarContrib/lang/calendar-de.js
  pub/TWiki/JSCalendarContrib/lang/calendar-du.js
  pub/TWiki/JSCalendarContrib/lang/calendar-el.js
  pub/TWiki/JSCalendarContrib/lang/calendar-en.js
  pub/TWiki/JSCalendarContrib/lang/calendar-es.js
  pub/TWiki/JSCalendarContrib/lang/calendar-fi.js
  pub/TWiki/JSCalendarContrib/lang/calendar-fr.js
  pub/TWiki/JSCalendarContrib/lang/calendar-he-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-hr.js
  pub/TWiki/JSCalendarContrib/lang/calendar-hr-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-hu.js
  pub/TWiki/JSCalendarContrib/lang/calendar-it.js
  pub/TWiki/JSCalendarContrib/lang/calendar-jp.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ko.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ko-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-lt.js
  pub/TWiki/JSCalendarContrib/lang/calendar-lt-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-lv.js
  pub/TWiki/JSCalendarContrib/lang/calendar-nl.js
  pub/TWiki/JSCalendarContrib/lang/calendar-no.js
  pub/TWiki/JSCalendarContrib/lang/calendar-pl.js
  pub/TWiki/JSCalendarContrib/lang/calendar-pl-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-pt.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ro.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ru_win_.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ru.js
  pub/TWiki/JSCalendarContrib/lang/calendar-si.js
  pub/TWiki/JSCalendarContrib/lang/calendar-sk.js
  pub/TWiki/JSCalendarContrib/lang/calendar-sp.js
  pub/TWiki/JSCalendarContrib/lang/calendar-sv.js
  pub/TWiki/JSCalendarContrib/lang/calendar-tr.js
  pub/TWiki/JSCalendarContrib/lang/calendar-zh.js
  pub/TWiki/JSCalendarContrib/lang/cn_utf8.js
  pub/TWiki/JSCalendarContrib/skins/aqua/active-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/dark-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/hover-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/menuarrow.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/normal-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/rowhover-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/status-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/theme.css
  pub/TWiki/JSCalendarContrib/skins/aqua/title-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/today-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/transparent-bg.png
  pub/TWiki/JSCalendarContrib/menuarrow.gif
  pub/TWiki/JSCalendarContrib/menuarrow2.gif
  pub/TWiki/JSCalendarContrib/multiple-dates.html
  pub/TWiki/JSCalendarContrib/README
  pub/TWiki/JSCalendarContrib/release-notes.html
  pub/TWiki/JSCalendarContrib/simple-1.html
  pub/TWiki/JSCalendarContrib/simple-2.html
  pub/TWiki/JSCalendarContrib/simple-3.html
  pub/TWiki/JSCalendarContrib/test.php
  pub/TWiki/JSCalendarContrib/test-position.html

• Make sure that all files are readable by the web server user

Contrib Info

Related Topics: TWikiPreferences

<--

   PLEASE DO NOT EDIT THIS TOPIC

   It is automatically generated from the subversion repository, and any changes
   you make will simply be overwritten the next time a release is generated.

   Instead, you could check your fix in, raise a bug in the Bugs web, or mail thge author.
-->

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the function:

addHEAD( $setup )

    # Add styles and javascript for the calendar
    require TWiki::Contrib::JSCalendarContrib;
    if( $@ || !$TWiki::Contrib::JSCalendarContrib::VERSION ||
        $TWiki::Contrib::JSCalendarContrib::VERSION < 0.961 ) {
        TWiki::Func::writeWarning('JSCalendarContrib >=0.961 not found '.$@);
    } else {
        TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );
    }

    $html .= CGI::textfield(
        { name => 'datefield',
          id => "id_datefield" });
    $html .=
          CGI::image_button(
                      -name => 'datefield_calendar',
                      -onclick =>
                          "return showCalendar('id_datefield','%e %B %Y')",
                      -src=> TWiki::Func::getPubUrlPath() . '/' .
                        TWiki::Func::getTwikiWebname() .
                            '/JSCalendarContrib/img.gif',
                      -alt => 'Calendar',
                      -align => 'MIDDLE' );
            }
        }

Note that the header will only be added once, regardless of the number of times that addHEAD is called.

addHEAD can be called from commonTagsHandler for adding the header to all pages, or to beforeEditHandler just for edit pages etc.

• Name of the perl package
  • Set STUB = TWiki::Contrib::JSCalendarContrib

• Make sure that all files are readable by the web server user

Summary of Contents

Detailed Documentation

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the function:

addHEAD( $setup )

Note that the header will only be added once, regardless of the number of times that addHEAD is called.

addHEAD can be called from commonTagsHandler for adding the header to all pages, or to beforeEditHandler just for edit pages etc.

Settings

• Name of the perl package
  • Set STUB = TWiki::Contrib::JSCalendarContrib

Installation Instructions

• Download the ZIP file from the Plugin web (see below)
• Unzip JSCalendarContrib.zip in your twiki installation directory. Content:

• Make sure that all files are readable by the web server user

Contrib Info

Related Topics: TWikiPreferences

Summary of Contents

Detailed Documentation

This package also includes a small Perl module to make using the calendar easier from TWiki plugins. This module includes the function:

addHEAD( $setup )

    # Add styles and javascript for the calendar
    require TWiki::Contrib::JSCalendarContrib;
    if( $@ || !$TWiki::Contrib::JSCalendarContrib::VERSION ||
        $TWiki::Contrib::JSCalendarContrib::VERSION < 0.961 ) {
        TWiki::Func::writeWarning('JSCalendarContrib >=0.961 not found '.$@);
    } else {
        TWiki::Contrib::JSCalendarContrib::addHEAD( 'twiki' );
    }

    $html .= CGI::textfield(
        { name => 'datefield',
          id => "id_datefield" });
    $html .=
          CGI::image_button(
                      -name => 'datefield_calendar',
                      -onclick =>
                          "return showCalendar('id_datefield','%e %B %Y')",
                      -src=> TWiki::Func::getPubUrlPath() . '/' .
                        TWiki::Func::getTwikiWebname() .
                            '/JSCalendarContrib/img.gif',
                      -alt => 'Calendar',
                      -align => 'MIDDLE' );
            }
        }

Note that the header will only be added once, regardless of the number of times that addHEAD is called.

addHEAD can be called from commonTagsHandler for adding the header to all pages, or to beforeEditHandler just for edit pages etc.

Settings

• Name of the perl package
  • Set STUB = TWiki::Contrib::JSCalendarContrib

Installation Instructions

• Download the ZIP file from the Plugin web (see below)
• Unzip JSCalendarContrib.zip in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/JSCalendarContrib.txt
  lib/TWiki/Contrib/JSCalendarContrib/build.pl
  lib/TWiki/Contrib/JSCalendarContrib.pm
  pub/TWiki/JSCalendarContrib/twiki.js
  pub/TWiki/JSCalendarContrib/bugtest-hidden-selects.html
  pub/TWiki/JSCalendarContrib/calendar-blue2.css
  pub/TWiki/JSCalendarContrib/calendar-blue.css
  pub/TWiki/JSCalendarContrib/calendar-brown.css
  pub/TWiki/JSCalendarContrib/calendar-green.css
  pub/TWiki/JSCalendarContrib/calendar.js
  pub/TWiki/JSCalendarContrib/calendar.php
  pub/TWiki/JSCalendarContrib/calendar-setup.js
  pub/TWiki/JSCalendarContrib/calendar-setup_stripped.js
  pub/TWiki/JSCalendarContrib/calendar_stripped.js
  pub/TWiki/JSCalendarContrib/calendar-system.css
  pub/TWiki/JSCalendarContrib/calendar-tas.css
  pub/TWiki/JSCalendarContrib/calendar-win2k-1.css
  pub/TWiki/JSCalendarContrib/calendar-win2k-2.css
  pub/TWiki/JSCalendarContrib/calendar-win2k-cold-1.css
  pub/TWiki/JSCalendarContrib/calendar-win2k-cold-2.css
  pub/TWiki/JSCalendarContrib/ChangeLog
  pub/TWiki/JSCalendarContrib/dayinfo.html
  pub/TWiki/JSCalendarContrib/doc/html/field-button.jpg
  pub/TWiki/JSCalendarContrib/doc/html/reference.css
  pub/TWiki/JSCalendarContrib/doc/html/reference.html
  pub/TWiki/JSCalendarContrib/doc/html/reference-Z-S.css
  pub/TWiki/JSCalendarContrib/doc/reference.pdf
  pub/TWiki/JSCalendarContrib/img.gif
  pub/TWiki/JSCalendarContrib/index.html
  pub/TWiki/JSCalendarContrib/lang/calendar-af.js
  pub/TWiki/JSCalendarContrib/lang/calendar-al.js
  pub/TWiki/JSCalendarContrib/lang/calendar-bg.js
  pub/TWiki/JSCalendarContrib/lang/calendar-big5.js
  pub/TWiki/JSCalendarContrib/lang/calendar-big5-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-br.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ca.js
  pub/TWiki/JSCalendarContrib/lang/calendar-cs-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-cs-win.js
  pub/TWiki/JSCalendarContrib/lang/calendar-da.js
  pub/TWiki/JSCalendarContrib/lang/calendar-de.js
  pub/TWiki/JSCalendarContrib/lang/calendar-du.js
  pub/TWiki/JSCalendarContrib/lang/calendar-el.js
  pub/TWiki/JSCalendarContrib/lang/calendar-en.js
  pub/TWiki/JSCalendarContrib/lang/calendar-es.js
  pub/TWiki/JSCalendarContrib/lang/calendar-fi.js
  pub/TWiki/JSCalendarContrib/lang/calendar-fr.js
  pub/TWiki/JSCalendarContrib/lang/calendar-he-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-hr.js
  pub/TWiki/JSCalendarContrib/lang/calendar-hr-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-hu.js
  pub/TWiki/JSCalendarContrib/lang/calendar-it.js
  pub/TWiki/JSCalendarContrib/lang/calendar-jp.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ko.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ko-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-lt.js
  pub/TWiki/JSCalendarContrib/lang/calendar-lt-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-lv.js
  pub/TWiki/JSCalendarContrib/lang/calendar-nl.js
  pub/TWiki/JSCalendarContrib/lang/calendar-no.js
  pub/TWiki/JSCalendarContrib/lang/calendar-pl.js
  pub/TWiki/JSCalendarContrib/lang/calendar-pl-utf8.js
  pub/TWiki/JSCalendarContrib/lang/calendar-pt.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ro.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ru_win_.js
  pub/TWiki/JSCalendarContrib/lang/calendar-ru.js
  pub/TWiki/JSCalendarContrib/lang/calendar-si.js
  pub/TWiki/JSCalendarContrib/lang/calendar-sk.js
  pub/TWiki/JSCalendarContrib/lang/calendar-sp.js
  pub/TWiki/JSCalendarContrib/lang/calendar-sv.js
  pub/TWiki/JSCalendarContrib/lang/calendar-tr.js
  pub/TWiki/JSCalendarContrib/lang/calendar-zh.js
  pub/TWiki/JSCalendarContrib/lang/cn_utf8.js
  pub/TWiki/JSCalendarContrib/skins/aqua/active-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/dark-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/hover-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/menuarrow.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/normal-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/rowhover-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/status-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/theme.css
  pub/TWiki/JSCalendarContrib/skins/aqua/title-bg.gif
  pub/TWiki/JSCalendarContrib/skins/aqua/today-bg.gif
  pub/TWiki/JSCalendarContrib/menuarrow.gif
  pub/TWiki/JSCalendarContrib/menuarrow2.gif
  pub/TWiki/JSCalendarContrib/multiple-dates.html
  pub/TWiki/JSCalendarContrib/README
  pub/TWiki/JSCalendarContrib/release-notes.html
  pub/TWiki/JSCalendarContrib/simple-1.html
  pub/TWiki/JSCalendarContrib/simple-2.html
  pub/TWiki/JSCalendarContrib/simple-3.html
  pub/TWiki/JSCalendarContrib/test.php
  pub/TWiki/JSCalendarContrib/test-position.html