PHPackages brookinsconsulting/bciconextensions - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. brookinsconsulting/bciconextensions ActiveEzpublish-legacy-extension brookinsconsulting/bciconextensions =================================== eZ Publish Legacy extension which provides a basic but time tested kernel override class modified to offer flexible solution for storing share/icon theme icons within eZ Publish extensions instead of kernel hacking your eZ Publish installation. Great for smart developers! 242PHP Since Aug 29Pushed 8y ago1 watchersCompare [ Source](https://github.com/brookinsconsulting/bciconextensions)[ Packagist](https://packagist.org/packages/brookinsconsulting/bciconextensions)[ RSS](/packages/brookinsconsulting-bciconextensions/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependenciesVersions (1)Used By (0) BC Icon Extensions ================== [](#bc-icon-extensions) This extension is a simple eZ Publish Platform (Legacy) kernel override extension which provides a basic but time tested kernel override class modified to offer flexible solution for storing share/icon theme icons within eZ Publish extensions instead of kernel hacking your eZ Publish installation. Great for smart developers! With this kernel class override installed and enabled you can override the default features which detect share/icon theme(s) and with this solution by default you can detect share/icon theme(s) within extensions. This is helpful and useful for overriding or customizing the default share/icon theme(s) icon image files. With this solution you can finally add your own custom icons which match your custom content classes within an extension and prevent kernel hacking your eZ Publish Platform (Legacy) installation! Version ======= [](#version) - The current version of BC Icon Extensions is 0.1.2 - Last Major update: April 05, 2017 Copyright ========= [](#copyright) - BC Icon Extensions is copyright 1999 - 2017 Brookins Consulting and eZ Systems AS - See: [COPYRIGHT.md](COPYRIGHT.md) for more information on the terms of the copyright and license License ======= [](#license) BC Icon Extensions is licensed under the GNU General Public License. The complete license agreement is included in the [LICENSE](LICENSE.md) file. BC Icon Extensions is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License or at your option a later version. BC Icon Extensions is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. The GNU GPL gives you the right to use, modify and redistribute BC Icon Extensions under certain conditions. The GNU GPL license is distributed with the software, see the file LICENSE. It is also available at You should have received a copy of the GNU General Public License along with BC Icon Extensions in LICENSE. If not, see . Using BC Icon Extensions under the terms of the GNU GPL is free (as in freedom). For more information or questions please contact: Requirements ============ [](#requirements) The following requirements exists for using BC Icon Extensions extension: ### eZ Publish version [](#ez-publish-version) - Make sure you use eZ Publish version 4.x (required) or higher. - Designed and tested with eZ Publish Community Project 2014.11 ### PHP version [](#php-version) - Make sure you have PHP 5.x or higher. Features ======== [](#features) This solution provides the following features: - Kernel Module Class Override Class: eZWordToImageOperator - Custom settings/icon.ini settings and settings overrides: settings/icon.ini.append.php ### Dependencies [](#dependencies) - This solution depends on eZ Publish Legacy and kernel class overrides enabled in config.php ### Kernel class override [](#kernel-class-override) This solution overrides the following kernel class: - PHP Class : `eZWordToImageOperator` - Found by default at: `kernel/common/ezwordtoimageoperator.php` This solution provides the following kernel class override: - PHP Class : `eZWordToImageOperator` - Found by at: `extension/bciconextensions/classes/kerneloverride/v2017.02.0/kernel/common/ezwordtoimageoperator.php` **Note**: This solution requires only one legacy kernel class override of a class that is very stable and not subject to much change (if at all) per release (which is important for maintainability). The class has not been modified or [needed a bugfix since early 2014](https://github.com/ezsystems/ezpublish-legacy/blob/master/kernel/common/ezwordtoimageoperator.php). Installation ============ [](#installation) ### Bundle Installation via Composer [](#bundle-installation-via-composer) Run the following command from your project root to install the bundle: ``` bash$ composer require brookinsconsulting/bciconextensions dev-master; ``` ### Extension Activation [](#extension-activation) Required. Activate this extension by adding the following to your `settings/override/site.ini.append.php`: ``` [ExtensionSettings] # ActiveExtensions[]=bciconextensions ``` Kernel class override extensions are **not** activated via ini settings. Normal site.ini extension activation settings are still required to use this extension and it's solution's custom settings. ### Enable eZ Publish Kernel Overrides [](#enable-ez-publish-kernel-overrides) Kernel class overrides are only able to be used if you add the following to your eZ Publish Legacy config.php configuration file. ``` 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 ); ``` ### Regenerate kernel class override autoloads [](#regenerate-kernel-class-override-autoloads) Regenerate kernel class override autoloads (Required). ``` php ./bin/php/ezpgenerateautoloads.php --kernel-override; ``` ### Clear the caches [](#clear-the-caches) Optional. Clear eZ Publish Platform / eZ Publish Legacy caches (Required). ``` php ./bin/php/ezcache.php --clear-all; ``` ### Install Rewrite Rules [](#install-rewrite-rules) #### Apache Rewrite Rules [](#apache-rewrite-rules) Required. To be able to access the image files provided by an icon extension you must install the following apache mod\_rewrite rule into your webserver's virtual host configuration. ``` # bciconextensions required mod_rewrite rules to allow access to icon extension icon image files RewriteRule ^/extension/[^/]+/icons/[^/]+/[^/]+/[^/]+/.* - [L] ``` #### Nginx Rewrite Rules [](#nginx-rewrite-rules) Required. To be able to access the image files provided by an icon extension you must install the following nginx rewrite rule into your webserver's virtual host configuration. ``` # bciconextensions required rewrite rules to allow access to icon extension icon image files rewrite "^/extension/([^/]+)/icons/([^/]+)/([^/]+)/([^/]+)/(.*)" "/extension/$1/icons/$2/$3/$4" break; ``` Usage ===== [](#usage) The solution is configured to work virtually by default once properly installed. This solution allows you have to icon themes in extensions. This means you install, activate and configure this extension in your installation and then create your own custom share/icon themes in your own custom extension. History ======= [](#history) Icons are always bound to one single repository. This makes the hole icon-engine in eZ publish uncomfortable, especially in mulit-site environments. It is much easier to have an icon engine, behaving similar to the template engine, which is capable of loading templates out of different designs, using a fallback design and even can load things from extensions. This solution implements the following features: 1. Load icon themes via a extensions 2. Have a standard theme on which the engine falls back if an icon can't be found in the current theme 3. Have a list of additional themes, where the engine looks for icons before falling back to the standard theme Usage - Creating your own icon extension ======================================== [](#usage---creating-your-own-icon-extension) Sample configuration: To have icon themes in an extension, place them in /extensions/YOUREXTENSION/icons/YOURTHEME, where YOUREXTENSION is the name of one of your extensions and YOURTHEME is a new theme. Then set in \[ExtensionSettings\] the setting IconExtensions\[\] to: IconExtensions\[\]=YOUREXTENSION To make use of additional themes, name them using AdditionalThemeList\[\], eg.: AdditionalThemeList\[\]=blue AdditionalThemeList\[\]=exotic And make shure they exists either in an extension or in the default repository. *Please note:* The directory structure of your icon extension (and it's themes) must match the directory structure conventions of the eZ Publish Legacy share/icons content provided in a default installation. The more you match the defaults expected the less ini setting configuration settings override you will require. Troubleshooting =============== [](#troubleshooting) ### Read the FAQ [](#read-the-faq) Some problems are more common than others. The most common ones are listed in the the [doc/FAQ.md](doc/FAQ.md) ### Support [](#support) If you have find any problems not handled by this document or the FAQ you can contact Brookins Consulting through the support system: ### Health Score 22 — LowBetter than 23% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity11 Limited adoption so far Community7 Small or concentrated contributor base Maturity41 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://www.gravatar.com/avatar/fda10bb840bcf345ab87d5ec5bd7c79da0be8858fc1b754db272ca1fc45e49e2?d=identicon)[brookinsconsulting](/maintainers/brookinsconsulting) --- Top Contributors [![brookinsconsulting](https://avatars.githubusercontent.com/u/617031?v=4)](https://github.com/brookinsconsulting "brookinsconsulting (1 commits)") --- Tags classextensionezpublishezpublishlegacyezpublishplatformicon-themeiconskernel-overridelegacyphpsettingsshare-iconsthemes ### Embed Badge ![Health badge](/badges/brookinsconsulting-bciconextensions/health.svg) ``` [![Health](https://phpackages.com/badges/brookinsconsulting-bciconextensions/health.svg)](https://phpackages.com/packages/brookinsconsulting-bciconextensions) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)