Omni Icon
| 开发者 |
suabahasa
rosua |
|---|---|
| 更新时间 | 2026年1月12日 14:33 |
| 捐献地址: | 去捐款 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Omni Icon: Modern icon management solution for WordPress
Omni Icon is a comprehensive icon management solution that seamlessly integrates icons across the WordPress ecosystem. Upload custom icons, use bundled icons, or access 200,000+ icons from Iconify with support for Gutenberg, Elementor, Bricks, Breakdance, and LiveCanvas.
Features
Omni Icon is packed with features designed to make icon management effortless:
- Multi-source Icon System: Upload custom SVG icons, use pre-bundled icons, or access 200,000+ Iconify icons
- Icon Search & Discovery: Powerful search across all icon sources with intelligent caching
- Server-Side Rendering (SSR): Icons pre-rendered on server for instant display and optimal performance
- Smart Caching: Multi-layer caching (memory, filesystem, IndexedDB) for blazing fast load times
- Web Component: Use
<omni-icon>custom element anywhere in your theme or content - Secure: SVG sanitization prevents XSS attacks on uploaded icons
- Modern Architecture: Built with PHP 8.2+ attributes, Symfony DI, and auto-discovery
- Lightweight: Small footprint with lazy loading won't slow down your site
- Gutenberg / Block Editor — Custom Icon block with live preview
- Elementor — Native widget with Elementor controls
- Bricks — Native element with full theme compatibility
- Breakdance — Element Studio integration with SSR
- LiveCanvas — Custom block with panel controls
- More integrations coming soon!
- Material Design Icons (mdi)
- Font Awesome (fa6-brands, fa6-regular, fa6-solid)
- Bootstrap Icons (bi)
- Hero Icons (heroicons)
- Lucide (lucide)
- And 150+ more collections
<omni-icon> web component directly in your theme or content:
<omni-icon name="mdi:home"></omni-icon>
<omni-icon name="local:my-logo" width="64" height="64"></omni-icon>
<omni-icon name="fa6-solid:heart" color="#3b82f6"></omni-icon>
Gutenberg:
- In the block editor, add a new "Omni Icon" block
- Click the icon picker to browse or search icons
- Add the "Omni Icon" widget
- Click "Browse Icons" to open the icon picker
- Add the "Omni Icon" element
- Click "Browse Icons" to open the icon picker
- Add the "Omni Icon" element
- Click "Browse Icons" to open the icon picker
- Add the "Omni Icon" element
- Create or edit an ACF Field Group
- Add a new field and select "Omni Icon" as the field type
- Configure return format (string, array, or HTML)
- Lazy Loading: Web components loaded on-demand
- Multi-layer Caching: Memory → Filesystem → IndexedDB
- SSR Support: Icons pre-rendered on server for instant display
- SVG Sanitization: All uploaded SVGs sanitized to prevent XSS
- MIME Type Validation: Server-side validation of uploaded files
- Give a 5-star review
- Join our Facebook Group
- Sponsor us on GitHub or Ko-fi
- Built with Symfony UX Icons
- Powered by Iconify
- SVG sanitization by enshrined/svg-sanitize Affiliate Disclosure: This readme.txt may contain affiliate links. If you decide to make a purchase through these links, we may earn a commission at no extra cost to you.
常见问题:
What icon sources does Omni Icon support?
Omni Icon supports three icon sources:
- Local Icons - Upload your own custom SVG icons
- Bundle Icons - Pre-packaged icons included with the plugin
- Iconify Icons - Access to 200,000+ icons from 150+ collections
How do I use icons in my theme?
You can use the <omni-icon> web component directly in your theme templates:
<omni-icon name="mdi:home"></omni-icon>
The component supports many attributes like width, height, and color for customization.
Which page builders are supported?
Omni Icon currently supports:
- Gutenberg / Block Editor
- Elementor
- Bricks
- Breakdance
- LiveCanvas
- And more coming soon! All integrations include icon picker modals for easy icon selection.
Are uploaded SVG icons safe?
Yes! All uploaded SVG files are sanitized using enshrined/svg-sanitize to prevent XSS attacks and security vulnerabilities.
Does Omni Icon require an internet connection?
For local and bundle icons, no internet connection is required. Iconify icons are fetched from the Iconify API and cached locally for optimal performance.
What is Server-Side Rendering (SSR)?
SSR means icons are pre-rendered on the server and sent as inline SVG in the HTML. This provides instant display without JavaScript required, improving performance and SEO.
Can I use Omni Icon with any WordPress theme?
Yes, Omni Icon is compatible with any WordPress theme. You can use the web component, Gutenberg block, or page builder integrations with any theme.
What 3rd Party services used?
Omni Icon uses the Iconify API to fetch icons from their extensive icon collections.
Where can I find the source code for compiled/minified files?
The complete source code, including uncompiled versions of all JavaScript and CSS files in the dist/ directory, is publicly available on GitHub
更新日志:
1.0.9 - 2026-01-12
Changed
- Update readme file
- [ACF] Discovery compatibility issue
- ACF (Advanced Custom Fields) integration #4 Fixed
- Modal footer visibility on laptop screens - Confirm/Cancel buttons now visible without requiring full-screen mode #3
- WordPress.org plugin repository compliance fixes
- WordPress.org plugin repository compliance fixes
- Multiple and drag-and-drop icon upload support - upload multiple SVG files at once
- Multi-select icons with keyboard shortcuts (Ctrl/Cmd+Click, Shift+Click) and mouse drag area selection for bulk operations
- WordPress.org plugin repository compliance fixes
- 🐣 Initial release. See changelog for all versions.