fullstackfreelancer/faicon

Provides Font Awesome Icons for the TYPO3 page settings in the backend, and Icons for the Bootstrap Package in the frontend.

2.0.0 2023-12-09 12:59 UTC

Requires

• typo3/cms-core: ^11.4.0 || ^12.4

Replaces

• typo3-ter/faicon: 2.0.0

GPL-3.0-or-later

• Simon Köhler

• css
• extension
• addon
• frontend
• icons
• typo3
• FontAwesome

README

What is Font Awesome Icon (faicon) for TYPO3?

Are you using the Bootstrap Package for TYPO3 and want to use FontAwesome Icons instead of the included icons? Then this extension is for you, because that's what it was made for. After installation, the extension provides you with the latest version of FontAwesome Icons, selectable in the page properties of each page. Modified main navigation templates are included for the bootstrap package. But of course you can also use the extension in combination with your own themes or extensions. All templates and paths are easy to change.

Features

• Adds a new field to the page properties that allows editors to select a FontAwesome Icon from a list
• Provides a Configuration for the latest Bootstrap Package, to add Icons to the Main Navigation
• Current version of Font Awesome: 6.5.1

Installation

Install the extension by downloading it in the extension manager or on https://extensions.typo3.org/extension/faicon/.

Basic configuration

You don't need to configure anything to get this extension running. But clear your caches after installing.

Using faicon with the Bootstrap Package

You can simply include the static TypoScript "Faicon: Icons for Bootstrap Package" into your root template to make faicon overwrite the template of the Bootstrap Package. The extension overwrites the main navigation template by adding a new partial root path like this:

page{
    10{
        partialRootPaths{
            0 = EXT:bootstrap_package/Resources/Private/Partials/Page/
            1 = EXT:bootstrap_package/Resources/Private/Partials/Page/
            5 = EXT:faicon/Resources/Private/BootstrapPackage/Partials/Page/ (new path by faicon)
        }
    }
}

If you want to change the order of the paths, or the sequential number is already used by another extension, you can do that by adding a few lines in your TypoScript setup:

// Adding a new path (use any random number that is higher than the last existing one)
page.10.partialRootPaths.765 = EXT:faicon/Resources/Private/BootstrapPackage/Partials/Page/

// Alternative: Clear the entry and set a new path
page.10.partialRootPaths.5 >
page.10.partialRootPaths.5 = mypath/myfolder/

Example Usage in your Fluid-Templates

Example of using the icon field in a menu. (Assuming your menu entry has the variable name "{menu}")

<a class="nav-link">
   <f:if condition="{menu.data.tx_faicon_icon}">
       <i class="{menu.data.tx_faicon_icon}"></i>
   </f:if> {menu.title}
</a>

Support Development

I believe in the power of open source and free software. I also believe in you and your projects. If you like my work and you want to ensure further development, please support it here:

• https://paypal.me/fullstackfreelancer

Support & Service

If you have any issues with the extension, please let me know! Don't hesitate to send a message: https://simonkoehler.com/contact

Hire Simon Köhler as a TYPO3 or PHP Freelancer

• https://simonkoehler.com