ekandreas/bladerunner

WordPress Blade L5 template engine

Wednesday, December 20, 2017
by EkAndreas
Repository
7 Watchers
76 Stars
11,004 Installations

PHP
4 Dependents
0 Suggesters
8 Forks
6 Open issues
75 Versions
8 % Grown

The README.md

Bladerunner

, _(*1)

WordPress plugin for Laravel Blade templating., _(*2)

To install it to your Composer based WordPress installation:, _(*3)

composer require ekandreas/bladerunner

Activate the plugin inside WordPress and templates with *.blade.php are inspected and active. Your theme still needs an index.php due to WordPress basic functionality. When removed the theme is known as broken., _(*4)

If you don't use a composer based WordPress development environment you can download the latest distributed plugin at Bladerunner site http://bladerunner.aekab.se and install it the common way with zip upload to WordPress via wp-admin., _(*5)

Releases to this plugin is listed last in this readme., _(*6)

Hello World

Install the library with composer
Make sure the cache-folder is writeable in uploads, eg ../wp-content/uploads/.cache
Activate the plugin
Create a view, eg:

<!-- view file: views/pages/index.blade.php -->
Hello World Page rendered at {{ date('Y-m-d H:i:s') }}

In your index.php, add a global call for the view created, eg:

<?php
    bladerunner('views.pages.index')

https://laravel.com/docs/5.2/blade, _(*7)

Cache

If WP_DEBUG is set and true then templates always will be rendered and updated.
View files (cache) is invalidated at save_post
(It's a really good idea to empty the .cache folder inside uploads when develop templates. Eg, create a del command inside your gulp-file.)

Directories

Your cached views will always be stored in your wp upload folder, .cache
Your views must be placed within your theme folder.
Your views must have .blade.php extension.

Template helper

There is a template helper function named bladerunner, defined globally to use in standard WordPress templates., _(*8)

Example: You want to create a 404-template and don't want to use the .blade.php extension to the template file., _(*9)

Create a 404.php in the theme root.
Add the following code to the template:

<?php
    bladerunner('views.pages.404');

In the folder views/pages, create a blade template 404.blade.php

You can pass any data with the global bladerunner function like so,, _(*10)

<?php
    bladerunner('views.pages.404', ['module'=>$module]);

or use compact, eg:, _(*11)

<?php
    bladerunner('views.pages.404', compact('module'));

Controllers

With version 1.7 controllers are added to Bladerunner. As default Bladerunner will look for extended classes in the theme folder + /controllers. If you would like to add or change the controller paths take a look below at filters!, _(*12)

The controller class has to extend \Bladerunner\Controller to work. It will guess the path to the view but you can override this with protected $view='your.custom.view.path'', _(*13)

The controller files follow the same hierarchy as WordPress. You can view the controller hierarchy by using the Blade directive @debug., _(*14)

Extend the Controller Class, it is recommended that the class name matches the filename. Create methods within the Controller Class: * Use public function to expose the returned values to the Blade views/s. * Use public static function to use the function within your Blade view/s. * Use protected function for internal controller methods as only public methods are exposed to the view. You can run them within __construct, _(*15)

Controller example:

The following example will expose $images to views/single.blade.php, _(*16)

controllers/Single.php, _(*17)

<?php

namespace App;

use Bladerunner\Controller;

class Single extends Controller
{
    /**
     * Return images from Advanced Custom Fields
     *
     * @return array
     */
    public function images()
    {
        return get_field('images');
    }
}

views/single.blade.php, _(*18)

@if($images)
  <ul>
    @foreach($images as $image)
      <li><img src="{{$image['sizes']['thumbnail']}}" alt="{{$image['alt']}}"></li>
    @endforeach
  </ul>
@endif

Hooks and Filters

Bladerunner continuously implements filters and hooks to modify values and processes., _(*19)

Hooks

..., _(*20)

Filters

Modify Bladerunners cache folder path, default ../wp-content/uploads/.cache, _(*21)

add_filter('bladerunner/cache/path', function() {
    return '/my/path/to/cache';
});

If you don't want Bladerunner to create the cache folder:, _(*22)

add_filter('bladerunner/cache/make', function() {
    return false;
});

If you wan't to customize the base paths where you have your views stored, use:, _(*23)

add_filter('bladerunner/template/bladepath', function ($paths) {
    if (!is_array($paths)) {
        $paths = [$paths];
    }
    $paths[] = ABSPATH . '../../resources/views';
    return $paths;
});

If you wan't to customize the controller paths where you have your controllers stored, use:, _(*24)

add_filter('bladerunner/controller/paths', function ($paths) { 
    $paths[] = PLUGIN_DIR . '/my-fancy-plugin/controllers';
    return $path; 
});

We will soon add more WordPress extenstions to the Bladerunner engine. Please give us your great examples to implement!, _(*25)

Tests

Test requirements:

Latest Docker install (not the old school Boot2Docker)
PHP Composer Currently only tested on OSX.

Test step by step

Checkout the components for testing via Composer inside the repo:, _(*26)

composer update

Using Testrunner (required-dev package) and Docker the test should be exexuted with a single command:, _(*27)

vendor/bin/dep testrunner

The Versions

20/12 2017

dev-master

9999999-dev

WordPress Blade L5 template engine

wordpress-plugin bladerunner

WordPress Blade L5 template engine

ekandreas/bladerunner

The README.md

Bladerunner

Hello World

Cache

Directories

Template helper

Controllers

Controller example:

Hooks and Filters

Hooks

Filters

Links

Tests

Test requirements:

Test step by step

The Versions

dev-master

The Requires

The Development Requires

by Andreas Ek

1.7.4

The Requires

The Development Requires

by Andreas Ek

1.7.3

The Requires

The Development Requires

by Andreas Ek

dev-analysis-XW1L9y

The Requires

The Development Requires

by Andreas Ek

dev-composer

The Requires

The Development Requires

by Andreas Ek

dev-develop

The Requires

The Development Requires

by Andreas Ek

1.7

The Requires

The Development Requires

by Andreas Ek

dev-release/1.7

The Requires

The Development Requires

by Andreas Ek

1.7-beta.3

The Requires

The Development Requires

by Andreas Ek

dev-release/1.7-beta.3

The Requires

The Development Requires

by Andreas Ek

dev-release/1.7-beta.2

The Requires

The Development Requires

by Andreas Ek

1.7-beta.2

The Requires

The Development Requires

by Andreas Ek

dev-feature/1-7-beta-fix-2

The Requires

The Development Requires

by Andreas Ek

1.7-beta

The Requires

The Development Requires

by Andreas Ek

1.7-beta.1

The Requires

The Development Requires

by Andreas Ek

1.6.3