ScoreRender

ScoreRender is a Wordpress plugin for rendering sheet music fragments into images. It supports converting fragments in excerpts, posts, pages and (optionally) comments. Currently it supports 5 music notations: ABC, Guido, Lilypond, Mup and Philip's Music Writer. For latest version, detailed usage instructions and demo cases, please visit ScoreRender official site. Requires PHP5, ImageMagick and various programs to generate music score.

Prerequisite

1. PHP 5.x (PHP4 compatibility is dropped since 0.2; please visit offical site if ancient version using PHP4 is needed)
2. ImageMagick >= 6.3.6-2 (due to usage of -flatten option). Newer version is better, since a bug about detecting PostScript transparency is fixed (updating pending in this area)
3. Music rendering programs must also be installed on the same machine web server is running. For example, to support Lilypond fragments, Lilypond >= 2.8.1 must be installed in web server. Most notations require explicit program to render, except GUIDO notation which fetches remote images instead. Refer to installation page for more detail.

New install

1. Install any prerequisite programs as noted above.
2. Extract archive, and copy 'scorerender' folder to wp-content/plugins/, keeping the folder structure intact.
3. Login to WordPress and enable the plugin in admin interface.
4. Configure ScoreRender under the ScoreRender tab of the Options page.
5. In Option -> Writing, check if this option is turned on:

"WordPress should correct invalidly nested XHTML automatically" It must be turned off if you intent to render Lilypond and Mup fragments, since this option will convert "<<" and ">>" into "< <" and "> >" correspondingly, thus destroying the music content and cause render error. Upgrade

1. Deactivate the plugin in WordPress admin page.
2. Remove the whole plugin folder.
3. Upload new plugin and activate again.

0.3.3

• Change license to AGPL v3.
• 'Show source' setting is moved to 'Contents' admin section.
• BUG FIX: Admin form html tags incorrectly nested.
• BUG FIX: Notation was not deactivated even when program name is not filled.
• BUG FIX: Restore safe mode for Lilypond, use precise version detection to determine command line argument.
• BUG FIX: PostScript transparency shall be properly detected for PMW and Mup on recent ImageMagick versions.
• BUG FIX: Prevents PMW from reading config file.
• FEATURE: Add icon for admin form title (on recent WP versions).

0.3.2

• BUG FIX: Fix invocation for LilyPond 2.12.x

0.3.1

• FEATURE: Show image dimension in output.
• BUG FIX: Fix line break when showing score source code under Windows.
• FEATURE: Better autodetection of program.
• BUG FIX: program availability checking.

0.3.0

• FEATURE: Philip's Music Writer notation support.
• FEATURE: IE Alpha fix has been incorporated, which provides translucent PNG support for IE 5.5 / 6.x. Thus drop IE PNG transparency warning altogether.
• FEATURE: Zero Clipboard has been incorporated, which provides cross platform copy and paste via flash. Warning about non-IE browser during copy and paste is removed.
• FEATURE: Better support of installation on web hosting, where disabling certain PHP functions is common practise.
• Rendering or not also depends on 'unfiltered_html' WordPress capability.
• Refactor functions and files, so admin page is only included when needed, and PHP class no longer access global variables.

0.2.1

• BUG FIX: Toggling IE PNG transparency warning option was ineffective.

0.2.0

• Revamp admin page and simplify options.
• Allows limiting number of score fragments and length of fragment.
• Allows showing music source code when image is clicked.
• Better Windows support.
• Mandates abcm2ps must be used for ABC notation support.

0.1.3

• Add WordPress nonce protection.

0.1.2

• Fix image rendering during ImageMagick conversion process.

0.1.1

• Fix transparency of images generated by Lilypond.
• Issue warning if correct invalidly nested XHTML automatically option is checked, instead of turning the option off.

0.1.0

• Initial release.