Command Palette

Command palette in Craft.

Requirements

This plugin requires Craft CMS 3.0.0-RC1 or later.

Installation

To install the plugin, follow these instructions.

1. Open your terminal and go to your Craft project:

    cd /path/to/project
   

2. Then tell Composer to load the plugin:

    composer require am-impact/amcommand
   

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Command Palette.

Functionality

If you have ever used Alfred, you know you'll be zipping through the control panel in no time!

You can open the command palette by using the keyboard combination: (command key for Apple users) CTRL + SHIFT + P, or you click on Command in the CP navigation.

Use the keyboard arrows (up and down) to navigate to your desired command. When you hit the return key or click on a command, the command palette will navigate to the location and show what it's loading. Use (command key for Apple users) CTRL + RETURN (or click) to fire the command in a new window.

Current commands

Default commands

Command	Description
Content: Delete all entries	Delete all entries in one of the available sections.
Content: Delete entries	Delete an entry in one of the available sections.
Content: Edit entries	Edit an entry in one of the available sections.
Content: New entry	Create a new entry in one of the available sections.
Dashboard	Redirect.
Globals: Edit	Edit one of your globals.
Search on Craft	Redirect - Search on Craft with given keywords.
Search on StackExchange	Redirect - Search on StackExchange with given keywords.
Settings: Assets	Redirect.
Settings: Categories	Redirect.
Settings: Fields	Redirect.
Settings: Fields - Duplicate	Duplicate a field.
Settings: Fields - Edit	Edit one of the fields.
Settings: Globals	Redirect.
Settings: Globals - Global Sets	Edit the settings for one of the globals.
Settings: New...	Add something new in the settings...
Settings: Plugins	Redirect.
Settings: Plugin settings	Edit the settings for one of the enabled plugins
Settings: Routes	Redirect.
Settings: Sections	Redirect.
Settings: Sections - Edit	Edit a section.
Settings: Sections - Edit entry type	Edit an entry type of a section. (Field Layout and such)
Settings: Users	Redirect.
Tasks	Manage Craft tasks.
Tools	Use one of the most used tools.
Users: Delete users	Delete a user other than your own.
Users: Edit users	Edit a user.
Users: Login as user	Log in as a different user, and navigate to their dashboard.
Users: New user	Create a user.
Sign out	End current session.
My Account	Redirect.

Special commands

Command	Description
Content: Compare entry version	Compare the current entry you are viewing in the CP with older versions.
Content: Duplicate entry	Duplicate the current entry you are viewing in the CP.
Simply type!	You will be able to search in elements directly when you haven't triggered a (deeper command, that returns a new list or such things) command yet.

Adding your own commands

If you'd like to add commands for a plugin you're developing, register the commands through an event.

Add this at the top of your main plugin file:

use amimpact\commandpalette\events\RegisterCommandsEvent;
use amimpact\commandpalette\services\General;
use yii\base\Event;

Add this to the init function of your main plugin file:

if (class_exists(General::class)) {
    Event::on(General::class, General::EVENT_REGISTER_COMMANDS, function(RegisterCommandsEvent $event) {
        $event->commands[] = [
            'name' => 'Search on Google',
            'type' => 'Custom',
            'url'  => 'http://www.google.nl',
            'icon' => [
                'type' => 'font',
                'content' => 'plugin'
            ]
        ];
        $event->commands[] = [
            'name' => 'My own plugin function in a service',
            'type' => 'Custom',
            'call' => 'yourPluginFunctionName',
            'plugin' => 'your-plugin-handle',
            'service' => 'yourPluginServiceName'
        ];
    });
}

That's it! The command palette will add these two commands.

If you look at the second example, you see a call, plugin and service key. These can be used to load a new set of commands.

In your plugin's service yourPluginServiceName (e.g.: general), you'll create a new function called yourPluginFunctionName. In here you could do the same thing as you see in the example, and just return the new set of commands.

Contact

If you have any questions or suggestions, don't hesitate to contact us. We would like to add more commands to the palette, so if you have any ideas then please let us know!