Manual:Extension/FontAwesome: Difference between revisions

(Created page with "{{BSVersion|bsvFrom=4.3|bsvFeature=FontAwesome}} The icon library ''FontAwesome'' is available in BlueSpice. You can insert icons directly in source mode or via templates. ==Available icons== Available are all icons of type "Free" up to ''FontAwesome'' version 6. They are listed at: https://fontawesome.com/v6/search?o=r&m=free. The following icon styles are supported in the "Free"-Version of ''FontAwesome'': *'''Solid''' (always): Icons with CSS-class "fa-solid"...")
 
No edit summary
Tag: 2017 source edit
Line 13: Line 13:
*'''Regular''' (rareley): Icons mit CSS-class "fa-regular"  (current) or "far" (legacy)
*'''Regular''' (rareley): Icons mit CSS-class "fa-regular"  (current) or "far" (legacy)
*'''Brand''' (always) Brand-Icons mit CSS-class "fa-brand"  (current) or "far" (legacy)
*'''Brand''' (always) Brand-Icons mit CSS-class "fa-brand"  (current) or "far" (legacy)
[[Datei:FontAwesome icons.png|alternativtext=Screenshot der FontAwesome Icons-Übersicht, gefiltert für Icons vom Typ "Free"|zentriert|mini|750x750px|Verfügbare Icons]]
[[File:FontAwesome icons.png|alt=Screenshot of the FontAwesome icons selection, filterd for icons of type "Free"|center|thumb|750x750px|Available icons]]




Line 20: Line 20:


In addition, the bottom left corner shows in which version the icon has been added (screenshot annotation 5) . In BlueSpice 4.3, icons up to release version 6.2.1 can be used.
In addition, the bottom left corner shows in which version the icon has been added (screenshot annotation 5) . In BlueSpice 4.3, icons up to release version 6.2.1 can be used.
[[Datei:FontAwesome Icon-selection.png|alternativtext=Detail-Fenster für die Eigenschaften des Icons "utensils" mit hervorgehobenen Erklär-Hinweisen|zentriert|mini|750x750px|FontAwesome Icon-Info]]
[[File:FontAwesome Icon-selection.png|alt=Annotated details panel for the icon "utensils"|zentriert|mini|750x750px|FontAwesome Icon-Info]]





Revision as of 09:19, 18 August 2023

FontAwesome is available from BlueSpice 4.3.


The icon library FontAwesome is available in BlueSpice. You can insert icons directly in source mode or via templates.

Available icons

Available are all icons of type "Free" up to FontAwesome version 6.

They are listed at: https://fontawesome.com/v6/search?o=r&m=free.

The following icon styles are supported in the "Free"-Version of FontAwesome:

  • Solid (always): Icons with CSS-class "fa-solid" (current) or "fas" (legacy)
  • Regular (rareley): Icons mit CSS-class "fa-regular" (current) or "far" (legacy)
  • Brand (always) Brand-Icons mit CSS-class "fa-brand" (current) or "far" (legacy)
Screenshot of the FontAwesome icons selection, filterd for icons of type "Free"
Available icons


"light", "duotone" and "thin" variations are part of FontAwesome Pro and therefore not available in BlueSpice. The "Regular" style is available for some icons only. You can see this when you switch to the "Regular" variation of an icon (screenshot annotation 2) . A PRO reference will be shown next to the icon name (screenshot annotation 3).

In addition, the bottom left corner shows in which version the icon has been added (screenshot annotation 5) . In BlueSpice 4.3, icons up to release version 6.2.1 can be used. Annotated details panel for the icon "utensils"


Inserting the icon in source edit mode

To insert the icon in source edit mode:

  1. Search for an icon on the FontAwesome website and take note of its class name (see screenshot annotation 4).
  2. In the page source, add the corresponding parser function: Icon "Solid":
    {{#fas:fa-solid fa-utensils}}
    
    Icon "Regular" (if available as a "Free" icon):
    {{#fas:fa-regular fa-folder}}
    
    Brand icon:
    {{#fab:fa-brands fa-docker}}
    

Inserting the icon via template

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:

To embed an icon directly via template on a page, you can adapt the Template:Icon that is supplied with BlueSpice 4.3. This template can take FontAwesome icons into account if the corresponding parser functions are provided. In BlueSpice 4.3.1, they must be added manually. You can overwrite the template with the following content:

<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>

Now, the template can be selected from the visual editor toolbar via Insert > Template or as a ContentDroplet:

alternativtext=Eingabemaske der Vorlage:Icon|zentriert|mini|350x350px|FontAwesome Icon in der Vorlage:Icon



To submit feedback about this documentation, visit our community forum.