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