aerni/font-awesome

Statamic 插件,轻松添加 Font Awesome 图标。

v3.0.1 2024-07-23 15:04 UTC

This package is auto-updated.

Last update: 2024-09-23 15:27:35 UTC


README

Statamic Packagist version Packagist Total Downloads

Font Awesome

此 Statamic 插件提供了一个图标字段类型,可以浏览和选择 Font Awesome 6.x 图标。它还包含一个标签,可以在模板中输出所选图标。

安装

使用 Composer 安装插件

composer require aerni/font-awesome

您可以发布包的配置

php please vendor:publish --tag=font-awesome-config

配置

您可以选择使用套件或自己托管 Font Awesome。

套件驱动程序

如果您想使用套件,请确保将配置文件中的 driver 选项设置为 kit

'driver' => 'kit'

接下来,将您的 API 令牌套件令牌 添加到 .env 文件中

FA_API_TOKEN=************************************
FA_KIT_TOKEN=************************************

本地驱动程序

如果您更愿意自己托管 Font Awesome,可以使用 local 驱动程序

'driver' => 'local'

接下来,下载 Font Awesome (For The Web) 并将 metadatacss 目录放置在配置中定义的位置

'local' => [
    'metadata' => resource_path('fonts/fontawesome/metadata'),
    'css' => '/fonts/fontawesome/css/all.min.css',
],

元数据

元数据目录中的文件用于获取图标信息。我建议将元数据放在 resources 目录中,因为这些文件不需要公开访问。

CSS

css 配置选项定义了加载到控制面板中样式表的公共路径。样式表必须放在 public 目录中。CSS 只会在控制面板中加载。您还需要自己将样式表添加到前端布局中。

用法

字段类型

Font Awesome 字段类型添加到蓝图或字段集中。字段类型提供了一个配置选项,允许您仅提供某些图标样式供选择。

标签

如果您使用的是 kit 驱动程序,请将以下标签添加到布局的 <head> 中以渲染 Font Awesome 脚本。

{{ font_awesome:kit }}

使用 Font Awesome 字段的句柄作为通配符方法来渲染图标。

{{ font_awesome:icon_field }}

您还可以使用较短的标签别名。

{{ fa:kit }}

{{ fa:icon_field }}

致谢

Michael Aerni 开发