README

本扩展是一个简单的 eZ Publish 平台（旧版）分享图标扩展，它使用内核覆盖扩展 bciconextensions，该扩展提供了一个基本但经过时间考验的内核覆盖类，修改后提供了一种灵活的解决方案，用于在 eZ Publish 扩展内存储分享图标主题图标，而不是在 eZ Publish 安装中进行内核修改。本扩展提供了一个使用 bciconextensions 提供的内核覆盖图标系统的实际应用的示例。非常适合聪明开发者！

这有助于覆盖或自定义默认的分享/图标主题图标图像文件。使用这个解决方案，您最终可以添加自己的自定义图标，这些图标与扩展中的自定义内容类匹配，并防止对 eZ Publish 平台（旧版）安装进行内核修改！

版本

BC Icon Extensions Share Icons 的当前版本为 0.1.0
最后重大更新：2017 年 8 月 12 日

版权

BC Icon Extensions Share Icons 版权所有 1999 - 2017 Brookins Consulting
更多信息请参阅：COPYRIGHT.md

许可证

BC Icon Extensions Share Icons 受 GNU 通用公共许可证的许可。

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

BC Icon Extensions Share Icons 是免费软件：您可以在自由软件基金会发布的 GNU 通用公共许可证的条款下重新分发和/或修改它，无论是许可证的第 2 版还是您选择的更高版本。

BC Icon Extensions Share Icons 以希望它将是有用的，但没有任何保证；甚至没有隐含的保证，即其商业性或适用于特定用途。请参阅 GNU 通用公共许可证以获取更多详细信息。

GNU GPL 在某些条件下赋予您使用、修改和重新分发 BC Icon Extensions Share Icons 的权利。GNU GPL 许可证与软件一起分发，请参阅 LICENSE 文件。

它也可以在https://gnu.ac.cn/licenses/gpl.txt找到。

您应该已经收到了与 BC Icon Extensions Share Icons 一起在 LICENSE 中提供的 GNU 通用公共许可证副本。

如果没有，请参阅https://gnu.ac.cn/licenses/。

在 GNU GPL 的条款下使用 BC Icon Extensions Share Icons 是免费的（作为自由）。

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

要求

使用 BC Icon Extensions Share Icons 扩展需要以下要求

eZ Publish 版本

请确保您使用 eZ Publish 版本 4.x（必需）或更高版本。
设计与 eZ Publish 社区项目 2014.11 测试

PHP 版本

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

功能

本解决方案提供以下功能

扩展分享图标覆盖
自定义设置/icon.ini 设置覆盖：settings/icon.ini.append.php

依赖项

本解决方案依赖于 eZ Publish 旧版和 config.php 中启用的内核类覆盖
bciconextensions 扩展

安装

通过 Composer 进行捆绑安装

从您的项目根目录运行以下命令以安装捆绑包

bash$ composer require brookinsconsulting/bciconextensions_share_icons dev-master;

扩展激活

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

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

内核类覆盖扩展不能通过ini设置激活。要使用此扩展及其解决方案的自定义设置，仍需要正常设置site.ini扩展激活设置。

启用eZ Publish内核覆盖

内核类覆盖只有在您将以下内容添加到您的eZ Publish Legacy config.php配置文件中时才能使用。

cp -va config.php-RECOMMENDED config.php;
# Edit config.php to set 'EZP_AUTOLOAD_ALLOW_KERNEL_OVERRIDE' to true. It should look like this:
define( 'EZP_AUTOLOAD_ALLOW_KERNEL_OVERRIDE', true );

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

重新生成内核类覆盖自动加载（必需）。

php ./bin/php/ezpgenerateautoloads.php --kernel-override;

清除缓存

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

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

安装重写规则

Apache重写规则

必需。要能够访问由图标扩展提供的图像文件，您必须将以下Apache mod_rewrite规则安装到您的web服务器虚拟主机配置中。

# bciconextensions required mod_rewrite rules to allow access to icon extension icon image files
RewriteRule ^/extension/[^/]+/icons/[^/]+/[^/]+/[^/]+/.* - [L]

Nginx重写规则

必需。要能够访问由图标扩展提供的图像文件，您必须将以下Nginx重写规则安装到您的web服务器虚拟主机配置中。

# bciconextensions required rewrite rules to allow access to icon extension icon image files
rewrite "^/extension/([^/]+)/icons/([^/]+)/([^/]+)/([^/]+)/(.*)" "/extension/$1/design/$2/$3/$4" break;

使用方法

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

此解决方案允许您在扩展中拥有图标主题。

这意味着您需要在安装、激活和配置此扩展后，然后创建自己的自定义共享/图标主题在自己的自定义扩展中。

历史记录

图标始终绑定到一个单一存储库。这使得整个图标引擎在eZ publish中感到不舒服，尤其是在多站点环境中。

有一个与模板引擎行为相似的图标引擎会更容易，它能够从不同的设计加载模板，使用回退设计，甚至可以从扩展中加载内容。

此解决方案实现了以下功能

通过扩展加载图标主题
有一个标准主题，当当前主题中找不到图标时，引擎将回退到该主题
有一个附加主题列表，在回退到标准主题之前，引擎将查找这些主题中的图标

使用方法 - 创建您自己的图标扩展

示例配置：要在扩展中拥有图标主题，请将它们放置在 /extensions/YOUREXTENSION/icons/YOURTHEME 中，其中 YOUREXTENSION 是您扩展的名称之一，YOURTHEME 是一个新主题。

然后在 [ExtensionSettings] 中设置设置 IconExtensions[] 为：IconExtensions[]=YOUREXTENSION

要使用附加主题，请使用 AdditionalThemeList[] 命名它们，例如：AdditionalThemeList[]=blue AdditionalThemeList[]=exotic

并确保它们存在于扩展或默认存储库中。

请注意：您的图标扩展（及其主题）的目录结构必须与默认安装中提供的eZ Publish Legacy share/icons内容的目录结构约定相匹配。您与默认期望匹配得越多，您将需要的ini设置配置设置覆盖就越少。

故障排除

阅读FAQ

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

支持

如果您在此文档或FAQ中找不到任何问题，您可以通过支持系统联系Brookins Consulting： http://brookinsconsulting.com/contact

brookinsconsulting / bciconextensions_share_icons

维护者

详情