This package allows you to use WordPress as backend (admin panel) and retrieve its data using Eloquent, with any PHP project or even framework.

Corcel is a class collection created to retrieve WordPress database data using a better syntax. It uses the Eloquent ORM developed for the Laravel Framework, but you can use Corcel in any type of PHP project, with any framework, including Laravel.

This way, you can use WordPress as the backend (admin panel), to insert posts, custom types, etc, and you can use whatever you want in the frontend, like Silex, Slim Framework, Laravel, Zend, or even pure PHP (why not?). So, just use Corcel to retrieve data from WordPress.


To install Corcel, just run the following command:

composer require jgrossi/corcel

Or you can include Corcel inside composer.json, run composer install and wait the installation process.

"require": { "jgrossi/corcel": "~1.0.0" },


If you are using Laravel you do not need to configure database again. It’s all already set by Laravel. So you have only to change the config/database.php config file and set yours connections. You can use just one connection or two (one for your Laravel app and another to Corcel). Your file will look like this:

// File: /config/database.php 'connections' => [ 'mysql' => [ // this is your Laravel database connection 'driver' => 'mysql', 'host' => 'localhost', 'database' => 'app', 'username' => 'admin' 'password' => 'secret', 'charset' => 'utf8', 'collation' => 'utf8_unicode_ci', 'prefix' => '', 'strict' => false, 'engine' => null, ], 'wordpress' => [ // this is your Corcel database connection, where WordPress tables are 'driver' => 'mysql', 'host' => 'localhost', 'database' => 'corcel', 'username' => 'admin', 'password' => 'secret', 'charset' => 'utf8', 'collation' => 'utf8_unicode_ci', 'prefix' => 'wp_', 'strict' => false, 'engine' => null, ], ],

Now you should create your own Post model class. Laravel stores model classes in app directory, inside App namespace (or the name you gave it). Your Post class should extends Corcel\Post and set the connection name you’re using, in this case wordpress:

// File: app/Post.php namespace App; use Corcel\Post as Corcel; class Post extends Corcel { protected $connection = 'wordpress'; }

So, now you can fetch database data:

$posts = App\Post::all(); // using the 'wordpress' connection $posts = Corcel\Post::all(); // using the 'default' Laravel connection


Every time you see Post::method(), if you’re using your own Post class (where you set the connection name), like App\Post you should use App\Post::method() and not Post::method(). All the examples are assuming you already know this difference.
// All published posts $posts = Post::published()->get(); $posts = Post::status('publish')->get(); // A specific post $post = Post::find(31); echo $post->post_title; // Filter by meta/custom field $posts = Post::published()->hasMeta('field')->get(); $posts = Post::hasMeta('acf')->get();

You can retrieve meta data from posts too.

// Get a custom meta value (like 'link' or whatever) from a post (any type) $post = Post::find(31); echo $post->meta->link; // OR echo $post->fields->link; echo $post->link; // OR

Updating post custom fields:

$post = Post::find(1); $post->meta->username = 'juniorgrossi'; $post->meta->url = ''; $post->save();

Inserting custom fields:

$post = new Post; $post->save(); $post->meta->username = 'juniorgrossi'; $post->meta->url = ''; $post->save();

Custom Post Type

You can work with custom post types too. You can use the type(string) method or create your own class.

// using type() method $videos = Post::type('video')->status('publish')->get(); // using your own class class Video extends Corcel\Post { protected $postType = 'video'; } $videos = Video::status('publish')->get();

Using type() method will make Corcel to return all objects as Corcel\Post. Using your custom class you have the advantage to customize classes, including custom methods and properties, return all objects as Video, for example.

Custom post types and meta data:

// Get 3 posts with custom post type (store) and show its address $stores = Post::type('store')->status('publish')->take(3)->get(); foreach ($stores as $store) { $storeAddress = $store->address; // option 1 $storeAddress = $store->meta->address; // option 2 $storeAddress = $store->fields->address; // option 3 }

Single Table Inheritance

If you choose to create a new class for your custom post type, you can have this class be returned for all instances of that post type.

//all objects in the $videos Collection will be instances of Post $videos = Post::type('video')->status('publish')->get(); // register the video custom post type and its particular class Post::registerPostType('video', '\App\Video') //now all objects in the $videos Collection will be instances of Video $videos = Post::type('video')->status('publish')->get();

You can also do this for inbuilt classes, such as Page or Post. Simply register the Page or Post class with the associated post type string, and that object will be returned instead of the default one.

This is particular useful when you are intending to get a Collection of Posts of different types (e.g. when fetching the posts defined in a menu).


You can get taxonomies for a specific post like:

$post = Post::find(1); $taxonomy = $post->taxonomies()->first(); echo $taxonomy->taxonomy;

Or you can search for posts using its taxonomies:

$post = Post::taxonomy('category', 'php')->first();


Pages are like custom post types. You can use Post::type(‘page’) or the Page class.

// Find a page by slug $page = Page::slug('about')->first(); // OR $page = Post::type('page')->slug('about')->first(); echo $page->post_title;

Categories & Taxonomies

Get a category or taxonomy or load posts from a certain category. There are multiple ways to achieve it.

// all categories $cat = Taxonomy::category()->slug('uncategorized')->posts()->first(); echo "
"; print_r($cat->name); echo "
"; // only all categories and posts connected with it $cat = Taxonomy::where('taxonomy', 'category')->with('posts')->get(); $cat->each(function($category) { echo $category->name; }); // clean and simple all posts from a category $cat = Category::slug('uncategorized')->posts()->first(); $cat->posts->each(function($post) { echo $post->post_title; });

Attachment and Revision

Getting the attachment and/or revision from a Post or Page.

$page = Page::slug('about')->with('attachment')->first(); // get feature image from page or post print_r($page->attachment); $post = Post::slug('test')->with('revision')->first(); // get all revisions from a post or page print_r($post->revision);


To get a menu by its slug, use the syntax below. The menu items will be loaded in the nav_items variable. The currently supported menu items are: Pages, Posts, Links, Categories, Tags.

$menu = Menu::slug('primary')->first(); foreach ($menu->nav_items as $item) { // .... 'post_title' => '....', // Nav item name 'post_name' => '....', // Nav item slug 'guid' => '....', // Nav full url, influent by permalinks // .... }

To handle multi-levels menus, loop through all the menu items to put them on the right levels in an array. Then, you can walk through the items recursively.

Here’s just a basic example:

// first, set all menu items on their level $menuArray = array(); foreach ($menu->nav_items as $item) { $parent_id = $item->meta->_menu_item_menu_item_parent; $menuArray[$parent_id][] = $item; } // now build the menu foreach ($menuArray[0] as $item) { echo '.. menu item main ..'; if (isset($menuArray[$item->ID])) { foreach($menuArray[$item->ID] as $subItem) { echo '.. show sub menu item ..'; } } }


You can manipulate users in the same manner you work with posts:

// All users $users = User::get(); // A specific user $user = User::find(1); echo $user->user_login;


Using laravel

You will have to register Corcel’s authentication service provider in config/app.php :

'providers' => [ // Other Service Providers Corcel\Providers\Laravel\AuthServiceProvider::class, ],

And then, define the user provider in config/auth.php :

'providers' => [ 'users' => [ 'driver' => 'corcel', 'model' => Corcel\User::class, ], ],

To make Laravel’s Password Reset work with Corcel, we have to override how passwords are stored in the database. To do this, you must change Auth/PasswordController.php from :

use App\Http\Controllers\Controller; use Illuminate\Foundation\Auth\ResetsPasswords; class PasswordController extends Controller { use ResetsPasswords;
use App\Http\Controllers\Controller; use Illuminate\Foundation\Auth\ResetsPasswords; use Corcel\Auth\ResetsPasswords as CorcelResetsPasswords; class PasswordController extends Controller { use ResetsPasswords, CorcelResetsPasswords { CorcelResetsPasswords::resetPassword insteadof ResetsPasswords; }

Originally published at

Like what you read? Give LaravelFeed a round of applause.

From a quick cheer to a standing ovation, clap to show how much you enjoyed this story.