This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

This plugin has been closed and is no longer available for download.

ScoreRender

Description

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 with GD extension, ImageMagick and various programs to generate music score.

Installation

Prerequisite

  1. PHP 5.x with GD extension (Please visit offical site if ancient version using PHP4 is needed)
  2. ImageMagick >= 6.3.5-7 (due to usage of -alpha option). Version later than 6.3.9-6 is preferred, since a bug about detecting PostScript transparency is fixed.
  3. GhostScript (Usually pre-installed on Linux. Under Windows, download prepackaged installer from official site )
  4. 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.

FAQ

It just complains about some obscure error!

The error code indicates the kind of error in some degree. There are comments inside wp-scorerender.php indicating what kind of error it is. If you can’t make any heads and tails out of PHP code, feel free to contact the author.

Why music score fragments are not rendered at all?
  • Check if the beginning tag and ending tag of your music score fragment are correct.
  • It will only be rendered if logged in user has unfiltered_html capability, i.e. the user has Administrator or Editor role in WordPress. User can ask blog admin to boost their capabilities if needed.
  • Some programs required for certain notation may be not working or missing.
Is any ABC notation compatible program also supported?

Since 0.2, abcm2ps will be the only one supported. This is a design decision. If you REALLY want to use other similar programs, you are on your own, though modifying the code to support others is not very hard. Take a look at is_notation_usable() method in notation/abc.php.

I want to remove some specific cached image and re-render, but how can I determine which is which?

Right now this is still impossible. Management of cache is planned in future, but can’t say when it would be finished.

How to debug my fragment when posting?

Simply answer: don’t do that if possible. The best way is render it privately in your computer first, then post the content, rather than needlessly spending lots of time on trial and error.
Long answer: There is no easy method for debugging a fragment yet. If there is no choice but perform trial and error, please search for this line in wp-scorerender.php:

    define (DEBUG, FALSE);

Change FALSE to TRUE, then resubmit the content again. It has 2 purposes:

  1. Erraneous fragments are not deleted from server temp folder, and you can try manually rendering the fragment using command line to see what’s wrong.
  2. Full command line for rendering is now shown on blog, so that you can check out if command line argument is wrong.
How can I install Philip’s Music Writer?

Only by downloading source from its official website and compile the program yourself. The author failed to notice any binary package for Windows or Linux as of Feb 2010, except an outdated RPM package for Mandriva Linux.

Please refer to the documents inside PMW tarball on how to compile its source code.

I discovered a bug. How can I notify the author?

You can either submit bug report to Googlecode or contact the author.

Contributors & Developers

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

Contributors

Translate “ScoreRender” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

0.3.4

  • CHG: Update ZeroClipboard to 1.0.6 which contains some bug fixes.
  • BUG: Image fetched from Guido notation server will not look blurred now.
  • BUG: More precise resizing and zooming for ABC image, so image width is more in line with setting.

0.3.3

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

0.3.2

  • BUG: Fix invocation for LilyPond 2.12.x

0.3.1

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

0.3.0

  • FEAT: Philip’s Music Writer notation support.
  • FEAT: IE Alpha fix has been incorporated, which provides translucent PNG support for IE 5.5 / 6.x. Thus drop IE PNG transparency warning altogether.
  • FEAT: 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.
  • FEAT: 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: Toggling IE PNG transparency warning option was ineffective.

0.2.0

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

0.1.3

  • FEAT: Add WordPress nonce protection.

0.1.2

  • BUG: Fix image rendering during ImageMagick conversion process.

0.1.1

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

0.1.0

  • Initial release.