Deutsche Version? ipeRSS
Overview
Via ipeRSS it is possible, to view ones pictures (uploaded at ipernity) in a Wordpress powered blog. The only requirement is, that PHP is allowed to access files hosted elsewere in the web.
This plugin only displays pictures – but this it does very customizable. It’s possible to use 74×74 pixels small preview pictures up to 1024 pixels width large “preview” pictures. The display is customizable via CSS, tha class gets provided via the function call.
Of course the plugin allows caching. Per default it caches hourly. But only, if an user acesses the blog. If not, nothing will be done. Only if one hour is over AND an user accesses the blog, there will be created a new cache. The caching interval is customizable, too – Same with the amount of pictures shown.
Of course one can use more tha only one single gallery. I. e. one in the Sidebar that refreshes every 10 minutes and shows the last three pictures uploaded at ipernity by using 75 pixels thumbnails, and one on a special page that refreshes it cache every 10 hours and displays the last 20 pictures. Whatever one want.
Download
ipeRSS is always available via the same URL, there is no determination of the different versions.
download ipeRSS here
Current version: 3.0.0-beta3
Installation
After downloading and extracting the RAR archive, the directory “iperss” needs to be put on the webserver into the Wordpress plugin directory at “wp-content/plugins/iperss”. If it should be another directory, the file “iperss.php” has to be edited: Line 69 needs to be adjusted.
After downloading the archive and uploading the directory , the plugin is at standby and the only thing, that is to do now, is going to the administration backend and activating the plugin.
The function call
There are two ways to display an ipernity gallery. The function call is the same in both ways.
< ?php iperss('userid', count, 'size', 'class', 'target', 'inter', 'cacheid'); ?>
The blank amongst “< ” and “?php” is a bug in the syntax highlighting extension. It has to be “<?php”.
“userid” is the ipernity user ID. This ID could be the username, but don't have to. To discover the user ID, the user needs to go to it's ipernity home page. In my case it's “http://www.ipernity.com/home/dirk”. The last part of this URL is my user ID (“dirk”).
count tells the plugin, how many püictures to display. 0 and any value above 20 displays the last 20 pictures (there aren’t more pictures in the ipernity feed, the plugin uses).
Via size the displaying size of the pictures is defined. The sizes are given by ipernity
- 75x -Ppreview pictures in 75×75 pixels size will be used
- 100 – The wider side is 100 pixels long
- 240 – The wider side is 240 pixels long
- 560 – The wider side is 560 pixels long/li>
- 1024 – The wider side is 1024 pixels long
Other values resulting in bno picture- Only the image title will be displayed, because there is no image to display. (This will be fixed in future versions of this plugin – As soon as the ipernity API will be done and fully documented *g*)
Via class the CSS class is defined. Assuming, “class” gets defined with “ipernitybilder”, one can now use this class in the CSS style sheet file via “img.ipernitybilder”.
Example
img.ipernitypictures { border: 0.1em solid #2e3436; margin: 0.5em; }
target
This parameter defines, what HTML target the plugin should use for the links. The usual HTML target attributes can be used. “_top” for the current window, “_self” for the current frame, “_blank” for a new tab/window or the frame name for a defined frame in a frameset.
These are the minimum parameters for displaying pictures from ipernity in your Blog. It is possible, to extend the function call.
< ?php iperss('userid', count, 'size', 'class', 'target', 'inter', 'cacheid'); ?>
inter and cacheid are new.
inter defines a period, after this the cache file would be creted new by accessing the ipernity feed again (a.k.a “the interval”). By default this value is at 60 what is corersponding to one hour. Any values can be entered (except negative values, of course *g*). Using 0 the cache file will be rewritten every time a user enters the blog. By using 10080 the interval is set to one week.
cacheid is only necessary, if one want to use more galleries with different values. I. E. one in the Sidebar and one in an extra page. As “cacheid” everything can be used. But no special characters or blanks should be used. Only “_” and “-” are okay, but should not be used at first or last character.
If “cacheid” should be used, it is mandatory to set “inter”, too. Because “inter” comes first before “cacheid”. If only “inter“ should be used, then – of course – “cacheid” don’t needs to be set.
Example
Here is a little example. First the function call and after this the resulr.
< ?php iperss('dirk', 4, 100, ipernitypictures, '_blank', 600, 'example'); ?>
Use the feed of user ID “dirk”, display four pictures and use the preview images which longest side is 100 pixels wide. Use the CSS class “ipernitypictures”, the HTML target “_blank”, and an cache interval of 600 Minutes and the cache ID “example”.
By the way: It would be nice, if you make a note, that you’re using ipeRSS and linking this note to http://blog.schlunzen.org/iperss but you don’t have to so.
FAQ
Q: I always get “Could not load feed” or something like that. Why? And how to wix it?
A: Maybe your hosting provider don’t allows PHP to access files hostet elsewere in the web. If you know a little about PHP and stuff, have a look in the “iperss.php” file for more informations about this. If you don’t know much about PHP, i’m sorry, the plugin don’t works on your blog.
Q: I always get “Could not write cache file” or something like this, why?
A: The user, that runs the web server needs to have read and write permission to the files “cachedate-[cacheid]” and “cachestore-[cacheid]”. If you want to save some time and work, allow the user to read and write the directory, that contains the plugin. If you don’t want to do this, you always need to create the cache files by yourself and set the permissions manually.
Q: Nothing is displayed?! I only se PHP code?!
A: If nothing is shown, you try to run the function within a page not basing on a page preview or in an article. I both cases you need something like RunPHP, to runn PHP code in articles and pages. For creating the function call you need to switch the Wordpress editor to HTML view.
Q: Aaaaahrg! It’s all destroyed!!oneoneeleven!11!1
A: Aw, that’s bad … :)
Please leave comments below the German version at ipeRSS
