README

图标包

TYPO3 CMS 扩展 iconpack

适用于TYPO3 10, 11, 12和13的最灵活的图标系统！

本扩展提供自定义图标包的图标包注册表，可用于后端和前端，并根据安装的图标包配置进行渲染。

本扩展的核心理念是通过提供一种灵活的系统，任何图标集都可以使用，并且可以通过分离存储和渲染在任何时候生成所需的输出。

特性

扩展 iconpack 与之前的实现不同，将来可能将是您唯一需要的图标扩展。

最大的不同之处在于

• 不受特定图标集的限制！可以根据需求安装现有图标包或创建自定义图标包
• 易于使用：安装，添加提供的TypoScript模板并使用它，无需进一步配置（但可能需要！）
• 支持在标题、页面、正文（CKEditor 4/5）以及您自己的字段中使用各种图标
• 默认情况下，根据使用的图标集配置，所有必需的资产（JavaScript、CSS样式表等）都会在前后端自动添加
• 可以通过单独的配置（YAML）覆盖图标包的所有设置
• 可以轻松添加单个图标集（有关创建自己的图标包提供者的说明，请参阅说明）
• 也可以通过提供的形式向导集成到自己的扩展中
• 图标的多语言标签
• 使用TYPO3集成的后端缓存来配置安装的图标包，以避免减慢后端速度
• 可以在之后更改图标的渲染（通过TypoScript轻松从Web字体切换到SVG）
• 与Bootstrap Package和其他扩展兼容
• 不依赖于其他扩展或第三方代码！

计划中的特性

• 启用在CKEditor 5中使用SVG精灵的功能
• 在CKEditor中添加上下文菜单以编辑之前添加的图标（及其选项）
• 优化UI/模态框
• 添加有关使用和创建自己的图标包的更详细信息

需要赞助

它是如何工作的？

在数据库字段中，不是存储整个HTML标记或图标的静态文件路径，而是存储一个简短的配置字符串（在RTE中也是如此）。这个字符串称为"iconfig"，看起来像fa6:solid,star,transform:spin。此示例将渲染来自图标包Font Awesome 6（实心样式）的图标星号，并具有额外的旋转旋转属性。

此字符串仅在渲染时根据配置转换为HTML代码，这确保了最大的灵活性。可以选择将图标渲染为Web字体、精灵、内联SVG或SVG图像，而无需更改数据库中的内容。

此外，此扩展为页面和文本标题添加了额外的图标字段，但它也可以用来扩展您自己扩展的字段。

注意：此扩展与TYPO3集成的IconRegistry采用不同的方法，它缓存所有图标及其HTML标记，并将它们视为绝对路径，但此扩展专注于处理编辑器和前端输出的图标！

安装

1. 从TER或使用Composer安装此扩展。
2. 安装现有的图标包提供者之一。
   • Bootstrap
   • Boxicons
   • Dripicons
   • Elegant Icons
   • Feather Icons
   • Font Awesome
   • Helium Icons
   • Ikons矢量图标
   • Ionicons
   • Linea Icons
   • Linearicons
   • Lineicons
   • Material Icons (WIP)
   • Octicons
   • Themify Icons
   • ...或创建您自己的图标包提供者
3. 将提供的TypoScript添加到您的模板中。
4. [可选] 如果您想将图标包与Bootstrap Package一起使用，请安装Bootstrap Package 图标包扩展。

配置

您可以在以下位置找到扩展的详细描述：[a href="https://docs.typo3.org/p/quellenform/t3x-iconpack/main/en-us/" rel="nofollow noindex noopener external ugc">图标包文档。

贡献 | 感谢！

• 如果您喜欢此扩展，请使用它。
• 如果您认为可以做得更好，请慷慨地贡献您的一份力量。
• 如果您喜欢此扩展或想支持进一步的开发，请捐赠任意金额。