內容簡介
IconQuarry 為 WordPress 提供一致且易於編輯的圖示工作流程。編輯者可以直接從熟悉的 Gutenberg RichText 工具列選擇、搜尋、調整大小並插入圖示，無需學習額外的設計工具。
【主要功能】
• 支援多種專業圖示來源
• 直接在 Gutenberg 編輯器中使用
• 自訂 SVG 上傳並進行安全處理
• 提供即時預覽與大小控制
• 兼容 KSES 的 Gutenberg 標記
外掛標籤
開發者團隊
原文外掛簡介
IconQuarry brings a consistent, editor-friendly icon workflow to WordPress. Editors can choose, search, size and insert icons directly from the familiar Gutenberg RichText toolbar, while block developers can use the same IconPicker and IconRenderer components in their own blocks.
There is no separate design tool to learn and no need to paste icon markup by hand. The compact picker shows a focused initial selection, offers fast search for larger libraries and previews every icon at the selected size before insertion.
Professional icon sources
Heroicons Outline and Solid
Material Icons Outlined and Round
Font Awesome Free Solid, Regular and Brands
Authenticated Font Awesome Pro/Pro+ Kits and uploaded Kit icons
Custom SVG icons from the WordPress Media Library
Heroicons, Material Icons and Font Awesome Free are bundled locally and do not require external front-end requests. Font Awesome Pro, Pro+ and custom Kit icons are available through an optional authenticated connection.
A natural Gutenberg experience
IconQuarry is available inside the RichText toolbar used by Gutenberg blocks. Editors can select an icon source and variant, search the catalog, choose a size from 12 to 128 pixels and insert the result without leaving the editor. Crisp vector SVG assets keep locally bundled icons consistent in the editor and on the front end.
Built for custom blocks
The same picker and renderer are exposed as reusable React components through the @fxchs/iconquarry package. This gives custom blocks the same polished icon workflow as editorial RichText content and keeps stored icon values consistent throughout a project.
Secure custom SVG uploads
Custom SVG files are sanitized during upload. Scripts, event handlers, external references, foreign objects and unsupported SVG features are removed. Accepted files are marked with the dedicated media type “Icon”, making them easy to filter and manage in both Media Library views.
Private Font Awesome authentication
Font Awesome API tokens are encrypted at rest with AES-256-GCM using a key derived from the WordPress authentication salt. Credentials and temporary access tokens remain server-side and are never returned to editor JavaScript.
Additional highlights
More than 7,000 locally available icons
Per-icon size controls and live previews
Accessible decorative and labelled icon output
KSES-compatible Gutenberg markup
Backward-compatible rendering of previously stored icon values
English and German interfaces based on the WordPress user language
Central settings under Tools → IconQuarry
Development
The distributed plugin includes the complete human-readable JavaScript and SCSS sources, icon-data and translation build scripts, webpack configuration and npm lockfile.
To reproduce the production assets and WordPress installation archive, use Node.js 20.10 or newer and npm 10.2.3 or newer:
Run npm ci.
Run npm run build.
Run npm run plugin-zip.
The resulting iconquarry.zip always contains iconquarry/ as its single top-level plugin directory.
External services
When a Font Awesome account is connected, IconQuarry sends the configured API token to https://api.fontawesome.com/token and sends Kit metadata, search, and authorized SVG-data queries with the resulting access token to https://api.fontawesome.com. This happens when connecting, loading Kits, searching the selected Kit, or rebuilding an expired local icon cache. Font Awesome’s terms and privacy policy apply.
Font Awesome Terms of Service: https://fontawesome.com/tos
Font Awesome Privacy Policy: https://fontawesome.com/privacy
Font Awesome Kit SVGs are defensively sanitized, cached by WordPress, and served from the site’s own domain. IconQuarry does not load executable code from Font Awesome in the editor or front end. Heroicons, Material Icons and Font Awesome Free are bundled locally and do not make external requests.
