Add FontAwesome icons to StreamField.
pip install wagtailfontawesome
Then add wagtailfontawesome
to your installed apps.
Add FontAwesome icons to StreamField the regular way, just set icon="fa-something"
. Reference the full list.
wagtailmodeladmin is supported if you're using Wagtail 1.4 or above. Similar to StreamField, just set icon="fa-something"
on your menu item.
You can use FontAwesome icons on custom Hallo buttons by setting the icon
option to icon icon-fa-something
.
button.hallobutton({
label: "Blockquote",
icon: 'icon icon-fa-quote-left',
});
You can include icons anywhere in the admin with:
<i class="icon icon-fa-something"></i>
In Wagtail 1.3.x and below you can only use icons on the page editor screen.
You can also include the CSS on the front end, and follow FontAwesome's documentation.
{% load wagtailfontawesome %}
{% fontawesome_css %}
This will generate equivalent markup to:
<link rel="stylesheet" href="{% static 'wagtailfontawesome/css/fontawesome.css' %}">
Then include icons anywhere on the front-end with:
<i class="fa fa-something"></i>
If you want to distribute a Wagtail plugin with FontAwesome icons, you can use this package as an optional dependency by checking if it's installed in Django, and falling back otherwise.
from django.apps import apps
try:
from wagtail.core.blocks import StructBlock
except ImportError: # fallback for Wagtail <2.0
from wagtail.wagtailcore.blocks import StructBlock
class BlockquoteBlock(StructBlock):
quote = TextBlock()
author = TextBlock()
class Meta:
if apps.is_installed('wagtailfontawesome'):
icon = 'fa-quote-left'
(in this case, the fallback is to do nothing)