-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
8 changed files
with
447 additions
and
120 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,64 @@ | ||
# (MODX)EvolutionCMS.snippets.ddGetParentId changelog | ||
|
||
|
||
## Версия 1.4 (2023-09-04) | ||
* \+ Запустить сниппет без DB и eval можно через `\DDTools\Snippet::runSnippet` (см. README → Примеры). | ||
* \+ README → Установка → Используя (MODX)EvolutionCMS.libraries.ddInstaller. | ||
* \+ README_ru, CHANGELOG_ru. | ||
* \* Внимание! Требуется (MODX)EvolutionCMS.libraries.ddTools >= 0.60. | ||
|
||
|
||
## Версия 1.3.1 (2020-06-22) | ||
* \* Внимание! Требуется (MODX)EvolutionCMS.libraries.ddTools >= 0.40.1 (не тестировался с более ранними версиями). | ||
* \* Совместимость с новыми версиями (MODX)EvolutionCMS.libraries.ddTools. | ||
* \* README, CHANGELOG: Изменения стиля. | ||
* \* README: | ||
* \- Home. | ||
* \+ Links. | ||
* \* Composer.json → `require` → `dd/evolutioncms-libraries-ddtools`: | ||
* \* Переименована из `dd/modxevo-library-ddtools`. | ||
* \* Исправлен формат версии. | ||
|
||
|
||
## Версия 1.3 (2020-03-02) | ||
* \+ Пустые элементы после парсинга `result_itemTpl` будут игнорироваться (можно вызывать сторонние сниппеты в шаблоне и задавать свои условия отображения). | ||
* \+ Composer.json → Require. | ||
|
||
|
||
## Версия 1.2.2 (2020-02-11) | ||
* \* Внимание! Требуется (MODX)EvolutionCMS.libraries.ddTools >= 0.30. | ||
* \* Исправлена ошибка, при которой `result_itemsNumber` всегда было равно `'all'`. | ||
* \* Рефакторинг и прочие изменения. | ||
|
||
|
||
## Версия 1.2.1 (2018-12-09) | ||
* \* Исправлено неправильное имя переменной. | ||
|
||
|
||
## Версия 1.2 (2017-10-09) | ||
* \+ Добавлено указание шаблона `tpl` без чанка, через префикс `@CODE:` | ||
* \+ Добавлена возможность возвращать несколько родителей (см. параметры `result_itemsNumber` и `result_itemsGlue`). | ||
* \* Следующие параметры были переименованы (с обратной совместимостью): | ||
* \* `tpl` → `result_itemTpl`. | ||
* \* `toPlaceholder` → `result_toPlaceholder`. | ||
* \* `placeholderName` → `result_toPlaceholder_name`. | ||
* \* Результат сниппета возвращается всегда (пустой для пустой строки). | ||
* \* Внимание! Требуется PHP >= 5.4. | ||
* \* Внимание! Требуется (MODX)EvolutionCMS >= 1.1. | ||
* \* Внимание! Требуется (MODX)EvolutionCMS.libraries.ddTools >= 0.20. | ||
|
||
|
||
## Версия 1.1 (2014-11-05) | ||
* \+ Параметр `level` теперь может принимать отрицательные значения, чтобы задать уровень родителя с конца (`-1` соответствует последнему; `-2` — предпоследнему и т.д.). | ||
|
||
|
||
## Версия 1.0.1 (2013-08-10) | ||
* \* Если родителя нет (документ в корне), возвращается ID текущего документа. | ||
|
||
|
||
## Версия 1.0 (2011-12-18) | ||
* \+ Первый релиз. | ||
|
||
|
||
<link rel="stylesheet" type="text/css" href="https://raw.githack.com/DivanDesign/CSS.ddMarkdown/master/style.min.css" /> | ||
<style>ul{list-style:none;}</style> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,136 @@ | ||
# (MODX)EvolutionCMS.snippets.ddGetParentId | ||
|
||
Получает ID родителя(ей) необходимого уровня. | ||
|
||
|
||
## Использует | ||
* PHP >= 5.6 | ||
* [(MODX)EvolutionCMS](https://github.com/evolution-cms/evolution) >= 1.1 | ||
* [(MODX)EvolutionCMS.libraries.ddTools](https://code.divandesign.ru/modx/ddtools) >= 0.60 | ||
|
||
|
||
## Установка | ||
|
||
|
||
### Используя [(MODX)EvolutionCMS.libraries.ddInstaller](https://github.com/DivanDesign/EvolutionCMS.libraries.ddInstaller) | ||
|
||
Просто вызовите следующий код в своих исходинках или модуле [Console](https://github.com/vanchelo/MODX-Evolution-Ajax-Console): | ||
|
||
```php | ||
//Подключение (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 | ||
|
||
```php | ||
//Подключение (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 | ||
] | ||
]); | ||
``` | ||
|
||
|
||
## Ссылки | ||
|
||
* [Home page](https://code.divandesign.ru/modx/ddgetparentid) | ||
* [Telegram chat](https://t.me/dd_code) | ||
* [Packagist](https://packagist.org/packages/dd/evolutioncms-snippets-ddgetparentid) | ||
* [GitHub](https://github.com/DivanDesign/EvolutionCMS.snippets.ddGetParentId) | ||
|
||
|
||
<link rel="stylesheet" type="text/css" href="https://raw.githack.com/DivanDesign/CSS.ddMarkdown/master/style.min.css" /> |
Oops, something went wrong.