Open Icons for ACF (Lite)

Description

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 – Beautiful, hand-crafted SVG icons by the makers of Tailwind CSS
  • Color palette – Define up to 3 color tokens and apply them to icons
  • Bundled locally – All icons are included in the plugin, no external requests needed
  • Clean output – Simple get_openicon() helper function for displaying icons
  • Sanitised SVGs – 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 – 1,500+ icons
  • Tabler Icons – 5,200+ 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/.

Installation

  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.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Open Icons for ACF (Lite)” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

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.