PHPackages                             netzmacht/contao-font-awesome-inserttag - 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. netzmacht/contao-font-awesome-inserttag

ActiveContao-bundle[Utility & Helpers](/categories/utility)

netzmacht/contao-font-awesome-inserttag
=======================================

Provides an insert tag for using font awesome icons.

2.2.3(4w ago)928.0k↑25.7%4[1 issues](https://github.com/netzmacht/contao-font-awesome-inserttag/issues)2LGPL-3.0-or-laterPHPPHP ^8.2CI passing

Since Jul 3Pushed 1w ago1 watchersCompare

[ Source](https://github.com/netzmacht/contao-font-awesome-inserttag)[ Packagist](https://packagist.org/packages/netzmacht/contao-font-awesome-inserttag)[ GitHub Sponsors](https://github.com/dmolineus)[ RSS](/packages/netzmacht-contao-font-awesome-inserttag/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (17)Versions (15)Used By (2)

Font Awesome InsertTag
======================

[](#font-awesome-inserttag)

This extension provides two insert tags for creating font awesome icons in Contao CMS.

Features
--------

[](#features)

Font Awesome Inserttag supports FontAwesome 4 and FontAwesome 5 as well.

### Icon Insert Tags

[](#icon-insert-tags)

There are a couple of insert tags for icon generation. For Font Awesome 4 there is the previously known `fa` insert tag. To support the styles introduced in Font Awesome 5 there a specific insert tags the styles `fas`, `far`, `fal`, `fab`.

Following options are supported:

- All values after the first double column get prefixed with `fa-` Prefix: `{{fa::phone}}````

    ```
- Multiple values are supported: `{{fa::phone 4x muted}}````

    ```
- Additional values could be passed as second param devided by a colon: `{{fa::phone 4x muted:pull-left custom}}`

```

```

The former syntax with a double colon "::" between two params is deprecated but still supported.

It works the same with the new short codes provided by Font Awesome 5. If you're migrating from Font Awesome 4 to 5 and have some old insert tags you may have a look at the provided configuration option `default_style`.

### Insert Tag "fa-stack"

[](#insert-tag-fa-stack)

The second insert tag support the icon stack feature of font awesome. All features described above are supported for every icon. Furthermore the icon stack wrapper itself can be adjusted by classes:

`{fa-stack::square:first-icon::plus:secon-icon::lg:custom-stack}`

```

```

To support the styles introduced in Font Awesome 5 there a specific insert tags the styles `fas-stack`, `far-stack`, `fal-stack`, `fab-stack`.

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

[](#requirements)

Version 2 is designed for Contao 4.4 and above. It can be installed by using the managed edition of Contao.

If you want to add the bundle yourself just add `Netzmacht\Contao\FontAwesomeInsertTag\NetzmachtFontAwesomeInsertTagBundle`to your app kernel.

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

[](#configuration)

You can override the templates being used for the icon or icon-stack in your config.yml. The default configuration is:

```
config:
  netzmacht_font_awesome_insert_tag:
    icon_template: ''
    stack_template: '%%s%%s'
    default_style: 'fa'
```

If you migrate from Font Awesome 4 to 5 you might want to set the default style to `far` or `fas`.

###  Health Score

61

↑

FairBetter than 98% of packages

Maintenance94

Actively maintained with recent releases

Popularity34

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity83

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 90% 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 ~362 days

Recently: every ~480 days

Total

10

Last Release

29d ago

PHP version history (4 changes)2.0.0-beta1PHP >=5.6

2.1.0PHP ^7.2 || ^8.0

2.2.1PHP ^7.4 || ^8.0

2.2.2PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8189209?v=4)[netzmacht](/maintainers/netzmacht)[@netzmacht](https://github.com/netzmacht)

---

Top Contributors

[![dmolineus](https://avatars.githubusercontent.com/u/1186266?v=4)](https://github.com/dmolineus "dmolineus (45 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")

---

Tags

iconscontaofont-awesomeicon font

### Embed Badge

![Health badge](/badges/netzmacht-contao-font-awesome-inserttag/health.svg)

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

PHPackages © 2026

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