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(6mo ago)0221[3 issues](https://github.com/netgroupgmbh/contao-icontoolkit/issues)[2 PRs](https://github.com/netgroupgmbh/contao-icontoolkit/pulls)1proprietaryPHPPHP ^8.2 Since Dec 15Pushed 1mo 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 today 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 38 — LowBetter than 83% of packages Maintenance79 Regular maintenance activity Popularity7 Limited adoption so far Community6 Small or concentrated contributor base Maturity50 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 200d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/3307250?v=4)[Netgroup Research Group](/maintainers/netgroup)[@netgroup](https://github.com/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 [metamodels/core MetaModels core 10156.4k67](/packages/metamodels-core)[codefog/contao-haste haste extension for Contao Open Source CMS 46676.5k170](/packages/codefog-contao-haste)[codefog/contao-news_categories News Categories bundle for Contao Open Source CMS 3189.0k6](/packages/codefog-contao-news-categories)[terminal42/contao-node Node bundle for Contao Open Source CMS 3177.0k6](/packages/terminal42-contao-node)[terminal42/contao-folderpage Provides a new page type for Contao that allows you to group pages into folders. 18156.0k10](/packages/terminal42-contao-folderpage)[madeyourday/contao-rocksolid-frontend-helper Frontend Editing for Contao. Stop stumbling through the backend and edit the elements you want easily and directly. 10132.3k3](/packages/madeyourday-contao-rocksolid-frontend-helper) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)