Open Icons for ACF (Lite)

Àpèjúwe

Open Icons for ACF (Lite) adds a custom field type to Advanced Custom Fields (ACF) that lets you select and display SVG icons from the Heroicons library. All 324 icons are bundled with the plugin — no external downloads required.

Features:

  • 324 Heroicons Ìtumọ̀ Yorùbá: – Beautiful, hand-crafted SVG icons by the makers of Tailwind CSS
  • Color palette Ìtumọ̀ Yorùbá: – Define up to 3 color tokens and apply them to icons
  • Bundled locally Ìtumọ̀ Yorùbá: – All icons are included in the plugin, no external requests needed
  • Clean output Ìtumọ̀ Yorùbá: – Simple get_openicon() helper function for displaying icons
  • Sanitised SVGs Ìtumọ̀ Yorùbá: – All icons are sanitised for security

How it works:

  1. Add an “Open Icons” field to your ACF field group
  2. Select an icon and color from the beautiful picker interface
  3. Display the icon in your theme using the get_openicon() function

Display icons in your theme:

php
<?php
$icon = get_field('your_icon_field');
get_openicon($icon, ['size' => 24, 'class' => 'my-icon']);
?>

Want more icons?

Open Icons for ACF Premium unlocks:

  • Lucide Icons Ìtumọ̀ Yorùbá: – 1,500+ icons
  • Tabler Icons Ìtumọ̀ Yorùbá: – 5,200+ icons
  • Custom Icons Ìtumọ̀ Yorùbá: – Add your own set of icons
  • Icon migration tools when switching providers
  • Priority support

Development

The src/ directory contains the uncompiled React/TypeScript source code for the admin UI components.

Source code is available on GitHub:
https://github.com/davidosull/open-icons-acf-lite.git

To build from source:

  1. Clone the repository
  2. Run npm install
  3. Run npm run build

This will bundle the Heroicons SVGs into assets/icons/ and compile the TypeScript/React source into assets/build/.

Ìgbéwọlẹ̀

  1. Upload the open-icons-acf folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Ensure you have Advanced Custom Fields installed and activated
  4. Create a new field with the “Open Icons” type

FAQ

Does this plugin require ACF?

Yes, Open Icons for ACF (Lite) requires Advanced Custom Fields (free or Pro) to be installed and activated.

Can I use this with ACF PRO?

Absolutely! Open Icons for ACF (Lite) works with both the free version of ACF and ACF PRO.

Can I have both Lite and Premium versions active?

No. The plugin will automatically prevent you from activating both versions simultaneously to avoid conflicts.

How do I display an icon in my theme?

Use the get_openicon() function:

php
$icon = get_field('icon');
get_openicon($icon, ['size' => 24, 'class' => 'my-icon']);

Can I change the icon color dynamically?

Yes! Pass a color parameter:

php
get_openicon($icon, ['color' => '#ff0000']);

What icons are included?

The Lite version includes the full Heroicons library (324 icons). For access to Lucide (1,500+ icons) and Tabler (5,200+ icons), consider upgrading to Premium.

Àwọn àgbéyẹ̀wò

Kò sí àwọn àgbéyẹ̀wò fún plugin yìí.

Àwọn Olùkópa & Olùgbéejáde

“Open Icons for ACF (Lite)” jẹ́ ètò ìṣàmúlò orísun ṣíṣí sílẹ̀. Àwọn ènìyàn wọ̀nyí ti ṣe ìkópa sí plugin yìí.

Àwọn Olùkópa

Túmọ̀ “Open Icons for ACF (Lite)” sí èdè rẹ.

Ṣe o nífẹ̀ẹ́ sí ìdàgbàsókè?

Ṣàwárí koodu, ṣàyẹ̀wò ibi ìpamọ́ SVN, tàbí ṣe àgbékalẹ̀ sí àkọsílẹ̀ ìdàgbàsókè nípasẹ̀ RSS.

Àkọsílẹ̀ àwọn àyípadà

1.0.3

  • Release packaging fix.

1.0.2

  • Improved icon picker browsing with a search-first layout and a dedicated “Browse all icons” action.
  • Added a “Common Icons” section that learns from usage frequency and recency to surface frequently selected icons.
  • Upgraded picker rendering with virtualised grid loading for smoother performance when browsing large icon lists.
  • Improved keyboard and scroll behaviour across recent, common, and full icon lists.

1.0.1

  • Compatibility update for Pro migration release.
  • Added explicit conflict detection support for renamed Pro plugin paths and constants.

1.0.0

  • Initial release of Open Icons for ACF (Lite).
  • Breaking: Renamed public helper function from openicon_open_icon() to get_openicon(). Update any theme templates that reference the old function name.