dd/evolutioncms-snippets-ddgetparentid

此软件包最新版本(1.4.0)没有可用的许可信息。

获取所需级别的文档父ID。

1.4.0 2023-09-03 23:42 UTC

This package is auto-updated.

Last update: 2024-09-06 07:36:15 UTC


README

获取所需级别的文档父ID。

需求

安装

使用 (MODX)EvolutionCMS.libraries.ddInstaller

只需在您的源代码中运行以下PHP代码或 控制台

//Include (MODX)EvolutionCMS.libraries.ddInstaller
require_once(
	$modx->getConfig('base_path') .
	'assets/libs/ddInstaller/require.php'
);

//Install (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. 类别:核心
  4. 解析文档块:
  5. 片段代码(PHP):从存档中插入 ddGetParentId_snippet.php 文件的内容。

2. 元素 → 管理文件

  1. 创建一个新的文件夹 assets/snippets/ddGetParentId/
  2. 将存档解压缩到该文件夹(除 ddGetParentId_snippet.php 外)。

参数描述

  • id

    • 描述:文档ID。
    • 有效值:整数
    • 默认值:[*id*](当前文档)
  • level

    • 描述:父级级别。
    • 有效值
      • 1 — 立即父级
      • 2 — 立即父级的父级
      • -1 — 最后一个父级
      • -2 — 最后一个父级之前的父级
      • 整数 — 依此类推
    • 默认值:1
  • result_itemsNumber

    • 描述:将返回的父级数量。
    • 有效值
      • 整数
      • 'all'
    • 默认值:1
  • result_itemTpl

    • 描述:输出模板。
      解析模板后忽略空项(您可以在模板中调用第三方片段并设置自己的显示条件)。
      可用占位符
      • [+id+] — 父级ID。
    • 有效值
      • stringChunkName
      • 字符串 — 使用以 @CODE: 开头的内联模板。
    • 默认值:'@CODE:[+id+]'
  • result_itemsGlue

    • 描述:在渲染时组合项的字符串。
    • 有效值:字符串
    • 默认值:''
  • result_toPlaceholder

    • 描述:将值返回到占位符。
    • 有效值
      • 0
      • 1
    • 默认值:0
  • result_toPlaceholder_name

    • 描述:占位符名称。
    • 有效值:字符串
    • 默认值:'ddParent'

示例

通过 \DDTools\Snippet::runSnippet 运行片段,不使用数据库和 eval

//Include (MODX)EvolutionCMS.libraries.ddTools
require_once(
	$modx->getConfig('base_path') .
	'assets/libs/ddTools/modx.ddtools.class.php'
);

//Run (MODX)EvolutionCMS.snippets.ddGetParentId
\DDTools\Snippet::runSnippet([
	'name' => 'ddGetParentId',
	'params' => [
		'level' => -1
	]
]);

链接