PHPackages                             balaianu/acf-double-range - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. balaianu/acf-double-range

ActiveWordpress-plugin[Utility &amp; Helpers](/categories/utility)

balaianu/acf-double-range
=========================

A professional double (min–max) range slider field type for Advanced Custom Fields.

v2.0.0(8mo ago)00GPL-2.0-or-laterPHPPHP &gt;=7.4

Since Oct 27Pushed 8mo agoCompare

[ Source](https://github.com/balaianu/acf-double-range)[ Packagist](https://packagist.org/packages/balaianu/acf-double-range)[ RSS](/packages/balaianu-acf-double-range/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (2)Used By (0)

ACF Double Range Field
======================

[](#acf-double-range-field)

The **ACF Double Range Field** extends [Advanced Custom Fields](https://www.advancedcustomfields.com/) by introducing a modern and flexible min–max slider input type. Designed for precision, clarity, and responsiveness, it integrates seamlessly within both the block editor and the classic WordPress experience.

---

Overview
--------

[](#overview)

This plugin provides a clean and intuitive interface for selecting numeric ranges. It combines two synchronized number inputs with a dual-handle slider, offering developers and content editors a more refined way to define numeric intervals.

Key use cases include pricing filters, score ranges, percentage thresholds, or any configuration that requires both a minimum and maximum value.

---

Features
--------

[](#features)

- Fully compatible with **ACF Free** and **ACF PRO (6.0+)**
- Real-time synchronization between slider and numeric inputs
- Smooth cursor behavior and precision typing
- Configurable limits for `min`, `max`, and `step` values
- Adaptive layout for both block editor and sidebar views
- Lightweight implementation with no external dependencies
- Built on WordPress core’s native **jQuery UI Slider**

---

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

[](#installation)

### Using Composer (recommended)

[](#using-composer-recommended)

Install the plugin directly from your project’s root directory:

```
composer require balaianu/acf-double-range
```

Ensure your environment loads the plugin through the standard WordPress bootstrap or an autoloader.

### Manual Installation

[](#manual-installation)

1. Clone or download the repository:

    ```
    git clone https://github.com/balaianu/acf-double-range.git
    ```
2. Copy the folder into your `wp-content/plugins/` directory.
3. Activate **ACF Double Range Field** from the WordPress admin under *Plugins → Installed Plugins*.

---

Usage
-----

[](#usage)

Once activated, the new field type will appear in your ACF field type list.

1. In ACF → *Field Groups* → *Add Field*
2. Choose **Field Type → Double Range**
3. Configure the field options:

    - **Minimum Value**: The lower bound of the range.
    - **Maximum Value**: The upper bound of the range.
    - **Step**: The incremental value between range steps.
    - **Default Values**: Optional initial minimum and maximum settings.

The resulting interface presents two numeric inputs alongside a synchronized range slider, enabling direct numeric entry or visual adjustment.

---

Example
-------

[](#example)

```
[Min Input]  —  [Slider Track]  —  [Max Input]

```

The component automatically validates all inputs, ensuring values remain within the defined limits. Both values are accessible in your template or logic as an associative array:

```
$range = get_field('price_range');
$min = $range['min'];
$max = $range['max'];
```

---

Implementation Notes
--------------------

[](#implementation-notes)

- The field is powered by the ACF Field API and integrates with the existing `acf.registerFieldType` JavaScript interface.
- Validation and reactivity are handled in real time using native event listeners.
- CSS is minimal and adaptive, optimized for both editor and sidebar contexts.
- Built entirely using WordPress core assets — no third-party libraries required.

---

Compatibility
-------------

[](#compatibility)

EnvironmentSupportedACF Free✓ACF PRO (6.0+)✓Classic Editor✓Block Editor / Gutenberg✓PHP 7.4+✓WordPress 5.8+✓---

Versioning
----------

[](#versioning)

The plugin follows **Semantic Versioning** principles:

- **2.0.0** — Initial public release (production stable)
- **2.1.x** — Minor enhancements and refinements
- **3.0.0** — Future major updates with expanded configuration options

---

License
-------

[](#license)

This plugin is open-source software licensed under the **GPLv2 or later** license. You are free to use, modify, and distribute it within the terms of that license.

---

Contributing
------------

[](#contributing)

Contributions are welcome. Please submit pull requests or open issues through [GitHub](https://github.com/balaianu/acf-double-range). For significant changes, start a discussion before submitting a PR.

---

**Maintained by [Andrei Balaianu](https://github.com/balaianu)**

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance61

Regular maintenance activity

Popularity0

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 57.1% 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

Unknown

Total

1

Last Release

249d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5259461?v=4)[Andrei Costin Balaianu](/maintainers/balaianu)[@balaianu](https://github.com/balaianu)

---

Top Contributors

[![balaianu](https://avatars.githubusercontent.com/u/5259461?v=4)](https://github.com/balaianu "balaianu (4 commits)")[![OGAndreiB](https://avatars.githubusercontent.com/u/172387465?v=4)](https://github.com/OGAndreiB "OGAndreiB (3 commits)")

---

Tags

acfacf-addonadvanced-custom-fieldsadvanced-custom-fields-prodouble-rangerange-sliderwordpresswordpress-plugin

### Embed Badge

![Health badge](/badges/balaianu-acf-double-range/health.svg)

```
[![Health](https://phpackages.com/badges/balaianu-acf-double-range/health.svg)](https://phpackages.com/packages/balaianu-acf-double-range)
```

###  Alternatives

[nette/utils

🛠 Nette Utils: lightweight utilities for string &amp; array manipulation, image handling, safe JSON encoding/decoding, validation, slug or strong password generating etc.

2.1k430.4M1.7k](/packages/nette-utils)[dgr/nohup

A library to run a command in the background, it will return the process's pid, and get it's is running status anytime in the another process, and can be stoped anytime. It support Windows, Linux and Mac osx.

531.7k](/packages/dgr-nohup)

PHPackages © 2026

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