MODX. Встроенные модификаторы Fenom

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

// Устанавливаем другой формат даты
{'2023-03-08 12:45' | date : 'd.m.Y'} // 08.03.2023

// Получаем текущий год
{'' | date : 'Y'} // текущий год

// Устанавливаем другой формат даты
{'2023-03-08 12:45' | date_format : '%d.%m.%Y'} // 08.03.2023

// Получаем текущий год
{'' | date_format : '%Y'} // текущий год

{'<p>Текст внутри тегов</p>' | escape } // &lt;p&gt;Текст внутри тегов&lt;/p&gt;

 Имеет несколько параметров. Первым параметром принимает режим работы, вторым — кодировку.

{$content | escape : type = 'html' : charset = 'UTF8'}

Режимы работы:

• html — экранирует HTML сущности в строке.
• url — экранирует строку для использования в URL.
• js — экранирует строку для использования в JavaScript.

// html
{'<p>Текст внутри тегов</p>' | escape : 'html' : 'utf-8'} // &lt;p&gt;Текст внутри тегов&lt;/p&gt;

// url
{'http://site.com/?key=value' | escape : 'url'} // http%3A%2F%2Fsite.com%2F%3Fkey%3Dvalue

// js
{['key' => 'value'] | escape : 'js'}

Декодирование переменной. Модификатор unescape является обратным действием модификатора escape. Так же как и escape имеет режимы html, js и URI.

// html
{'&lt;p&gt;Текст внутри тегов&lt;/p&gt;' | unescape : 'html' : 'utf-8'} // <p>Текст внутри тегов</p>

// url
{'http%3A%2F%2Fsite.com%2F%3Fkey%3Dvalue' | unescape : 'url'} // http://site.com/?key=value

// js
{'{"key":"value"}' | unescape : 'js'}

Режимы работы:

• html — декодирует HTML сущности в строке.
• url — декодирует строку для использования в URL.
• js — декодирует строку для использования в JavaScript. 

{"Текст     с    пробелами"| strip } // Текст с пробелами

{"    Многострочный
    текст    "| strip : true } // Многострочный текст

Подсчитывает длину строки, массива, объекта. Может принимать строку или массив.

// Длинна строки
{'Длинна' | length} // 6

// Длинна массива
{['key' => 'value'] | length} // 1

// Длинна переменной
{if $images | length > 5}
    Слишком много изображений
{/if}

Подсчитывает количество элементов.

{set $array = [
"foo" => "bar",
"bar" => "foo",
]}

{$array | count} // 2

Оператор проверки наличия подстроки в строке или значения в массиве.

{if 'img' | in : $content}
  В тексте есть картинки
{/if}

// Искомую строку можно вынести в переменную
{var $key = '10'}

{if $key | in : 'У меня 10 яблок'}
    Ключ найден
{/if}

// массив + тернарный оператор
{$key | in : [1, 3, 42] ? 'ключ найден' : 'не найден'}

{var $array = ['key' => 'value']}
{if $array | iterable}
    {foreach $array as $key => $value}
        <p>{$key} is {$value}</p>
    {/foreach}
{/if}

Заменяет все вхождения искомой строки на строку для замены. Принимает 2 обязательных параметра: искомую строку и строку замены.

{ $content | replace : search_string : replace_string }


{ $fruits | replace : "pear" : "orange"} // все pear будут заменены на orange

{ $content | ereplace : pattern : replacement }

Выполняет поиск совпадений в строке $content с шаблоном pattern и заменяет их на <em>replacement</em>.

replacement может содержать ссылки вида \n, $n или ${n}, причем последний вариант предпочтительней. Каждая такая ссылка будет заменена на подстроку, соответствующую n-ой подмаске. n может принимать значения от 0 до 99, причем ссылка \0 (либо $0) соответствует вхождению всего шаблона. 

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

{'April 15, 2014' | ereplace : '/(\w+) (\d+), (\d+)/i' : '${1}1, $3'} // April1, 2014

Замечание: во избежание скрытых ошибок при выполнении сущностей регулярные выражения стоит помещать в одинарные кавычки.

Проверяет совпадение строки с паттерном.

Специальные символы:

• ? — соответствие одному или нулю любых символов. ?at соответствует Cat, cat, Bat или bat.
• * — соответствие любому количеству символов. Law* соответствует Law, Laws, или Lawyer.
• [characters] — соответствие символа группе символов. [CB]at соответствует Cat или Bat, но не cat, rat или bat.
• \ — экранирующий символ. Law\* будет соответствовать только Law*.

{ $string | match : pattern}


{if $color | match : "*gr[ae]y" }
  какой-то оттенок серого
{/if}

Выполняет проверку на соответствие регулярному выражению. 

{ $string | ematch : pattern }

{if $color | ematch : '/^(.*?)gr[ae]y$/i' }
  какой-то оттенок серого ...
{/if}

Разбивает строку и возвращает массив, используя первый параметр в качестве разделителя (по умолчанию — ,).

{ $string | split : delimiter = ',' }

{var $fruits = 'banana,apple,pear' | split } // ["banana", "apple", "pear"]
{var $fruits = 'banana,apple,pear' | split : ',apple,'} // ["banana", "pear"]

{ $string | esplit : pattern = '/,\s*/' }

{var $fruits = 'banana, apple, pear' | esplit} // ["banana", "apple", "pear"]
{var $fruits = 'banana; apple; pear' | esplit : '/;\s/'} // ["banana", "apple", "pear"]

Объединяет элементы массива в строку, используя первый параметр в качестве соединителя (по умолчанию — ,).

{ $array | join : delimiter = "," }

{var $fruits1 = ["banana", "apple", "pear"]}
{$fruits1 | join} // banana, apple, pear
{$fruits1 | join : 'is not'} // banana is not apple is not pear

{var $number = 10000}

{$number | number : 0 : '.' : ' '} // выведет 10 000

Функция принимает один, два или четыре аргумента (не три):

{$int | number_format : number : decimals : dec_point : thousands_sep}

• number — Форматируемое число.
• decimals — Устанавливает число знаков после запятой.
• dec_point — Устанавливает разделитель дробной части.
• thousands_sep — Устанавливает разделитель тысяч.

{'text' | md5} // 1cb251ec0d568de6a929b520c4aed8d1
{'text' | sha1} // 372ea08cab33e71c02c651dbc83a474d32c676ea
{'text' | crc32} // 999008199

{'http://site.com/?key=value' | urlencode} // http%3A%2F%2Fsite.com%2F%3Fkey%3Dvalue
{'http%3A%2F%2Fsite.com%2F%3Fkey%3Dvalue' | urldecode} // http://site.com/?key=value

{'text' | base64_encode} // dGV4dA==
{'dGV4dA==' | base64_decode} // text

{'{"key":"value"}' | fromJSON} // ["key" => "value"]
{["key" => "value"] | toJSON} // {"key":"value"}

{['foo'=>'bar','baz'=>'boom'] | http_build_query} // foo=bar&baz=boom

{$printed | print_r}

{var $printed = (['key' => 'value'] | print_r : true)} // Array ( [key] => value )

{$var | var_dump}

{$content | nl2br}

{'Текст для проверки' | lower} // текст для проверки

{'Текст для проверки' | upper} // ТЕКСТ ДЛЯ ПРОВЕРКИ

{'теКст Для провЕрки' | ucwords} // Текст Для Проверки

{'теКст Для провЕрки' | ucfirst} // Текст для проверки

{'<b>Текст для проверки</b>' | htmlent} // &lt;b&gt;Текст для проверки&lt;/b&gt;gt;

Обрезает строку до указанного количества символов.

{'Этот модификатор обрезает строку' | limit : 16} // Этот модификатор

Если в строке есть html теги, они останутся не закрытыми. Для предотвращения неправильного отображения html используйте модификатор truncate.

Обрезает переменную до определенной длинны, по умолчанию — 80 символов.

{var $str = 'Очень длинная строка, которую необходимо обрезать'}
{$str | truncate : 20} // Очень длинная строка...

Этот модификатор имеет несколько параметров:

• length (обязателен) —  определяет максимальную длину обрезаемой строки;
• etc, по умолчанию троеточие (…)  —  текстовая строка, которая заменяет обрезанный текст. Её длинна НЕ включена в максимальную длину обрезаемой строки.
• by_word, по умолчанию FALSE  —  определяет, обрезать ли строку в промежутке между словами (true) или строго на указанной длине (false).
• middle, по умолчанию FALSE —  определяет, нужно ли обрезать строку в конце (false) или в середине строки (true).

{ $content | truncate : length : etc : by_words : middle }

 Применение truncate с параметрами:

// Можно изменить окончание или добавить к нему какой-либо текст
{$str | truncate : 20 : '... Читать полностью'} // Очень длинная строка... Читать полностью

// Можно обрезать текст в середине строки
{$str | truncate : 20 : ' ... ' : true : true} // Очень длинная строка ... 

// Если в тексте есть html теги, то лучше обрезать в конце строки.
{$content| truncate : 20 : ' ... ' : true} 

{'Привет, [[+username]]' | esc} // тег username не будет обработан

{'<b>Привет!</b>' | notags} // Привет!

{'Привет, [[+username]]' | stripmodxtags} // Привет,

{'Тестовый текст' | cdata} // <!--[CDATA[Тестовый текст]]-->

{'mirrortext' | reverse} // txetrorrim

{'very very long text' | wordwrap : 3} // very<br />very<br />long<br />text

{'very very long text' | wordwrapcut : 3} // ver<br />y<br />ver<br />y<br />lon<br />g<br />tex<br />t

{'2016-03-20 13:15' | fuzzydate : '%d.%m.%Y'} // 20.03.2016
{'' | date : 'Y-m-d 13:15' | fuzzydate} // сегодня в 01:15 PM

{6 | declension : 'яблоко|яблока|яблок'} // яблок
{3 | declension : 'яблоко|яблока|яблок' : true} // 3 яблока
{101 | decl : 'яблоко,яблока,яблок' : false : ','} // яблоко

{1 | ismember : 'Administrator'} // true
{0 | ismember : ['Administrator', 'Manager']} // false

{'' | isloggedin : 'web'} // true
{'' | isnotloggedin : 'web'} // false

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

{$_modx->lexicon->load('en:core:default')}
{'action_err_nfs' | lexicon : ['id' => 25] : 'en'} // No action with 25 found.

{1 | user : 'fullname'} // Administrator

{1 | resource : 'longtitle'} // Home page
{1 | resource : 'my_tv'} // My_tv value

{$_modx->resource | print} // Распечатает все поля ресурса, включая TV
{1 | resource | print} // Распечатает массив с данными всего ресурса, но без TV
{$_modx->getPlaceholders() | print} // Распечатает все плейсхолдеры ресурса
{0 | user : 'extended' | print : false} // Распечатает массив поля `extended` текущего пользователя в одну строку

{'Новое имя сайта' | setOption : 'site_name'}

{'site_name' | option} // Новое имя сайта

{'My text' | setPlaceholder : 'my_text'}

{'my_text' | placeholder} // My text

{var $int = 123}
{var $float = 1.5}
{var $str = 'test'}

{$int | gettype} // integer
{$float | gettype} // double
{$str | gettype} // string

{'assets/css/bootstrap.css' | cssToHead}

{'<div class="content">some html</div>' | htmlToHead}

{'<div class="content">some html</div>' | htmlToBottom}

{'<script>alert();</script>' | jsToHead : true} // При загрузке страницы будет javascript alert

{'<script>alert();</script>' | jsToBottom : true} // При загрузке страницы будет javascript alert

. \ + * ? [ ^ ] $ ( ) { } = ! < > | : -

// Если соответствует выражению, выведем email
{if 'email@mail.ru'|preg_match : '/^.+@.+\\.\\w+$/' }
    email
{/if}

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

// Получим первое изображение из поля content
{set $image = $_modx->resource.content | preg_get : '!http://.+\.(?:jpe?g|png|gif)!Ui}

// В результате будут только даты
{["26-04-1974", "Сергей", "27-11-1977", "Юля"] | preg_grep : "/(\d{2})-(\d{2})-(\d{4})/" | print_r : true}

// выведет адрес сайта без протокола https
Website: {'https://site.name'| preg_replace : '~^https?://~': ''}

{'I love MODX' | preg_split : '/ /' | print_r : true}// Array ( [0] => I [1] => love [2] => MODX )