This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



This plugin allows to format poems in a nice way. The content of the poem is capsuled by the [poem]-tag.

It loads a template from the template-directory if specified, else the default template is choosen.

Poem Syntax

The plugin supports a simple formatting syntax. All formatting information has to be put at the line-start

  • #c# -> Center all lines starting with this line
  • #l# -> Align left all lines starting with this line
  • #r# -> Align right all lines starting with this line
    • -> Indent the line by count(+) times <indent> pixels
  • #1#,#2#,#3# -> the following text will be put to the text-box number 1, 2, 3…. Text-Box 1 is default text-box

Template syntax

has to be explained and written. Job is on my ToDo-list.


  • one column layout
  • advanced formatting
  • two column layout
  • default-layout with advanced format


  1. Download the Plugin ZIP file
  2. Unpack the Plugin-ZIP
  3. Upload the poem_formatter folder to your wordpress plugin directory
  4. Activate the plugin through the ‘Plugins’ menu in WordPress

After activating the plugin you can use Poem Formatter with these shortcode:

  • [poem title=””]Your poem here[/poem]

Optional parameters are poem title=”title” (debug) (align=”center|left|right”) (indent=””)

  • title=”title” -> specify the title of your poem
  • author -> Specify the author of the poem.
  • date -> Specify the creation date of the poem (if you want to)
  • align=”center|left|right” -> default is center, specify the default align of the poem lines (can be changed during the poem)
  • indent = “pixel” default is 50, specifies the indent per line in pixel per + sign at the start of the line
  • template -> The name of the template that shall be used for the poem. If not specified “default” is loaded
  • debug -> If this is present the PHP-module put some more information into the HTML-file
  • ipsum -> If this is present the content will be replaced by “Lorem Ipsum”
  • titlecolor -> If the template supports changing the title-color this can be done with this switch
  • textcolor -> If the template supports changing the text-color this can be done with this switch


Where do I get the development-version?

I use git for my own development. You can find the Trunk-version on GitHub. It includes also the scripts to update the subversion-directory on wordpress.

Are there known bugs?

Yes, I’m sure, that there are some known bugs. I had no time to fix or trace them yet.

  • to be done…

Is there a Roadmap?

Yes, there is kind of a roadmap. But the order depends on my time.

  • improve the documentation
  • create some more templates

Contributors & Developers

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

Translate “PoemFormatter” into your language.

Interested in development?

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



  • only minor adjustments. Preparation for further changes


  • support for different templates and text-blocks
  • proper replacement of meta-attributes like author, creation date, color replacement
  • poem template added


  • Initial pre-beta version, does not really allow public usage