README

抓取节点或节点集合的随机子节点。

版本

Hfp Fetch Random 当前版本为 0.2.0
最后重大更新：2017年1月28日

原作者

刘斌 bin.liu@lagardere-active.com

版权

Hfp Fetch Random 版权所有 1999 - 2017 Brookins Consulting 和刘斌
查看： COPYRIGHT.md 以获取关于版权和许可条款的更多信息

许可

Hfp Fetch Random 使用 GNU 通用公共许可证。

完整的许可协议包含在 LICENSE 文件中。

Hfp Fetch Random 是自由软件：您可以在自由软件基金会发布的 GNU 通用公共许可证的条款下重新分发和/或修改它，无论是许可证的第 2 版还是您选择的任何后续版本。

Hfp Fetch Random 以希望其对您有用的方式分发，但没有任何保证；甚至没有关于适销性或适用于特定目的的隐含保证。有关详细信息，请参阅 GNU 通用公共许可证。

GNU GPL 在某些条件下授予您使用、修改和重新分发 Hfp Fetch Random 的权利。GNU GPL 许可证随软件一起分发，请参阅文件 doc/LICENSE。

它也可在 https://gnu.ac.cn/licenses/gpl.txt 获得。

您应该已经收到了 GNU 通用公共许可证的副本，与 Hfp Fetch Random 一起在 doc/LICENSE 中。如果没有，请参阅 https://gnu.ac.cn/licenses/。

在 GNU GPL 的条款下使用 Hfp Fetch Random 是免费的（指自由）。

有关更多信息或疑问，请联系： license@brookinsconsulting.com

需求

使用 Hfp Fetch Random 扩展需要以下需求

eZ Publish 版本

请确保您使用 eZ Publish 版本 5.x（必需）或更高版本。
设计与测试使用 eZ Publish Community Project GitHub Release 标签（通过 composer）v2015.01.3

PHP 版本

请确保您有 PHP 5.x 或更高版本。

功能

此解决方案提供以下功能

自定义内容抓取功能模块
- 抓取随机内容树节点对象

安装

通过 Composer 安装扩展

从您的项目根目录运行以下命令来安装扩展

bash$ composer require brookinsconsulting/hfpfetchrandom dev-master;

扩展激活

通过将以下内容添加到您的 settings/override/site.ini.append.php 来激活此扩展

[ExtensionSettings]
# <snip existing active extensions list />
ActiveExtensions[]=hfpfetchrandom

重新生成内核类覆盖自动加载

重新生成自动加载（必需）。

php ./bin/php/ezpgenerateautoloads.php;

清除缓存

清除 eZ Publish 平台 / eZ Publish Legacy 缓存（必需）。

php ./bin/php/ezcache.php --clear-all;

配置

目前不需要配置。

用法

默认情况下，安装正确后，解决方案配置为虚拟工作。

将提供的fetch函数添加到您的模板中。

使用选项

fetch( 'hfpfetchrandom', 'list',
 hash( 'parent_node_id',            parent_node_id,
     [ 'offset',                    offset,                    ]
     [ 'limit',                     limit,                     ]
     [ 'attribute_filter',          attribute_filter,          ]
     [ 'extended_attribute_filter', extended_attribute_filter, ]
     [ 'class_filter_type',         class_filter_type,         ]
     [ 'class_filter_array',        class_filter_array,        ]
     [ 'only_translated',           only_translated,           ]
     [ 'language',                  language,                  ]
     [ 'main_node_only',            main_node_only,            ]
     [ 'as_object',                 as_object,                 ]
     [ 'depth',                     depth,                     ]
     [ 'limitation',                limitation                 ]
     [ 'ignore_visibility',         ignore_visibility          ] ) )

返回值

一个ezcontentobjecttreenode对象的数组或FALSE。

使用示例1

以下示例hfpfetchrandom展示了如何使用fetch功能随机列出三个文件夹节点对象。

{def $tests = fetch( 'hfpfetchrandom', 'list', hash( 'parent_node_id', 2,
                                                     'offset',0,
                                                     'limit',3,
                                                     'class_filter_type',  'include',
                                                     'class_filter_array', array('folder')
                                                     ) )}
{foreach $tests as $test}
  {$test.name}
{/foreach}

故障排除

阅读常见问题解答

有些问题比其他问题更常见。最常见的问题列在doc/FAQ.md中

支持

如果您发现本文档或常见问题解答中未处理的问题，可以通过支持系统联系Brookins Consulting： http://brookinsconsulting.com/contact

brookinsconsulting / hfpfetchrandom

维护者

详细信息