 |
CaRP/WP Display RSS Feeds In Your WordPress Posts Free Plugin Integrates WordPress & CaRP |
Contributors: Antone Roundy
Donate link:
Tags: rss, feed, amazon, aggregate, aggregations, syndication
Requires at least: unknown
Tested up to: 2.3.3
Stable tag: 1.0.3
Description
CaRP/WP is a WordPress plugin that, working with CaRP, enables you to display RSS feeds, including Amazon.com affiliate feeds and YouTube feeds, in your WordPress posts and pages.
CaRP/WP uses CaRP to handle the feed processing and display. (A free version of CaRP is available -- you'll find a link at the bottom of the page linked to above).
Download
Installation
- Install CaRP (http://www.geckotribe.com/rss/carp/). Be sure to copy the code that the installer script gives you at the end.
- Upload carp-wp-theme.php and carp-wp-youtube-theme.php to your CaRP themes directory.
- Upload the 'carp-wp' directory and its contents to the '/wp-content/plugins/' directory.
- Activate the plugin through the 'Plugins' menu in WordPress
- 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'.
- 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).
- If you signed up on a non-US Amazon affiliate site, select your country.
- Update any of the other options you wish to change.
Frequently Asked Questions
How do I display a feed?
Enter the following code in your post or page 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 or page 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]
If you have CaRP version 4.0 or higher, you may also use the "interleave" style of aggregating as follows:
[carpwp:interleave{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 or page content, substituting in the keywords to use to perform the search:
[carpwp:amazon{keywords go here}][/carpwp]
How do I display a YouTube feed
Note: YouTube support requires CaRP Evolution 4.0 or higher.
To display a tag or keyword-based YouTube feed, enter the following code in your post or page content, substituting the keywords or tags you wish to search for:
[carpwp:youtube-tag{keywords go here}][/carpwp]
Or to display videos by particular YouTube user, substitute their username in the following:
[carpwp:youtube-user{username goes 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 />
Note that, as in the last line of the example above, the "<" character in some HTML tags must be replaced with "<" because of how WordPress processes content internally.
Documentation for CaRP's options
To customize the display of YouTube feeds, you may either edit carp-wp-youtube-theme.php (to change your default YouTube configuration) or enter code like the following between the opening and closing tags. Specify plugin settings by entering "youtube-" followed by the setting name.
youtube-language=de
youtube-show-border=1
Documentation for CaRP's YouTube Plugin
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;
}
Screenshots
License
Copyright 2008 Antone Roundy
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. YouTube support requires CaRP Evolution 4.0 or higher.
PO Box 5835
Grand Island, NE 68802
(801)326-4934