[pdoTools] 2.3.0 - Рефакторинг и стандарты

Привет, друзья! Хочу представить вам новую версию pdoTools с важными изменениями.

Первым делом, весь код теперь соответствует стандарту PSR-2. Как бы я не любил табы, стандарт есть стандарт и пора уже его применять.

Вторым делом, по многочисленным просьбам заграничных товарищей, pdoTools больше не устанавливает дополнительные файлы в директорию core/model/modx/.
Я постарался сделать так, чтобы это ничего не сломало, и вы могли запускать класс как и раньше:

$pdo = $modx-getService('pdoTools');
$pdo->setConfig(array('param' => 'value'));
// или
$pdo = new pdoTools($modx, array('param' => 'value'));

Просьбы обусловлены глюками при разворачивании образов сайтов с pdoTools через Teleport. В том числе, на MODXCloud.

В Fenom добавлена пара модификаторов «по умолчанию». Ничего нового они не привносят, просто сокращают писанину.

Первый — это lexicon, который теперь можно использовать вот так:

{'string' | lexicon}
// или
{'string' | lexicon : ['key' => 'value'] : 'ru'}

Модификатор принимает опциональный массив плейсхолдеров для замены и указание языка. Рабочий пример:

{$_modx->lexicon->load('en:core:default')}
{'action_err_nfs' | lexicon : ['id' => 25] : 'en'}

Грузим английский словарь (если нужно) и выводим из него запись.

Второй модификатор — url:

{10 | url}
// или
{10 | url : ['scheme' => 'full'] : ['param' => 'value']}

Он принимает id ресурса и 2 опциональных массива: настройки и параметры url. Мой пример на тестовом сайте генерирует такой адрес:

http://test23.dev/container/document?param=value

А раньше было так:

{$_modx->lexicon('action_err_nfs', ['id' => 25], 'en')}
// и
{$_modx->makeUrl(10, ['scheme' => 'full'], ['param' => 'value'])}

Следующие изменения касаются сниппетов.

В pdoSitemap изменён формат даты, теперь она выводится как ISO 8601.

А в pdoCrumbs, наконец-то, поменяны родные чанки, чтобы генерировать общепринятый список хлебных крошек в виде ul > li.
При установленном Bootstrap крошки теперь работают сразу из коробки.

Заключение

Как видите, новая версия pdoTools старается лучше соответствовать стандартам и привносит изменения, которые нужно было сделать уже давно.

При обновлении не забудьте проверять работоспособность своих сайтов и если будут проблемы — пишите. Наше сообщество, понятно, уже работает на новой версии без проблем.

$row['date'] = date('c', $time);

$row['date'] = date('c', $time);

<lastmod>2016-01-02T23:36:21+05:00</lastmod>

[[!officeAuth? &tplLogout=`@INLINE
    {{!ms2form?
        &tplCreate=`tpl.ms2form.create.journal`
        &tplUpdate=`tpl.ms2form.update.journal`
        &tplTagRow=`tpl.ms2form.tag.journal.row`
        &allowedFields=`parent,pagetitle,content,published,template,hidemenu,site,email,date_field,textarea0,textarea1,textarea2,textarea3,textfield0,textfield1,made_in`
        &requiredFields=`parent,pagetitle,content,published,template,site,email,textarea0,textarea1,textarea2,textarea3,textfield0,textfield1,made_in`
        &parent=`419`
        &tags=`0`
        &newTags=`0`
        &template=`20`
        &editor=`quill`
        &source=`6`
        &redirectPublished=`new`
    }}
    ` 
...

[2016-03-15 10:40:47] (ERROR @ /connectors/index.php) Unexpected token ':' in fcdd770d74671ddd20f42172bb6c1db3 line 1, near '{"w":' <- there

[{"MIGX_id":"1","number":"AAA"},{"MIGX_id":"2","number":"BBB"}]

[[!pdoResources?
	&parents=`9`
        &showHidden=`1`
	&includeTVList=`tvName`
	&showUnpublished=`1`
	&tpl=`pT`
	&processTVs=`1`
	&where=`{
	    "tvName:LIKE":"%\"number\":\"3\"%"
	}`
]]