Title: Plectrum
Author: creativecortexuk
Published: <strong>November 13, 2026</strong>
Last modified: November 13, 2026

---

Search plugins

![](https://ps.w.org/plectrum/assets/banner-772x250.png?rev=3801126)

![](https://ps.w.org/plectrum/assets/icon-256x256.png?rev=3801126)

# Plectrum

 By [creativecortexuk](https://profiles.wordpress.org/creativecortexuk/)

[Download](https://downloads.wordpress.org/plugin/plectrum.1.1.0.zip)

 * [Details](https://wordpress.org/plugins/plectrum/#description)
 * [Reviews](https://wordpress.org/plugins/plectrum/#reviews)
 *  [Installation](https://wordpress.org/plugins/plectrum/#installation)
 * [Development](https://wordpress.org/plugins/plectrum/#developers)

 [Support](https://wordpress.org/support/plugin/plectrum/)

## Description

Plectrum parses square-bracket chord notation inside song lyrics and renders the
chord directly above the following lyric segment.

Features include:

 * Shortcode rendering for chord-marked content
 * Optional automatic processing for selected public post types
 * Browser-generated SVG ukulele chord diagrams for `gCEA`
 * Per-song transpose, size, diagram visibility, and print controls
 * Focused print output with optional footer notice
 * Multiple song instances per page without shared control state
 * Extensible hooks for rendering, aliases, settings, and lifecycle events

Example authoring format:

    ```
    There [Am]once was a ship that put to sea
    ```

Shortcode usage:

    ```
    [ukulele_chords]There [Am]once was a ship that put to sea[/ukulele_chords]
    ```

Supported shortcode attributes:

 * `controls="true|false"`
 * `diagrams="true|false"`
 * `transpose="0"`
 * `print_button="true|false"`
 * `print_diagrams="true|false"`
 * `tuning="gCEA"`
 * `enharmonic_preference="auto|preserve-source|sharps|flats"`

Literal square brackets can be escaped using doubled brackets such as `[[Am]]`.

## Screenshots

[⌊Annotated chord-and-lyric output with controls⌉⌊Annotated chord-and-lyric output
with controls⌉[

Annotated chord-and-lyric output with controls

[⌊Settings screen for defaults and automatic processing⌉⌊Settings screen for defaults
and automatic processing⌉[

Settings screen for defaults and automatic processing

## Installation

 1. Upload the plugin zip through `Plugins > Add New > Upload Plugin`, or copy the 
    plugin folder into `/wp-content/plugins/`.
 2. Activate `Plectrum` through the WordPress plugins screen.
 3. Visit `Settings > Plectrum` to configure automatic processing, diagram defaults,
    print settings, and uninstall behavior.
 4. Add `[ukulele_chords]...[/ukulele_chords]` to song content, or enable automatic
    processing for your chosen post types.

## FAQ

### Does Plectrum change the stored post content?

No. Rendering and transposition happen at display time only.

### What happens if a chord is unknown?

The chord name still renders above the lyric segment, but no diagram is shown.

### Can I use Plectrum without automatic processing?

Yes. The shortcode is fully supported on its own.

### Does it support multiple songs on the same page?

Yes. Each rendered song instance manages its own controls, transpose state, diagram
visibility, and print targeting.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Plectrum” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ creativecortexuk ](https://profiles.wordpress.org/creativecortexuk/)

[Translate “Plectrum” into your language.](https://translate.wordpress.org/projects/wp-plugins/plectrum)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/plectrum/), check out
the [SVN repository](https://plugins.svn.wordpress.org/plectrum/), or subscribe 
to the [development log](https://plugins.trac.wordpress.org/log/plectrum/) by [RSS](https://plugins.trac.wordpress.org/log/plectrum/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.1

 * Sanitize filtered controls, chord names, and SVG diagrams immediately before 
   output
 * Refresh diagrams and voicing metadata together with transposed chord labels
 * Use movable voicings when the transposed chord has no exact library entry
 * Use WordPress.org automatic translation loading

#### 1.0

 * Add the Eb chord diagram with separate fingers and a D# alias
 * Add a settings-page guide to chord markup with a copyable Greensleeves example
 * Include the software disclaimer and DigitalArena plugin links

#### 0.1.11

 * Update plugin and author links to the author plugins page
 * Display the software warranty and liability disclaimer on the settings page

#### 0.1.10

 * Use the canonical plectrum plugin folder to match the translation domain
 * Add plugin license and bundled language directory headers; remove the hidden 
   language placeholder
 * Register bundled translations on init and prefix the uninstall settings variable
 * Record successful site-owner testing on WordPress 7.1.3

#### 0.1.9

 * Standardize JavaScript and documentation formatting and tidy variable declarations
 * Modernize screen-reader clipping and print break properties while preserving 
   focused song printing

#### 0.1.8

 * Prime front-end assets earlier in the request so plugin CSS and JavaScript load
   before rendered song markup appears

#### 0.1.3

 * Fix initial front-end diagram rendering so browser-generated SVG diagrams receive
   their configuration before first paint

#### 0.1.2

 * Ensure browser-rendered chord diagrams replace the server placeholder output 
   after page load

#### 0.1.1

 * Tightened the default chord diagram size for inline readability
 * Added visible string and fret labels to rendered chord diagrams

#### 0.1.0

 * Initial testing release
 * Chord parsing with escaped bracket support
 * Ukulele chord diagrams rendered in the browser
 * Per-instance transpose, size, diagram visibility, and print controls
 * Automatic processing settings for selected post types
 * Enharmonic preference support and print footer placeholders
 * Developer hooks, regression tests, and shared QA validation

## Meta

 *  Version **1.1**
 *  Last updated **4 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.6 or higher **
 *  Tested up to **7.1.4**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [chords](https://wordpress.org/plugins/tags/chords/)[lyrics](https://wordpress.org/plugins/tags/lyrics/)
   [music](https://wordpress.org/plugins/tags/music/)[ukulele](https://wordpress.org/plugins/tags/ukulele/)
 *  [Advanced View](https://wordpress.org/plugins/plectrum/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/plectrum/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/plectrum/reviews/)

## Contributors

 *   [ creativecortexuk ](https://profiles.wordpress.org/creativecortexuk/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/plectrum/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://digitalarena.co.uk/)