== In-Series == Tags: series, sequential, connected, article series, linking posts, post series Contributors: Lorelle (http://codex.wordpress.org/User:Lorelle) In-Series provides an easy, future-proof way to connect a series of posts. If you have a series of articles on your site, and you want to ensure your readers can follow the sequence within the series, In-Series will help you provide the links between the posts and articles, improving your site's navigation. == Installation == 1. Install in-series.php into your wp-content/plugins directory. 2. Modify your single.php (http://codex.wordpress.org/Template_Hierarchy#Single_Post_Page) template to call any of the following functions: previous_in_series() next_in_series() all_in_series() series_table_of_content() If you're not using (or don't have) single.php, then place these template tags in index.php after your post content and before your next and previous page navigation tags. == Usage == To create a connected series of posts, add two custom field (http://codex.wordpress.org/Using_Custom_Fields) key/value pairs to each post in the series. series_name a unique name for the series. series_order the current post's position in the series. The step-by-step instructions for usage follow. Assume you are writing a tutorial on WordPress plugins. 1. Create the first post in the series. 2. Before saving, move to the Custom Field section under Advanced Editing. 3. In the KEY field, type series_name. 4. In the VALUE field, type in a unique name for this series such as "Writing A WordPress Plugin". 5. Click Add Custom Field. 6. Again, in the KEY field, type series_order. 7. In the VALUE field, type in the number "1", as this is the first post in the series. 8. Click Add Custom Field. 9. Click Save or Publish. For the second post or article in the series, repeat the process, incrementing the series_order number by 1. The custom fields for each post, by themselves, don't do anything. If the In_Series plugin is deactivated, they will not appear. When the In-Series plugin is activated, though, several new template tags are available which do use these custom fields. These new template tags only output when viewing a single post. When these new template tags are called on an index, archive, category, or any non-single-post view template file, they will silently do nothing. The tags will generate the series information when viewing a single post that is part of a series as defined by the custom fields series_name and series_order. By default, if there is no next or previous article in the series, that link will not appear. The default usage also does not highlight the current page in a link. The following functions will output links as described below. If the post is not part of a series (as defined by the custom fields), the template tags will not display anything; so it's safe to add these tags to your default template(s). If the plugin is deactivated, you will need to remove or comment out these tags. displays a link to the previous post in the series, if there is one. If the current post is the first post in the series, this template tag will not display anything. displays a link to the next post in the series, if there is one. If the current post is the last post in the series, this template tag will not display anything. displays a list of links to each post in the series. The current post is not linked, to ensure the reader knows where in the series they are. displays each post's title as a clickable link to that post, as
  • elements. The current post is not linked, to ensure the reader knows where in the series they are. == Advanced == === Next and Previous === The next and previous series template tags can be called with no parameters: and they output a link that looks something like this: Writing a WordPress Plugin Part 2 » By default, the title of the next post will be used for the link. You can modify the output by passing the following variables to the function: * format The format parameter features the format for the text before or after the link. The default usage features '%link »' for next_in_series() and '« %link' for previous_in_series(). * link This parameter sets the link usage. The default, '%title', will use the post's title. An example would be: Next in the series: ', '%title'); ?> which would produce Next in the series: Writing a WordPress Plugin Part 2 » This example will create a link to the next post in the series (if there is one) with the word "NEXT" for the link, instead of the post's title. Writing a WordPress Plugin Part 2 NEXT » This example will create a link to the next post in the series (if there is one) with "Next Up: " followed by the post's title. Next Up: Writing a WordPress Plugin Part 2 » If you want to simply remove the little arrows from the links, use this: previous_in_series('%link'); next_in_series('%link'); === All in Series === The all_in_series() function also works without arguments, producing the following: « Read the whole series: 1,2,3 » Where "1,2,3" are links to the series' posts. The current page is not linked in the list. The parameters are: * separator What to place between the links to the posts. Default is a comma (','). * before What to place before the list of links. Default is '« Read the whole series: ' * after What to place after the list of links. Default is ' »' To change the text and put the entire thing in an HTML paragraph tag: The whole shebang: ', '

    '); ?> The whole shebang: 1,2,3 You can use get_post_meta (http://codex.wordpress.org/Using_Custom_Fields) to first grab the current series' name, and then use that in all_in_series, like this: ID, 'series_name', TRUE); all_in_series(',', "$series_name: "); ?> will produce something like this: Writing a WordPress Plugin: 1,2,3,4,5 If you simply want to remove the little arrows (»), use this: all_in_series(',', 'Read the whole series: ', ' '); === Table of Contents === The series_table_of_contents() function will produce HTML list elements for each post in the series:
  • Part 1
  • Part 2
  • Part 3
    • Note that the tag ONLY outputs the list elements. This allows you to use ordered or unordered lists as you wish:
    will produce an ordered list of your series' posts. The function accepts a single parameter: * class if specified, this is the name of a CSS class that will be applied to each list element:
  • To include this tag in your default template, use something like this (adjust HTML and CSS declarations as needed): ID, 'series_name', TRUE); if ('' != $series) { echo "

    $series

    "; echo "
      "; series_table_of_contents(); echo
    "; } ?> == Frequently Asked Questions == None, yet. == Credits == Copyright (c) 2005 Scott Merrill (skippy@skippy.net) Released under the terms of the GNU GPL Documentation: Lorelle (http://www.cameraontheroad.com/)