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. balaianu/acf-double-range

ActiveWordpress-plugin

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

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

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

Since Oct 27Pushed 6mo 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 1mo ago

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

29

—

LowBetter than 60% of packages

Maintenance71

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

193d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/36c7842cad00a390796a9e16f72950e7d4181249e3ce7a2a4c56b9c7ff8e1622?d=identicon)[balaianu](/maintainers/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)
```

PHPackages © 2026

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