PHPackages                             cbp/redactor-fa-list - 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 & Helpers](/categories/utility)
4. /
5. cbp/redactor-fa-list

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

cbp/redactor-fa-list
====================

Adds a way to add font awesome icons as list markers in Redactor.

2.0.1(3y ago)01.4k[1 issues](https://github.com/danbrellis/craft-redactor-fa-list/issues)MITPHPPHP ^8.0.2

Since Oct 21Pushed 3y ago1 watchersCompare

[ Source](https://github.com/danbrellis/craft-redactor-fa-list)[ Packagist](https://packagist.org/packages/cbp/redactor-fa-list)[ RSS](/packages/cbp-redactor-fa-list/feed)WikiDiscussions main Synced 1mo ago

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

[![Redactor Font Awesome List icon](./src/icon.svg)](./src/icon.svg)

Redactor Font Awesome List
==========================

[](#redactor-font-awesome-list)

This redactor plugin allows you to add Font Awesome icons as markers for your redactor lists.

Will generate HTML through a simple icon picker:

```

     List item 1
     List item 2
     List item 3

```

See Font Awesome's [Icons in a List](https://fontawesome.com/how-to-use/on-the-web/styling/icons-in-a-list).

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

[](#requirements)

This plugin requires Craft CMS 3.1 or later as well as the [Craft Redactor plugin](https://github.com/craftcms/redactor) v2.0 or later.

Installation
------------

[](#installation)

Install through the Plugin Store.

Alternatively, you can download and install this plugin with Composer.

Open your terminal and run the following commands:

```
# go to the project directory
cd /path/to/my-project

# tell Composer to load the plugin
composer require cbp/redactor-fa-list

# tell Craft to install the plugin
./craft plugin/install redactor-fa-list
```

Adding to your Redactor fields
------------------------------

[](#adding-to-your-redactor-fields)

Include the plugin in your Redactor config file located in `config/redactor/Default.json`. To do so, add `"falist"` in the plugins array:

```
{
  "buttons": ["html"],
  "plugins": ["fullscreen", "falist"]
}
```

**NOTE:** Don't forget to include Font Awesome on your front-end.

Allow Certain Icons and Styles
------------------------------

[](#allow-certain-icons-and-styles)

By default, over 1000 Font Awesome icons are available to be selected from within the field. If you want to limit which icons your authors can select, you can [override the setting value](https://craftcms.com/docs/3.x/extend/plugin-settings.html#overriding-setting-values).

Create a new file `config/redactor-fa-list.php`:

```
return [
    'icons' => [
        "heart",
        "star"
    ]
];
```

If only a string is provided (as above), it will default to the Solid (`.fas`) styling. To specify styled icons, use a `key => value` pair:

```
return [
    'icons' => [
        ["heart" => "fal"], // this will be the Light style
        ["heart" => "fad"], // this will be the Duotone style
        "star", // this defaults to Solid style
        ["creative-commons" => "fab"] // this will be the Brands style
    ]
];
```

### Specify Versions

[](#specify-versions)

Since, by default, only free Solid styles are assumed, the [Font Awesome CSS webfont](https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.3/css/all.min.css) is loaded to display icons in the redactor field automatically. If you choose to use other icon styles or target a specific version of FA, you need to include the proper CSS file(s) in your settings override:

```
//Using Webfont CDN
use craft\helpers\App;
return [
    'icons' => [
        ["alien" => "fad"],
        ["creative-commons" => "fab"]
    ],
    'styles' => [
        [
            'src' => "https://pro.fontawesome.com/releases/v5.15.3/css/all.css",
            'params' => [
                'integrity' => App::env('FA_INTEGRITY'),
                'crossorigin' => "anonymous"
            ]
        ],
        'https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.3/css/brands.min.css'
    ]
];
```

**NOTE:** Currently there are too many bugs with using FA Kits with the redactor fields, so support was removed in v1.0.4 of this plugin. However, just because you use the webfont CDN on the backend doesn't mean you can't use the FA Kit script for your frontend :)

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity64

Established project with proven stability

 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 ~122 days

Recently: every ~155 days

Total

8

Last Release

1170d ago

Major Versions

1.0.5 → 2.0.02023-02-25

PHP version history (2 changes)2.0.0PHP ^8.0

2.0.1PHP ^8.0.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/3cf9e84feb6d07668dd54cc6b1345d1b6117048e9fce1dfb52e40e77d883fe40?d=identicon)[danbrellis](/maintainers/danbrellis)

---

Top Contributors

[![danbrellis](https://avatars.githubusercontent.com/u/7229803?v=4)](https://github.com/danbrellis "danbrellis (24 commits)")

---

Tags

bulletcraft-plugincraft3craftcmsfont-awesomelistsredactorredactor-pluginlisticonfont-awesomeRedactor

### Embed Badge

![Health badge](/badges/cbp-redactor-fa-list/health.svg)

```
[![Health](https://phpackages.com/badges/cbp-redactor-fa-list/health.svg)](https://phpackages.com/packages/cbp-redactor-fa-list)
```

###  Alternatives

[phpcollection/phpcollection

General-Purpose Collection Library for PHP

1.0k64.0M34](/packages/phpcollection-phpcollection)[carlcs/craft-redactorcustomstyles

Redactor Custom Styles plugin for Craft CMS

59221.7k3](/packages/carlcs-craft-redactorcustomstyles)[yiidoc/yii2-redactor

Extension redactor for Yii2 Framework.

191618.8k47](/packages/yiidoc-yii2-redactor)[ashallendesign/favicon-fetcher

A Laravel package for fetching website's favicons.

190272.4k3](/packages/ashallendesign-favicon-fetcher)[kartik-v/yii2-icons

Set of icon frameworks for use in Yii Framework 2.0

73970.3k34](/packages/kartik-v-yii2-icons)[verbb/redactor-tweaks

Provide some tweaks for Redactor.

1791.6k](/packages/verbb-redactor-tweaks)

PHPackages © 2026

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