PHPackages                             builtnorth/wp-environment-indicator - 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. builtnorth/wp-environment-indicator

ActiveLibrary

builtnorth/wp-environment-indicator
===================================

A simple WordPress environment indicator for the admin bar

v1.0.2(9mo ago)1525GPL-2.0-or-laterPHPPHP >=8.1CI passing

Since Jul 22Pushed 2mo agoCompare

[ Source](https://github.com/builtnorth/wp-environment-indicator)[ Packagist](https://packagist.org/packages/builtnorth/wp-environment-indicator)[ RSS](/packages/builtnorth-wp-environment-indicator/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (4)Versions (4)Used By (0)

WP Environment Indicator
========================

[](#wp-environment-indicator)

A simple composer package that shows the current WordPress environment (development, staging, production) in the admin bar.

[![WP Environment Indicator Screenshot](https://camo.githubusercontent.com/6043ae1d0e24c194f928c2851ada79318eeb93f59978bbfbc7ce3134a7cde076/68747470733a2f2f692e696d6775722e636f6d2f6957494e5835492e706e67)](https://camo.githubusercontent.com/6043ae1d0e24c194f928c2851ada79318eeb93f59978bbfbc7ce3134a7cde076/68747470733a2f2f692e696d6775722e636f6d2f6957494e5835492e706e67)

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

[](#installation)

```
composer require builtnorth/wp-environment-indicator
```

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

Initialize the plugin in your theme or plugin:

```
$indicator = new BuiltNorth\WPEnvironmentIndicator\App();
$indicator->boot();
```

### Custom Configuration

[](#custom-configuration)

Customize the environment colors and labels:

```
use WPEnvironmentIndicator\App;

$indicator = new App();

// Customize environment settings
$indicator->set_config([
    'development' => [
        'color' => '#00ff00',
        'text' => 'Local Dev'
    ],
    'staging' => [
        'color' => '#ffaa00',
        'text' => 'QA Environment'
    ]
]);

$indicator->init();
```

Features
--------

[](#features)

- Automatically detects environment using `WP_ENVIRONMENT_TYPE`
- Shows environment indicator in admin bar
- Customizable colors and labels
- Only visible to users with `manage_options` capability
- Lightweight and efficient

Requirements
------------

[](#requirements)

- PHP 8.0 or higher
- WordPress 5.0 or higher

License
-------

[](#license)

GPL-2.0-or-later

Disclaimer
----------

[](#disclaimer)

This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.

Use of this library is at your own risk. The authors and contributors of this project are not responsible for any damage to your website or any loss of data that may result from the use of this library.

While we strive to keep this library up-to-date and secure, we make no guarantees about its performance, reliability, or suitability for any particular purpose. Users are advised to thoroughly test the library in a safe environment before deploying it to a live site.

By using this library, you acknowledge that you have read this disclaimer and agree to its terms.

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance74

Regular maintenance activity

Popularity18

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.5% 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 ~21 days

Total

2

Last Release

279d ago

PHP version history (2 changes)1.0.1PHP >=8.0

v1.0.2PHP >=8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/4ea760d2fc869dfda680e0bd6dce422606e91d6a1687938a8ebc38a0c29ca343?d=identicon)[dannorthern](/maintainers/dannorthern)

---

Top Contributors

[![dannorthern](https://avatars.githubusercontent.com/u/157666970?v=4)](https://github.com/dannorthern "dannorthern (19 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (2 commits)")

---

Tags

composer-packagewordpresswordpress-composerwordpress-environment

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/builtnorth-wp-environment-indicator/health.svg)

```
[![Health](https://phpackages.com/badges/builtnorth-wp-environment-indicator/health.svg)](https://phpackages.com/packages/builtnorth-wp-environment-indicator)
```

PHPackages © 2026

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