OctoberCMS

Починил архив

graker — Sat, 07 Jun 2025 08:50:00 +0000

Недавно отключил на сайте комментарии, а сегодня вдруг взял и починил архив. Как говорится, где-то убыло, где-то прибыло.

Архив ломался когда-то давно в ходе обновлений OctoberCMS, но я тогда почти ничего не писал, и просто его отключил. А сегодня посмотрел, и решил что так больше нельзя. И починил. Оказалось, просто изменился способ получения параметров из url, который в плагине был сделан по-другому. В общем, быстренько поправил, заодно сделал нормальный локализованный вывод названий месяцев, и залил. Найти архив можно под лентой постов, вот например за 2025-й год. Если сравнить с предыдущими годами, моя графомания пережила ремиссию и снова требует крови.

Также можно смотреть архив по категориям (ссылка под лентой постов в каждой категории). А сам плагин BlogArchive для OctoberCMS можно по-прежнему найти на гитхабе: https://github.com/graker/blogarchive, обновления я в него добавил.

Встречайте Winter CMS

graker — Mon, 26 Apr 2021 10:05:00 +0000

Rebirth as Winter CMS

As a result of these dramatic structural changes of the project that we rely upon to run our businesses, former October CMS maintainers Luke Towers, Ben Thomson and Marc Jauvin wish to announce the formation of the Winter CMS project, a community-driven fork of October CMS with a dedication to speed, security, stability, and simplicity. Along with Jack Wilkinson, we aim to continue to deliver a professional and feature-rich platform that you can rely upon for your websites and applications; as well as engage with the community and become a more community-driven project overall.

Winter CMS is a fork of October CMS as of v1.1.2 / v1.0.472, any of your October projects can be seamlessly migrated to use Winter instead as long as they are using a version of October prior to the dramatic changes recently introduced by the original founders.

For more information on the exact events that led to the decision to fork, you can view our announcement on GitHub.

Видимо, надо помигрировать. Название только какое-то безыскусное. Винтар ЦМС. Можно было бы назвать например Bleak Midwinter CMS, было бы гораздо круче.

OctoberCMS станет платным

graker — Tue, 13 Apr 2021 14:15:00 +0000

This means that as a business, the October CMS platform, its features, and processes now focus primarily on the needs of our professional customers. To this end, we have been working hard on a new release for over a year now, and it is ready to go.

We believe you will be pleasantly surprised by the new features and streamlined back end to October CMS to increase both its capability and ease of use.

However, we will also be moving to a new business model to ensure the continuity and sustainability of October CMS. October CMS will become a proprietary product and the licensing model is to be changed. Under these changes, October CMS will no longer be a free platform.

We believe that these changes are necessary in the interests of providing the timely and effective support expected of our professional users.

October CMS Moves to Become a Paid Platform

$9 в год за лицензию на один сайт, $150 в год за лицензию на произвольное количество сайтов. Если не обновляться, можно не платить.

Наверное, надо свои два плагинчика тоже платными сделать, раз пошла такая пьянка.

Локализация в OctoberCMS

graker — Sat, 04 May 2019 22:30:00 +0000

На днях совершил над собой титаническое усилие и добавил-таки своему Netspark.ru английскую версию. Учитывая, что это по сути одностраничник (ну, плюс 404 и «Сайт на обслуживании») — можно было бы тупо скопировать и поменять текстики на английские. Тем более английскую версию поставил на другой домен. Но все же чтобы фронт-энд был одинаковый в обеих версиях — мало ли там, добавить чего, поменять — решил использовать возможности локализации. О чем и расскажу немного.

Локализация в OctoberCMS — примерно такая же, как в Laravel. Есть файлы с локализацией, например lang.php, из них возвращаются массивы, примерно так:

return [
    'messages' => [
        'my_message' => 'Hello world',
    ],
];

После чего используется фильтр trans в твиге, где обращение к строке происходит как author.pluginname::lang.messages.mymessage. Author и pluginname — это имя автора и плагина, чтобы было ясно, откуда брать строки. Соответственно, файлы локализации должны жить в плагинах.

Это нормально, если проект не совсем примитивный и в нём есть кастомный плагин для всяких там дополнений и расширений. Но в рассматриваемом случае проект совсем примитивный и кастомных плагинов в нём нет, соответственно, хранить переводные строки негде. В таком случае нужно использовать плагин Translate. Если он установлен, хранить переводы можно прямо в theme.yaml используемой фронт-энд-темы. Заинклудить отдельный ямл с переводами тоже можно, да.

В файле строки будут храниться вот так:

translate:
    en:
        nav.portfolio: 'Our works'
        nav.services: 'Services'
    ru:
        nav.portfolio: 'Наши работы'
        nav.services: 'Услуги'

А обращаться к строчкам во фронт-энде можно с помощью фильтра твига _, вот так:

{{ 'nav.portfolio'|_ }}

То есть даже неймспейс никакой соблюдать не надо.

В фильтр перевода можно передавать параметры для подстановки:

{{ 'There are :works works in portfolio'|_({works: 1000}) }}

Естественно, строчку There are :works works in portfolio тоже можно положить в ямл и заменить дескриптором.

Помимо фильтра перевода _, есть и фильтр __, вызывающий transchoice() и помогающий в правильном склонении множественных чисел.

Чтобы строки из yaml-файла попали в систему, нужно их сначала обнаружить плагином Translate. Для этого со страницы переводов нужно запустить сканирование сообщений и затем почистить кэш.

К слову, если пользоваться плагином Translate, хранить строки в yaml-файле вообще необязательно. Если подать любую строку во фронт-энде на фильтр перевода, она может быть отсканирована и переведена через админку плагина. Примерно как функция t() в Друпале — засунул в неё что-нибудь, и это что-нибудь стало можно перевести. Но что еще интересно, в отличие от Друпала, где системный язык всегда английский и мы переводим с него, в OctoberCMS с плагином Translate дефолтный язык — действительно дефолтный. То есть мы можем сделать сайт на русском, сделать русский дефолтным, и переводить строки с русского на французский, или китайский, вообще без какого-либо упоминания английского.

Что еще можно сказать. Как видно из скриншота выше, плагин позволяет экспортировать переводы в и импортировать из csv-файлов (аналогично импорту-экспорту моделей).

Напоследок приведу пример определения текущей локали в системе. Я просто добавил обработчик onStart() в лейаут, и страницам, использующим этот лейаут, стали доступны переменные switchLocaleName, switchLocaleFlag и switchLocaleLink.

use RainLab\Translate\Classes\Translator;
protected $translator;

function onStart() {
    $this->translator = Translator::instance();
    $switchLocale = ($this->translator->getLocale() == 'ru') ? 'en' : 'ru';
    $this['switchLocaleName'] = ($switchLocale == 'ru') ? 'Русская версия' : 'English version';
    $this['switchLocaleFlag'] = 'assets/img/flags/' . $switchLocale . '.svg';
    $this['switchLocaleLink'] = ($switchLocale == 'ru') ? 'https://netspark.ru' : 'https://netspark.pro';
}

Лично мне это пригодилось, чтобы построить свой переключатель языков, который направляет на другой домен, вместо изменения языка в URL.

Турагентство AlayTravel

graker — Mon, 26 Feb 2018 08:14:00 +0000

Мой верный соратник по всем поездкам и по совместительству супруга Настя на днях запилила турагентство AlayTravel. С бронированием туров по всему миру, чаем, печеньками и бесконечной заботой о туристах.

А я, соответственно, запилил на OctoberCMS для турагентства сайтик. Делать такие сайты на OctoberCMS — одно удовольствие, тем более по такому приятному поводу. Приглашаю всех заходить и подбирать себе отпуск. Онлайн-поиск и подбор туров с актуальными ценами к сайту уже прикручен. Тем, кто сам сможет до 8 марта подобрать себе тур — сообразим скидку.

Срочно забронировать тур на AlayTravel.ru

Кнопка Load More на AJAX в OctoberCMS

graker — Thu, 01 Feb 2018 07:31:00 +0000

Работу с AJAX в OctoberCMS я уже раньше немного затрагивал, но для бэк-энда. А теперь можно затронуть и фронт. В этой заметке мы сделаем кнопочку Load More, чтобы подгружала без перезагрузки страницы новые посты блога (из плагина RainLab.Blog).

На первый взгляд может показаться, что для этого нужно влезть в компонент Posts этого плагина, но на самом деле — вовсе не нужно. Дело в том, что раньше из документации можно было подумать, что обработчики AJAX-событий нужно описывать только в классе контроллера (если в бэк-энде), или компонента (если во фронте). И поэтому не очень было понятно, как быть, когда ты хочешь получить красивый ajax-пейджер для блога. То ли лезть в код чужого плагина, что влечет проблемы с обновлениями. То ли писать свой собственный компонент, из которого грузить компонент Posts программно. Что ведет к сомнениям в том, надо ли вообще такой негибкой CMS пользоваться.

Генерация тестового контента в OctoberCMS

graker — Thu, 25 Jan 2018 08:35:00 +0000

Что мне всегда отдельно нравилось в Ларавеле — так это как там организована генерация тестовых материалов. Для этого используется мега-библиотека Faker, которая умеет практически всё, что может понадобиться при разработке. Годится как для автоматизированных тестов, так и для заполнения БД тестовыми данными.

В самом Ларавеле можно описать для моделей классы-factory и генерировать данные по ним, это описано в документации. В OctoberCMS про фабрики документация ничего не говорит, но можно обойтись и без них.

TL;DR: Далее несколько примеров генерации тестовых данных с помощью библиотеки Faker в OctoberCMS

Множественные числа в OctoberCMS

graker — Sun, 21 Jan 2018 12:53:00 +0000

Вообще говоря, локализация интерфейса в OctoberCMS такая же как в Laravel. Есть файлы типа lang.php, разложенные по директориям, соответствующим языку, в них есть строки, их можно переводить. Неудобство лично для меня лишь в одном — когда нужно куда-то вставить локализованный текст, не видно самого текста, только идентификатор строки. В остальном, на мой взгляд, система эта несколько удобнее перевода интерфейса в Друпале.

Даже если поддерживать сайт или интерфейс на нескольких языках не нужно, с переводами можно столкнуться, например, при плюрализации, то есть склонении в зависимости от значения числа. Потому что в 2018 году уже как-то стыдно делать сайт, на котором написано «1 предложений», «22 предложений» и т.д. Надо склонять.

В Ларавеле это делается тривиально, для английского языка в lang.php пишем например:

return [
    'count' => [
        'offers' => 'offer|offers',
    ],
];

Тогда при вызове trans_choice('lang.count.offers', 10); выведется слово offers, а при trans_choice('lang.count.offers', 1); — offer.

И для перевода на русский достаточно добавить в соответствующий lang.php перевод:

return [
    'count' => [
        'offers' => 'предложение|предложения|предложений',
    ],
];

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

Но в OctoberCMS есть нюанс. Дело в том, что Ларавел поддерживает единую директорию lang для локализации всего проекта, поэтому туда можно складывать любые строки и обращаться тоже можно к любым строкам. А в Октябре у каждого плагина своя директория переводов, у ядра — своя директория переводов, а у используемой темы её и вовсе нет.

Из-за этого, в первый раз столкнувшись с задачей, можно немного смутиться — а как же сделать плюрализацию для строки, которую я просто в теме вывожу. Документация пока об этом ничего не говорит. А строчка:

Note: For translating front-end content, there are plugins that can be used for this purpose.

и вовсе может навести на мысль, что для перевода строк в теме (каковая и есть фронт-энд) нужно какие-то плагины ставить (нужно, но только для контента, то есть моделей из БД).

На самом деле для обращения к строкам локализации из темы, то есть из шаблонов Twig, есть фильтры. Для обычного перевода — фильтр trans, а для плюрализации — transchoice. Его и нужно применить, чтобы получить склоняемое количество предложений:

{{ "graker.touristic::lang.count.offers"|transchoice(quantity) }}

graker.touristic здесь — это обращение к плагину Touristic за авторством Graker: к сожалению, поскольку у темы нет своего файла локализаций, необходимые строки придется разместить в каком-нибудь плагине.

Обновления до Laravel 5.5

graker — Tue, 05 Sep 2017 20:20:00 +0000

Поскольку Laravel 5.5 (который, кстати, LTS) уже неделю как вышел, стал обновляться. Проекту, который недавно обновлял с 5.1 до 5.4, повезло: достаточно было поменять версии в composer.json — и всё обновилось и заработало без проблем и все тесты прошли. Подправить пришлось лишь пару методов в тестах — там просто вместо строк кое-где стали числа возвращаться.

А поскольку авторы OctoberCMS обещали, что апгрейд до 5.5 выйдет примерно одновременно с самим 5.5 — стал обновлять домовую страницу. Тут вышло чуть-чуть сложнее. Встроенный механизм обновления обновлять ничего кроме плагинов не стал, потребовалось взять из гитхаба новый composer.json и тогда уже обновляться через composer update и последующий php artisan october:up, который запустит все новые миграции.

После обновления также нужно заменить значение параметра cipher в config/app.php на 'AES-256-CBC'. Просто перегенерация ключа php artisan key:generate тут не сработает, потому что по умолчанию в October не используется файл .env, а используются файлы в config.

Проблемка после обновления возникла одна — перестали сортироваться категории в соответствующем компоненте плагина Blog. Придется немножко покопаться. Учитывая, что обновление было аж с Laravel 5.0, одна маленькая проблема — отличный результат. Видно, что авторы основательно над апгрейдом поработали.

Ну и теперь у меня на сервере есть PHP 7, поскольку для Laravel с версии 5.5 он обязателен. Тоже полезно.

Будущее обновление OctoberCMS

graker — Sun, 30 Jul 2017 13:45:00 +0000

Как известно — скоро, уже вот-вот, совсем чуть-чуть осталось — выйдет Laravel 5.5. Но помимо того, что это само по себе хорошо, давно и вовсю идет работа по обновлению OctoberCMS, тоже до использования Laravel 5.5. Для October это наверное даже важнее: сейчас-то там под капотом вообще Laravel 5.0, так что обновление будет очень кстати.

В данный момент приобщиться к версии на 5.5 уже можно из репозитория, ветка develop. Я попробовал и могу сообщить: PhotoAlbums и MapMarkers в новой версии работают нормально, проблем не выявлено. Можно сказать, к обновлению готов.

OctoberCMS: виджет с ajax-диалогом

graker — Tue, 04 Jul 2017 08:20:00 +0000

Рассмотрим вставку виджета внутрь сторонней бэкэнд-формы и обращение к вставленному виджету из JS для подгрузки контента. На этом примере мы узнаем:

что такое виджет в OctoberCMS, зачем он и как его сделать;
как прикрепить виджет к контроллеру, определенному в другом плагине;
как пользоваться ajax-фреймворком в OctoberCMS.

Виджет для бэк-энда OctoberCMS — это то же самое, что компонент для фронт-энда. То есть это отдельный блок логики и представления, который можно ~~пихать где попало~~ повторно использовать. Вообще, виджеты бывают трёх видов:

Form Widget, то есть для использования в формах, для манипуляции данными моделей,
Report Widget для вывода полезных данных на панель управления в бэк-энде,
и просто Widget — для использования в любом контроллере бэк-энда. Например, Media Manager, красивый диалог для вставки медиа-файлов в текст, реализован в OctoberCMS как виджет.

В данной заметке мы будем делать ajax-диалог (который потом превратится в диалог выбора фотографий и вставки специального маркдаун-кода выбранной фотографии в текст).

MapMarkers, плагин с гугл-картой для OctoberCMS

graker — Wed, 17 May 2017 15:25:00 +0000

В маркетплейсе OctoberCMS появился еще один мой плагин — MapMarkers. Плагин предназначен для показа на карте нескольких маркеров (например, списка офисов). Маркеры можно создавать, указывать им широту-долготу, задавать при необходимости картинку, и выводить как на карте, так и списком. При клике по маркеру на карте появляется поп-ап, содержимым которого тоже можно управлять.

Также можно опционально аттачить к маркерам ссылки на блог-посты из плагина Blog и фотоальбомы из моего PhotoAlbums. С помощью этой фичи сделана страница «Путешествия».

Страница плагина MapMarkers в маркетплейсе

PhotoAlbums, фотоальбомы для OctoberCMS

graker — Tue, 09 May 2017 10:05:00 +0000

Когда переделывал домовую страницу под OctoberCMS, написал плагин для управления фотокарточками. После шестого Друпала хотелось сделать более удобно, чтоб с мультиаплоадом, опциональными заголовками и вставкой фотокарточек в посты по id. В целом можно сказать — получилось. Управлять фотокарточками стало гораздо удобнее, чем раньше (хотя есть еще что улучшить).

Плагин изначально был доступен на гитхабе, а на днях отправил заявку, чтобы добавить его в маркетплейс плагинов. Сегодня эту заявку одобрили, так что теперь я официально автор плагина для OctoberCMS.

Страница плагина PhotoAlbums в маркетплейсе

OctoberCMS и сортировка моделей

graker — Thu, 04 May 2017 19:30:00 +0000

Есть в OctoberCMS такая полезная штука — бихевиор для ручной сортировки моделей. Например, чтобы перетаскиванием отсортировать категории по значимости (и вложенности). Использовать его для своих моделей — очень просто, вот страничка в документации. Подключаем бихевиор к классу-контроллеру, заполняем конфиг, а в модели используем трейт Sortable (или NestedTree). А что такое бихевиор, можно тоже прочитать в доках.

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

Бихевиор ReorderController для этого использовать не получится, придется строить сортировку вручную. Однако если покопаться, как устроен ReorderController, его шаблоны и трейт Sortable, можно сделать свою сортировку по аналогии и даже не дублировать какую-то часть кода. Об этом и поговорим.

Новые типы столбцов в списках OctoberCMS

graker — Tue, 02 May 2017 08:30:00 +0000

В плагинах OctoberCMS обычно мы имеем дело с моделями. Допустим, есть у нас вот такой список моделей как на картинке. Это список моделей Photo, принадлежащих одной модели Album. Сделать такой список легко — пара строчек в контроллере и он создастся автоматически.

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

Список столбцов задается (по умолчанию) в файле columns.yaml для отображаемой модели. Туда можно добавлять новые столбцы, но их набор довольно ограничен. Зато, как написано на этой же странице документации, можно добавлять свои типы столбцов. И сейчас мы рассмотрим эту возможность, чуть-чуть подробнее, чем в доках.

Тест компонента в OctoberCMS

graker — Thu, 20 Apr 2017 15:00:00 +0000

В принципе, тесты в OctoberCMS устроены примерно так же, как и в Laravel. Но поскольку это CMS и у нее есть плагины — к ним можно писать отдельные тесты. Правда, документация по этому вопросу довольно лаконична.

Вот, есть, например, в плагине компонент и на него нужно написать тесты. Чтобы это сделать, нам понадобится экземпляр класса компонента, но как его создать? Просто оператором new не получается. В общем, решение нашлось (не сразу) в дебрях тестов самого октября, привожу, вдруг кто еще искать будет:

$theme = Theme::load('test');
$page = Page::load($theme, 'index.htm');
$layout = Layout::load($theme, 'content.htm');
$controller = new Controller($theme);
$parser = new CodeParser($page);
$pageObj = $parser->source($page, $layout, $controller);
$manager = ComponentManager::instance();
$component = $manager->makeComponent('myComponent', $pageObj);

То есть, оказывается, нужна особая магия в виде создания сущностей из «тестовой» темы и генерации компонента с их помощью. Вот бы узнать, где можно почитать об этом, помимо исходников.

Кстати, третьим аргументом в makeComponent() можно передать массив свойств компонента. Поможет протестировать логику, когда свойства должны отличаться от дефолтных.

Анонсы и Markdown в OctoberCMS

graker — Mon, 13 Mar 2017 07:15:00 +0000

Как я уже писал раньше, в OctoberCMS из коробки работает фильтр Markdown, который можно применять практически везде. В плагине Blog текст каждой заметки проводится через фильтр перед сохранением, а сохраняется уже готовый html. Но при этом, по загадочным для меня причинам, excerpt (то есть анонс) заметки через фильтр Markdown не пропускается.

Из-за этого приходится либо для анонса переводить маркдаун в html вручную, либо при выводе анонса выводить его с фильтром {{ excerpt | md }}. Со вторым вариантом можно жить, но в сомнениях: ведь анонс каждого поста на странице будет обрабатываться фильтром при каждой загрузке ленты. Непорядок, надо же экономить электроэнергию-то!

Проблему можно решить аккуратно в несколько строчек кода. Раз плагин Blog не преобразует маркдаун в анонсе перед сохранением, поможем ему:

Post::extend(function (Post $model) {
  $model->bindEvent('model.beforeSave', function() use ($model) {
    $model->excerpt = Markdown::parse($model->excerpt);
  });
});

Здесь мы добавили для модели Post обработчик события model.beforeSave, которое происходит всякий раз перед созданием или обновлением заметки в блог. В обработчике мы просто пропускаем анонс через фильтр маркдауна (обратите внимание, для простоты здесь использован фасад Markdown).

Всё, теперь анонсы новых заметок будут обработаны фильтром маркдаун при сохранении. Для порядка можно еще разово обработать анонсы старых заметок. Сделать это нетрудно. Добавим новую команду artisan:

php artisan create:command AuthorName.MyPlugin MyCommand

И в теле метода fire() выполним код:

$posts = Post::where('excerpt', '<>', '')->get();
foreach ($posts as $post) {
  $post->save();
}

То есть находим все заметки, у которых задан анонс и просто пересохраняем их. При пересохранении выполнится наш обработчик события и анонс будет обработан фильтром Markdown.

Для удобства обработчик события и команда обработки старых заметок — добавлены в мой плагин BlogArchive.

OctoberCMS и расширение плагинов

graker — Thu, 22 Sep 2016 20:00:00 +0000

Многих интересует, а как в OctoberCMS расширять «чужие» модели и формы. Один из авторов системы, Сэмюэл Джорджс, показывает на пальцах как:

Вообще, я не большой фанат скринкастов о программировании. Но как автор обращается с мультикурсорностью — любо-дорого смотреть.

OctoberCMS: расширяем фильтр Markdown

graker — Sun, 18 Sep 2016 12:45:00 +0000

В OctoberCMS из коробки работает фильтр Markdown, он применяется почти везде и, к тому же, его можно легко применять к любому тексту вручную. И, что важно, фильтр автоматически применяется к записям плагина Blog перед сохранением готового к выводу html.

Если мы хотим применить к проходящему через Markdown тексту какие-то свои фильтры, можно прицепиться к событию markdown.parse. Это событие генерируется сразу после парсинга входящего текста самим фильтром. Подключимся к нему в методе boot() нашего плагина:

public function boot() {
  Event::listen('markdown.parse', 'Author\PluginName\Classes\MarkdownExtender@parse');
}

Теперь при каждом применении фильтра Markdown будет вызываться метод parse() класса MarkdownExtender, который должен находиться в author/pluginname/classes/MarkdownExtender.php. Код класса:

namespace Author\PluginName\Classes;

class MarkdownExtender {

  public function parse($text, $data) {
    // в $text находится оригинальный текст
    // а в $data->text - результирующий
  }
}

Производим все нужные манипуляции с текстом в $data->text и сохраняем результат обратно, сверяясь с оригиналом в $text при необходимости. Вот и всё.

Плагин Blog Archive

graker — Wed, 31 Aug 2016 08:25:00 +0000

В процессе миграции домовой страницы с Drupal 6 на OctoberCMS, написал несколько плагинов. Первым из них стал плагин BlogArchive и в этой заметке я немного о нем расскажу.

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