FontAwesome BBCode Extension

Antoine

Hello everybody !

My second Flarum extension is based on a request from @Aethior.
It adds a custom BBCode command to add FontAwesome icons in your posts.
~~Once you have enabled the extension, you can use the [fa]icon[/fa] command which will be replaced by a FA icon 🙂~~
Once you have enabled the extension, you can use 4 commands to choose an icon.

[fas] : solid
[far] : regular
[fal] : light
[fab] : brand

Installation

composer require antoinefr/flarum-ext-bbcode-fa

Screenshot

A post

Repositories

GitHub
Packagist

JoshyPHP

Antoine I'd recommend using {IDENTIFIER} rather than {TEXT} to avoid letting users insert any class names. {TEXT} accepts literally any text, so it would be possible to add more than one name using spaces.

0E800

Antoine
Is there anyway to include fa-2x or any way to change the size of the fa icons?

Something like

[fa-2x]train[/fa]
[fa-3x]train][/fa]

Aethior

@Antoine Works fine! Thanks!

Antoine

JoshyPHP Thanks for your comment, I have updated the extension.

Updating

Run composer updateto get the fix, then disable and enable the extension again.

0E800

Antoine

I have added a few more custom BBcode examples to your source.

The customization's / additions can be reviewed here:
https://discuss.flarum.org/d/5241-additions-to-antoine-fa-bbcode-extension-more-icons

Aethior

0E800 Is there anyway to include fa-2x or any way to change the size of the fa icons?

You can change the icon size using [size][/size] BBCode. Example: [size=36][fa]rocket[/fa][/size].

Antoine

I thought I had already updated this extension for beta 8, but obviously not. It's now done 🙂

Version 0.2.1

This version is now compatible with Flarum beta 8 (and newer versions like 8.1 and 9).
It uses the new prefixes from FontAwesome (fas, fal, far, fab).

Update

To update this extension, run the command
composer require antoinefr/flarum-ext-bbcode-fa
and clear your cache (php flarum cache:clear).

datitisev

Antoine Looking at the source code, it doesn't seem possible to insert regular or brand icons, as you prefix the i tag with fas fa-. Brands use fab and regular icons use far, so you should probably remove the prefix. It has been removed from core extensions and other extensions that that require FA icon inputs in beta 8.

Antoine

datitisev Thank you for your message, I changed this extension to add new bbcodes for [fas], [far], [fal] and [fab].
I tagged a new release 0.2.1.

Veriael

Finally! 😃 Well done!

Antoine

v1.0.0

This extension is now compatible with Flarum 1.0.
It is also still compatible with beta16 (and in fact a lot of older releases)!

Feel free to leave a comment if you find a bug with this new version!

Updating

composer update antoinefr/flarum-ext-bbcode-fa
php flarum cache:clear

simoninedinburgh

Does it support fa's duo format and the animated forms ?
If not can it be modernised?
Thnx

Antoine

simoninedinburgh

Hello, currently this extension is only compatible with fa-solid, fa-regular, fa-light and fa-brands.

I can work on adding the other styles mentioned in this table: https://docs.fontawesome.com/web/setup/upgrade/whats-changed#full-style-names . However, they will only work if newer FontAwesome CSS is loaded on the page.

For the animations, the amount of classes combination is really huge so I don't think I can include it in this extension.

Antoine

v1.1.0

This extension can now display FontAwesome v6 icons. See this table (https://docs.fontawesome.com/web/setup/upgrade/whats-changed#full-style-names) to find the accepted tags.
Please note that it only adds some BBCode tags, you must include the FontAwesome CSS yourself, for example in the Custom header admin section or with this extension: https://discuss.flarum.org/d/31219-blomstra-font-awesome-6

Feel free to leave a comment if you find a bug with this new version!

Updating

composer update antoinefr/flarum-ext-bbcode-fa
php flarum cache:clear

HasanMerkit

Antoine still updated 🙂 Thank you. Very basic extension but good 🙂

Antoine

v2.0.0

This extension can now be used with Flarum 2.0

I didn't have to change anything, just allowing the new version 🙂

Please report any bug you could encounter.