Skip to content

Latest commit

 

History

History
136 lines (98 loc) · 5.07 KB

README_ru.md

File metadata and controls

136 lines (98 loc) · 5.07 KB
Raw

(MODX)EvolutionCMS.snippets.ddGetParentId

Получает ID родителя(ей) необходимого уровня.

Использует

Установка

Используя (MODX)EvolutionCMS.libraries.ddInstaller

Просто вызовите следующий код в своих исходинках или модуле Console:

//Подключение (MODX)EvolutionCMS.libraries.ddInstaller
require_once(
	$modx->getConfig('base_path') .
	'assets/libs/ddInstaller/require.php'
);

//Установка (MODX)EvolutionCMS.snippets.ddGetParentId
\DDInstaller::install([
	'url' => 'https://github.com/DivanDesign/EvolutionCMS.snippets.ddGetParentId',
	'type' => 'snippet'
]);
  • Если ddGetParentId отсутствует на вашем сайте, ddInstaller просто установит его.
  • Если ddGetParentId уже есть на вашем сайте, ddInstaller проверит его версию и обновит, если нужно.

Вручную

1. Элементы → Сниппеты: Создайте новый сниппет со следующими параметрами

  1. Название сниппета: ddGetParentId.
  2. Описание: <b>1.4</b> Получает ID родителя(ей) необходимого уровня..
  3. Категория: Core.
  4. Анализировать DocBlock: no.
  5. Код сниппета (php): Вставьте содержимое файла ddGetParentId_snippet.php из архива.

2. Элементы → Управление файлами

  1. Создайте новую папку assets/snippets/ddGetParentId/.
  2. Извлеките содержимое архива в неё (кроме файла ddGetParentId_snippet.php).

Описание параметров

  • id

    • Описание: ID документа.
    • Допустимые значения: integer
    • Значение по умолчанию: [*id*] (текущий документ)

  • level

    • Описание: Уровень родителя.
    • Допустимые значения:
      • 1 — непосредственный родитель
      • 2 — родитель родителя
      • -1 — последний родитель
      • -2 — предпоследний родитель
      • integer — etc
    • Значение по умолчанию: 1

  • result_itemsNumber

    • Описание: Количество возвращаемых родителей.
    • Допустимые значения:
      • integer
      • 'all'
    • Значение по умолчанию: 1

  • result_itemTpl

    • Описание: Шаблон (имя чанка) для вывода.
      Пустые элементы после парсинга шаблона будут игнорироваться (можно вызывать сторонние сниппеты в шаблоне и задавать свои условия отображения).
      Доступные плейсхолдеры:
      • [+id+] — Parent ID.
    • Допустимые значения:
      • stringChunkName
      • string — передавать код напрямую без чанка можно начиная значение с @CODE:
    • Значение по умолчанию: '@CODE:[+id+]'

  • result_itemsGlue

    • Описание: Строка, объединяющая элементы при рендеринге.
    • Допустимые значения: string
    • Значение по умолчанию: ''

  • result_toPlaceholder

    • Описание: Возвращать значение в плэйсхолдер.
    • Допустимые значения:
      • 0
      • 1
    • Значение по умолчанию: 0

  • result_toPlaceholder_name

    • Описание: Имя плэйсхолдера.
    • Допустимые значения: string
    • Значение по умолчанию: 'ddParent'

Примеры

Запустить сниппет через \DDTools\Snippet::runSnippet без DB и eval

//Подключение (MODX)EvolutionCMS.libraries.ddTools
require_once(
	$modx->getConfig('base_path') .
	'assets/libs/ddTools/modx.ddtools.class.php'
);

//Запуск (MODX)EvolutionCMS.snippets.ddGetParentId
\DDTools\Snippet::runSnippet([
	'name' => 'ddGetParentId',
	'params' => [
		'level' => -1
	]
]);

Ссылки