PHPackages                             mediawiki/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. mediawiki/font-awesome

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

mediawiki/font-awesome
======================

Provides the FontAwesome icon font, CSS, and SVG framework in the wiki

4.0.0(9mo ago)615.0k↓20.6%3[5 issues](https://github.com/ProfessionalWiki/FontAwesome/issues)[2 PRs](https://github.com/ProfessionalWiki/FontAwesome/pulls)GPL-3.0-or-laterJavaScriptPHP &gt;=8.1CI passing

Since Oct 20Pushed 8mo ago6 watchersCompare

[ Source](https://github.com/ProfessionalWiki/FontAwesome)[ Packagist](https://packagist.org/packages/mediawiki/font-awesome)[ Docs](https://www.mediawiki.org/wiki/Extension:FontAwesome)[ GitHub Sponsors](https://github.com/JeroenDeDauw)[ RSS](/packages/mediawiki-font-awesome/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (5)Dependencies (2)Versions (8)Used By (0)

FontAwesome
===========

[](#fontawesome)

[![GitHub Workflow Status](https://camo.githubusercontent.com/8dc22b0e0cdb694d36aa8ee7177edfc78ba7a342267d18de5993550afebd6fb7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f50726f66657373696f6e616c57696b692f466f6e74417765736f6d652f63692e796d6c3f6272616e63683d6d6173746572)](https://github.com/ProfessionalWiki/FontAwesome/actions?query=workflow%3ACI)[![Latest Stable Version](https://camo.githubusercontent.com/1ee94fbdf6a1f90d142df4c22819ee009bb5c4d0fbc28f006135d5825b505faf/68747470733a2f2f706f7365722e707567782e6f72672f6d6564696177696b692f666f6e742d617765736f6d652f762f737461626c65)](https://packagist.org/packages/mediawiki/font-awesome)[![Packagist download count](https://camo.githubusercontent.com/e648f48e4937dea0e76d7f3a441f9b3f227edc995280f79da2a2a25e74b7c889/68747470733a2f2f706f7365722e707567782e6f72672f6d6564696177696b692f666f6e742d617765736f6d652f646f776e6c6f616473)](https://packagist.org/packages/mediawiki/font-awesome)

The [FontAwesome](https://www.mediawiki.org/wiki/Extension:FontAwesome) extension to MediaWiki provides parser functions to insert [Font Awesome Free](https://fontawesome.com/) icons into the wiki text.

Currently Font Awesome Free version 7.0.0 is included.

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

[](#requirements)

- PHP 8.1.0 or later
- MediaWiki 1.43 or later

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

[](#installation)

### Using Composer

[](#using-composer)

Using [Composer](https://getcomposer.org/) is the recommended way to install this extension.

Run the following commands from the MediaWiki installation directory:

1. `COMPOSER=composer.local.json php composer.phar require --no-update mediawiki/font-awesome ^4.0`
2. `php composer.phar update --no-dev mediawiki/font-awesome`

To update the extension, run the last command again.

### Using a download from GitHub

[](#using-a-download-from-github)

1. Download a tar ball or zip file from [GitHub](https://github.com/ProfessionalWiki/FontAwesome/releases/latest)
2. Extract it into the `extensions` directory of your MediaWiki installation
3. Rename the folder `FontAwesome-...` to `FontAwesome`

To update the extension delete the `FontAwesome` folder completely and re-install.

Activation
----------

[](#activation)

Add the following line to your `LocalSettings.php`:

```
wfLoadExtension( 'FontAwesome' );
```

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

[](#configuration)

There are two render modes available for FontAwesome icons:

- **Web Fonts with CSS:** This implementation uses web fonts as the file format and relies on the browser to render icons as it would any custom font.
- **SVG with JavaScript:** This implementation encodes icon data and the mechanism to display them in the browser in JavaScript code that the browser executes.

The render mode can be selected by setting the variable `$wgFaRenderMode` in LocalSettings.php. Allowed values are: `webfonts` (default) and `javascript`.

**Example:** `$wgFaRenderMode = 'javascript';`

For a discussion of the advantages and drawbacks of the render modes see [Performance &amp; Font Awesome](https://fontawesome.com/how-to-use/on-the-web/other-topics/performance)on fontawesome.com.

Usage
-----

[](#usage)

This extension defines three parser functions:

- `{{#far:...}}` to insert an icon from the FontAwesome Regular font
- `{{#fas:...}}` to insert an icon from the FontAwesome Solid font
- `{{#fab:...}}` to insert an icon from the FontAwesome Brands font

**Example:**`{{#fab:wikipedia-w}}` will insert the Wikipedia-W

For valid icon names see .

### Styling

[](#styling)

- `{{#far:... ...}}` to insert an icon from the FontAwesome Regular font with additional classes
- `{{#fas:... ...}}` to insert an icon from the FontAwesome Solid font with additional classes
- `{{#fab:... ...}}` to insert an icon from the FontAwesome Brands font with additional classes

**Example:**`{{#fab:wikipedia-w fa-spin}}` will insert a spinning Wikipedia-W

For valid Font Awesome class names see .

Professional Support
--------------------

[](#professional-support)

The FontAwesome extension is maintained by [Professional Wiki](https://professional.wiki). You can [contract us](https://professional.wiki/en/contact) to help you with installation or customization of FontAwesome. We also do development work.

License
-------

[](#license)

[GNU General Public License, Version 3](https://www.gnu.org/copyleft/gpl.html) or later.

The Font Awesome Free package is included in the extension. See its [license file](./res/fontawesome/LICENSE.txt) for details.

Release notes
-------------

[](#release-notes)

### Version 4.0.0

[](#version-400)

Released on July 25, 2025.

- Raised the minimum PHP version from 7.4.3 to 8.1.0
- Raised the minimum MediaWiki version from 1.39 to 1.43
- Updated FontAwesome to 7.0.0

### Version 3.0.0

[](#version-300)

Released on March 15, 2025.

- Raised the minimum MediaWiki version from 1.35 to 1.39
- Updated FontAwesome to 6.7.2

### Version 2.0.0

[](#version-200)

Released on January 27, 2023.

- Raised the minimum PHP version from 7.0 to 7.4.3
- Raised the minimum MediaWiki version from 1.31 to 1.35
- Updated to FontAwesome 6

### Version 1.1.0

[](#version-110)

Released on January 25, 2023.

- Updated FontAwesome to 5.15.4

### Version 1.0.0

[](#version-100)

Released on October 20, 2019.

- Initial release

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance41

Moderate activity, may be stable

Popularity32

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Total

5

Last Release

298d ago

Major Versions

1.1.0 → 2.0.02023-01-27

2.0.0 → 3.0.02025-03-16

3.0.0 → 4.0.02025-07-25

PHP version history (3 changes)1.0PHP &gt;=7.0

2.0.0PHP &gt;=7.4.3

4.0.0PHP &gt;=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/451bd4039d530fed8f9c3da91bfa519233a397d2182cdfdcad700f6cfea19b7f?d=identicon)[Jeroen De Dauw](/maintainers/Jeroen%20De%20Dauw)

![](https://www.gravatar.com/avatar/05e03b274e4924bf511416ec2f343c76609b8f3856e1d7804fc96f1338ce5bc3?d=identicon)[s7eph4n](/maintainers/s7eph4n)

---

Top Contributors

[![malberts](https://avatars.githubusercontent.com/u/1428594?v=4)](https://github.com/malberts "malberts (29 commits)")[![s7eph4n](https://avatars.githubusercontent.com/u/2829850?v=4)](https://github.com/s7eph4n "s7eph4n (20 commits)")[![alistair3149](https://avatars.githubusercontent.com/u/9260542?v=4)](https://github.com/alistair3149 "alistair3149 (14 commits)")[![JeroenDeDauw](https://avatars.githubusercontent.com/u/146040?v=4)](https://github.com/JeroenDeDauw "JeroenDeDauw (14 commits)")[![SomeMWDev](https://avatars.githubusercontent.com/u/186634068?v=4)](https://github.com/SomeMWDev "SomeMWDev (4 commits)")[![WouterRademaker](https://avatars.githubusercontent.com/u/5064826?v=4)](https://github.com/WouterRademaker "WouterRademaker (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![Ciferlingvulo](https://avatars.githubusercontent.com/u/57536850?v=4)](https://github.com/Ciferlingvulo "Ciferlingvulo (1 commits)")[![scrutinizer-auto-fixer](https://avatars.githubusercontent.com/u/6253494?v=4)](https://github.com/scrutinizer-auto-fixer "scrutinizer-auto-fixer (1 commits)")[![Universal-Omega](https://avatars.githubusercontent.com/u/54654040?v=4)](https://github.com/Universal-Omega "Universal-Omega (1 commits)")

---

Tags

extensionfontawesomefontawesome5iconsmediawikiparser-functionsmediawikiiconsextensionwikiFontAwesome

### Embed Badge

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

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

###  Alternatives

[mediawiki/semantic-glossary

A terminology markup extension with a Semantic MediaWiki back-end

1352.4k](/packages/mediawiki-semantic-glossary)[mediawiki/chameleon-skin

A highly flexible MediaWiki skin using Bootstrap 4

12481.8k2](/packages/mediawiki-chameleon-skin)[mediawiki/semantic-extra-special-properties

Provides extra special properties for Semantic MediaWiki

3074.6k1](/packages/mediawiki-semantic-extra-special-properties)[mediawiki/semantic-scribunto

A Semantic Mediawiki extension to natively support the Scribunto extension

2967.5k](/packages/mediawiki-semantic-scribunto)[mediawiki/semantic-cite

A Semantic MediaWiki extension to manage citation resources.

2310.2k1](/packages/mediawiki-semantic-cite)[starcitizentools/tabber-neue

Allows to create tabs within a page. Forked from Extension:Tabber

243.6k](/packages/starcitizentools-tabber-neue)

PHPackages © 2026

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