WordPress.org

Instructions for use

Using the plugin

The plugin provides two methods for inserting the list of Serial Posts in a page: a shortcode and a template tag, either of which may be used. It is recommended that you use one or the other, but not both, in accordance with your needs and preferences.

Template tag: Add this template tag to, typically, your single post theme template file, usually single.php or index.php, wherever you want to display the list of Posts/Pages. This tag must appear within the Loop.

<?php serial_posts(); ?>

Shortcode: Add this shortcode directly into the post editor when writing or editing a Post or Page.

[serialposts]

Configuration and set-up

Further information can be found at http://www.studiograsshopper.ch/serial-posts/configuration/ and a comprehensive "how to" at http://www.studiograsshopper.ch/serial-posts/tutorial/

In the Dashboard, go to Settings and open the Serial Posts Configuration page.

List Display options. This is where you can customise the Serial Posts heading and list of posts. The Heading is made up of three elements: "Text before Serial name" "Serial Name" "Text after Serial name".

Text before Serial name: Enter the text that you would like to appear in the Heading BEFORE the Serial name. If you don't want to show any text before the Serial name, just blank out the field before saving your settings.

Text after Serial name: Enter the text that you would like to appear in the Heading AFTER the Serial name. If you don't want to show any text after the Serial name, just blank out the field before saving your settings.

Hide Serial Name: By default, the Serial Name always appears in the Heading. Check this box to prevent display of the Serial Name in the Heading. Note: checking this option will also hide the "Text after Serial name".

List type <ul> or <ol>: Select either unordered list <ul> or ordered list <ol> from the dropdown.

List <ul>/<ol> class: To allow even greater control over the styling of the list, you may specify a class name for the list's <ul> or <ol> tag. The default is "serial-posts". Note that the plugin replaces any whitespace with hyphens.

Include current post: Check the box if you want to include the currently viewed Post/Page in the list of Serial Posts. Default is CHECKED. If you uncheck this box, the currently viewed Post/Page will not appear in the Serial Posts list.

Show current post as a link: If you have checked "Include current post", you may check this box if you want the current viewed Post or Page to be shown as a link. Default is UNCHECKED. If you check this box, the currently viewed Post/Page will appear as a link in the Serial Posts list.

That's it! The Settings Page is now configured.

Acknowledgements

With acknowledgements to Justin Tadlock whose original code idea inspired this plugin.