PHPackages                             refresj/rfrsj-font-awesome - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. refresj/rfrsj-font-awesome

ActiveTypo3-cms-extension[Utility &amp; Helpers](/categories/utility)

refresj/rfrsj-font-awesome
==========================

Font Awesome for CKEditor - Integrates Font Awesome 7 Pro+ icons into the CKEditor 5 RTE! Font Awesome license required and not included.

v14.4.0(1mo ago)01GPL-2.0-or-laterHTMLPHP ^8.5

Since May 27Pushed 1mo agoCompare

[ Source](https://github.com/NitinParri/rfrsj_font_awesome)[ Packagist](https://packagist.org/packages/refresj/rfrsj-font-awesome)[ RSS](/packages/refresj-rfrsj-font-awesome/feed)WikiDiscussions main Synced 2w ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

Font Awesome for CKEditor
=========================

[](#font-awesome-for-ckeditor)

[![Donate](https://camo.githubusercontent.com/1b2c869e873ef682c4c5bad88c215509a70e51f7b2616579e84c098ed79df985/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f50617950616c2d446f6e6174652d677265656e3f7374796c653d666f722d7468652d6261646765266c6f676f3d70617970616c266c6f676f436f6c6f723d303032393931266c6162656c436f6c6f723d646464646464)](https://paypal.me/NitinParri)[![TYPO3](https://camo.githubusercontent.com/35b260175b3e7ccb6d9911bc54dd0e927af59279a64f54a2d16186ae7a35131a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5459504f332d726672736a5f5f666f6e745f5f617765736f6d652d4646383630303f7374796c653d666f722d7468652d6261646765266c6f676f3d7479706f33266c6f676f436f6c6f723d464638363030266c6162656c436f6c6f723d646464646464)](https://extensions.typo3.org/extension/rfrsj_font_awesome)[![Repo](https://camo.githubusercontent.com/c9c850c7af1ad6138c5b2460f68f2b563a43709add8f9ba38ba7e5a877a4666d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4769746875622d7265706f2d626c75653f7374796c653d666f722d7468652d6261646765266c6f676f3d676974687562266c6f676f436f6c6f723d313831373137266c6162656c436f6c6f723d646464646464)](https://github.com/NitinParri/rfrsj_font_awesome)[![Latest Stable version](https://camo.githubusercontent.com/48ededd6bfdfe0752b3f784eea6fb6071e0ecdd615ad4e0492d263933767993e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7265667265736a2f726672736a2d666f6e742d617765736f6d653f7374796c653d666f722d7468652d6261646765266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d313831373137266c6162656c436f6c6f723d646464646464)](https://packagist.org/packages/refresj/rfrsj-font-awesome)

TYPO3 extension that integrates Font Awesome 7 Pro+ icons into the CKEditor 5 rich text editor. Provides a toolbar button to browse and insert Font Awesome icons directly into content with extra options. *Inspired by the TYPO3 extension rte\_ckeditor\_fontawesome.*

Features
--------

[](#features)

- Browse and insert Font Awesome icons via a modal dialog in CKEditor 5
- Supports Font Awesome 7.2 Pro+ icon packs with all styles: Classic, Sharp, Duotone, Sharp Duotone and Brands
- Filter icons by icon pack and style or search icons by name
- Set extra options: Size, Animation, Rotation, Pull and/or Auto width
- CSS files can be configured once via Site Settings and are automatically applied to CKEditor (and optionally to the frontend)
- **Font Awesome is not included!** You have to purchase a license and upload the required files so you can include the CSS files by setting the correct paths in Site Settings.

Requirements
------------

[](#requirements)

RequirementVersionPHP^8.5TYPO3 CMS^14.3Installation
------------

[](#installation)

Install the extension

Configuration
-------------

[](#configuration)

### 1. Add the Site Set

[](#1-add-the-site-set)

Add set via ***Sites → Setup → Pencil icon button (bottom right of your site)*** and under `Sets for this Site` add the site set `Font Awesome for CKEditor [refresj/refresj-font-awesome]`.

Or add `refresj/refresj-font-awesome` to your site's or your Site Set's config.yaml:

```
sets:
  - refresj/refresj-font-awesome
```

### 2. Upload Font Awesome files

[](#2-upload-font-awesome-files)

1. Download [Font Awesome Pro+ for web](https://fontawesome.com/releases/7.2.0/pro-plus/web/download) (license required)
2. Create a new folder `FontAwesome` in ***Media → fileadmin/***
3. Upload the downloaded `css` and `webfonts` folders to the newly created folder

### 3. Configure CSS files

[](#3-configure-css-files)

After adding the Site Set, configure the Font Awesome CSS files via ***Sites → Setup → Gear icon button (bottom right of your site)***:

SettingDescription`plugin.tx_rfrsjfontawesome.settings.loadCSS`Enable or disable frontend CSS inclusion`plugin.tx_rfrsjfontawesome.settings.cssFiles`List of Font Awesome CSS file paths to includeBoth `EXT:` paths and absolute paths (e.g. `/fileadmin/...`) are supported:

```
plugin.tx_rfrsjfontawesome.settings.cssFiles:
  - '/fileadmin/FontAwesome/css/fontawesome.min.css'
  - '/fileadmin/FontAwesome/css/brands.min.css'
  - '/fileadmin/FontAwesome/css/thin.min.css'
  - '/fileadmin/FontAwesome/css/light.min.css'
  - '/fileadmin/FontAwesome/css/regular.min.css'
  - '/fileadmin/FontAwesome/css/solid.min.css'
  - '/fileadmin/FontAwesome/css/sharp-thin.min.css'
  - '/fileadmin/FontAwesome/css/sharp-light.min.css'
  - '/fileadmin/FontAwesome/css/sharp-regular.min.css'
  - '/fileadmin/FontAwesome/css/sharp-solid.min.css'
  - '/fileadmin/FontAwesome/css/duotone-thin.min.css'
  - '/fileadmin/FontAwesome/css/duotone-light.min.css'
  - '/fileadmin/FontAwesome/css/duotone-regular.min.css'
  - '/fileadmin/FontAwesome/css/duotone.min.css'
  - '/fileadmin/FontAwesome/css/sharp-duotone-thin.min.css'
  - '/fileadmin/FontAwesome/css/sharp-duotone-light.min.css'
  - '/fileadmin/FontAwesome/css/sharp-duotone-regular.min.css'
  - '/fileadmin/FontAwesome/css/sharp-duotone-solid.min.css'
```

### 4. RTE configuration

[](#4-rte-configuration)

The extension extends the three default TYPO3 RTE presets which can be used in your TCA or page TSconfig:

PresetDescription`default`Standard editor configuration`full`Full editor configuration`minimal`Minimal editor configurationTo use a preset in page TSconfig:

```
# Default for all RTE textareas:
RTE.default.preset = full

# Specific RTE textareas such as ext:powermail:
RTE.config.tt_content {
    settings\.flexform\.sender\.body.preset < RTE.default.preset
    settings\.flexform\.receiver\.body.preset < RTE.default.preset
}

```

To use a preset in your TCA:

```
'config' => [
    'type' => 'text',
    'enableRichtext' => true,
    'richtextConfiguration' => 'full',
],
```

How it works
------------

[](#how-it-works)

### Icon insertion

[](#icon-insertion)

Clicking the Font Awesome toolbar button (green flag icon) opens a modal dialog. The dialog allows you to:

1. Select an icon pack: Brands, Classic, Sharp, Duotone, Sharp Duotone
2. Select a style: Thin, Light, Regular, Solid
3. Search icons by name
4. Set extra options Size, Animation, Rotation, Pull, Auto width and/or List item

Clicking an icon inserts an `` element with the correct Font Awesome classes into the editor.

### Icons in a list

[](#icons-in-a-list)

You can also make a list and replace the default bullets or numbers with icons:

1. Make unordered or ordered list as usual
2. Make sure your cursor is in the list
3. Select block style `Font Awesome (Unordered list)` or `Font Awesome (Ordered list)` under Styles in RTE
4. Insert icon with option `List item` for each list item

Known Problems
--------------

[](#known-problems)

### No icons showing

[](#no-icons-showing)

If no icons are showing, you didn't add a correct path to the CSS file(s) in Site Settings.

### Extra options not inserted

[](#extra-options-not-inserted)

You have to select them **before** you click on an icon.

### License lower than Pro+

[](#license-lower-than-pro)

If you have a Font Awesome license lower than Pro+, the extension will still work. Icons not included in your license tier will simply not be available.

License
-------

[](#license)

This extension is released under the [GNU General Public License v2.0 or later](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html).

Author
------

[](#author)

Nitin Parri - [Refresj](https://refresj.nl)

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance88

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

58d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e75a5f826ba4a6ca26be63987f7feb204aaa92052b9dd3a9cc5dfed6bc67bf9b?d=identicon)[NitinParri](/maintainers/NitinParri)

---

Top Contributors

[![NitinParri](https://avatars.githubusercontent.com/u/10200415?v=4)](https://github.com/NitinParri "NitinParri (5 commits)")

### Embed Badge

![Health badge](/badges/refresj-rfrsj-font-awesome/health.svg)

```
[![Health](https://phpackages.com/badges/refresj-rfrsj-font-awesome/health.svg)](https://phpackages.com/packages/refresj-rfrsj-font-awesome)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k57](/packages/friendsoftypo3-content-blocks)[wazum/sluggi

TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects

40529.5k](/packages/wazum-sluggi)[typo3/cms-lowlevel

TYPO3 CMS Lowlevel - Technical analysis of the system. This includes raw database search, checking relations, counting pages and records etc.

178.2M328](/packages/typo3-cms-lowlevel)[typo3/cms-redirects

TYPO3 CMS Redirects - Create manual redirects, list existing redirects and automatically createredirects on slug changes.

167.4M81](/packages/typo3-cms-redirects)[typo3/cms-form

TYPO3 CMS Form - Flexible TYPO3 frontend form framework that comes with a backend editor interface.

147.6M269](/packages/typo3-cms-form)[derhansen/sf_event_mgt

Event management and registration - Configurable event management and registration extension based on ExtBase and Fluid

66338.4k10](/packages/derhansen-sf-event-mgt)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
