Шорткод getcomponent для GetSimple CMS предназначен для встраивания вызовов компонентов непосредственно в содержание страницы.
Работа шорткода getcomponent аналогична вызову функции <?php get_component('component_name'); ?>
в PHP-файле шаблона оформления страницы, но производится внутри содержания страницы, что значительно расширяет возможности практического использования компонентов GetSimple CMS.
Примеры использования шорткода getcomponent
[getcomponent id="component_name" /] - вызов компонента;
[getcomponent id="component_name" force="true" raw="false"] - вызов компонента с дополнительными параметрами.
Параметры шорткода getcomponent:
id
- обязательный параметр, принимающий имя вызываемого компонента. В случае, если запрашиваемый компонент существует и активен (актуально для версии GetSimple CMS 3.4.x), шорткод встроит результат выполнения функции <?php get_component('component_name'); ?>
в содержание страницы;force
- необязательный параметр, используемый в GetSimple CMS 3.4.x. При значении true
позволяет игнорировать статус активности запрашиваемого компонента. По умолчанию принимает значение false
;raw
- необязательный параметр, использумый в GetSimple CMS 3.4.x. При значении true
позволяет получить содержание компонента, не выполняя его код. То есть, если запрашиваемый компонент содержит исполняемый PHP-код, то при передаче параметраraw="true"
, этот код не будет выполнен, а будет возвращён в виде текста. По умолчанию принимает значение false
.
Важно! Для получения корректного результата работы шорткода getcomponent, значения, передаваемые параметрам force
и raw
, должны приводиться к соответствующим значениям типа Boolean, используя PHP-функцию filter_var с фильтром FILTER_VALIDATE_BOOLEAN.