Shortcode for Keyboard and Controller Buttons

A simple shortcode plugin to insert keyboard keys and controller buttons into the article.

Installation

1. Get zip file from the release page
2. Upload the zip file to your WordPress plugin page
3. Enable the plugin

How to Use

This plugin provides two shortcodes: [kbd] and [btn] for representing keyboard keys and controller buttons.

All names used for keys and controllers are in lowercase unless stated otherwise.

Keyboard

Keyboard keys are represented by [kbd]key[/kbd]. Some special keys that has a symbol are listed below.

Names for Special Keys

• left - Left Arrow
• right - Right Arrow
• up - Up Arrow
• down - Down Arrow
• enter - Enter
• tab - Tab
• shift - Shift
• ctrl - Control, as on IBM compatibles
• cmd - Command, as on Apple keyboards
• helm - Control, as on Apple keyboards
• ctrls - Control/Command
• alt - Alt
• option - Option, as on Apple keyboards
• alts - Alt/Option
• win - Windows key
• meta - Windows key
• backspace - Backspace
• pgdn - Page Down
• pgup - Page Up
• home - Home
• end - End
• del - Dekte
• ins - Insert
• sysrq - Print Screen / System Request
• pause - Pause / Break
• menu - Menu, as on IBM compatibles, near right ctrl
• compose - Compose
• esc - Escape
• caps - Caps lock
• num - Num lock
• scroll - Scroll lock

Controllers

Xbox Series X, PlayStation 5 and Switch controller buttons are supported. You can specify which to use with v parameter:

XBox A button is [btn v="xbox"]a[/btn];
Switch B button is [btn v="switch"]b[/btn];
and PlayStation Triangle button is [btn v="ps"]triangle[/btn]

Names for XBox Controllers

Following names are recognized for XBox controllers:

• a => A
• b => B
• x => X
• y => Y
• view => View
• share => Share
• menu => Menu
• du => DPad Up
• dd => DPad Down
• dl => DPad Left
• dr => DPad Right
• ls => Left Stick
• lsp => Left Stick Press
• rs => Right Stick
• rsp => Right Stick Press
• lb => Left Bumper
• lt => Left Trigger
• rb => Right Bumper
• rt => Right Trigger

Names for PlayStation Controllers

Following names are recognized for PlayStation controllers:

• circle => Circle
• cross => Cross
• square => Square
• triangle => Triangle
• view => View
• share => Share Alt
• options => Options Alt
• du => DPad Up
• dd => DPad Down
• dl => DPad Left
• dr => DPad Right
• ls => Left Stick
• l3 => Left Stick Press
• lsp => Left Stick Press
• rs => Right Stick
• r3 => Right Stick Press
• rsp => Right Stick Press
• l1 => L1
• l2 => L2
• r1 => R1
• r2 => R2

Names for Switch Controllers

• a => A
• b => B
• x => X
• y => Y
• plus => Plus
• minus => Minus
• home => Home
• record => Square
• du => DPad Up
• dd => DPad Down
• dl => DPad Left
• dr => DPad Right
• ls => Left Stick
• lsp => Left Stick
• rs => Right Stick
• rsp => Right Stick
• l => Left Bumper (L)
• zl => Left Trigger (ZL)
• r => Right Bumper (R)
• zr => Right Trigger (ZR)

Equivalence Buttons

Some times you may want to talk about the buttons that usually has the same function across all platforms, like DPad right.

When using equivalence button names, v parameter is not used.

You can use equivalence names listed below:

• EquivalenceUp => DPad up
• EquivalenceDown => DPad down
• EquivalenceLeft => DPad left
• EquivalenceRight => DPad right
• EquivalenceSelect => Select key. Maps to XBox View button, PS Touchpad press, and Switch Minus button.
• EquivalenceStart => Start key. Maps to XBox Menu button, PS Option button, and Switch Plus button.
• EquivalenceActionUp => The upper action button. Maps to XBox Y button, PS Triangle button, and Switch "Up" button.
• EquivalenceActionDown => The lower action button. Maps to XBox B button, PS Cross button, and Switch "Down" button.
• EquivalenceActionLeft => The left-side action button. Maps to XBox X button, PS Square button, and Switch "Left" button.
• EquivalenceActionRight => The right-side action button. Maps to XBox A button, PS Circle button, and Switch "Right" button.
• EquivalenceLeftBumper => The left bumper. Maps to XBox LB, PS L1, and Switch L.
• EquivalenceLeftTrigger => The left trigger. Maps to XBox LT, PS L2, and Switch ZL.
• EquivalenceRightBumper => The right bumper. Maps to XBox RB, PS R1, and Switch R.
• EquivalenceRightTrigger => The right trigger. Maps to XBox RT, PS R2, and Switch ZR.
• EquivalenceLeftStick => The left stick movement.
• EquivalenceRightStick => The right stick movement.
• EquivalenceLeftStickPress => The left stick press.
• EquivalenceRightStickPress => The right stick press.

Credits

Huge thanks to Nicolae Berbece for releasing Xelu's Controllers & Keyboard Prompts under CC0 license.

License

Icon images made by Nicolae remain under Creative Commons 0 (CC0).

All other code is MIT licensed.