ChordPress – ChordPro Text Formatter

Beschreibung

ChordPress pretty-prints ChordPro formatted text files on your pages and posts. You can configure output and formatting options. With ‚interactive‘ mode on, you can transpose the chords up and down and also print the output right from the page.

ChordPress 2.1 introduced „Vexchords„, an awesome Javascript library for displaying guitar chord diagrams. Create your own guitar chord diagrams via a new post type and display them using shortcodes. Or enable the Chord Sheet option that will show all chords used in a song as diagrams below the rendered ChordPro text (given that you have created them as guitar chord posts).

Your input to ChordPress needs to be a valid ChordPro formatted text. ChordPro is a simple text-based syntax used to write lead sheets, the lyrics and chords of a song. ChordPro also comes with a command line tool that pretty prints that text into other formats like PDF.
You can read all about ChordPro here:
ChordPro

The ChordPress plugin allows to put ChordPro text inside its shortcode tags on a page or post and will pretty print it when the web page is displayed.

Simply insert a ChordPro text inbetween the [chordpress] and [/chordpress] tags and it will be rendered based on the default options of the plugin. You can change output and formatting settings on the plugin’s admin page.

A TinyMCE editor integration is also included, providing an editor menu button to insert the shortcode for you with its default paramaters, e.g. wrapping it around selected text.

The [chordpress] shortag allows specifying custom options for rendering ChordPro texts. For example:

  1. [chordpress transpose="1"] will transpose the chords rendered by one semitone.
  2. [chordpress interactive="yes"] will allow you to transpose the chords up and down and also print the output right from the rendered page.

Check out this example:
ChordPress Demo

The [chordpress-chord] shortag allows you to display a guitar chord as a diagram. For example:

  1. [chordpress-chord chord="112"] will show the guitar chord post with ID 112 as a diagram.
  2. [chordpress-chord chord="100" strokeColor="#000099" canvaswidth="100" canvasheight="100" titlestyle="font-size:1em;text-align:center;"] will show the guitar chord post with ID 100 as a diagram with custom settings.

Check out this example:
ChordPress Guitar Chord Demo

If not from the WordPress marketplace, get the plugin here:
ChordPress Homepage

Features

  • renders the lyrics/chord format of ChordPro
  • configure output and formatting
  • transpose up and down on the fly from the rendered page
  • print the rendered output

ChordPress supports the following ChordPro tags:

  • {album}
  • {artist}
  • {capo}
  • {composer}
  • {key}
  • {subtitle}
  • {tempo}
  • {time}
  • {title}
  • {year}
  • {meta} for all of the above

ChordPress supports custom CSS for the following ChordPro tags:

  • {comment}
  • {start_of_chorus}, {end_of_chorus}
  • {start_of_verse}, {end_of_verse}

ChordPress supports note/chord translations

Usage

  1. Enter a [chordpress] shortcode in your page or post editor
  2. Paste your ChordPro text right after it
  3. Enter the closing [/chordpress] shortcode

Optional shortcode parameters

  • float= Forces the rendered text block to float left or right.
  • hbnotation= Input is H/B notation (using H for B and Bb for B). Wether it is displayed as such is defined on the Options page.
  • interactive= Enables interactive mode. A listbox will be shown on the right of the title that allows you to transpose the chords on the fly. Also, a print button will be shown fopr printing out the rendered ChordPro text.
  • transpose= Enter a positive or negative number for the amount of semitones to transpose the chords

Use the „ChordPress“ admin menu of your backend to change the default settings.

Documentation

ChordPress User Manual

Support

Choose your preferred support channel:
1. WordPress Support Forum
2. Lewe.com Support Site
3. Lewe.com ChordPress Forum
4. ChordPress User Manual

Credits

@rlisle for his work on the ChordsAndLyrics plugin that he created in 2009.
Ahkâm for the beautiful ChordPress Plugin Icon.

Screenshots

  • ChordPress Output Options
  • ChordPress Formatting Options
  • Shortcut with ChordPro text in editor
  • Rendered text on webpage
  • Optional chord sheet for each song

Installation

Backend Installation

  1. Go to Plugin page
  2. Click Add New
  3. Enter „chordpress“ in search field
  4. Install and Activate

Manual Installation

  1. Download the plugin ZIP file from here
  2. Unpack the ZIP file locally
  3. Upload the ‚chordpress‘ folder to your ‚/wp-content/plugins/‘ directory
  4. Activate the plugin on the ‚Plugins‘ page of your WordPress backend

FAQ

Why are empty ChordPro lines not rendered ?

Empty lines are stripped from shortcode content and are not passed to the plugin. A good way to work around that is to use the {start_of_verse}/{start_of_chorus} tags and give them a top/bottom margin on the options page.

What is the H/B notation ?

The H/B notation uses H instead of B and B is used insetad of Bb. This notation is used in some European countries. Read more about it here: H/BN Notation.

Rezensionen

1. Mai 2020
Bars appear in chords which has not been given bar. Had to remove bar from all chords.
24. April 2020
this is awesome plugin. please next update add button + - chord transpose and resize Text or Hide chord on Post rendering. Thank
4. März 2019
I have tried almost all free chord plugin and this one is by far the best I have used. Feature rich and super easy to use and customize. If transposing on the fly is implemented this will be a killer 🙂
Lies alle 5 Rezensionen

Mitwirkende & Entwickler

„ChordPress – ChordPro Text Formatter“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

Mitwirkende

Änderungsprotokoll

2.2.0 (2020-06-06)

  • Directive support for capo, key, time, tempo
  • Chord sheet on top option

2.1.0 (2020-02-23)

  • Vexchords support
  • Chord diagrams

2.0.0 (2020-01-26)

  • Completely rewritten plugin framework
  • Adeded option to remove plugin data from database when it is deleted
  • Added language translation support
  • Character ‚~‘ can now be used in chord brackets as chord placeholder or strumming indicator
  • Fixed TinyMCE ChordPress menu shortcut bug

1.5.0

  • Reworked the options page and fixed the tab save bug

1.4.0

  • Added print feature for interactive mode

1.3.0

  • Added interactive mode

1.2.0

  • Fixed duplicate plugin entry bug
  • Reworked the plugins settings page
  • Added TinyMCE integration

1.0.5

  • Updated documentation and support links
  • Compatibility: WordPress 5.3.2

1.0.4

  • Fixed: Bass notes were not rendered correctly, e.g. A/C#
  • Compatibility: WordPress 5.1

1.0.3

  • Readme update

1.0.2

  • Added screenshots, icons and banners

1.0.1

  • Fixed hard coded image path

1.0.0

  • Initital development for http://sayandsound.lewe.com