There is no license information available for the latest version (3.2.1) of this package.

Framework for developing application in your WP install.

3.2.1 2023-01-17 14:00 UTC

This package is auto-updated.

Last update: 2024-02-17 16:24:28 UTC


This package provides an easy way to create custom routes (MVC), roles, Custom post types, ... using a config file.


Add this package to your plugin dependencies

composer require tombroucke/wp-sidewheels

Initialize sidewheels your plugin:

dirname(__FILE__) is where your config.php file resides.

use Otomaties\Sidewheels\Sidewheels;

add_action('init', function(){

Add to your plugin activation hook:

use Otomaties\Sidewheels\Sidewheels;

register_activation_hook(__FILE__, function(){

Add to your plugin deactivation hook:

use Otomaties\Sidewheels\Sidewheels;

register_deactivation_hook(__FILE__, function(){

add config.php to your plugin root directory

Important notice

After adding new routes, you need to manually flush your rewrite rules.

Example configuration file


use Namespace\Models\Order;

return [
    'templatePath' => __DIR__ . '/views', // This is the default template directory, so this could be omitted
    'textDomain' => 'plugin-textdomain', // Text domain for admin strings translation
    'routes' => [
            'path' => 'public-page',
            'callback' => ['Namespace\Controllers\Frontend', 'index'], // Or string: 'Namespace\Controllers\Frontend@index'
            'title' => __('Public page', 'plugin-textdomain'),
            'path' => 'private-page',
            'callback' => ['Namespace\Controllers\Admin', 'index'],
            'title' => __('Private page', 'plugin-textdomain'),
            'capability' => 'manage_my_plugin',
            'path' => 'private-page',
            'callback' => ['Namespace\Controllers\Admin', 'create'],
            'capability' => 'manage_my_plugin',
            'method' => 'POST',
            'path' => 'private-page/orders/{order_id}',
            'callback' => 'Namespaces\Controllers\Admin\Order@index',
            'method' => 'GET',
            'title' => __('Order #{order_id}', 'plugin-textdomain'),
            'path' => 'private-page/orders/{order_id}/{order_item}',
            'callback' => 'Namespaces\Controllers\Admin\OrderItem@index',
            'method' => 'GET',
            'title' => __('Order item #{order_item}', 'plugin-textdomain'),
    'postTypes' => [ // See
        'shop_order' => array(
            'args' => array(
                'labels' => array(
                    'singular_name' => __('Order', 'plugin-textdomain'),
                    'plural_name' => __('Orders', 'plugin-textdomain'),
                'menu_icon' => 'dashicons-cart',
                'supports' => array( 'title', 'author' ),
                'show_in_menu' => true,
                'public' => false,
                'publicly_queryable' => false,
                'has_archive' => false,
                'admin_cols' => array(
                    'name' => array(
                        'title' => __('Name', 'plugin-textdomain'),
                        'meta_key' => 'name',
                    'total' => array(
                        'title' => __('Total', 'plugin-textdomain'),
                        'function' => function () {
                            $order = new Order(get_the_ID());
                            echo $order->total();
    'roles' => [
        'administrator' => array(
            'label' => __('Administrator', 'plugin-textdomain'),
            'capabilities' => array(
                'manage_my_plugin' => true,



For each route, you need to define a callback. This can be an inline function or a controller.


namespace Namespace\Controllers;

use Otomaties\Sidewheels\Abstracts\Controller;

class Admin extends Controller
    public function index()
        $this->route()->setTitle('Dashboard'); // Optional, only for rendering complete pages
        $this->render('admin/dash.html', [ // render() : complete page, renderContent() : render during the_content(), renderShortcode() : returns html instead of rendering
            'website' => ''

    public function create() 
        // Create a post or perform other action on POST
    public function shout(string $string)
    	return strtoupper($string);


This package uses twig as it's templating engine. You can pass variable to your templates, e.g. 'website'. The route object is also passed in as a variable, so you can use {{ route.title }} for example. You can call public methods from your controller.

<!DOCTYPE html>
<html lang="en">
	<title>{{ route.title }}</title>
	<h1>{{ route.title }}</h1>
	<p>Check out this website: {{ website }}</p>
	<p>{{ shout('I\'m shouting'); }}</p>

By default, the very basic vendor/tombroucke/wp-sidewheels/templates/sidewheels.php template will be loaded for all endpoints. You can add a sidewheels.php template in your views directory, or in your theme root directory. You can use the sidewheels_template_paths filter to load a custom template based on a specific route or other logic.


Deny access to certain routes

use Namespace\Models\Order;
add_filter('sidewheels_user_has_access', function ($access, $route) {
    if (current_user_can('manage_options')) {
        $access = true;
    // Only give access if current user is author of {order_id}
    if ($route->path() == 'private-page/orders/{order_id}') {
        $order = new Order($route->parameter('order_id'));
        return $order->author() == get_current_user_id();
    return $access;
}, 10, 2);

Manipulate title, will override the title in config file

Title can also be set from controller $this->route()->setTitle('title');, but this filter will override everything.

add_filter('sidewheels_route_title', function ($title, $route) {
    if ($route->path() == 'public-page') {
        $title = 'Custom public page title';
    return $title;
}, 10, 2);

Add custom functions to be used in your twig templates.

use \Twig\TwigFunction;

add_filter('sidewheels_twig_functions', function ($functions) {
    $functions = new TwigFunction(
        function ($argument) {
            // Modify $argument
            return $argument;
    return $functions;

Adding routes

You can add routes outside of the config file:

Route::get('public-page', 'Namespace\Controllers\Frontend@index');