library wp_on_laravel

meesoverdevest/wp_on_laravel

A package that syncs WordPress posts, categories and tags with your laravel project.

WP-on-Laravel

A Laravel Package which makes use of WordPress to easily manage blog content, but also makes it possible to access all WordPress' posts, categories and tags through Eloquent Models., _(*1)

Requirements

• WP CLI globally installed
• A valid APP_URL in your .env-file

1 Run composer require meesoverdevest/wp_on_laravel

2 Add service provider to config

Add the service provider in config/app.php:, _(*2)

 'providers' = [
   ...
   meesoverdevest\wp_on_laravel\WPServiceProvider::class
 ];

3 Run the installer

Run the following from your project folder: php artisan wol:install $password $email, _(*3)

Replace $password and $email with your wished credentials to use in WordPress., _(*4)

gitignore public/blog if you don't want you content and uploads to be public., _(*5)

4 Install Cartalyst Tags

Our package depends on Cartalyst Tags, which installs automatically as dependency. To be able to use Cartalyst Tags with WP_on_Laravel, you have to run their migrations as well. Doing so: $ php artisan vendor:publish --provider="Cartalyst\Tags\TagsServiceProvider" --tag="migrations" or without publishing php artisan migrate --path=vendor/cartalyst/tags/resources/migrations, _(*6)

5 Run migration

After running the installation command (php artisan wol:install $password $email), _(*7)

Run php artisan migrate to migrate the new migrations, _(*8)

6 Edit NGINX config

To enable outer access to the public WordPress installation you have to add the following to your website's nginx config:, _(*9)

server {
 ...
  location = /blog {
   return 301 /blog/wp-login.php;
  }

  location /blog/wp-json {
    try_files $uri $uri/ /blog/index.php?$query_string;
  } 

  location /blog/wp-admin {
    try_files $uri $uri/ /blog/index.php?$query_string;
  } 

  location / {
    // standard settings
  }
 ...
}

Don't forget to run (sudo) service nginx restart, _(*10)

7 Syncing Wordpress Posts, Categories and Tags

 use meesoverdevest\wp_on_laravel\helpers\WPAPI;

 function syncWP(){
   $WPAPI = new WPAPI();
   $WPAPI->syncWP();
 }

8 Using Wordpress Posts, Categories and Tags

Use them freely inside your project. You can use the models like:, _(*11)

 // WPPost 
 use meesoverdevest\wp_on_laravel\models\WPPost;

 // WPCategory 
 use meesoverdevest\wp_on_laravel\models\WPCategory;

 // Tag (managed by Cartalyst/Tags) 
 use meesoverdevest\wp_on_laravel\models\Tag;

 // Show WPCategories for post
 $posts = WPPost::where('parent', 0)->first()->categories();

 // Show WPosts for tag
 $tag = Tag::first()->posts();

 // Show children WPCategories for parent WPCategory
 $tag = WPCategory::first()->children();

====== TODO ======, _(*12)

1. Add Delete Method and Webhooks to Package and functions.php in Wordpress installation
2. Extend content retrieval methods
3. Normalize the codebase