Read a Poem – Month by Month

Use this plugin to dynamically display content that changes every month. This plugin creates a ‘poem’ custom post type. Use a shortcode to display a poem on a page or to cycle through a series of posts to display a different poem each month.

  •  Use the shortcode [poem-current] to display the poem for the given month on a page
  •  Use the shortcode [poem id=XXX] to display a poem in a pag.
  •  Developers can add do_shortcode(‘[poem-current]’) to their templates.

Praise or Need Support?

Please use the WordPress.org forum if you have a question regarding this plugin.

If you like this plugin please rate it on WordPress.org

Installation

  1. Upload read-a-poem folder to the /wp-content/plugins directory
  2. Activate the plugin through the Plugins menu in WordPress
  3. Add your poem in the new ‘Read a Poem’ custom post type section of the admin.
  4. To display a given poem on a page/post in your site — go to the “All Poems” screen and copy the poem’s shortcode [poem id=XXX]. Paste the shortcode into your site where you want to display your poem.
  5. To cycle through and display a different poem each month….
    •  begin by adding 12 poems to the Read a Poem post type
    •  then go to Assign to Month and designate which poem is to be displayed each month
    •  Add the shortcode [poem-current] to a page
  6. DEVELOPERS: include echo do_shortcode(“[poem-current]”); in the template where you want the poems to display.

Frequently Asked Questions

1.  Can this plugin display monthly content other than poetry?
Yes! The custom post type is called Read a Poem but you can use it for any content that you want to change on a month by month basis.

2. What shortcodes do I use for this plugin?

  • From the All Poems page you can grab the poem’s shortcode – go to the “All Poems” screen and copy the poem’s shortcode [poem id=XXX] id=XXX will be the specific id number for your poem.
  •  [poem-current] will display the poem assigned to the current month

3.  How do I include Read a Poem in a page template?
include echo do_shortcode(“[poem-current]”); in the template where you want the poems to display.

4.  Can I see a Demo of this plugin in action?
The plugin was written for use here D.S. Martin, Poet

Screenshots