README

ACF SVG 图标选择器字段

从 houke/acf-icon-picker (现已不再活跃开发) 分支，更新为与 ACF v6.3 及以上版本兼容。

描述

将您想要在主题中可用的 svg 图标添加到主题 img 文件夹内的 acf 文件夹中。该字段返回 svg 的名称。

兼容性

此 ACF 字段类型与以下版本兼容：

ACF 6
ACF 5

屏幕截图

安装

通过 Composer

运行 composer require smithfield-studio/acf-svg-icon-picker 并通过插件管理页面激活插件。

手动

将 acf-svg-icon-picker 文件夹复制到您的 wp-content/plugins 文件夹
通过插件管理页面激活图标选择器插件
通过 ACF 创建一个新字段并选择图标选择器类型

从 ACF 图标选择器切换到 ACF SVG 图标选择器

如果您来自原始 ACF 图标选择器插件，可以通过以下步骤切换到此插件：

停用旧的 ACF 图标选择器插件
通过 Composer 或手动安装 ACF SVG 图标选择器插件
激活 ACF SVG 图标选择器插件
检查您的字段配置，并在字段设置中将字段类型从 icon-picker 更改为 svg_icon_picker。注意字段类型名称中的下划线。
检查字段类型是否现在可在您的 ACF 字段设置中使用

过滤器

使用以下过滤器来覆盖默认图标文件夹、路径和/或 URL

// modify the path to the icons directory
add_filter('acf_icon_path_suffix', 'acf_icon_path_suffix');

function acf_icon_path_suffix($path_suffix) {
    return 'assets/img/icons/';
}

// modify the path to the above prefix
add_filter('acf_icon_path', 'acf_icon_path');

function acf_icon_path($path_suffix) {
    return plugin_dir_path(__FILE__);
}

// modify the URL to the icons directory to display on the page
add_filter('acf_icon_url', 'acf_icon_url');

function acf_icon_url($path_suffix) {
    return plugin_dir_url( __FILE__ );
}

对于 Sage/Bedrock，编辑 filters.php

/// modify the path to the icons directory
add_filter('acf_icon_path_suffix',
  function ( $path_suffix ) {
    return '/assets/images/icons/'; // After assets folder you can define folder structure
  }
);

// modify the path to the above prefix
add_filter('acf_icon_path',
  function ( $path_suffix ) {
    return '/app/public/web/themes/THEME_NAME/resources';
  }
);

// modify the URL to the icons directory to display on the page
add_filter('acf_icon_url',
  function ( $path_suffix ) {
    return get_stylesheet_directory_uri();
  }
);

与 ACF Builder / ACF Composer 一起使用

$fields->addField('my_icon', 'svg_icon_picker', [
    'label' => 'My Icon',
])

变更日志

3.1.0 - 将字段名称更改为 svg_icon_picker 以避免与原始 ACF 图标选择器字段冲突。
3.0.0 - 恢复到原始 ACF 字段名称，快速整理 + README 更新
2.0.0 - 修复 ACF 6.3 的问题，该版本现在具有官方的 icon-picker 字段 + 合并来自 Levdbas & phschmanau 的开放 PR
1.9.1 - ACF 6 兼容性修复。感谢 idflood
1.9.0 - 修复移除时 Gutenberg 预览不更新的问题。感谢 cherbst
1.8.0 - 修复 Gutenberg 保存图标时的问题。感谢 tlewap
1.7.0 - 2 个新的过滤器，以更好地控制图标路径。感谢 benjibee
1.6.0 - 在图标众多的情况下进行性能修复。感谢 idflood
1.5.0 - 修复搜索图标时，如果图标名称有空格会破坏预览的问题
1.4.0 - 添加过滤器以更改存储 svg 图标的文件夹
1.3.0 - 在模态框中添加关闭选项
1.2.0 - 添加搜索过滤器输入，通过名称过滤图标
1.1.0 - 当字段非必填时，添加按钮以移除选定的图标
1.0.0 - 首次发布

smithfield-studio / acf-svg-icon-picker

维护者

详细信息