Mudrava Icon Field for ACF with Lucide
| 开发者 | mudrava |
|---|---|
| 更新时间 | 2026年3月19日 14:54 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPL-2.0-or-later |
| 版权网址: | 版权信息 |
详情介绍:
- Visual Icon Picker - Browse and select from 1,500+ Lucide icons
- Smart Search - Filter icons by name or tags instantly
- Performant - Local sprite file, paginated grid (100 icons per page)
- Native ACF Look - Seamlessly integrates with ACF's design language
- Responsive - Works on all screen sizes
- Accessible - Keyboard navigation support
- Flexible Output - Return icon name or full SVG markup
- No External Requests - All icon data is stored locally
- Go to Custom Fields > Add New
- Add a new field and select Lucide Icon as the field type
- Configure the field settings (default value, return format, etc.)
- Save your field group
<?php $icon_name = get_field('your_field_name'); echo esc_html($icon_name); // Returns: 'rocket' ?>
Get SVG Markup (with return_format = 'svg'):
<?php $icon_svg = get_field('your_field_name'); echo $icon_svg; // Returns: <svg>...</svg> ?>
Using the Helper Function:
`<?php
// Basic usage
echo mudrava_get_lucide_icon('rocket');
// With custom attributes
echo mudrava_get_lucide_icon('rocket', [
'class' => 'my-custom-class',
'width' => 32,
'height' => 32,
'stroke' => '#ff0000',
]);
?>`
About Lucide Icons
Lucide is a modern, open-source icon library with 1,500+ carefully crafted icons. All icons are licensed under ISC, making them free to use in commercial and personal projects.
安装:
- WordPress 6.0 or higher
- PHP 7.4 or higher
- Advanced Custom Fields (ACF) Pro 6.0 or higher (required)
- Install and activate ACF Pro (if not already installed)
- Upload the
mudrava-acf-lucide-fieldfolder to/wp-content/plugins/ - Activate the plugin through the 'Plugins' menu in WordPress
- The new "Lucide Icon" field type will appear in ACF field type selection
- Go to Plugins > Add New > Upload Plugin
- Upload the plugin zip file
- Click Install Now and then Activate
常见问题:
Do I need ACF Pro for this plugin to work?
Yes, this plugin is an extension for Advanced Custom Fields Pro and requires ACF Pro version 6.0 or higher to function. It will not work with the free version of ACF.
Will the plugin work if I deactivate ACF Pro?
No, the plugin will show an admin notice and the field type will not be available. You must keep ACF Pro active.
Does this plugin make external requests?
No. All icon data is stored locally in the plugin files (sprite.svg and icons.json). No external API calls or CDN requests are made.
Where are the icons stored?
All icon SVG data is bundled with the plugin in the assets/sprite.svg file. Icon metadata (names and tags) is stored in data/icons.json. Everything runs locally on your server.
Can I use this with ACF Repeater or Flexible Content fields?
Yes, the Lucide Icon field works perfectly within Repeater fields, Flexible Content fields, and any other ACF field groups.
What format does the field return?
You can configure the return format in the field settings:
- Icon Name - Returns the icon name as a string (e.g., "rocket")
- SVG Markup - Returns the complete SVG HTML code
How do I customize the icon appearance?
Use the mudrava_get_lucide_icon() helper function with custom attributes for width, height, stroke color, and CSS classes.
Is the plugin translation-ready?
Yes, the plugin is fully translation-ready with text domain mudrava-acf-lucide-field. Translation files should be placed in the /languages/ directory.
更新日志:
- Initial release
- Visual icon picker with 1,500+ Lucide icons
- Real-time search and filter functionality
- Icon name or SVG return format options
- Helper function for template use
- Allow null option for optional icon selection
- Default value configuration
- Custom placeholder text setting
- Keyboard navigation support
- RTL language support
- Responsive grid layout
- Native ACF styling integration
- Local sprite file (no external requests)
- Bundled icon metadata for instant search
- Full compatibility with ACF Repeater and Flexible Content fields