Xperience Font Awesome Integrator

This project is a .NET global tool that helps integrate Font Awesome 5 into the Kentico Xperience content management application.

It requires the .NET Core SDK to run at the command line (which should already be installed with Visual Studio).

View the NuGet Package

Adding Icons to Xperience

Kentico Xperience already provides a set of icons for developers and content editors to use in the content management application.

Icons can also be added to the default set, but this requires some customization if you are trying to integrate the Font Awesome 5 icons.

This global tool will handle all the file/folder processing for you. It works with the Free and Pro versions of Font Awesome 5.

Examples

First install the global tool:

dotnet tool install --global WiredViews.Xperience.FontAwesomeIntegrator

Extract the .zip file downloaded from Font Awesome's site.

Execute the tool to process and copy files to your CMS application

fpath is the path to the extracted Font Awesome content folder (containing /css, /webfonts, and /metadata folders). cpath is the path to your Xperience CMS application folder

> xperience-fa-integrator -fpath C:\dev\fontawesome-free-5.14.0-web -cpath C:\dev\Xperience\CMS

This tool does not include the copied files into your project. You will need to either edit the CMSApp.csproj project file and add the entries or use the Visual Studio Solution Explorer to add the files. If the files are not added to the project, they will not be included during deployments.

References

Font Awesome

• Icon Library
• Free Icons Download

.NET Global Tool Docs

• .NET Core SDK
• How to use a Global Tool

Kentico Docs

• Xperience Icon List
• Changing Page Type Icons
• Customizing Font Icons in Xperience

Blog Posts

• Kentico CMS Quick Tip: Using Font Awesome Icons for Custom Page Types to see the details of about the creation of this project.