aerni / font-awesome
Statamic 插件,轻松添加 Font Awesome 图标。
v3.0.1
2024-07-23 15:04 UTC
Requires
- php: ^8.1
- statamic/cms: ^5.0
README
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) 并将 metadata
和 css
目录放置在配置中定义的位置
'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 开发