Adventcalendar_XH - a CMSimple_XH плагин

Adventcalendar_XH позволяет легко разместить календарь рождественского поста на Вашем сайте. Небольшие двери могут быть открыты посетителями только при наступлении определенной даты. Хранящиеся за дверью тайны - это содержимое страниц CMSimple, таким образом, Вы можете разместить на них все, что пожелаете (стихи, изображения, видео, произведения и пр.)

Во избежание проблем, пожалуйста, внимательно прочитайте этот документ ДО использования плагина!

Важно

Adventcalendar_XH не был тестирован во всех возможных условиях, и является БЕТА-версией. Используйте плагин с необходимыми предосторожностями!

Требования

Adventcalendar_XH - плагин для CMSimple_XH. Для работы плагина необходима версия CMSimple_XH, поддерживающая UTF-8, и плагин jQuery4CMSimple.

Установка

Установка плагина не отличается от установки многих других плагинов CMSimple_XH. Более подробно с особенностями установки можно ознакомиться на странице CMSimple_XH wiki.

  1. Создайте резервную копию вашего сайта.
  2. Разархивируйте дистрибутив в папку на вашем компьютере.
  3. Загрузите каталог adventcalendar/ на серевер в директорию плагинов CMSimple_XH.
  4. Укажите права доступа для подкаталогов data/, config/, css/ и languages/
  5. Перейдите в режим администрирования ПлагиныAdventcalendar для проверки соответствия требованиям.

Настройки

Конфигурирование плагина в режиме администратора не отличается от конфигурирования большинства других плагинов CMSimple_XH.. Выберите "Adventcalendar" в меню "Плагины".

Вы можете изменить настройки Adventcalendar_XH на вкладке "Конфигурация". Поместив курсор мыши на иконке помощи, можно посмотреть подсказки для соотвествующей опции.

Локализация доступна на вкладке "Язык". Вы можете перевести языковые строки на ваш язык, или изменить строки в соответствии с вашими потребностями.

Настройки стиля плагина Adventcalendar_XH доступны на вкладке "Стиль".

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

Вы можете разместить неограниченное количество рождественских календарей для одной установленной CMSimple_XH. Но для каждого рождественского календаря необходимо указать уникальное имя. Имя должно содержать исключительно латинские символы и цифры, и не должно повторять заголовок любой из страниц.

Подготовка обложки

Найдите соответствующее фоновое изображение для Вашего рождественского календаря, при необходимости, измените его размеры (по умолчанию, ширина изображения должна соответствовать ширине блока контента вашего шаблона), и загрузите изображение в папку данных плагина (data/). После этого перейдите на страницу "Плагины"→"Adventcalendar"→"Управление", где Вы можете подготовить изображение для использования в качестве обложки рождественского календаря. После нажатия кнопки "Подготовить обложку" будут созданы небольшие двери с сответствующими датами. Для изображения, расположенного горизонтально, будут созданы 4 строки по 6 дверей в каждой, для изображения, расположенного вертикально, будет создано 6 строк по 4 двери в каждой. Размер дверей и желаемые цвета можно указать в настройках плагина. Порядок дверей определяется в случайном порядке, если данный порядок вас не устраивает, процедуру подготовки изображения следует повторить.

Подготовка "тайн"

Создайте новую страницу CMSimple с именем рождественского календаря в качестве заголовка (уровень меню страницы не имеет значения). Создайте страницу уровнем ниже (суб-страницу) для каждого дня (первая суб-страница - для дня №1, вторая для дня №2 и т.д.).Вы можете заполнить страницу любым содержимым в соответствии с вашими предпочтениями, использовав, в том числе, и вызовы плагинов. В общем случае, Вы пожелаете скрыть эти страницы в меню. При желании, Вы можете использовать существующую страницу в качестве хранящейся за дверью "тайны", для этого достаточно использовать перенаправление соответствующей суб-страницы на существующую страницу, и добавить "&print" к URL.

Отображение календаря

Для отображения рождественского календаря на любой из страниц достаточно вызвать плагин:

{{{PLUGIN:Adventcalendar('name_of_the_calendar');}}}

Естественно, "name_of_the_calendar" необходимо изменить на текущее имя Вашего рождественского календаря.

Лицензия

Adventcalendar_XH распространяется по лицензии GPLv3.

© 2012 Christoph M. Becker

Russian translation and user manual © 2012 Любомир Кудрай.

Благодарности

Adventcalendar_XH использует Colorbox. Выражаем благодарность Jack Moore за предоставление великолепного клона лайтбокса по лицензии MIT.

Иконка плагина создана Enhanced Labs Design Studio. Выражаем благодарность за публикацию иконки по либеральной лицензии.

Данный плагин использует свободно распространяемое приложение для создания иконок от Aha-Soft. Выражаем благодарность за предоставление иконок для свободного использования.

И последняя, но не менее искренняя благодарность Peter Harteg, "отцу" CMSimple, и всем разработчикам CMSimple_XH, без которых эта удивительная CMS не могла бы существовать.