PHPackages netgroup/icontoolkit - 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. [Utility & Helpers](/categories/utility) 4. / 5. netgroup/icontoolkit ActiveContao-bundle[Utility & Helpers](/categories/utility) netgroup/icontoolkit ==================== Bei dieser Software handelt es sich um eine Erweiterung für das Open Source CMS Contao, sie bietet Werkzeuge zur Verwendung von \[Font Awesome\](https://fontawesome.com/). Unter anderem stellt sie ein IconPicker für das Backend und ein Modul zur Einbindung der Assets für das Frontend zur Verfügung. 1.0.0(5mo ago)0181[3 issues](https://github.com/netgroupgmbh/contao-icontoolkit/issues)[2 PRs](https://github.com/netgroupgmbh/contao-icontoolkit/pulls)1proprietaryPHPPHP ^8.2 Since Dec 15Pushed 5mo agoCompare [ Source](https://github.com/netgroupgmbh/contao-icontoolkit)[ Packagist](https://packagist.org/packages/netgroup/icontoolkit)[ Docs](https://www.netgroup.de/icontoolkit.html)[ RSS](/packages/netgroup-icontoolkit/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (4)Versions (4)Used By (1) IconToolkit =========== [](#icontoolkit) Beschreibung ------------ [](#beschreibung) Bei dieser Software handelt es sich um eine Erweiterung für das Open Source CMS Contao. Sie bietet Werkzeuge zur Verwendung von [Font Awesome](https://fontawesome.com/). Unter anderem stellt sie ein IconPicker für das Backend und ein Modul zur Einbindung der Assets für das Frontend zur Verfügung. Font Awesome 7.1.0 wird mit ausgeliefert. Autor ----- [](#autor) **NetGroup GmbH:** Patrick Froch Support ------- [](#support) NetGroup Gesellschaft für Informationstechnologien in Deutschland mbH Kaiserstraße 67 44135 Dortmund Kontakt: Telefon: +49 231 557509-0 Telefax: +49 231 557509-99 E-Mail: Internet: Voraussetzungen --------------- [](#voraussetzungen) - php: ^8.2 - Contao: ^4.13 | ^5.0 Installation ------------ [](#installation) Die Erweiterung kann bequem über den **Contao Manager** installiert werden. Einfach nach `netgroup/userguide` suchen. Alternativ via Composer: ``` composer require netgroup/icontoolkit ``` Verwendung ---------- [](#verwendung) ### Backend Widget [](#backend-widget) Das Backend Widget kann für die Auswahl eines Icons verwendet werden. ``` $GLOBALS['TL_DCA'][$table]['palettes']['text'] .= ';{icon_legend},icotest;'; $GLOBALS['TL_DCA']['tl_content']['fields']['icotest'] = [ 'label' => &$GLOBALS['TL_LANG'][$table]['icotest'], 'inputType' => IconPickerWidget::TYPE, 'eval' => ['maxlength'=>255, 'tl_class' => 'w50'], 'sql' => "varchar(255) NOT NULL default ''" ]; ``` Die Ausgabe sieht dann wie folgt aus: [![widget.png](widget.png)](widget.png) ### Frontend Module [](#frontend-module) Für das Einbinden des CSS gibt es das Frontend Modul "IconHelper". Es bindet nur das CSS ein und erzeugt sonst keine Ausgabe. Im Frontend können die Icons ganz normal verwendet werden: ``` ``` ### AssetHelper [](#assethelper) Mit dem `AssetHelper` kann ganz einfach das CSS für die Icons eingebunden werden. Er kann z. B. in eigenen Inhaltselementen, oder Module verwendet werden. ``` use NetGroup\IconToolkit\Classes\Services\Helper\AssetHelper; MyClass { public function __construct(private readonly AssetHelper $assetHelper) { } public function myFunction(): void { $this->assetHelper->incldueCss(); } } ``` Font Awesome ------------ [](#font-awesome) Die aktuelle Version von Font Awesome kann auf folgender Seite bezogen werden: Aus dem Archiv werden die Ordner `css` und `webfonts`, sowie die Daten `metadata/icons.json` benötigt. Alternative Icon Packs ---------------------- [](#alternative-icon-packs) In den Einstellungen an die CSS-Datei eines alternativen Iconpacks ausgewählt werden. Zusätzlich muss die JSON-Datei mit der Definition der Icons ausgewählt werden. *(Diese muss dem Aufbau der Datei `metadata/icons.json` von Font Awesome entsprechen)* Mitwirken --------- [](#mitwirken) Beiträge sind herzlich willkommen! Bitte erstellen Sie bei größeren Änderungen zunächst ein Issue, um die geplanten Anpassungen zu besprechen. Pull Requests sollten mit entsprechenden Tests ergänzt werden. Tests ----- [](#tests) Tests können mit folgendem Skript im Wurzelverzeichnis der Erweiterung ausgeführt werden: ``` ./build/runtests.sh ``` *(Dies setzt voraus, dass die Erweiterung unter `CONTAO_ROOT/src/NetGroup/IconToolkit` installiert ist. Ist dies nicht der Fall, müssen die Testtools einzeln aufgerufen werden. Die Kommandos stehen in der oben genannten Datei.)* Getestete Versionen ------------------- [](#getestete-versionen) Die Erweiterung wurde erfolgreich mit folgenden Kombinationen aus PHP und Contao getestet: Contao[![PHP 8.2](https://camo.githubusercontent.com/dd14c71d22c26965797476c88c43ebb2ba06db225049c4496c17682cfe2e7dea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253230253230382e322d2532333838393242463f6c6f676f3d504850)](https://camo.githubusercontent.com/dd14c71d22c26965797476c88c43ebb2ba06db225049c4496c17682cfe2e7dea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253230253230382e322d2532333838393242463f6c6f676f3d504850)[![PHP 8.3](https://camo.githubusercontent.com/6c1cea9be23b7b925f494231eb3b97131b390346ff40272414eaa1091190aa43/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253230253230382e332d2532333838393242463f6c6f676f3d504850)](https://camo.githubusercontent.com/6c1cea9be23b7b925f494231eb3b97131b390346ff40272414eaa1091190aa43/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253230253230382e332d2532333838393242463f6c6f676f3d504850)[![PHP 8.4](https://camo.githubusercontent.com/a605faeed2375fec37eddb6b2558d47b91d14d114706b26e73f737eac8cba79a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253230253230382e342d2532333838393242463f6c6f676f3d504850)](https://camo.githubusercontent.com/a605faeed2375fec37eddb6b2558d47b91d14d114706b26e73f737eac8cba79a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253230253230382e342d2532333838393242463f6c6f676f3d504850)[![Contao 4.13](https://camo.githubusercontent.com/b10a2ff05626655b373ffeba9b4ecb2c823163f9f78ac464690ea718042205df/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230342e31332d6f72616e67653f6c6f676f3d436f6e74616f)](https://camo.githubusercontent.com/b10a2ff05626655b373ffeba9b4ecb2c823163f9f78ac464690ea718042205df/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230342e31332d6f72616e67653f6c6f676f3d436f6e74616f)✓✓✓[![Contao 5.0](https://camo.githubusercontent.com/40491aad26a4c27a1082a6e90be97787706a47ae705398c014d870a05d19c657/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e302d6f72616e67653f6c6f676f3d436f6e74616f)](https://camo.githubusercontent.com/40491aad26a4c27a1082a6e90be97787706a47ae705398c014d870a05d19c657/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e302d6f72616e67653f6c6f676f3d436f6e74616f)✓✓✓[![Contao 5.1](https://camo.githubusercontent.com/2042149bbd3a54477b8b4d113a5033e52a812f8baa0b84f57912a2473d961f8c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e312d6f72616e67653f6c6f676f3d436f6e74616f)](https://camo.githubusercontent.com/2042149bbd3a54477b8b4d113a5033e52a812f8baa0b84f57912a2473d961f8c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e312d6f72616e67653f6c6f676f3d436f6e74616f)✓✓✓[![Contao 5.2](https://camo.githubusercontent.com/902b30d49dd8e9f6df9a8b10b48eedc5c7a44dfde7dbee36d7fe805b3d69fc95/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e322d6f72616e67653f6c6f676f3d436f6e74616f)](https://camo.githubusercontent.com/902b30d49dd8e9f6df9a8b10b48eedc5c7a44dfde7dbee36d7fe805b3d69fc95/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e322d6f72616e67653f6c6f676f3d436f6e74616f)✓✓✓[![Contao 5.3](https://camo.githubusercontent.com/0fbc5f708d4d69330415588819b219383c062bc4fd270f8c1fc588e365456674/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e332d6f72616e67653f6c6f676f3d436f6e74616f)](https://camo.githubusercontent.com/0fbc5f708d4d69330415588819b219383c062bc4fd270f8c1fc588e365456674/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e332d6f72616e67653f6c6f676f3d436f6e74616f)✓✓✓[![Contao 5.4](https://camo.githubusercontent.com/642201ab6f14cb0c836324e506462c83a4c6249abec30a1278213ae8154fac20/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e342d6f72616e67653f6c6f676f3d436f6e74616f)](https://camo.githubusercontent.com/642201ab6f14cb0c836324e506462c83a4c6249abec30a1278213ae8154fac20/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e342d6f72616e67653f6c6f676f3d436f6e74616f)✓✓✓[![Contao 5.5](https://camo.githubusercontent.com/ac952d90da50ffc45b17d4d3661761f1a5686148ae25796ea1ad29ea81cfe6e3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e352d6f72616e67653f6c6f676f3d436f6e74616f)](https://camo.githubusercontent.com/ac952d90da50ffc45b17d4d3661761f1a5686148ae25796ea1ad29ea81cfe6e3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e74616f2533412d253230352e352d6f72616e67653f6c6f676f3d436f6e74616f)✓✓✓Lizenz ------ [](#lizenz) Dieses Projekt steht unter der [Apache 2.0 Lizenz](https://choosealicense.com/licenses/apache-2.0/). ### Health Score 36 — LowBetter than 82% of packages Maintenance73 Regular maintenance activity Popularity8 Limited adoption so far Community6 Small or concentrated contributor base Maturity49 Maturing project, gaining track record 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. ### Release Activity Cadence Unknown Total 1 Last Release 154d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1a45e3efba99c41e76b8633cef8e42d442e62d86e6b1edd9790923a1e33f6ee9?d=identicon)[netgroup](/maintainers/netgroup) --- Tags contaofont-awesome ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/netgroup-icontoolkit/health.svg) ``` [![Health](https://phpackages.com/badges/netgroup-icontoolkit/health.svg)](https://phpackages.com/packages/netgroup-icontoolkit) ``` ### Alternatives [codefog/contao-haste haste extension for Contao Open Source CMS 42650.8k139](/packages/codefog-contao-haste)[madeyourday/contao-rocksolid-custom-elements Create your own, nestable content elements using a modular system. End the WYSIWYG chaos with your own content elements. 50341.9k12](/packages/madeyourday-contao-rocksolid-custom-elements)[codefog/contao-news_categories News Categories bundle for Contao Open Source CMS 3183.3k6](/packages/codefog-contao-news-categories)[terminal42/contao-folderpage Provides a new page type for Contao that allows you to group pages into folders. 18147.9k9](/packages/terminal42-contao-folderpage)[inspiredminds/contao-wowjs Integrates WOW.js for Contao content elements and form fields. 1813.0k](/packages/inspiredminds-contao-wowjs)[inspiredminds/contao-glightbox Contao extension to integrate GLightbox. 1223.3k1](/packages/inspiredminds-contao-glightbox) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)