IconToolkit

Eine Erweiterung für das Open Source CMS Contao, die Administrator:innen praktische Werkzeuge für den Einsatz von Font Awesome bereitstellt.

Mehr erfahren

Font Awesome Integration für Contao

Diese Software ist eine Erweiterung für das Open Source CMS Contao. Sie bietet Werkzeuge zur Verwendung von Font Awesome. Unter anderem stellt sie einen IconPicker für das Backend und ein Modul zur Einbindung der Assets für das Frontend zur Verfügung.

Aktuell wird Font Awesome 7.1.0 mit ausgeliefert.

Wir sind Contao Premium-Partner!

Als Contao Premium-Partner unterstützt Sie NetGroup® bei allen Contao-Fragen und -Projekten.
Von NetGroup. Für die Contao-Community.

Features des IconToolkits

Voraussetzungen

php: ^8.2
Contao: ^4.13 | ^5.0

Installation

Die Erweiterung kann bequem über den Contao Manager installiert werden. Einfach nach netgroup/icontoolkit suchen.

Alternativ via Composer:

composer require netgroup/icontoolkit

Verwendung

Backend Widget
Der IconPicker kann zur Auswahl eines Icons im Backend 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:

Frontend-Module
Das Frontend-Modul IconHelper bindet die benötigten CSS-Dateien ein. Es erzeugt selbst keine Ausgabe und dient ausschließlich der Einbindung der Icons.

Im Frontend können die Icons dann ganz normal verwendet werden:

<i class="fa-brands fa-contao"></i>

AssetHelper
Der AssetHelper ermöglicht eine einfache Einbindung des CSS für Icons, z. B. in eigenen Inhaltselementen oder Modulen.

use NetGroup\IconToolkit\Classes\Services\Helper\AssetHelper;

MyClass {
    public function __construct(private readonly AssetHelper $assetHelper)
    {
    }

    public function myFunction(): void
    {
        $this->assetHelper->incldueCss();
    }
}

Font Awesome

Die aktuelle Version von Font Awesome kann unter folgendem Link heruntergeladen werden: https://fontawesome.com/download

Aus dem Archiv werden folgende Inhalte benötigt:

Ordner css
Ordner webfonts
Datei metadata/icons.json

Alternative Icon-Packs

In den Einstellungen kann die CSS-Datei eines alternativen Icon-Packs 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.

Fragen zum IconToolkit?

Haben Sie Fragen zum IconToolkit?
Melden Sie sich gern bei uns. Wir beraten Sie – schnell, unkompliziert und unverbindlich!

Kontaktieren Sie uns!

Getestete Versionen

Die Erweiterung wurde erfolgreich mit folgenden Kombinationen aus PHP und Contao getestet:


✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓

Lizenz
Dieses Projekt steht unter der Apache 2.0 Lizenz.


✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓


✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓


✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓
✓	✓	✓