ChordPress for WordPress

The ChordPress for WordPress plugin reads and processes ChordPro formatted text, including several content and formatting directives, and renders it for WordPress sites.

What is ChordPro?

The ChordPro site introduces this text format as follows:

In 1992 Martin Leclerc and Mario Dorion developed a simple text file format to write lead sheets, songs with lyrics and chords, and a tool to create neatly printed lead sheets out of these text files. The tool was called  chord, and the text files were called chord files. It soon became a popular way to write lead sheets and many users and tools adopted this format for similar purposes. For still unknown reasons people started calling the files chordpro files.

The simplicity of this text format is amazing and offers powerful options for rendering software to display lead sheets. Let’s have a look at an example:

There are three distinctive characters used, identifying specific content:

  • # :  A line starting with a hash is a comment and not supposed to be rendered
  • {} : Text enclosed in curly brackets identifies meta information or start/end of a lyrics section.
  • [] : Text enclosed in square brackets identifies a chord.

Lastly, the letter/sylible following the chord is where the chord is supposed to be played.

What is ChordPress for WordPress ?

ChordPress for WordPressChordPress for WordPress is a WordPress plugin that processes ChorPro text and renders it on your website (click the image for an example).

Simply insert a ChordPro text inbetween the [chordpress] and [/chordpress] tags and it will be rendered based on the options set for the plugin. You can change these settings on the plugin’s option page.

The shortags allow specifying custom options.
For example: [chordpress transpose="1"] will transpose the chords rendered up by one semitone.

Features

  • ChordPress for WordPress renders the lyrics/chord format of ChordPro.
  • ChordPress for WordPress supports the following ChordPro tags:
    • {album}
    • {artist}
    • {composer}
    • {subtitle}
    • {title}
    • {year}
    • {meta} (for all of the above)
  • ChordPress for WordPress supports custom CSS for the following ChordPro tags:
    • {comment}
    • {start_of_chorus}, {end_of_chorus}
    • {start_of_verse}, {end_of_verse}
  • ChordPress for WordPress supports note/chord translations

Installation

  1. Download the plugin ZIP file
  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

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

  • transpose="#" => Enter a positive or negative number for the amount of semitones to transpose the chords
  • hbnotation="yes" => 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.

Use the “ChordPress” sub-menu of your backend Settings to change the default settings.

Frequently Asked Questions

Why are empty ChordPro lines not rendered ?
Empty lines are stripped from shortcode content. The plugin doesn’t know they were there. 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.

Screenshots

ChordPress for WordPress

ChordPress for WordPress
ChordPress for WordPress
ChordPress for WordPress

Download

ChordPress for WordPress

Version: 1.0.1

A WordPress plugin rendering ChordPro formatted text

Author: George Lewe

Read more...


Your Rating
software image
Aggregate Rating
4 based on 4 votes
Software Name
ChordPress for WordPress
Operating System
WordPress
Software Category
Plugin
Price
USD 0
Landing Page