=== CaRP/WP ===

URL: http://www.geckotribe.com/rss/carp/CaRP-WP/
Contributors: Antone Roundy
Tags: rss, feed, amazon, aggregate, aggregations, syndication
Tested up to: 2.3.3
Stable tag: 0.9

CaRP/WP works with CaRP (http://www.geckotribe.com/rss/carp/) to display RSS feeds, including Amazon.com affiliate feeds, in your posts and pages.

== Description ==

CaRP/WP is a WordPress plugin that, working with [CaRP](http://www.geckotribe.com/rss/carp/), enables you to display RSS feeds, including Amazon.com affiliate feeds, in your WordPress posts and pages.

== Installation ==

1. Install CaRP (http://www.geckotribe.com/rss/carp/). Be sure to copy the code that the installer script gives you at the end.
1. Upload carp-wp-theme.php to your CaRP themes directory.
1. Upload the 'carp-wp' directory and its contents to the '/wp-content/plugins/' directory.
1. Activate the plugin through the 'Plugins' menu in WordPress
1. In the WordPress 'Options' menu, 'CaRP/WP' submenu, enter the path to CaRP that the installer script gave you. This should include everything inside the quotation marks on the line that begins with 'require_once'.
1. If you wish to display Amazon.com affiliate feeds, also enter your Associate Tag and Access Key ID (if you don't have either of those, go to the Amazon.com affiliates site and get them).
1. If you signed up on a non-US Amazon affiliate site, select your country.
1. Update any of the other options you wish to change.

== Screenshots ==

== Frequently Asked Questions ==

= How do I display a feed? =
Enter the following code in your post content, substituting in the URL of the desired feed:

		[carpwp:feed{http://example.com/feed.rss}][/carpwp]

= How do I aggregate multiple feeds together? =
Enter the following code in your post content, substituting in the URLs of the desired feeds, and choosing a unique "groupkey" for each output formatting configuration. Note that it is only necessary to specify the encoding of the feed if CaRP is unable to determine it automatically. 

		[carpwp:aggregate{groupkey}]
		feed={http://example.com/feed1.rss}
		feed={http://example.com/feed2.rss},UTF-8
		feed={http://example.com/feed3.rss}
		[/carpwp]

= How to I display an Amazon.com affilite feed? =
Enter the following code in your post content, substituting in the keywords to use to perform the search:

		[carpwp:amazon{keywords go here}][/carpwp]

= How do I customize the output? =
Enter code like the following between the opening and closing tags ([carpwp:...] and [/carpwp]). The first word is the name of a CaRP configuration variable, and the value after the "=" sign is the value to set it to. These names and values are exactly that same as are used with CaRP's "CarpConf" function. Enter each configuration setting on a separate line.

		cborder=
		iorder=link,author,desc
		ai=<br />

[Documentation for CaRP's options](http://carp.docs.geckotribe.com/full-index.php)

= How do I set a configuration value containing line breaks? =
Since line breaks don't actually render as line breaks in HTML, it shouldn't be necessary. However, if you really need to, you'll have to create a CaRP theme file, specify the configuration settings using "CarpConf", and load the theme.

= How do I load a CaRP theme? =
If you wish to load a CaRP theme other than your default theme, enter the following between the opening and closing tags, substituting in the name of the desired theme file:

		theme=theme-file.php

= How do I override my default Amazon.com settings? =
Enter code like the following between the opening and closing tags:

		amazon_length=250
		amazon_one_review=0

= How about a full example? =
Okay, here's an example of an Amazon affiliate feed in a div with some CaRP configuration and setting overrides:

		<div id="carpamazon">[carpwp:amazon{rss marketing}]
		theme=my_amazon_theme.php
		cborder=
		iorder=link,image,desc
		ilinkstyle=font-weight:bold;
		ai=<br style="clear:left;" />
		amazon_length=250
		amazon_one_review=0
		[/carpwp]</div>

Format the div and its contents by putting something like this in your theme's CSS stylesheet:

		#carpamazon {
			float:right;
			margin-left:10px;
			width:200px;
			border:1px solid #ccc;
			background-color:#eee;
			padding:4px 7px;
		}
		#carpamazon a {
			font-size:120%;
		}
		#carpamazon img {
			float:left;
			margin-right:7px;
		}

== License ==

Copyright 2008 [Antone Roundy](http://antone.geckotribe.com/alpha-gecko/)

CaRP/WP is released under the GNU General Public License. This means the software is free to use, redistribute and modify.

Note that CaRP/WP requires CaRP, which is NOT free software.