Релиз InstantCMS 1.10.3

Вот и настало время заявить о новом релизе.

Изменений получилось немало и по традиции мы поработали над тем, что не планировали. Итак, список изменений:

jQuery v1.10.2

Обновлена как сама библиотека, так и все используемые ее скрипты. Lightbox удален, вместо него в системе везде используется colorbox — фото, вставленные через bb-коды, просмотр фотографий, изображения в универсальном каталоге, в объявлениях и т.п. — все показываются в нем. Основную работу по обновлению jQuery выполнил • Mike •.

Полная поддержка локализации интерфейса

Это означает то, что все русские фразы вынесены в языковые файлы. В js, в админке и в других местах, где были фразы на русском языке — все они вынесены в переменные. Большую помощь в этом оказали пользователи нашего сообщества: Олег Васильевич я и Странник, а так же немного, посильно помогли Андрей и Нил — за что им всем большое спасибо. Тексты почтовых писем перенесены из /includes/letters/ в /languages/ru/letters/ и зависят теперь от языка системы.

Поддержка любых шаблонизаторов

В своих шаблонах вы теперь можете использовать любой шаблонизатор (за идею благодарим lokanaft). Что это значит?

Все предельно просто. За тип шаблона (и его шаблонизатора) отвечает файл с названием system.php, который может находиться в директории /templates/название_шаблона/. Внутри этого файла должен быть объявлен массив $info = array('author'=>'Автор шаблона', 'renderer'=>'Название класса шаблонизатора', 'ext'=>'Расширение файлов шаблона'). Если данного файл нет, то предполагается, что шаблонизатор Smarty, автор шаблона — InstantCMS Team, расширение файлов — tpl.

Итак, если вы решили создать шаблон на своем шаблонизаторе, то:

• создать в шаблоне файл system.php и заполнить его как описано выше;
• создать класс шаблонизатора, например (есть в системе для примера) с названием phpTpl;
• сохранить его в файле /core/tpl_classes/phpTpl.php
• создать в классе как минимум три обязательных метода: display, assign и конструктор класса.
• создавать файлы шаблонов необходимо по принципу системное имя шаблона без расширения + расширение шаблонизатора, например com_actions_friends.php в случае с phpTpl.

В шаблоне необязательно наличие всех файлов шаблонов системы. Если в текущем шаблоне файл не найден, используется файл из шаблона по умолчанию с шаблонизатором smarty.

Более подробно можно разобраться на примере существующих классов в системе — smartyTpl и phpTpl.

Геолокация

В систему встроена база страна-регион-город, все поля типа "город" приведены к единому виду и функционалу. Если включено автоопределение местоположения, то в свойства текущего авторизованного пользователя добавляется массив его гео данных ($inUser->geo), что будет полезным если вы собираетесь использовать геотаргетинг в своих разработках. Для автоматического определения местоположения используется сервис ipgeobase.ru. Вы можете использовать любой сервис, написав свой класс по аналогии с системным — cmsgeo и указав в настройках его использование.

Остальные изменения

Здесь перечислены основные изменения в новой версии, десятки других более мелких правок вы найдете сами :-)

Как обновиться с версии 1.10.2

Перед началом обновления обязательно сделайте резервную копию своего сайта и дамп базы данных. Обновляться лучше на копии сайта, поднятом локально на ПК или иным подобным способом. Мы не несем никакой ответственности за любые потери данных произошедшие в результате неправильных действий при обновлении.

Если у вас куплены наши премиум компоненты, то приступать к миграции на 1.10.3 необходимо только после получения их официальных обновлений.

Обновляем систему:

1. Сделать полный бекап файлов и базы данных — ОБЯЗАТЕЛЬНО!
2. Отключить сайт в админке;
3. Распаковать архив версии 1.10.3 на сервере, заменяя или смержив совпадения;
4. Перейти по адресу site.ru/migrate и дождаться сообщения "миграция завершена", прочитать все информационные сообщения;
5. Удалить папку "migrate" и "install";
6. Включить сайт в админке;
7. Очистить кеш системы и браузера.

Обновляем шаблон:

1. Скачать патч для шаблона для оценки изменений;
2. Сравнить файлы (например при помощи winmerge) патча с файлами шаблона версии 1.10.2;
3. В своем шаблоне (если он есть) внести изменения в соответствии с новыми правками.

Добавлены файлы шаблона:

• /templates/_default_/special/installation.php
• /templates/_default_/modules/mod_arhive.tpl
• /templates/_default_/modules/mod_cart.tpl
• /templates/_default_/modules/mod_rss.tpl
• /templates/_default_/modules/mod_whoonline.tpl
• /templates/_default_/components/com_geo_view.tpl

Адаптируем js скрипты в своих разработках и дополнениях

• Изучаем особенности новой версии jQuery на официальном сайте бибилиотеки;
• Обновляем используемые скрипты на основе jQuery.

Информация для разработчиков

Отдельно хочется подчеркнуть и обратить еще раз внимание на некоторые нюансы.

Шаблоны:

Поддержка любых шаблонизаторов, файл positions.jpg, с визуально показанными позициями, вложенный в корень шаблона теперь показывается при создании/редактировании модуля и в общих настройках сайта, версия jQuery в системе 1.10.2. Единое поле для выбора города в шаблоне smarty, конструкция (например) — {city_input value=$city city_id=$city_id region_id=$region_id country_id=$country_id name="city" width="100%"}.

Ядро:

Константа HOST задается в ядре, задавать ее вручную теперь нет необходимости. Для задания cron имя домена необходимо передавать параметром, например так: php -f /path_to_site/cron.php site.ru > /dev/null.

Ядро теперь определяет автоматически контекст запроса (аякс/не аякс), и в случае аякс запроса вывод компонента завершится его отдачей, не выводя полный шаблон. Проверять контекст можно статическим методом ядра isAjax.

Модули формируются до показа шаблона, поэтому теперь в них можно использовать конструкции addHeadJS, addHeadCSS и т.п.

Файлы email писем теперь нужно подключать при помощи статического метода ядра getLanguageTextFile($name), указывая параметром имя текстового файла без расширения.

Заголовок компонента по умолчанию необходимо получать при помощи метода ядра getComponentTitle. Заголовок вернется с учетом названия пункта меню, если таковой имеется.

Метод ядра initSmarty помечен как устаревший, используйте вместо него cmsPage::initTemplate с теми же параметрами. Методы getSmartyObj и clearSmartyCache убраны из ядра. Очистка папки /cache производится при помощи статического метода clearCache.

Метод ядра getRusDate заменен на статический метод intMonthToStr, где параметром выступает номер месяца.

Метод ядра getDateForm убран, вместо него в шаблонах используйте конструкцию {dateform seldate=$usr.birthdate}.

Убраны все deprecated методы из ядра: userIsAdmin, checkAdminAccess, userIsEditor, isAdminCan, isUserCan. Вместо них используйте соответственно: cmsUser::userIsAdmin, cmsUser::getAdminAccess, cmsUser::userIsEditor, cmsUser::isAdminCan, cmsUser::isUserCan.

Локализация интерфейса

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

Принцип прост, рассмотрим на примере файла настроек mod_blogs. Ключ массива для названия поля формируется как MOD_ЗНАЧЕНИЕ_АТРИБУТА_NAME тега param. Остальные фразы поля формируются так же основываясь на значение атрибута name.

• Описание поля: MOD_ЗНАЧЕНИЕ_АТРИБУТА_NAME_HINT;
• Обозначение количества: MOD_ЗНАЧЕНИЕ_АТРИБУТА_NAME_UNITS;
• Обозначение название опций для тега option в форме: MOD_ЗНАЧЕНИЕ_АТРИБУТА_NAME_OPT_ЗНАЧЕНИЕ_АТРИБУТА_VALUE;

Для локализации js скриптов необходимо использовать методы класса cmsPage:

• addHeadJsLang(КЛЮЧ_ИЛИ_МАССИВ_КЛЮЧЕЙ_LANG_МАССИВА) — добавляет в набор доступных js переменных фразу(ы);
• displayLangJS(МАССИВ_КЛЮЧЕЙ_LANG_МАССИВА) — печатает строки js с языковыми переменными;
• getLangJS(КЛЮЧ_LANG_МАССИВА ) — возвращает js строку типа "var LANG_{$key} = '{$value}'; "

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

По традиции хотим поблагодарить всех кто помогал в работе над этим релизом, участвовал в его подготовке и тестировании. Так же, пользуясь случаем, благодарю все сообщество — как тех, кто зарегистрирован на этом сайте, так и других пользователей, использующих так или иначе ;-) наш продукт.

Скачать версию 1.10.3

upd 18.10.2013:

Архив дистрибутива 1.10.3 обновлен. Исправлен баг с датами в админке: в статьях, клубах и faq.

Обновлены autocomplete и colorbox. Smarty обновлен до версии 2.6.28 из-за проблем на php > 5.5.

Для тех, кто уже обновился или только установил, скачав архив 1.10.3 до указанной даты (18.10.2013) мы подготовили патч — скачать. Распаковать, заменяя совпадения.