=== ZigConnect ===
Contributors: ZigPress
Donate link: http://www.zigpress.com/wordpress/plugins/zigconnect/
Tags: post links, posts to posts, post to post, post connection, connect posts, link posts, custom post types, zigpress, zig
Requires at least: 3.0.4
Tested up to: 3.0.5
Stable tag: 0.4

Allows you to link post types and posts to each other and attach data directly to the links.

== Description ==

Allows you to link post types (including custom post types) and posts to each other and attach data directly to the links. ZigConnect was inspired by the plugin "Posts 2 Posts" but has been written from scratch.

Requires WordPress 3.0.4+, PHP 5.0+ and MySQL 4.1+.

For further information and support, please visit [the ZigConnect home page](http://www.zigpress.com/wordpress/plugins/zigconnect/).

ZigConnect uses icons from the [Silk icon set](http://www.famfamfam.com/lab/icons/silk/) and the [Tango Desktop Project](http://tango.freedesktop.org/).

= To Do =

* Improve permissions checking
* Allow multiple (named) connections between the same post types, so that different fields can be attached
* Some query optimisation so that it scales better

== Installation ==

1. Unzip the installer and upload the resulting 'zigconnect' folder to the `/wp-content/plugins/` directory. Alternatively, go to Admin > Plugins > Add New and enter ZigConnect in the search box.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to the plugin's main admin page and start creating connections between content types.
4. Edit a post of a connected type and look for the ZigConnect panels below the main content edit panel.

== Frequently Asked Questions ==

= How do I use the template tags? =

Try the following example. It should be inserted into single.php, inside the loop. It will show a list of posts of type 'my_type' which are linked to the current post via a connection.

	$connectedposts = zc_get_linked_posts('my_type');
	if ($connectedposts)
		{
		echo '<ul>';
		foreach ($connectedposts as $otherpostid)
			{
			$otherpost = get_post($otherpostid);
			echo '<li>';
			echo '<a href="' . get_bloginfo('url') . '/my_type/' . $otherpost->post_name . '">' . $otherpost->post_title . '</a>';
			echo '</li>';
			}
		echo '</ul>';
		}

If you have a connection between types that carries one or more data fields, you can also show the content of these data fields for each link in the list, like this enlarged example.

	$connectedposts = zc_get_linked_posts('my_type');
	if ($connectedposts)
		{
		echo '<ul>';
		foreach ($connectedposts as $otherpostid)
			{
			$otherpost = get_post($otherpostid);
			$linkdata = zc_get_linkdata($otherpostid);
			echo '<li>';
			echo '<a href="' . get_bloginfo('url') . '/my_type/' . $otherpost->post_name . '">' . $otherpost->post_title . '</a>';
			if ($linkdata)
				{
				echo ' ( ';
				foreach ($linkdata as $linkdatakey=>$linkdatavalue)
					{
					echo $linkdatakey . '=' . $linkdatavalue . ' ';
					}
				echo ' ) ';
				}
			echo '</li>';
			}
		echo '</ul>';
		}

= Is ZigConnect available in my language? =

Not yet but it is now ready for localization, so potential translators are encouraged to submit .po and .mo files for their language.

= I have a question not shown here! =

For further information and support, please visit [the ZigConnect home page](http://www.zigpress.com/wordpress/plugins/zigconnect/).

== Screenshots ==

1. The main admin page where connections between post types are defined.

== Changelog ==

= 0.4 =
* Added some template tag usage examples
* Improved template tag code
* Merged in various functionality from an unreleased sub-plugin (this will be enhanced and documented later)
* Completely rebuilt admin form callback system to fix various 'headers already sent' warnings on some installations
* Restricted contextual help to ZigConnect pages only
* Some code refactoring
* Made ready for localization
= 0.3.1 =
* Custom admin columns in admin post editing pages now show connection totals only to avoid rows getting too high
* Fixed bug that may cause connected types to be duplicated in arrays when queried
* Fixed fatal error on activation
* Fixed warning on post update when no fields defined for connections
= 0.3 =
* Added AJAX post search to post edit panels
= 0.2 =
* Substantial code refactoring
* Widget code (under development) removed until I think of a useful widget to add
* Improved admin message system to avoid duplicate database actions
* Added more relevant admin icon
* Tidied readme file and added icon usage credits
* Removed unused icons from images folder
= 0.1 =
* First public release