{"id":392554,"date":"2026-11-13T20:36:52","date_gmt":"2026-11-13T20:36:52","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/plectrum\/"},"modified":"2026-11-13T20:46:47","modified_gmt":"2026-11-13T20:46:47","slug":"plectrum","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/plectrum\/","author":23506920,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1","stable_tag":"1.1.0","tested":"7.1.4","requires":"6.6","requires_php":"7.4","requires_plugins":null,"header_name":"Plectrum","header_author":"DigitalArena","header_description":"Renders chord-marked lyrics with ukulele-friendly annotations and progressive enhancement hooks.","last_updated":"2026-11-13 20:46:47","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/digitalarena.co.uk\/","header_plugin_uri":"https:\/\/digitalarena.co.uk\/wordpress-plugins","header_author_uri":"","rating":0,"author_block_rating":0,"active_installs":0,"downloads":124,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.0":{"tag":"1.1.0","author":"creativecortexuk","date":"2026-11-13 20:46:47","revision":3801140}},"upgrade_notice":{"1.1":"<p>Improves output safety and keeps chord diagrams synchronized with key changes. Upload as a replacement for the existing plectrum installation.<\/p>","1.0":"<p>Adds chord-markup instructions and a Greensleeves example above the settings-page disclaimer. Installations still using the old structure must follow the one-time folder migration in Installation.<\/p>","0.1.11":"<p>Adds the settings-page disclaimer and updates plugin and author links. If upgrading follow the one-time folder migration in Installation.<\/p>","0.1.10":"<p>Requires a one-time folder migration to plectrum. Deactivate, rename the folder without uninstalling, upload this ZIP as a replacement, then reactivate. See Installation for details.<\/p>","0.1.9":"<p>Quality-control cleanup, modernized accessibility and print styles, and refreshed asset versions.<\/p>","0.1.8":"<p>Loads the plugin\u2019s front-end CSS and JavaScript early enough for the intended interactive chord layout and browser-rendered diagrams to appear correctly.<\/p>","0.1.3":"<p>Fixes the front-end configuration timing so the intended SVG chord diagrams render on initial page load.<\/p>","0.1.2":"<p>Fixes the front-end diagram handoff so the latest compact SVG diagrams reliably render on loaded pages.<\/p>","0.1.1":"<p>Refines the default chord diagram presentation for more practical inline song-sheet rendering.<\/p>","0.1.0":"<p>Initial testing release of Plectrum.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3801126,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3801126,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3801126,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3801126,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3801126,"resolution":"1","location":"assets","locale":"","width":768,"height":1024},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3801126,"resolution":"2","location":"assets","locale":"","width":1024,"height":768}},"screenshots":{"1":"Annotated chord-and-lyric output with controls","2":"Settings screen for defaults and automatic processing","3":"Print-focused song output"}},"plugin_section":[],"plugin_tags":[17389,1396,218,292644,172276],"plugin_category":[50],"plugin_contributors":[292645],"plugin_business_model":[],"class_list":["post-392554","plugin","type-plugin","status-publish","hentry","plugin_tags-chords","plugin_tags-lyrics","plugin_tags-music","plugin_tags-transpose","plugin_tags-ukulele","plugin_category-media","plugin_contributors-creativecortexuk","plugin_committers-creativecortexuk"],"banners":{"banner":"https:\/\/ps.w.org\/plectrum\/assets\/banner-772x250.png?rev=3801126","banner_2x":"https:\/\/ps.w.org\/plectrum\/assets\/banner-1544x500.png?rev=3801126","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/plectrum\/assets\/icon-128x128.png?rev=3801126","icon_2x":"https:\/\/ps.w.org\/plectrum\/assets\/icon-256x256.png?rev=3801126","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/plectrum\/assets\/screenshot-1.png?rev=3801126","caption":"Annotated chord-and-lyric output with controls"},{"src":"https:\/\/ps.w.org\/plectrum\/assets\/screenshot-2.png?rev=3801126","caption":"Settings screen for defaults and automatic processing"}],"raw_content":"<!--section=description-->\n<p>Plectrum parses square-bracket chord notation inside song lyrics and renders the chord directly above the following lyric segment.<\/p>\n\n<p>Features include:<\/p>\n\n<ul>\n<li>Shortcode rendering for chord-marked content<\/li>\n<li>Optional automatic processing for selected public post types<\/li>\n<li>Browser-generated SVG ukulele chord diagrams for <code>gCEA<\/code><\/li>\n<li>Per-song transpose, size, diagram visibility, and print controls<\/li>\n<li>Focused print output with optional footer notice<\/li>\n<li>Multiple song instances per page without shared control state<\/li>\n<li>Extensible hooks for rendering, aliases, settings, and lifecycle events<\/li>\n<\/ul>\n\n<p>Example authoring format:<\/p>\n\n<pre><code>There [Am]once was a ship that put to sea\n<\/code><\/pre>\n\n<p>Shortcode usage:<\/p>\n\n<pre><code>[ukulele_chords]There [Am]once was a ship that put to sea[\/ukulele_chords]\n<\/code><\/pre>\n\n<p>Supported shortcode attributes:<\/p>\n\n<ul>\n<li><code>controls=\"true|false\"<\/code><\/li>\n<li><code>diagrams=\"true|false\"<\/code><\/li>\n<li><code>transpose=\"0\"<\/code><\/li>\n<li><code>print_button=\"true|false\"<\/code><\/li>\n<li><code>print_diagrams=\"true|false\"<\/code><\/li>\n<li><code>tuning=\"gCEA\"<\/code><\/li>\n<li><code>enharmonic_preference=\"auto|preserve-source|sharps|flats\"<\/code><\/li>\n<\/ul>\n\n<p>Literal square brackets can be escaped using doubled brackets such as <code>[[Am]]<\/code>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin zip through <code>Plugins &gt; Add New &gt; Upload Plugin<\/code>, or copy the plugin folder into <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Activate <code>Plectrum<\/code> through the WordPress plugins screen.<\/li>\n<li>Visit <code>Settings &gt; Plectrum<\/code> to configure automatic processing, diagram defaults, print settings, and uninstall behavior.<\/li>\n<li>Add <code>[ukulele_chords]...[\/ukulele_chords]<\/code> to song content, or enable automatic processing for your chosen post types.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20plectrum%20change%20the%20stored%20post%20content%3F\"><h3>Does Plectrum change the stored post content?<\/h3><\/dt>\n<dd><p>No. Rendering and transposition happen at display time only.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20a%20chord%20is%20unknown%3F\"><h3>What happens if a chord is unknown?<\/h3><\/dt>\n<dd><p>The chord name still renders above the lyric segment, but no diagram is shown.<\/p><\/dd>\n<dt id=\"can%20i%20use%20plectrum%20without%20automatic%20processing%3F\"><h3>Can I use Plectrum without automatic processing?<\/h3><\/dt>\n<dd><p>Yes. The shortcode is fully supported on its own.<\/p><\/dd>\n<dt id=\"does%20it%20support%20multiple%20songs%20on%20the%20same%20page%3F\"><h3>Does it support multiple songs on the same page?<\/h3><\/dt>\n<dd><p>Yes. Each rendered song instance manages its own controls, transpose state, diagram visibility, and print targeting.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1<\/h4>\n\n<ul>\n<li>Sanitize filtered controls, chord names, and SVG diagrams immediately before output<\/li>\n<li>Refresh diagrams and voicing metadata together with transposed chord labels<\/li>\n<li>Use movable voicings when the transposed chord has no exact library entry<\/li>\n<li>Use WordPress.org automatic translation loading<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Add the Eb chord diagram with separate fingers and a D# alias<\/li>\n<li>Add a settings-page guide to chord markup with a copyable Greensleeves example<\/li>\n<li>Include the software disclaimer and DigitalArena plugin links<\/li>\n<\/ul>\n\n<h4>0.1.11<\/h4>\n\n<ul>\n<li>Update plugin and author links to the author plugins page<\/li>\n<li>Display the software warranty and liability disclaimer on the settings page<\/li>\n<\/ul>\n\n<h4>0.1.10<\/h4>\n\n<ul>\n<li>Use the canonical plectrum plugin folder to match the translation domain<\/li>\n<li>Add plugin license and bundled language directory headers; remove the hidden language placeholder<\/li>\n<li>Register bundled translations on init and prefix the uninstall settings variable<\/li>\n<li>Record successful site-owner testing on WordPress 7.1.3<\/li>\n<\/ul>\n\n<h4>0.1.9<\/h4>\n\n<ul>\n<li>Standardize JavaScript and documentation formatting and tidy variable declarations<\/li>\n<li>Modernize screen-reader clipping and print break properties while preserving focused song printing<\/li>\n<\/ul>\n\n<h4>0.1.8<\/h4>\n\n<ul>\n<li>Prime front-end assets earlier in the request so plugin CSS and JavaScript load before rendered song markup appears<\/li>\n<\/ul>\n\n<h4>0.1.3<\/h4>\n\n<ul>\n<li>Fix initial front-end diagram rendering so browser-generated SVG diagrams receive their configuration before first paint<\/li>\n<\/ul>\n\n<h4>0.1.2<\/h4>\n\n<ul>\n<li>Ensure browser-rendered chord diagrams replace the server placeholder output after page load<\/li>\n<\/ul>\n\n<h4>0.1.1<\/h4>\n\n<ul>\n<li>Tightened the default chord diagram size for inline readability<\/li>\n<li>Added visible string and fret labels to rendered chord diagrams<\/li>\n<\/ul>\n\n<h4>0.1.0<\/h4>\n\n<ul>\n<li>Initial testing release<\/li>\n<li>Chord parsing with escaped bracket support<\/li>\n<li>Ukulele chord diagrams rendered in the browser<\/li>\n<li>Per-instance transpose, size, diagram visibility, and print controls<\/li>\n<li>Automatic processing settings for selected post types<\/li>\n<li>Enharmonic preference support and print footer placeholders<\/li>\n<li>Developer hooks, regression tests, and shared QA validation<\/li>\n<\/ul>","raw_excerpt":"Render chord-marked lyrics with ukulele-friendly annotations, browser-generated chord diagrams, transpose controls, and print-focused output.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/392554","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=392554"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/creativecortexuk"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=392554"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=392554"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=392554"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=392554"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=392554"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=392554"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}