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.1.0(3w ago)716.8k↑20.1%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 3w 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 3d ago

READMEChangelog (6)Dependencies (4)Versions (9)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.2.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.1.0

[](#version-410)

Released on June 12, 2026.

- Updated FontAwesome to 7.2.0

### 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

55

—

FairBetter than 97% of packages

Maintenance81

Actively maintained with recent releases

Popularity33

Limited adoption so far

Community21

Small or concentrated contributor base

Maturity72

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

Recently: every ~308 days

Total

6

Last Release

23d 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 (30 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)")[![WouterRademaker](https://avatars.githubusercontent.com/u/5064826?v=4)](https://github.com/WouterRademaker "WouterRademaker (5 commits)")[![SomeMWDev](https://avatars.githubusercontent.com/u/186634068?v=4)](https://github.com/SomeMWDev "SomeMWDev (4 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

[helsingborg-stad/municipio

A bootstrap theme for creating municipality sites.

4028.5k10](/packages/helsingborg-stad-municipio)[starcitizentools/citizen-skin

A beautiful, usable, responsive MediaWiki skin with in-depth extension support. Originally developed for the Star Citizen Wiki.

3376.6k](/packages/starcitizentools-citizen-skin)[mediawiki/maps

Adds various mapping features to MediaWiki

84152.3k3](/packages/mediawiki-maps)[mediawiki/semantic-glossary

A terminology markup extension with a Semantic MediaWiki back-end

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

A highly flexible MediaWiki skin using Bootstrap 5

12585.7k2](/packages/mediawiki-chameleon-skin)[mediawiki/page-forms

Forms for creating and editing wiki pages.

2380.7k2](/packages/mediawiki-page-forms)

PHPackages © 2026

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