Health Check Error: Deprecated use of FontAwesome detected

Overview

The Health Check wizard must be run when upgrading in order to evaluate whether your instance is suitable for upgrade. The Health Check wizard detects a variety of issues that may affect your ability to upgrade. This article will cover how to resolve a "Deprecated use of FontAwesome detected" error reported by the health check.

Symptoms

This error generates the warning, "Deprecated use of FontAwesome detected", in health check.

Resolution

In Sugar 11.1 (Q3 2021), Sugar introduced a new font-based icon library to customers running SugarCRM in SugarCloud. The SugarIcon library replaced the Font Awesome library, which has been deprecated as of Sugar 11.2 (Q4 2021) and will be completely removed in an upcoming release. 

This Health Check scanner searches for "fa-*" customizations. Administrators must fix their code before the release where Font Awesome will be removed. The message is: "FontAwesome is deprecated as of 11.2 and will not be supported in 12.0. Use of FontAwesome detected in: '%s'." 

Adopting the new icon library will be easy since the implementation is similar to Font Awesome. SugarIcons will use "sicon" and "sicon-" CSS classes instead of "fa" and "fa-" classes. SugarIcon icon names are different from Font Awesome icon names. More details will be shared in future updates to Sugar Styleguide.

More information on this health check error can be found on the Sugar Developer Blog in SugarClub in the Sugar 11.1 (Q3 2021) Customization Guide and Sugar 11.2 (Q4 2021) Customization Guide.