coffee2code

Extended Description

Installation

Template Tags

The plugin provides one template tag for use in your theme templates, functions.php, or plugins.

Functions

• <?php c2c_linkify_posts($posts, $before = '', $after = '', $between = ', ', $before_last = '', $none = '') ?>
  Displays links to each of any number of posts specified via post IDs

Arguments

• $posts
  A single post ID/slug, or multiple post IDs/slugs defined via an array, or multiple posts IDs/slugs defined via a comma-separated and/or space-separated string

• $before
  (optional) To appear before the entire post listing (if posts exist or if ‘none’ setting is specified)

• $after
  (optional) To appear after the entire post listing (if posts exist or if ‘none’ setting is specified)

• $between
  (optional) To appear between posts

• $before_last
  (optional) To appear between the second-to-last and last element, if not specified, ‘between’ value is used

• $none
  (optional) To appear when no posts have been found. If blank, then the entire function doesn’t display anything

Examples

• These are all valid calls:

<?php c2c_linkify_posts(43); ?>

<?php c2c_linkify_posts("43"); ?>

<?php c2c_linkify_posts("hello-world"); ?>

<?php c2c_linkify_posts("43 92 102"); ?>

<?php c2c_linkify_posts("hello-world whats-cooking"); ?>

<?php c2c_linkify_posts("43,92,102"); ?>

<?php c2c_linkify_posts("hello-world, whats-cooking"); ?>

<?php c2c_linkify_posts("43, 92, 102"); ?>

<?php c2c_linkify_posts("hello-world, 92, whats-cooking"); ?>

<?php c2c_linkify_posts(array(43,92,102)); ?>

<?php c2c_linkify_posts(array("hello-world", "whats-cooking")); ?>

<?php c2c_linkify_posts(array("43","92","102")); ?>

• <?php c2c_linkify_posts("43 92"); ?>

Outputs something like:

<a href="http://yourblog.com/archive/2008/01/15/some-post">Some Post</a>,
<a href="http://yourblog.com/archive/2008/01/15/another-post">Another Post</a>

• Assume that you have a custom field with a key of “Related Posts” that happens to have a value of “43 92″ defined (and you’re in-the-loop).

<?php c2c_linkify_posts(get_post_meta($post->ID, 'Related Posts', true), "Related posts: "); ?>

Outputs something like:

Related posts: <a href="http://yourblog.com/archive/2008/01/15/some-post">Some Post</a>,
<a href="http://yourblog.com/archive/2008/01/15/another-post">Another Post</a>

• <ul><?php c2c_linkify_posts("43, 92", "<li>", "</li>", "</li><li>"); ?></ul>

Outputs something like:

<ul><li><a href="http://yourblog.com/archive/2008/01/15/some-post">Some Post</a></li>
<li><a href="http://yourblog.com/archive/2008/01/15/another-post">Another Post</a></li></ul>

• <?php c2c_linkify_posts(""); // Assume you passed an empty string as the first value ?>

Displays nothing.

• <?php c2c_linkify_posts("", "", "", "", "", "No posts found."); // Assume you passed an empty string as the first value ?>

Outputs:

No posts found.

Filters

The plugin exposes one action for hooking.

c2c_linkify_posts (action)

The ‘c2c_linkify_posts’ hook allows you to use an alternative approach to safely invoke c2c_linkify_posts() in such a way that if the plugin were to be deactivated or deleted, then your calls to the function won’t cause errors in your site.

Arguments:

• same as for c2c_linkify_posts()

Example:

Instead of:

<?php c2c_linkify_posts( "112, 176", 'Posts: ' ); ?>

Do:

<?php do_action( 'c2c_linkify_posts', "112, 176", 'Posts: ' ); ?>

Frequently Asked Questions

Q. What happens if I tell it to list something that I have mistyped, haven’t created yet, or have deleted?
A. If a given ID/slug doesn’t match up with an existing post then that item is ignored without error.

Q. How do I get items to appear as a list (using HTML tags)?
A. Whether you use the template tag or the widget, specify the following information for the appropriate fields/arguments:

• Before text: <ul><li> (or <ol><li>)
• After text: </li></ul> (or </li></ol>)
• Between posts: </li><li>

Release Log

2.1.4

• Add check to prevent execution of code if file is directly accessed
• Note compatibility through WP 3.5+
• Update copyright date (2013)
• Create repo’s WP.org assets directory
• Move screenshot into repo’s assets directory

2.1.3

• Re-license as GPLv2 or later (from X11)
• Add ‘License’ and ‘License URI’ header tags to readme.txt and plugin file
• Remove ending PHP close tag
• Note compatibility through WP 3.4+

2.1.2

• Note compatibility through WP 3.3+
• Add link to plugin directory page to readme.txt
• Update copyright date (2012)

2.1.1

• Note compatibility through WP 3.2+
• Minor code formatting changes (spacing)
• Fix plugin homepage and author links in description in readme.txt

2.1

• Add Linkify Posts widget
• Note compatibility through WP 3.1+
• Add Screenshots and Frequently Asked Questions sections to readme.txt
• Add screenshot of widget admin
• Update copyright date (2011)
• Change tags in readme.txt

2.0

• Rename plugin from ‘Linkify Post IDs’ to ‘Linkify Posts’
• Rename linkify_post_ids() to c2c_linkify_posts() (but maintain a deprecated version for backwards compatibility)
• Rename ‘linkify_post_ids’ filter to ‘c2c_linkify_posts’ (no backwards compatibility support since v1.5 was never released)
• Allow linkifying posts specified by slug (in addition to existing support for posts specified by ID)
• Change description
• Drop support for version of WP older than 2.8

1.5

• Add filter ‘linkify_post_ids’ to respond to the function of the same name so that users can use the do_action() notation for invoking template tags
• Fix to prevent PHP notice
• Wrap function in if(!function_exists()) check
• Reverse order of implode() arguments
• Remove docs from top of plugin file (all that and more are in readme.txt)
• Add package info to top of plugin file
• Add PHPDoc documentation
• Note compatibility with WP 2.8+, 2.9+, 3.0+
• Minor tweaks to code formatting (spacing)
• Add Changelog, Filters, and Upgrade Notice sections to readme.txt
• Update copyright date
• Remove trailing whitespace

1.0

• Initial release

Copyright & Disclaimer