Шорткод 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.