Plugin / RSSPhoto

Installation

RSSPhoto install simply requires creating a writable directory in wp-content/cache to store thumbnails, and installing/activating the plugin itself:

1. If it doesn’t already exist, create the directory wp-content/cache and give it permissions of 755
2. Upload all files to the wp-content/plugins/rssphoto directory
3. Activate the plugin through the ‘Plugins’ menu in WordPress

To use the widget:

1. Navigate to the ‘Widgets’ section of the ‘Appearance’ menu in WordPress
2. Drag the widget to the sidebar
3. Configure the widget as needed

To use the shortcode:

1. Edit the page you want to display the images

2. Add the following text to the page:

   [rssphoto url=”http://your.url.com/feed.xml”]

3. Include any of the following attributes (see descriptions of these settings below)

   • title=”Title”
   • url=”http://your.url.com/feed.xml”
   • height=150
   • width=185
   • img_sel=”Most Recent”
   • num_img=1
   • item_sel=”Random”
   • num_item=10
   • show_title=1
   • show_img_title=1
   • output=”Slideshow2″
   • interval=6000
   • min_size=10
   • max_size=500

To integrate with a theme:

1. The plugin needs to be installed and activated.
2. Copy and paste the contents of the file RSSPhotoTheme.functions.php to the end of the file functions.php in your theme directory.
3. Declare RSSPhoto settings (multiple instances are supported).

4. Call the function display_rssphoto() from your theme (e.g., sidebar.php). An example of the last two steps:

     <?php
           $settings[0]['title']='RSSPhoto';
           $settings[0]['url']='http://photography.spencerkellis.net/rss.php';
           $settings[0]['height']=150;
           $settings[0]['width']=185;
           $settings[0]['img_sel']='Random';
           $settings[0]['num_img']=1;
           $settings[0]['item_sel']='Random';
           $settings[0]['num_item']=10;
           $settings[0]['show_title']=1;
           $settings[0]['show_img_title']=1;
           $settings[0]['output']='Slideshow2';
           $settings[0]['interval']=6000;
           $settings[0]['before_title']='<h2>';
           $settings[0]['after_title']='</h2>';
           $settings[0]['before_html']='<li>';
           $settings[0]['after_html']='</li>';
           display_rssphoto($settings[0]);
           ?>
   

Here’s a quick description of the settings:

1. (title) Title: Text that appears over the RSSPhoto image(s). “String in quotes”
2. (url) URL: address of the RSS or Atom feed. “http://your.url.com/feed.xml”
3. (height) Height: height of the RSSPhoto images in pixels; or, ‘variable’ to maintain the aspect ratio given the specified width (see #4). [Number]|”variable”
4. (width) Width: width of the RSSPhoto images in pixels; or, ‘variable’ to maintain the aspect ratio given the specified height (see #3). [Number]|”variable”
5. (img_sel) Image selection: the script can randomly select images or just display the first image in the feed item. “Random”|”Most Recent”
6. (num_img) # Images per Item: how many images embedded in each feed item to display. [Number]
7. (item_sel) Item Selection: RSSPhoto will choose a random feed item, or the most recent feed item. “Random”|”Most Recent”
8. (num_item) # Items: choose how many feed items to display. [Number]
9. (show_title) Show Title: whether to display the main RSSPhoto title over the images. 1|0
10. (show_img_title) Show Image Titles: whether to display the titles of each displayed thumbnail. 1|0
11. (output) Output: images will load as a slideshow or can be displayed statically. “Slideshow2″|”Slideshow”|”Static”
12. (interval) Slideshow Interval: the amount of time in milliseconds to wait between image transitions for the slideshows. [Number]

Note that for the height and width properties you should only set one or the other to “variable”, since RSSPhoto will use the other integer-valued dimension to fix the aspect ratio.