PHPackages                             phillipjohnson/wordpress-eloquent-clone - 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. phillipjohnson/wordpress-eloquent-clone

ActiveLibrary

phillipjohnson/wordpress-eloquent-clone
=======================================

A Laravel wrapper for wordpress which turns all Wordpress models into Laravel Eloquent Models.

0191PHP

Since May 28Pushed 6y ago2 watchersCompare

[ Source](https://github.com/philJohnson/wordpress-eloquent-clone)[ Packagist](https://packagist.org/packages/phillipjohnson/wordpress-eloquent-clone)[ RSS](/packages/phillipjohnson-wordpress-eloquent-clone/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (1)Used By (0)

Wordpress Laravel Eloquent Models
---------------------------------

[](#wordpress-laravel-eloquent-models)

[![](https://camo.githubusercontent.com/1dfedbae65fc9038b1823809b2675564207682c6d22b4e53d1c8ad77e4cbfbde/687474703a2f2f647265776a626172746c6574742e636f6d2f696d616765732f6769746875622f6c6f676f2d6c61726176656c2e737667)](https://camo.githubusercontent.com/1dfedbae65fc9038b1823809b2675564207682c6d22b4e53d1c8ad77e4cbfbde/687474703a2f2f647265776a626172746c6574742e636f6d2f696d616765732f6769746875622f6c6f676f2d6c61726176656c2e737667)[![](https://camo.githubusercontent.com/7aa74a43df31c0c0df3a4e7346efbbd7fc597033950a3a82ce3752b0feb82465/687474703a2f2f647265776a626172746c6574742e636f6d2f696d616765732f6769746875622f776f726470726573732d6c6f676f2e706e67)](https://camo.githubusercontent.com/7aa74a43df31c0c0df3a4e7346efbbd7fc597033950a3a82ce3752b0feb82465/687474703a2f2f647265776a626172746c6574742e636f6d2f696d616765732f6769746875622f776f726470726573732d6c6f676f2e706e67)

A library that converts converts wordpress tables into [Laravel Eloquent Models](https://laravel.com/docs/5.3/eloquent). This is helpful for dropping into any wordpress project where maybe you'd rather use the awesome features of Laravel's Eloquent Models. Or maybe you're writing an API with something like [Slim](https://www.slimframework.com/) or better yet [Lumen](https://lumen.laravel.com/) don't want to increase your load time by loading the entire WP core. This is a great boiler plate based off [Eloquent](https://laravel.com/docs/5.3/eloquent) by Laravel to get you going.

\*\* This is documentation for additional functionality on top of Eloquent. For documentation on all of Eloquent's features you visit the [documentation](https://laravel.com/docs/5.3/eloquent).

Overview
--------

[](#overview)

- [Installation](#installation)
- [Setup](#setup)
- [Posts](#posts)
- [Comments](#comments)
- [Terms](#terms)
- [Users](#users)
- [Meta](#meta)
- [Options](#options)
- [Links](#links)
- [Extending your own models](#extending-your-own-models)
- [Query Logs](#query-logs)

### Installation

[](#installation)

```
composer require drewjbartlett/wordpress-eloquent

```

### Setup

[](#setup)

```
require_once('vendor/autoload.php');

\WPEloquent\Core\Laravel::connect([
    'global' => true,

    'config' => [

        'database' => [
            'user'     => 'user',
            'password' => 'password',
            'name'     => 'database',
            'host'     => '127.0.0.1',
            'port'     => '3306'
        ],

        // your wpdb prefix
        'prefix' => 'wp_',
    ],

    // enable events
    'events' => false,

    // enable query log
    'log'    => true
]);
```

If you wanted to enable this on your entire WP install you could create a file with the above code to drop in the `mu-plugins` folder.

### Posts

[](#posts)

```
use \WPEloquent\Model\Post;

// getting a post
$post = Post::find(1);

// available relationships
$post->author;
$post->comments;
$post->terms;
$post->tags;
$post->categories;
$post->meta;
```

***Statuses***

By default, the `Post` returns posts with all statuses. You can however override this with the [local scope](https://laravel.com/docs/5.3/eloquent#query-scopes) `published` to return only published posts.

```
Post::published()->get();
```

Or if you need a specific status you can override with defined status via [local scope](https://laravel.com/docs/5.3/eloquent#query-scopes).

```
Post::status('draft')->get();
```

***Post Types***

By default, the `Post` returns posts with all post types. You can however override this by defining a post type via [local scope](https://laravel.com/docs/5.3/eloquent#query-scopes).

```
Post::type('page')->get();
```

### Comments

[](#comments)

```
use \WPEloquent\Model\Comment;

// getting a comment
$comment = Comment::find(12345);

// available relationships
$comment->post;
$comment->author;
$comment->meta
```

### Terms

[](#terms)

In this version `Term` is still accesible as a model but is only leveraged through posts.

```
$post->terms()->where('taxonomy', 'country');
```

### Users

[](#users)

```
use \WPEloquent\Model\User;

// getting a comment
$user = User::find(123);

// available relationships
$user->posts;
$user->meta;
$user->comments
```

### Meta

[](#meta)

The models `Post`, `User`, `Comment`, `Term`, all implement the `HasMeta`. Therefore they meta can easily be retrieved by the `getMeta` and set by the `setMeta` helper functions:

```
$post = Post::find(1);
$post->setMeta('featured_image', 'my-image.jpg');
$post->setMeta('breakfast', ['waffles' => 'blueberry', 'pancakes' => 'banana']);

// or all in one call
$featured_image = Post::find(1)->getMeta('featured_image');
Post::find(1)->setMeta('featured_image', 'image.jpg');

// same applies for all other models

$user = User::find(1)
$facebook = $user->getMeta('facebook');
$user->setMeta('social', ['facebook' => 'facebook.com/me', 'instagram' => 'instagram.com/me']);

$comment = Comment::find(1);
$meta = $comment->getMeta('some_comment_meta');

$term = Term::find(123);
$meta = $term->getMeta('some_term_meta');

// delete meta
$post = Post::find(123)->deleteMeta('some_term_meta');
```

### Options

[](#options)

In wordpress you can use `get_option`. Alternatively, if you don't want to load the wordpress core you can use helper function `getValue`.

```
use \WPEloquent\Model\Post;

$siteurl = Option::getValue('siteurl');
```

Or of course, the long form:

```
use \WPEloquent\Model\Options;

$siteurl = Option::where('option_name', 'siteurl')->value('option_value');
```

### Links

[](#links)

```
use \WPEloquent\Model\Link;

$siteurl = Link::find(1);
```

### Extending your own models

[](#extending-your-own-models)

If you want to add your own functionality to a model, for instance a `User` you can do so like this:

```
namespace App\Model;

class User extends \WPEloquent\Model\User {

    public function orders() {
        return $this->hasMany('\App\Model\User\Orders');
    }

    public function current() {
        // some functionality to get current user
    }

    public function favorites() {
        return $this->hasMany('Favorites');
    }

}
```

Another example would be for custom taxonomies on a post, say `country`

```
namespace App\Model;

class Post extends \WPEloquent\Model\Post {

    public function countries() {
        return $this->terms()->where('taxonomy', 'country');
    }

}

Post::with(['categories', 'countries'])->find(1);
```

### Query Logs

[](#query-logs)

Sometimes it's helpful to see the query logs for debugging. You can enable the logs by passing `log` is set to `true` (see [setup](#setup)) on the `Laravel::connect` method. Logs are retrieved by running.

```
use \WPEloquent\Core\Laravel;

print_r(Laravel::queryLog());
```

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/9d7ae7923820697ad84243c85f2c7e1469dba6314f5f777f7d8ed89ae062d193?d=identicon)[thelippyj](/maintainers/thelippyj)

### Embed Badge

![Health badge](/badges/phillipjohnson-wordpress-eloquent-clone/health.svg)

```
[![Health](https://phpackages.com/badges/phillipjohnson-wordpress-eloquent-clone/health.svg)](https://phpackages.com/packages/phillipjohnson-wordpress-eloquent-clone)
```

PHPackages © 2026

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