PHPackages                             helsingborg-stad/acf-select-image-field - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. helsingborg-stad/acf-select-image-field

ActiveWordpress-muplugin

helsingborg-stad/acf-select-image-field
=======================================

1.6.1(1y ago)322.0k—0%[1 PRs](https://github.com/helsingborg-stad/acf-image-select-field/pulls)3MITJavaScript

Since Sep 28Pushed 1y ago4 watchersCompare

[ Source](https://github.com/helsingborg-stad/acf-image-select-field)[ Packagist](https://packagist.org/packages/helsingborg-stad/acf-select-image-field)[ RSS](/packages/helsingborg-stad-acf-select-image-field/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)DependenciesVersions (37)Used By (3)

ACF Image Select MU Plugin
==========================

[](#acf-image-select-mu-plugin)

The ACF Image Select MU (Must Use) plugin is a custom field type for Advanced Custom Fields (ACF) that allows you to use radio buttons with images as options. This makes it easy to create visually appealing and user-friendly selections in your WordPress projects.

Installation
------------

[](#installation)

1. Download the latest release.
2. Upload the `acf-image-select` folder to your WordPress `mu-plugins` directory (usually `wp-content/mu-plugins`). If the `mu-plugins` directory does not exist, you can create it.
3. The plugin will be automatically activated as an MU plugin when placed in the `mu-plugins` directory.

Usage
-----

[](#usage)

Once the ACF Image Select MU plugin is activated, you can use the new field type in your ACF field groups. Here's how to set it up:

1. Create or edit a field group in the ACF settings.
2. Add a new field and select "Image Select" as the field type.
3. Configure the field settings with labels (visible in the backend of a post) and the value (the name of the image and also the actual value of the field in backend).
4. Add the field group to your posts, pages, or custom post types.

Customization
-------------

[](#customization)

To add your own images:

1. Upload your own svg file to the assets folder. The name of the file will now be available in the field settings. It will also automatically become the value of the field.

Limitations
-----------

[](#limitations)

**Normal Conditionals (Basic)**The ACF Image Select plugin has the following limitations regarding conditional logic:

- It supports either "and" or "or" conditionals. Not both.

    **Supported Conditionals:**

    - "image select" != "condition1" AND "image select" != "condition2"
    - "image select" == "condition1" OR "image select" == "condition2"

    **Unsupported Conditionals:**

    - "image select" != "condition1" OR "image select" != "condition2" AND "image select" != "condition3"

This solution will allow basic conditional logic that will work in most cases.

**Use Acf Conditionals (Advanced)**

- When creating an Image select field. Also create a "hidden" field with the same name like "{my\_field\_name}\_conditional.
- Set the conditions to this field instead of Image Select.
- It will update the value of this field each time the Image Select field changes and work like default ACF conditions.

Please keep these limitations in mind when implementing conditional logic with the ACF Image Select field.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance41

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 73.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~22 days

Recently: every ~36 days

Total

22

Last Release

488d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f46fe64973c3e89d15c745c0bf601c25983bafea81d30e64d4bf813a6f8c8c7c?d=identicon)[sebastianthulin](/maintainers/sebastianthulin)

---

Top Contributors

[![NiclasNorin](https://avatars.githubusercontent.com/u/103985736?v=4)](https://github.com/NiclasNorin "NiclasNorin (28 commits)")[![sebastianthulin](https://avatars.githubusercontent.com/u/797129?v=4)](https://github.com/sebastianthulin "sebastianthulin (7 commits)")[![Sven65](https://avatars.githubusercontent.com/u/10225982?v=4)](https://github.com/Sven65 "Sven65 (3 commits)")

### Embed Badge

![Health badge](/badges/helsingborg-stad-acf-select-image-field/health.svg)

```
[![Health](https://phpackages.com/badges/helsingborg-stad-acf-select-image-field/health.svg)](https://phpackages.com/packages/helsingborg-stad-acf-select-image-field)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)