dbout/wp-orm

WordPress ORM with Eloquent.

v4.0.0 2024-12-14 13:30 UTC

Requires

• php: >=8.2
• illuminate/database: ^11.0
• laravel/serializable-closure: ^1.3

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.64
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^1.12
• phpunit/phpunit: ^11.0
• rector/rector: ^1.2
• roots/wordpress: ^6.6
• szepeviktor/phpstan-wordpress: ^1.3
• yoast/phpunit-polyfills: ^3.0

Suggests

• illuminate/events: Add events to your models

MIT

• Dimitri BOUTEILLE

• database
• orm
• sql
• db
• wordpress
• migration
• eloquent
• wp

README

WordPress ORM with Eloquent is a small library that adds a basic ORM into WordPress, which is easily extendable and includes models for core WordPress models such as posts, post metas, users, comments and more. The ORM is based on Eloquent ORM and uses the WordPress connection (wpdb class).

Tip

To simplify the integration of this library, we recommend using WordPress with one of the following tools: Bedrock, Themosis or Wordplate.

Features

• ✅ Support core WordPress models: Comment, Option, Post, TermTaxonomy, Term, User, PostMeta and UserMeta
• ✅ Support core WordPress post type: Article, Attachment and Page
• ✅ Based on core WordPress database connection (wpdb class), no configuration required !
• ✅ Custom functions to filter models with meta
• ✅ Meta casting (e.g. Attribute Casting)
• ❤️ Easy integration of a custom post and comment type
• ❤️ Easy model creation for projects with custom tables
• ❤️ All the features available in Eloquent, are usable with this library !

Not yet developed but planned in a future version:

• 🗓️ Create migration tool with Eloquent

Documentation

This documentation only covers the specific points of this library, if you want to know more about Eloquent, the easiest is to look at the documentation of Eloquent.

You can find all the documentation in the wiki.

Installation

Requirements

The server requirements are basically the same as for WordPress with the addition of a few ones :

• PHP >= 8.2
• Composer

Installation

You can use Composer. Follow the installation instructions if you do not already have composer installed.

composer require dbout/wp-orm

In your PHP script, make sure you include the autoloader:

require __DIR__ . '/vendor/autoload.php';

🎉 You have nothing more to do, you can use the library now! Not even need to configure database accesses because it's the wpdb connection that is used.

Contributing

We encourage you to contribute to this repository, so everyone can benefit from new features, bug fixes, and any other improvements. Have a look at our contributing guidelines to find out how to raise a pull request.