Difference between revisions of "Calendar/ru"

Latest revision as of 15:30, 15 February 2013

Calendar — расширение MediaWiki.

• Назначение: Доработанный календарь событий для MediaWiki. Каждое событие, либо каждый день с событиями, хранится на вики-странице.
• Репозиторий: https://github.com/mediawiki4intranet/Calendar
• Домашняя страница: Calendar на mediawiki.org
• Лицензия: GPLv2.0+ 
• Дата создания: 2008-12-09 
• Оценка расширения: Возможно полезное (3)

Включение в сборку Mediawiki4Intranet:

• Дата включения: 2010-05-26
• Включённая версия: 2009-08-18
• Состояние доработок: Значительно доработано в сборке MediaWiki4Intranet

Позволяет размещать на Wiki-страницах календари событий, подгружающихся с (других) Wiki-страниц. Каждый календарь имеет имя. Идентифицируется календарь именем вики-страницы (ИМЯ) и именем календаря (КАЛЕНДАРЬ), все его события размещаются как вложенные статьи в статью «ИМЯ/КАЛЕНДАРЬ/» и имеют имена вида «YYYY-MM-DD» (Год-Месяц-День) или «YYYY-MM-DD HH Nxx», где HH — час дня (используется исключительно для удобства именования), а Nxx — номер события в часу или на дне. См. ниже параметр «usesectionevents».

Также у расширения есть некоторые расширенные возможности — RSS-подписка на события, повторяющиеся события, несколько видов (день/неделя/месяц/год) и т. п. Также есть некоторые «кривые» и непроверенные (пока что) лично мною фичи — импорт из vCalendar, учёт времени. Лучше не надо его использовать, не хватало ещё из какого-то костыльного календаря багзиллу строить.

Наши доработки

Проведён рефакторинг:

• исправлен стиль кода, части кода переписаны, убраны некоторые костыли.
• убраны нестандартные методы отладки и профилирования (debug.class.php).
• убраны неиспользуемые куски кода.
• убран незадействованный (временно незадействованный?) хук на добавление календаря в MediaWiki:Sidebar в расчёте на то, что при необходимости можно использовать расширения, позволяющие вешать в Sidebar любой вики-код.
• убраны конфликты имён классов со стандартными классами.
• код расширения более корректно растащен по файлам — загружается только тогда, когда нужен.
• файлы переименованы в имена, более стойкие к конфликтам.
• изменён способ именования статей событий, в сторону большей стандартизации — вместо «5.24.2009 -Event1», к тому же изменяющегося в зависимости от настроек, «2009-05-24» и «2009-05-24 N01» — стандартные «SQL-даты».

Изменения в функциональности:

• добавлено отслеживание занятости отдельных часов на дне и добавление событий сразу на определённый час: <calendar addeventsbyhour="8..21" />.
• переделан годовой вид календаря — там теперь AJAX-всплывающие подсказки со списками событий на каждый день, дни покрашены в зависимости от количества событий, а названия месяцов представляют собой ссылки на вид соответствующего месяца в календаре.
• добавлены RSS-ленты событий для всех календарей.
• поддержка вики-разметки в тексте событий — их вики-код теперь не очищается, а парсится.
• сортировка событий по названию в расчёте на то, что в начале названия пишется время события.
• добавлена русская локализация.
• отключён переделан ICAL-импорт как представляющий серьёзную дыру в безопасности (читает название файла из cookie и безусловно удаляет его). Правда всё равно по-извратному, из загруженного в вики файла.

TODO

• Возможно, следить за новыми версиями расширения — автор говорит, что в будущем перейдёт на прямой доступ к БД для хранения календаря.
• Возможно, добавить в каком-то виде оповещения.
• Возможно, полностью исключить расширение из сборки — в корпоративной среде полезность под большим вопросом, да и вообще, хранение календаря в вики — это всё-таки костыль.

Использование

Начать использовать расширение проще всего так — нужно добавить на любую вики-страницу тег <calendar />. Это создаст на ней календарь с настройками по умолчанию.

Параметры

Значения параметров, содержащие пробелы, должны окружаться кавычками (").

Значения булевых параметров (да/нет) трактуются точно так же, как PHP трактует значения переменных как true/false. То есть, «0» и "" (пустая строка) — это «нет», а всё остальное (например, «1») — «да».

Подсказки

Позиция и режим сохраняются

Когда вы двигаетесь по календарю или переключаете режимы (годовой/месячный/недельный виды), настройка сохраняется у вас в Cookies браузера и при следующем открытии календаря сохраняется и ваша позиция, и режим просмотра календаря.

RSS-ленты событий

На все события календаря можно подписаться, кликнув по ссылке «RSS-лента» внизу календаря в месячном или недельном виде, либо выбрав соответствующий пункт из выпадающего при клике по иконке в адресной строке меню.

События-перенаправления

Если создать в календаре событие как страницу-перенаправление на другую, даже «некалендарную» — она тоже будет просканирована на наличие событий. Это поведение можно отключить опцией disableredirects.

Страницы настроек

Если у вашего календаря стало много настроек, их можно утащить на страницу конфигурации Страница/Календарь/config (см. опцию useconfigpage выше).

Пример

Дополнительно

Ниже представлены части справки оригинального расширения, функциональность в которых могла быть признана по-идиотски реализованной, устаревшей или никому не нужной. Короче говоря, это то, что там по идее осталось, но как работает — никто не проверял, потому что вещи всё-таки извращенческие (например, учёт времени). :)

Recurrence Event

Recurrence type events are traditional repeating yearly events like holidays, birthdays, etc. To create a recurrence event, choose 'add event' and add the following trigger syntax:

##My Birthday

This will convert the event into an vCalendar RRULE event and store it into the 'page/name/recurrence' wiki page. This is also where any ical recurrence events are stored.

Colors and Formatting

1. The calendar supports most of the basic MediaWiki text/font properties including the 'ticks' for italic and bold.
   • '''<font color=red>vacation</font>'''
   • Vacation time!! --> <span style="color:red;background:yellow">Vacation time!!</span>
2. Setup the event style' page by adding as many 'styles' as you wish. These styles are based on keyword matches, so be wary of what words you choose… The styles follow standard html/css style properties.
   • syntax: keyword:: style1; style2; etc
     • myStyle:: color:green; text-decoration:line-through; --> Whatever
     • birthday:: color:red; font-style: bold; --> My Birthday
     • sick:: color: green;background-color: yellow --> Out Sick today
       
     • vacation:: color: red; font-style: italic --> Vacation to Florida!
       

I’m not sure how far and how many variation of the css and/or Wiki formatting will go, but I’ve tested a good portion of the standard text properties. (<div> is giving me an issue at this time though… but <span> works just fine!)

• you can default all events to your style preference by using the style="..." preference. However, individual keyword event styles override the global default.

Time Tracker

You can keep simple time tracking of events by formatting the event as below. This will track any dynamically created event in a simple table below the calendar in full mode only. The event is triggered by prefixing (2) colons followed by the event then (1) colon or (1) dash followed by a numeric value to add.

::Vacation: 8 or ::Vacation -8
::Team Project 1 - 3
::Sick : 4

Note that events created using the 'add event' link only track time for that month. If you want to track a years total, you need to enable and use month templates (usetemplates)

vCalendar (iCal) Support

The calendar supports the basic importing of vCalendar formatted files. The import utility is enabled by adding ical or ical=overwrite to your parameter string or config file settings.

The calendar accepts the following vCalendar formats

DTSTART

DTEND

SUMMARY

DESCRIPTION (not with RRULEs though)

RRULE

The RRULE evaluates basic calendar event logic only… nothing complex like «every 3rd Monday of every-other month». It does handle typical repeats like Thanksgiving, Mothers Day, etc that required logic like «the 4th Thursday of November» or «the last Monday of March» kinda logic. Basically, it should capture most repeating events like birthdays and holidays.

The RRULE (repeating) events are stored in a subpage called recurrence. Basically, in the following format page/calendarname/recurrence. You can manually edit or delete these as needed. If you use the ical=overwrite option, it deletes the data before writing in the new ical data.

Imported single day events, without the RRULE, are created in the calendar as normal pages in the -Event 0 page for the respective day.

Установка

Для установки расширения в свою MediaWiki нужно скопировать файлы расширения в папку extensions/Calendar и добавить в LocalSettings.php следующую строку:

require_once("$IP/extensions/Calendar/Calendar.php");

И далее, по желанию — задать опции.

Опции для LocalSettings.php

$wgExtraNamespaces[100] = "Calendars";
$wgExtraNamespaces[101] = "Calendars_talk";
$wgNamespacesWithSubpages[100] = true;
$wgNamespacesWithSubpages[101] = true;