=== Cross-references ===
Contributors: hervada
Tags: cross-references,backlinks,links,posts,related
Requires at least: 2.2
Tested up to: 2.3 beta 3
Stable tag: 1.1

Insert cross-references between posts or pages and get all back references via template.

== Description ==
With this plugin you can easily set a reference to another post or page in posts und pages and you get all back references automatically listed for every post and page.

* Forward links. When writing your posts, you can refer to other posts by their ID number, like so: [cref 12]. This is shown at the blog as the title of post #12 with a link to it.
  
* Back links. To show a list of all the posts that link to the current post, put <?php the_crossreferences() ?> in your templates, for example at the page single.php of your current theme.

Usage details:  
  
* If you want to get another description instead of the post title, write it after the id: [cref 12 see above]. This is shown at the blog as "see above" with a link to post #12.

* If you write [cref.from 12] you do not see a forward link, but both posts get linked to each other as a back link (appear at the "related posts" list).

* The parameters from template function are the_crossreferences($before,$between,$after,$id)

  $before - Optional. This string being printed once before the related posts list (only if there is 1 related post or more)
  
  $between - Optional. This string being printed between 2 entries in the related posts list.
  
  $after - Optional. This string being printed once after the related posts list (only if there is 1 related post or more)
  
  $id - Optional. The post id number to which the related posts list are shown. If not given, the current post is assumed.
  
  Examples:
  
  If you write <?php the_crossreferences() ?> you get an output such as:
	<li>Post title 1</li><li>Post title 2</li><li>Post title 3</li> (if there are 3 related posts)
        Nothing (if there are no related posts)
        
  If you write 	<?php the_crossreferences('See also:', '; ', '.') ?> you get an output such as:
	See also: Post title 1; Post title 2; Post title 3.(if there are 3 related posts)
        Nothing (if there are no related posts)
	
  If you write 	<?php the_crossreferences('<h2>Related posts</h2><li>') ?> you get an output such as:
	<h2>Related posts</h2><li>Post title 1</li><li>Post title 2</li> (if there are 2 related posts)
        Nothing (if there are no related posts)
  
  If you write 	<h2>Related posts</h2><?php the_crossreferences() ?> you get an output such as:
	<h2>Related posts</h2><li>Post title 1</li><li>Post title 2</li> (if there are 2 related posts)
        <h2>Related posts</h2> (if there are no related posts)

== Installation ==

1. Upload `crossreferences.php` to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Place `<?php the_crossreferences(); ?>` in your templates where you want to get the back links

== Frequently Asked Questions ==

= Are references automatically updated whenever the refered/referer post title changes? =

Yes, since the title of the post is read dynamically when it is shown.

= What happens if I delete a post to which there are references? =

All links will be removed from the referer posts, but their text (possibly the title of the removed post) will remain unchanged.