Right-to-Left Backend Skin

This plugin is an example skinning the backend, adding Right-To-Left support to the October CMS Backend Panel as an example.

How to use this plugin

Download the plugin files and copy them to the directory:

• plugins/acme/rtl/

Update the backend configuration file config/backend.php:

/*
|--------------------------------------------------------------------------
| Backend Skin
|--------------------------------------------------------------------------
|
| Specifies the backend skin class to use.
|
*/

'skin' => \Acme\Rtl\Skins\RightToLeft::class,

Now the Right-To-Left backend skin is enabled.

General Advice on Skinning the Backend Panel

There are two ways to manipulate the backend, you can either override assets or override layouts. In both cases the system will look for an override file and use that, otherwise it will fallback to the default file. Overriding assets is possible where Backend::skinAsset() is called in the code.

Below you can see an example skin structure:

plugins/
  acme/                      <== Plugin starts here
    demo/
      skins/                 <== Skins folder
        custom/              <== Skin resource directory
            assets/          <== Assets directory
              css/
                october.css  <== CSS override file
            layouts/         <== Layouts directory
                _head.php    <== Layout override file

        Custom.php           <== Skin registration file

The Skin resource directory should be the same name as the Skin registration file but in lower case. It contains files that will override the base assets found in the backend.

The CSS override file called october.css will override the following:

// Default (fallback) file
modules/backend/assets/css/october.css

// Skin override file
plugins/acme/demo/skins/custom/assets/css/october.css

The Layout override file called _head.php will override the following:

// Default (fallback) file
modules/backend/layouts/_head.php

// Skin override file
plugins/acme/demo/skins/custom/layouts/_head.php

Inside the Skin registation file it should simply provide a name:

<?php namespace Acme\Demo\Skins;

use Backend\Classes\Skin;

/**
 * RightToLeft is a custom skin information file
 *
 * @package acme\demo
 * @author Alexey Bobkov, Samuel Georges
 */
class RightToLeft extends Skin
{
    /**
     * {@inheritDoc}
     */
    public function skinDetails()
    {
        return [
            'name' => 'Custom skin'
        ];
    }

}