Handbuch:Erweiterung/FontAwesome: Unterschied zwischen den Versionen

Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Markierung: 2017-Quelltext-Bearbeitung
 
(2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{BSVersion|bsvFrom=4.3|bsvFeature=FontAwesome}}
{{BSVersion|bsvFrom=4.3|bsvFeature=FontAwesome}}


Die Icon-Bibliothek von FontAwesome ist in BlueSpice verfügbar.  Die Icons können direkt im Quelltext oder über Vorlagen auf einer Seite eingebunden werden.
Die Icon-Bibliothek von ''FontAwesome'' ist in BlueSpice verfügbar.  Die Icons können direkt im Quelltext oder über Vorlagen auf einer Seite eingebunden werden.


== Verfügbare Icons ==
== Verfügbare Icons ==
Zeile 42: Zeile 42:
</syntaxhighlight>Die Vorlage kann nun über ''Einfügen > Vorlage'' oder als [[Handbuch:Erweiterung/ContentDroplets|ContentDroplet]] ausgewählt werden:
</syntaxhighlight>Die Vorlage kann nun über ''Einfügen > Vorlage'' oder als [[Handbuch:Erweiterung/ContentDroplets|ContentDroplet]] ausgewählt werden:
[[Datei:FontAwesome icon-template.png|alternativtext=Eingabemaske der Vorlage:Icon|zentriert|mini|350x350px|FontAwesome Icon in der Vorlage:Icon ]]
[[Datei:FontAwesome icon-template.png|alternativtext=Eingabemaske der Vorlage:Icon|zentriert|mini|350x350px|FontAwesome Icon in der Vorlage:Icon ]]
{{translation}}

Aktuelle Version vom 18. August 2023, 09:04 Uhr

FontAwesome ist ab BlueSpice 4.3 enthalten.


Die Icon-Bibliothek von FontAwesome ist in BlueSpice verfügbar. Die Icons können direkt im Quelltext oder über Vorlagen auf einer Seite eingebunden werden.

Verfügbare Icons[Bearbeiten | Quelltext bearbeiten]

Verfügbar sind alle Icons vom Typ "Free" bis Version 6 von FontAwesome.

Diese finden Sie auf: https://fontawesome.com/v6/search?o=r&m=free.

In der "Free"-Version von FontAwesome werden folgende Stile unterstützt:

  • Solid (immer): Icons mit CSS-class "fa-solid" (aktuelle Schreibweise) oder "fas" (Legacy-Modus)
  • Regular (selten): Icons mit CSS-class "fa-regular" (aktuelle Schreibweise) oder "far" (Legacy-Modus)
  • Brand (immer) Brand-Icons mit CSS-class "fa-brand" (aktuelle Schreibweise) oder "far" (Legacy-Modus)
Screenshot der FontAwesome Icons-Übersicht, gefiltert für Icons vom Typ "Free"
Verfügbare Icons


"light", "duotone" und "thin" Variationen sind Bestandteil von FontAwesome Pro und daher nicht in BlueSpice verwendbar. Ob der Stil "Regular" für ein bestimmtes Icon verfügbar ist, sehen Sie, wenn Sie auf die Variation "Regular" wechseln (Screenshot Anmerkung 2) . Links oben neben dem Icon-Namen wird dann entsprechend ein PRO-Hinweis (Screenshot Anmerkung 3) angezeigt oder nicht.

Zusätzlich sehen Sie links unten, in welcher Version das Icon hinzugefügt wurde (Screenshot Anmerkung 5) . In BlueSpice 4.3 funktionieren Icons bis Release-Version 6.2.1.

Detail-Fenster für die Eigenschaften des Icons "utensils" mit hervorgehobenen Erklär-Hinweisen
FontAwesome Icon-Info


Einbindung im Quelltext[Bearbeiten | Quelltext bearbeiten]

So binden Sie ein Icon im Quelltext ein:

  1. Suchen Sie auf der FontAwesome-Website den class-Namen des Icons (siehe Screenshot Anmerkung 4).
  2. Geben Sie im Quelltext die zugehörige Parser-Funktion ein: Icon-Stil "Solid":
    {{#fas:fa-solid fa-utensils}}
    
    Icon-Stil "Regular" (falls vorhanden als "Free"-Icon:
    {{#fas:fa-regular fa-folder}}
    
    Brand-Icon:
    {{#fab:fa-brands fa-docker}}
    

Einbindung über Vorlage[Bearbeiten | Quelltext bearbeiten]

Um ein Icon direkt über Vorlage auf einer Seite einzubinden, können Sie die ab BlueSpice 4.3 mitgelieferte Vorlage:Icon anpassen. Diese kann FontAwesome-Icons berücksichtigen, wenn die entsprechenden Parserfunktionen hier leer mitgegeben werden. In BlueSpice 4.3.1 müssen diese nachträglich hinzugefügt werden. Die Vorlage können Sie mit folgendem Inhalt überschreiben:

<includeonly><span class="{{{1|bi bi-clock}}}" style="{{#if:{{{2|}}}|font-size:{{{2|}}};|}}{{#if:{{{3|}}}|color:{{{3|}}};|}}vertical-align:{{#if:{{{4|}}}|vertical-align:{{{4|}}};|text-top}};></span><span style="height:0; overflow:hidden;">{{#fas:}}{{#far:}}{{#fab:}}</span></includeonly>

Die Vorlage kann nun über Einfügen > Vorlage oder als ContentDroplet ausgewählt werden:

Eingabemaske der Vorlage:Icon
FontAwesome Icon in der Vorlage:Icon




Feedback zur Dokumentation ist im Community-Forum möglich.