PHPackages                             franciscoblancojn/wordpress\_utils - 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 & Helpers](/categories/utility)
4. /
5. franciscoblancojn/wordpress\_utils

ActiveLibrary[Utility & Helpers](/categories/utility)

franciscoblancojn/wordpress\_utils
==================================

Libreria que ofrece multiples funcionalidades

v1.0.5(3mo ago)027↓77.8%MITPHP

Since Mar 20Pushed 2w agoCompare

[ Source](https://github.com/franciscoblancojn/wordpress_utils)[ Packagist](https://packagist.org/packages/franciscoblancojn/wordpress_utils)[ RSS](/packages/franciscoblancojn-wordpress-utils/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (7)Used By (0)

wordpress\_utils
================

[](#wordpress_utils)

[![PHP Version](https://camo.githubusercontent.com/6eff5053a32c9e0bcc0982c4f118ef689cad7831a3d982767aae3901bf67313c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d253345253344372e342d626c75652e737667)](https://php.net/)[![License](https://camo.githubusercontent.com/784362b26e4b3546254f1893e778ba64616e362bd6ac791991d2c9e880a3a64e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e737667)](LICENSE)[![Packagist](https://camo.githubusercontent.com/ce990b8a4e66bc1537bf93e17fbbdcf79efb2b7f5759b7121a03028997317413/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6672616e636973636f626c616e636f6a6e2f776f726470726573735f7574696c732e737667)](https://packagist.org/packages/franciscoblancojn/wordpress_utils)

Una librería PHP moderna para WordPress que ofrece utilidades reutilizables, comenzando con un sistema de logs dinámico y extensible.

---

🚀 Características
-----------------

[](#-características)

- ✅ Sistema de logs dinámico por clave (`key`)
- ✅ Persistencia usando `get_option` / `update_option`
- ✅ Interfaz visual en el panel de administración de WordPress
- ✅ Soporte para múltiples logs independientes
- ✅ Fácil integración con plugins existentes
- ✅ Compatible con Composer (PSR-4)

---

📦 Instalación
-------------

[](#-instalación)

### Vía Composer

[](#vía-composer)

```
composer require franciscoblancojn/wordpress_utils
```

---

⚡ Inicio Rápido
---------------

[](#-inicio-rápido)

### 1. Cargar Composer en tu plugin

[](#1-cargar-composer-en-tu-plugin)

```
require_once __DIR__ . '/vendor/autoload.php';
```

### 2. Inicializar el sistema de logs

[](#2-inicializar-el-sistema-de-logs)

```
use franciscoblancojn\wordpress_utils\FWUSystemLog;

FWUSystemLog::init("MY_PLUGIN_SLUG");
```

### 3. Agregar logs

[](#3-agregar-logs)

```
FWUSystemLog::add("MY_PLUGIN_SLUG", [
    "type"    => "API",
    "message" => "Solicitud enviada correctamente",
    "data"    => ["id" => 123]
]);
```

### 4. Ver logs en WordPress

[](#4-ver-logs-en-wordpress)

Una vez inicializado, aparecerá una nueva opción en el menú del administrador:

> 👉 **MY\_PLUGIN\_SLUG\_LOG**

Desde esta página podrás **ver**, **copiar** y **limpiar** los logs registrados.

---

🧠 Conceptos
-----------

[](#-conceptos)

### 🔑 Clave (`key`)

[](#-clave-key)

Cada log funciona de forma completamente independiente usando una clave única:

```
FWUSystemLog::init("PAYMENTS");
FWUSystemLog::init("ORDERS");
```

### 🗂️ Tipos de log

[](#️-tipos-de-log)

Los logs se agrupan automáticamente por el campo `type`:

```
FWUSystemLog::add("MY_PLUGIN_SLUG", [
    "type"    => "ERROR",
    "message" => "Falló conexión"
]);
```

---

⚙️ Configuración opcional
-------------------------

[](#️-configuración-opcional)

Puedes personalizar el comportamiento definiendo constantes antes de llamar a `init()`:

ConstanteTipoDescripción`MY_PLUGIN_SLUG_LOG``bool`Activa o desactiva el sistema de logs`MY_PLUGIN_SLUG_LOG_COUNT``int`Cantidad máxima de registros por tipo`MY_PLUGIN_SLUG_LOG_KEY``string`Clave personalizada para almacenamiento en la DB```
define("MY_PLUGIN_SLUG_LOG",       true);          // activar/desactivar logs
define("MY_PLUGIN_SLUG_LOG_COUNT", 50);            // cantidad máxima por tipo
define("MY_PLUGIN_SLUG_LOG_KEY",   "custom_key");  // clave en la DB
```

---

🧪 Ejemplo completo
------------------

[](#-ejemplo-completo)

```
use franciscoblancojn\wordpress_utils\FWUSystemLog;

// Inicializar
FWUSystemLog::init("MY_PLUGIN_SLUG");

// Agregar log
FWUSystemLog::add("MY_PLUGIN_SLUG", [
    "type"    => "DEBUG",
    "message" => "Plugin cargado",
    "data"    => ["user" => get_current_user_id()]
]);
```

---

⚠️ Requisitos
-------------

[](#️-requisitos)

- PHP >= 7.4
- WordPress (usa funciones como `get_option`, `add_action`, etc.)
- Composer (recomendado)

---

💡 Notas
-------

[](#-notas)

- La librería **solo funciona dentro de WordPress**
- Los logs se almacenan en la tabla `wp_options`
- Pensado para **debugging y monitoreo interno** de plugins

---

📝 Licencia
----------

[](#-licencia)

Este proyecto está bajo la licencia [MIT](LICENSE). Eres libre de usarlo, modificarlo y distribuirlo.

---

👨‍💻 Autor
---------

[](#‍-autor)

**Francisco Blanco**
🔗 [franciscoblanco.vercel.app](https://franciscoblanco.vercel.app/)

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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 ~0 days

Total

6

Last Release

98d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/20581359?v=4)[Francisco Blanco](/maintainers/franciscoblancojn)[@franciscoblancojn](https://github.com/franciscoblancojn)

---

Top Contributors

[![franciscoblancojn](https://avatars.githubusercontent.com/u/20581359?v=4)](https://github.com/franciscoblancojn "franciscoblancojn (19 commits)")

### Embed Badge

![Health badge](/badges/franciscoblancojn-wordpress-utils/health.svg)

```
[![Health](https://phpackages.com/badges/franciscoblancojn-wordpress-utils/health.svg)](https://phpackages.com/packages/franciscoblancojn-wordpress-utils)
```

###  Alternatives

[markrassamni/inline-boolean

A Laravel Nova boolean field that can be directly edited from the index or detail page of a resource.

16162.8k](/packages/markrassamni-inline-boolean)

PHPackages © 2026

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