Visor is a simple admin overlay to get to the relevant areas of the Craft CMS control panel from the front-end of your site.
This plugin requires Craft CMS 3.1.20 or later.
To install the plugin, follow these instructions.
-
Open your terminal and go to your Craft project:
cd /path/to/project
-
Then tell Composer to load the plugin:
composer require trendyminds/visor
-
In the Control Panel, go to Settings โ Plugins and click the โInstallโ button for Visor.
You can activate Visor by clicking the gear icon or using the following keyboard shortcuts:
Key | Description |
---|---|
` |
Toggles Visor open or close |
ESC |
Closes Visor (if open) |
Visor has a class of Visor--override
on the outer <section>
element. To change any of the default styles, simply start your styles with .Visor.Visor--override
. This will make your styles more specific without resorting to !important
madness.
Visor also uses inline SVGs for all graphics. This:
- Reduces HTTP requests
- Looks crisp at any pixel density
- Allows you to re-style the icons using
fill
in your CSS
If you'd prefer to replace purple with a different color you can change this by targeting .Visor--override .Visor__modal
.
Since 3.0 Visor offers support for full-page static caching. In order to offer this a network request is made on every page request to check if the user should see the Visor controls. To ensure this does not impact performance numerous things are done:
- The JavaScript to make this check is inserted at the bottom of the page
- The JavaScript used to make the check is very small (< 2 KB)
- Early returns are used if the user is a guest and should not see anything from Visor
The checks to ensure we return early for guests is documented entirely in DefaultController.php. If you see opportunities to improve the performance of these checks (or any other part of Visor) pull requests are welcomed.
This has been tested on Chrome, Firefox and Safari, but drop in an Issue if you notice any strangeness.
We welcome anyone and everyone who would like to improve Visor to fork it and send in pull requests. To start developing Visor:
- Ensure you have Node version 10.x running on your machine
- Clone the repo to your computer
- Run
npm i
- Run
npm start
to compile the CSS and JS into the mainsrc/resources/
directory