MaxSite CMS 0.81

Версия получилась достаточно интересной, но главное, что её выход знаменует окончательный переход на shared-каталог и все причитающиеся по этому поводу «плюшки». Перед кратким обзором изменений, сразу отмечу, что версия может использоваться для рабочих сайтов без особых проблем. Само обновление следует выполнять согласно инструкции в файле install-ru.txt.

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

Загружать архив MaxSite CMS следует с Github. Файл latest.zip на моём сайте пока не удалял — в ней версия 0.77.

Изменений довольно много (winmerge выдаёт 117 шт.), поэтому я остановлюсь на самых заметных. Правда сразу отмечу, что некоторые возможности доступны только для шаблонов, основанных на shared-каталоге, например D2.

Меню

Меню теперь можно оформлять в виде:

http://ссылка | название | подсказка | class | class_для_span

Это позволяет задавать css-класс не только для li-элемента, но и вложенного span.

Если адрес будет задан в виде «##», то a-ссылка не будет сформирована вовсе. Останется только вложенный span-элемент.

Если пункт меню задать как «---», то будет сформирован пустой li.divider — разделитель пунктов меню. Стили уже заданы в css-фреймворке.

Новые BB-коды

Новый код create_list предназначен для формирования сложного UL-LI списка в тексте записи. Сам список задаётся по правилам обычного меню, включая подпункты «[ ]».

[create_list]
ссылка | Первый
ссылка | Второй

[
## | Третий-первый
link | Третий-второй
]

ссылка | Четвертый
ссылка | Пятый
[/create_list]

Уровней вложенности может быть сколько угодно, главное не сбиться в «[ ]»-блоках. Также допускается указания css-класса для родительского UL-элемента.

[create_list(класс)] 
...

BB-код show используется для скрытия/раскрытия блоков в тексте. Это в какой-то мере аналог спойлера, только используется анимация и сохраняется состояние открытых/закрытых блоков. Использовать только в таком варианте:

[show Заголовок]
текст 
[/show]

Также отмечу, что можно придумать и свои замены на уровне плагина — для этого следует использовать хук bbcode. Он выполняется сразу после всех стандартных замен в тексте.

Изменения в плагине Forms

Можно указывать некоторые дополнительные параметры.

[name_title=Название поля ИМЯ]
[email_title=Название поля EMAIL]

Также теперь сохраняются заполненные поля формы в случае неверной формы. Кроме того, при задании полей можно указать вариант фильтрации данных: base, xss, trim, integer, strip_tags, htmlspecialchars, email и not_url.

Отдельное спасибо Николаю Громову, который реализовал часть функционала.

Компоненты D2

Появились новые:

• _random-text — вывод цитаты на основе плагина randomtext. Это подкомпонент, который пока нигде не используется.
• footer-3-sidebars — три сайдбара в подвале сайта. Сами сайдбары нужно определить в custom/my_functions.php.
• menu-login — сдвоенный компонент из главного меню и формы логина (dropdown).

Стили компонентов находятся в css-less шаблона D2. Также в стилях небольшие правки из которых отмечу только новый вариант полу-резиновой вёрстки, которая больше подходит под адаптивный дизайн. Пример такого поведения — этот сайт.

Изменения в CSS/LESS

В целом изменения незначительные — поправлены некоторые неточности. В хелперы добавлен новый микс .box_sizing(border-box), позволяющий задавать боксовую модель блока:

-webkit-box-sizing: border-box;
-moz-box-sizing: border-box;
box-sizing: border-box;

В shared новый микс columns.less, в котором я собрал стили для колоночной верстки. Вариант div.columns и div.box присутствовал раньше в D2, поэтому уже знаком вебмастеру. А вот вариант div.onerow совершенно новый. Он позволяет делать резиновую адаптивную колоночную вёрстку. В текущем варианте я рассчитал ширины для 1-5 колонок. Например 4 колонки можно сделать так:

<div class="onerow">
	<div class="col w1-4">1-4</div>
	<div class="col w1-4">1-4</div>
	<div class="col w1-4">1-4</div>
	<div class="col w1-4">1-4</div>
</div>

А это вариант колонок, где первая 1/4, вторая 2/4 и третья — 1/4:

<div class="onerow">
	<div class="col w1-4">1-4</div>
	<div class="col w2-4">2-4</div>
	<div class="col w1-4">1-4</div>
</div>

То есть следует следить, чтобы сумма «числа класса» была равна числу колонок. Как-то так: wОДНАКОЛОНКА-ВСЕГОКОЛОНОК .

Микс .col() используется для задания стилей произвольному блоку. Например вариант 5-колоночной верстки, где первая занимает 4/5 ширины, вторая 1/5 часть:

div.r1 {
	.col > .w4_5;
}
 	
div.r2 {
	.col > .w1_5;
}

Классы используются те же только с подчеркиванием. (Пример блоков в виде картинки.)

Опции шаблона

По сравнению с 0.80 здесь небольшие изменения. В shared/options/default я перенёс дефолтные для всех шаблонов опции (ini-файлы), поскольку они всё равно дублируются. Поэтому в каталоге шаблона options следует размещать только свои опции. Если же стоит задача затереть или изменить дефолтные, то используется стандартные вариант: дублируем как пустую или новую секцию.

Также возможен вариант, при котором можно принудительно запретить подгрузку дефолтных опций. В option.php указываем:

mso_set_val('get_options_default', false);

Изменения в выводе записей

Можно управлять выводом миниатюр. Если задать

mso_set_val('show_thumb', false);

то вывод миниатюр вообще будет исключен.

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

mso_set_val('show_thumb_type_home', false);
mso_set_val('show_thumb_type_category', false);

То есть указываем к ключу «show_thumb_type_» тип данных.

На странице рубрики можно выводить произвольную ушку сразу под её описанием. Название ушки формируется как category_SLUG. Например, если у рубрики короткая ссылка news, то её ушка будет category_news.

Для страниц комюзеров можно дополнительно выводить произвольные данные через хук users_add_out.

CSS-профили для записей

Традиционно css-профили используются для всего сайта и включаются в настройках шаблона. Теперь css-профиль можно указывать и для любой страницы. Это несколько расширяет возможности, поскольку в такой профиль можно вынести стили специфичные для конкретной страницы.

Произвольные main-шаблоны

Вещь, призванная разрешить проблему произвольного вывода данных. Типовая задача — на какой-то странице нужно отключить вывод сайдбара. Код вывода сайдбара прописан в main.php и для решения данной задачи приходилось мудрить с custom-файлами, где и прописывать условия вывода сайдбара.

Теперь можно использовать любое количество main.php, которые будут созданы под любую задачу. В комплекте D2 в каталоге main шаблон вывода no-sidebar. В файле удалён вывод сайдбара, а также дополнительно указан body.no-sidebar. Соответствующие стили уже прописаны в css-less (при отсутствующем сайдбаре нужно увеличить колонку контента).

Выбрать main-шаблон можно не только при редактировании записей, но и в настройках шаблона: для главной, рубрик, меток, архивов и авторов.

Но и это ещё не всё. Возможно автоматическое подключение main-шаблона по типу данных. Для этого следует разместить файл как main/type/ТИП/main.php. Например для главной это будет main/type/home/main.php.

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

Произвольные шаблоны заголовков записей (info-top)

Тоже интересная возможность. Для записи можно указать любой info-top type_foreach-файл. Традиционно он всегда был один и чтобы разрулить разный вывод заголовков, требовалось вводить в файл дополнительные условия. Теперь достаточно сделать какой-то вариант info-top-файла и разместить его в type_foreach/info-top/. После этого при редактировании записи можно указать нужный файл.

Напомню, что для вывода в info-top лучше всего использовать шаблонизатор Page_out, который уже автоматом доступен в этом файле. Для примера я кинул два файла: category-and-header.php и header-only.php.

Пожалуй, это самые основные и интересные изменения в MaxSite CMS 0.81. Полный и детальный список я постоянно выкладываю на гитхабе.