A collection of useful utilities for WordPress plugin development. Includes an Eloquent-inspired ORM, reusable traits, and common helpers.
composer require wedevs/wp-utilsAn Eloquent-inspired ORM built for WordPress. Define models, query with a fluent builder, and get results as typed collections.
use WeDevs\WpUtils\Models\Model;
use WeDevs\WpUtils\Models\Traits\HasTimestamps;
use WeDevs\WpUtils\Models\Traits\SoftDeletes;
class Contact extends Model {
use HasTimestamps, SoftDeletes;
protected static $table = 'crm_contacts';
protected $fillable = [ 'first_name', 'last_name', 'email', 'phone' ];
protected $casts = [
'id' => 'int',
'is_active' => 'bool',
];
protected static function getHookPrefix() {
return 'myplugin';
}
}// Create
$contact = Contact::create( [ 'first_name' => 'John', 'email' => '[email protected]' ] );
// Find
$contact = Contact::find( 1 );
$contact = Contact::findBy( 'email', '[email protected]' );
// Query
$contacts = Contact::query()
->where( 'status', 'active' )
->where( 'age', '>=', 18 )
->orderBy( 'created_at', 'DESC' )
->limit( 10 )
->get();
// Update
$contact->update( [ 'phone' => '555-1234' ] );
// Soft delete & restore
$contact->trash();
$contact->restore();
// Aggregates
$count = Contact::query()->where( 'active', 1 )->count();
$total = Contact::query()->sum( 'amount' );
// Pagination
$result = Contact::query()->paginate( 20, 1 );
// [ 'data' => Collection, 'total' => 150, 'per_page' => 20, ... ]| Trait | Description |
|---|---|
HasTimestamps |
Auto-manages created_at and updated_at columns |
SoftDeletes |
Soft-delete via deleted_at with auto-scoping |
HasHash |
Auto-generates UUID v4 hash on creation |
See docs/models.md for the complete guide covering:
- Model definition and configuration
- Hook prefix system for namespaced WordPress hooks
- Query builder (WHERE, ORDER, LIMIT, aggregates, pagination, bulk operations)
- Accessors, mutators, and dirty tracking
- Collections API
- Trait details (SoftDeletes, HasTimestamps, HasHash)
- Lifecycle hooks and filters reference
Dynamic property storage via __get, __set, __isset, and __unset magic methods.
use WeDevs\WpUtils\Container;
class MyPlugin {
use Container;
public function __construct() {
$this->my_service = new MyService();
$this->my_service->doSomething();
}
}Convenience methods for WordPress action and filter hooks.
use WeDevs\WpUtils\Hooks;
class MyPlugin {
use Hooks;
public function __construct() {
$this->add_action( 'init', 'on_init' );
$this->add_filter( 'the_title', 'filter_title' );
}
public function on_init() {
// ...
}
public function filter_title( $title ) {
return $title . ' - Modified';
}
}Simple logging with level support and optional context data. Debug messages only log when WP_DEBUG is enabled.
use WeDevs\WpUtils\Logger;
class MyPlugin {
use Logger;
public function some_method() {
$this->log_info( 'User logged in', [ 'user_id' => 5 ] );
$this->log_error( 'Payment failed', [ 'order_id' => 123 ] );
$this->log_warning( 'Rate limit approaching' );
$this->log_debug( 'Query executed' ); // only when WP_DEBUG is on
}
}
// Output: [INFO][MyPlugin] User logged in {"user_id":5}Singleton pattern with proper per-class instance isolation.
use WeDevs\WpUtils\Singleton;
class MySingletonClass {
use Singleton;
}
$instance = MySingletonClass::instance();This project is licensed under the GPL 2.0 or Later License.