Foren / Cotonti / Extensions / MCalendar + Ajax

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 "cap" site
file footer.tpl, tag (FOOTER_MCALENDAR) - displays a calendar to "cap" 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).

MCalendar plugin for Seditio
version: 1.3
Date: 22 August 2008
Author: Almaz (Edited by Dayver)
Homepage: http://almaz.freehostia.com/
*************** in Russian ***************
1. Назначение
Плагин осуществляет вывод на страницы сайта календаря за текущий
месяц, с возможностью перехода на другой месяц или год (переход может осуществляться
без перезагрузки страницы). При наличии за данное число месяца новостей,
страниц и т.д. выводится ссылка на их просмотр.
2. Требования
Плагин тестировался и успешно работает под управлением Seditio v121.
3. Установка
3.1. Распакуйте архив в корень вашего сервера с уже
установленным и рабочим Seditio.
3.2. В браузере введите адрес своего Seditio сайта и под администратором
зайдите в [Администрирование] -> [Плагины] -> [Mcalendar]
нажмите на ссылку [Установить всё].
3.3. Вы сразу же можете настроить плагин.
3.3.1. Вы можете выбрать в настройках плагина, на какие события за данное число следует
реагировать календарю. Если параметр разрешен (yes), плагин сформирует ссылку
на подробный просмотр.
3.3.2. Вы можете выбрать в настройках плагина, включать ajax или нет. Если параметр
разрешен (yes), плагин позволит переключать месяц\год без перезагрузки страницы.
3.4. Добавление тегов в файл скина.
3.4.1. Если вы захотите установить отображение календаря только на конкретных страницах,
то вносите соответствующие теги лишь в нужные tpl файлы.
файл index.tpl , тег {INDEX_MCALENDAR} - выводит календарь на главную
файл list.tpl , тег {LIST_MCALENDAR} - выводит календарь в категории
файл page.tpl , тег {PAGE_MCALENDAR} - выводит календарь на страницы
3.4.2. Если вы захотите установить отображение календаря на всех страницах сайта,
то внесите соответствующий тег лишь в "шапку" или "подвал" (в зависимости от дизайна).
файл header.tpl , тег {HEADER_MCALENDAR} - выводит календарь в "шапку" сайта
файл footer.tpl , тег {FOOTER_MCALENDAR} - выводит календарь в "шапку" сайта
3.5. Добавление стилей в файл стилей.
Откройте файл /skins/имяскина/имяскина.css и добавьте в его конец эти стили.
/* 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 */
Через них вы можете установить цвета и размеры любого элемента календаря.
3.6. После тестирования можете перенастроить параметры плагина под ваши требования:
зайдите в [Администрирование] -> [Конфигурация] -> [Плагины] -> [mcalendar]
и установите параметры:
- News (if yes, set it below): (yes/no)
Yes - Показывать новости за текущее число
Off - Игнорировать новости
!!!!!!!!!!!!!!!!!!!!!!! ВНИМАНИЕ !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Если вы установили данный параметр в [yes] обязательно настройте
параметр "List of the News categories" (см. ниже).
- Pages: (yes/no)
Yes - Показывать страницы за текущее число
Off - Игнорировать страницы
- Users registration: (yes/no)
Yes - Показывать зарегистрировавшихся за текущее число
Off - Игнорировать зарегистрировавшихся
- Users birthday: (yes/no)
Yes - Показывать именинников за текущее число
Off - Игнорировать именинников
- Forums (only for new topic): (yes/no)
Yes - Показывать новые темы на форуме за текущее число
Off - Игнорировать новые темы на форуме
- List of the News categories (by comma):
Если параметр News установлен в положение [yes], укажите здесь
(через запятую без пробелов) коды категорий разделов, являющихся
новостями.
- Ajax (only for an opportunity transition to other month or year):
Yes - Включить возможность перехода на другой месяц или год без перезагрузки страницы
Off - Отключено. Перехода на другой месяц или год сопровождается перезагрузкой страницы
После этого плагин заработает.
********* История изменений *********
[ пояснения: ]
[ + добавлена функция ]
[ # удалена функция ]
[ * улучшено/изменено ]
[ - устранен баг (надеюсь) ]
05 янв 2006 v1.0
15 янв 2006 v1.1 [-] Парсинг bbcode для страниц.
[-] Вывод ссылки на комментарий для страниц.
[+] Реагирование на дни рождения пользователей.
03 авг 2007 v1.2

Плагин переписан под Seditio.

Доработан вывод всплывающих сообщений.

[-] Устранена проблема показа дней рождений позже 1970г.
22 авг 2008 v1.3

Переход на другой месяц/год может осуществляться

без перезагрузки страницы (Доработано Dayver'ом).
[+] Возможность установки в header.tpl, footer.tpl,
list.tpl, page.tpl (Добавлено Dayver'ом).
[+] Украинский язык (Добавлено Dayver'ом).