Версия 1.1.23 — небольшие исправления и чуть-чуть новенького

Таки вышел релиз Alto CMS 1.1.23. Каких-то «прорывных» фишек в ней нет, она, главным образом, исправляет ряд обнаруженных ошибок и чуть-чуть добавляет некоторых новых возможностей для разработчиков.

Вот список основных изменений:

Исправлены ошибки:

• несовместимость с php 5.3
• установка в конфиге экшена/ивента по умолчанию
• иногда нарушался порядок подключения js-файлов
• не работал ресайз в методе getPhotosetMainPhotoUrl() топика
• в некоторых случаях ломалась цветопередача для загружаемых jpeg-файлов с CMYK-профилем (очень старая ошибка, но никак не могли ее выловить)
• исправлен еще ряд мелких, но неприятных ошибок в коде и шаблонах

Обновлены сторонние библиотеки:

• CSSTidy до 1.5.5
• JShrink до 1.1.0
• jQuery до 1.12.4

Добавлено:

• местоположение директории для для загрузки и хранения изображений
• для js-файлов можно указывать атрибуты defer и async
• выбор изображений топика по параметрам
• методы AppendAsset() и PrependAsset() модуля Viewer
• вызов E::Module('Name') теперь кеширует экземпляр модуля, что увеличивает быстродействие
• ну и кое-что еще по мелочи

Кому интересны подробности про добавленные «плюшки», то добро пожаловать под кат

Местоположение директории для загрузки и хранения изображений

По умолчанию изображения загружаются в директорию /uploads, находящуюся в корневой директории сайта. Но иногда возникает желание загружать и хранить изображения в куда-то в другое место, возможно, на отдельный хост, специально создаваемый для статических файлов. Для этого в конфиге появились новые параметры:

$config['module']['uploader']['drives'] = array(
    'local' => array(
        'dir' => '___path.root.dir___',
        'url' => '___path.root.url___',
    ),
);

Нетрудно догадаться, что здесь задается полный путь на локальном диске до места расположения директории /uploads и URL к этой директории извне. Если изображение в базе сохраняется в виде '@uploads/path/to/image.jpg', то символ '@' заменяется на пути, указанные в конфиге, как показано выше.

Атрибуты defer и async для js-файлов

Если вы в курсе, зачем нужны атрибуты defer и async для загружаемых скриптов, то теперь вы можете их задавать в наборах js-файлов в конфигурации:

$config['assets']['default']['js'] = array(
    '___path.skin.dir___/assets/js/script1.js' => array('defer' => true),
    '___path.skin.dir___/assets/js/script2.js' => array('async' => true),
);

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

Новые методы получения изображений топика

В сущность топика добавлены новые методы, которые можно вызывать так (считаем, что в $oTopic у нас экземпляр конкретного топика):

• $oTopic->getImages() — возвращает все изображения топика (и включенные в текст, и в фотосет)
• $oTopic->getLoadedImages($aFilter = []) — возвращает загруженные изображения топика (т.е. изображения включенные в текст по ссылке, включены не будут); в метод может быть передан массив с набором фильтров для выборки нужных изображений (описание фильтра см. ниже), если фильтр не задан, то возвращаются все загруженные изображения.
• $oTopic->selectImage($aFilter = []) — возвращает первое из загруженные изображения топика (т.е. изображения включенные в текст по ссылке, включены не будут); фактически вызывает метод getLoadedImages() и берет первое значение из возвращенного массива.

Параметры фильтра методов getLoadedImages() и selectImage():

• 'width-more' => N — получить изображения с шириное более N пикселей
• 'width-less' => N — получить изображения с шириное менее N пикселей
• 'height-more' => N — получить изображения с высотой более N пикселей
• 'height-less' => N — получить изображения с высотой менее N пикселей
• 'width-max' => true — получить изображения с максимальной шириной
• 'width-min' => true — получить изображения с минимальной шириной
• 'height-max' => true — получить изображения с максимальной высотой
• 'height-min' => true — получить изображения с минимальной высотой

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

$aFilter = ['width-more' => 799, 'height-max' => true];
// Сначала будут выбраны все изображения с шириной более 799px, а потом из них будет выбрано с максимальной высотой 
$oImage = $oTopic->selectImage($aFilter);

// Сначала будут выбраны изображения с максимальной высотой, а из них - с шириной более 799px
$aFilter = ['width-more' => 799, 'height-max' => true];
$oImage = $oTopic->selectImage($aFilter);

Разумеется, эти методы могут быть использованы в шаблонах. Например, так:

<!-- выберем изображение с максимальными размерами, но не менее 800х600 -->
{$aFilter = ['width-more' => 799, 'height-more' => 599, 'height-max' => true, 'width-max' => true]}
{$oImage = $oTopic->selectImage($aFilter)}
{if $oImage}
    <img src="{$oImage->getImageUrl('800х600crop')}">
{else}
    <img src="default-image.jpg">
{/if}

Методы AppendAsset() и PrependAsset() модуля Viewer

Это лишь «синтаксический сахар»: методы в зависимости от расширения подключаемого файла вызывают AppendStyle()/AppendScript() или PrependStyle()/PrependScript() соответственно