MCalendar plugin for Seditio
version: 1.3
Date: 22 August 2008
Author: Almaz (Edited by Dayver)
Homepage: http://almaz.freehostia.com/


*************** in English ***************

1. Purpose

 The plugin carries out a conclusion on pages of a site of a calendar
 on current month, with an opportunity of transition to other month or year
 (transition can take place without reloading the page). At presence for given
 the date of news, pages, etc. is deduced the link to their viewing.

2. Requirements

 The plugin was tested and successfully works under control of Seditio v121.

3. Installation

3.1. Unpack archive in a root your server with already
     installed and worker Seditio.

3.2. In a browser enter the address of the Seditio a site and under the manager
     come into [Administration] -> [Plugins]-> [Mcalendar]
     Press the link [Install all].

3.3. You just can adjust the plug.

3.3.1. You can choose in options of a plugin, for what events for the given number
       follows to react to a calendar. If the parameter is resolved (yes), the plugin
       will generate the link on detailed viewing.

3.3.2. You can choose to plug in the settings, incorporate ajax or not. If the
       allowed (yes), the plug would allow switch month \ year without rebooting the page.

3.4. Addition tags in a file skin.

3.4.1. If you want to establish a calendar display only on specific pages,
        then make the tags only needed tpl files.

        file index.tpl, tag (INDEX_MCALENDAR) - displays the calendar at home

        file list.tpl, tag (LIST_MCALENDAR) - displays the calendar in the category

        file page.tpl, tag (PAGE_MCALENDAR) - displays a calendar on page

3.4.2. If you want to establish a calendar display for all pages,
        then make the appropriate tag only in the "header" or "footer" (depending on the design).

        file header.tpl, tag (HEADER_MCALENDAR) - displays a calendar to "header" site

        file footer.tpl, tag (FOOTER_MCALENDAR) - displays a calendar to "footer" site

3.5. Addition of styles in a file of styles.

     Open a file /skins/skinname/skinname.css and add in his end these styles.

/* This style only for MCALENDAR plugin BEGIN */
table.mcalendar{border-collapse:collapse;}
.mcalendar table{background-color:#FFFFFF;font-size:100%;font-family:tahoma;border-collapse:collapse;}
.mcalendar td{background-color:#EBEBEB;border:1px solid #FFFFFF;vertical-align:middle;text-align:center;}
.mcalendar td.field{width:20px;height:20px;}
.mcalendar td.future{color:#B0B0B0;width:20px;height:20px;}
.mcalendar td.today{background-color:#FFFFFF;width:20px;height:20px;}
.mcalendar td.week{color:#000000;width:20px;height:15px;font-weight:bold;}
.mcalendar td.navigation{background-color:#EBEBEB;}
.mcalendar td.month{background-color:#EBEBEB;}
.mcalendar td.year{background-color:#EBEBEB;}
.mcalendar a{color:#000000;text-decoration:none;font-weight:bold;}
.mcalendar a:hover{color:#000000;text-decoration:none;font-weight:normal;}
/* This style only for MCALENDAR plugin END */

     Through them you can establish colors and the sizes of any element of a calendar.

3.6. After testing you can reconfigure the parameters of the plug under your requirements:
     Come into [Administration] -> [Configuration] -> [Plugins] -> [mcalendar]
     Also install parameters:

     - News (if yes, set it below): (yes/no)
         Yes - show news for current date
         Off - ignore news
               !!!!!!!!!!!!!!!!!!!!!!! ATTENTION !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
               If you have installed the given parameter in [yes] necessarily
               adjust parameter "List of the News categories" (see below).

     - Pages: (yes/no)
         Yes - show pages for current date
         Off - ignore pages

     - Users registration: (yes/no)
         Yes - show registered users for current date
         Off - ignore registered users

     - Users birthday: (yes/no)
         Yes - show birthday men for current date
         Off - ignore birthday men

     - Forums (only for new topic): (yes/no)
         Yes - show new themes at a forum for current date
         Off - ignore new themes at a forum

     - List of the News categories (by comma):
               If parameter News is established in position [yes], specify here
               (through a comma without spaces) codes of categories of the
               sections which are being News.

	 - Ajax (only for an opportunity transition to other month or year):
         Yes - Add ability transition to another month or year without rebooting pages
         Off - Disabled. Transition to another month or year is accompanied by rebooting pages

 After that the plugin will earn.

********* Chang history  *********

[        explanations:         ]
[ + added feature      	       ]
[ # removed function           ]
[ * improved / changed         ]
[ - eliminated bug (hopefully) ]

05 jan 2006 v1.0
15 jan 2006 v1.1 [-] Parsing bbcode for pages.
                 [-] Finding links to pages for comment.
                 [+] Responding to the birthdays of users.
03 aug 2007 v1.2 [*] Plugin rewritten under Seditio.
                 [*] Improved withdrawal popup messages.
                 [-] Fixed problem display birthdays later in 1970
22 aug 2008 v1.3 [*] Switching to another month / year can be carried out
                     without reloading the page (Edited Dayver)
                 [+] Ability to set in header.tpl, footer.tpl,
                     list.tpl, page.tpl (Add Dayver).
                 [+] Ukrainian language (Add Dayver).