Overture - Campfire Services

Picasa Fetch 0.5

Sun, 03 Aug 2008 19:34:24 +1000

Creates data sources to fetch photos from a Picasa account. Adapted from Flickr Fetch campfire service created by Mark Lewis, http://www.casadelewis.com.

Latest version download link:

The campfire service management utility will not let me submit the latest version of Picasa Fetch. You will download version 0.3 if you download the campfire service from the overture21 domain. Please use the download link below to get Picasa Fetch version 0.5: http://www.fleshy.nl/dev/workspace/upload/picasa%20fetch%20v0.5.zip.

Version 0.5 Release Notes

Fixed a bug with sorting, now it actually works with integers and with strings too.

Bugs fixed:

Datasource now shows the full sort value, even when it is a string.

Version 0.4 Release Notes

New fetch type added: automatically detect input using RSS feed url. This allows you to simply copy/paste the RSS feed url from a Picasa-webalbum and let the campfire service detect the user id, album id and when present also the authorization key. Autodetection only works with album RSS feed urls and not with photo or user feeds.

Added functionality:

Autodetect album input using RSS feed url.

Version 0.3 Release Notes

The sort value is added to make it easier to sort multiple albums when you want to include multiple Picasa feed data sources. You could do this for instance when creating an overview of all your albums.

Added functionality:

Data source now fetches feed id (user id, album id or album name) from Picasa
Link to data source information for data source list items
Ability to specify sort value

Bugs fixed: + Datasource now really fetches album description from Picasa + Minor text revisions

Version 0.2 Release Notes

Added functionality:

Data source now fetches album title from Picasa
Date source now fetches album description from Picasa
Ability to specify prefered image size
Ability to specify prefered thumbnail size

Version 0.1 Release Notes

This version is the first and very basic beta version of Picasa Fetch. Expect more functionality in future versions, if demand requires it. This version is created to support symphony version 1.7. Unfortunately, it only supports PHP 5. If anyone wants to help me creating support for PHP 4, please drop me a message in the forum article I will create relating this campfire service.

Installation Instructions

After downloading Picasa Fetch, extract the archive and upload the "carsten" directory to your campfire directory. Then, install Picasa Fetch through the Symphony campfire services administration interface. Make sure that you give the carsten/picasa/data-sources folder CHMOD 777 permissions as this is the folder where Picasa Fetch will create its data sources.

Filling in the Form Fields

There are three ways to fill in the form. After giving your datasource a name, choose how you want to fetch your photos. You can choose from user-based feed, album-based feed using album id, and album-based feed using album name.

Mandatory for all feeds:

User ID - The username or e-mail address associated with a Google account.

For album-based feeds:

Authorization key - Only required for private albums. Get it from the url you see in your address bar when viewing a private Picasa-webalbum in your browser. http://picasaweb.google.com/userID/albumName?authkey=authorizationKey

Mandatory for album-based feeds using album id:

Album id - Get it from the url you see in your address bar after you have clicked on RSS while viewing your Picasa-webalbum. http://picasaweb.google.com/data/feed/base/user/userName/albumid/albumId?kind=photo&alt=rss

Mandatory for album-based feeds using album name:

Album name - Get it from the url you see in your address bar when viewing an album in your browser. http://picasaweb.google.com/userID/albumName

Example XML


    
        Album Title as retreived from Picasa
        The description of your album as retreived from Picasa
        The original feed ID as retreived from Picasa
        The value you have specified for album sorting, namely "sort value here"
    
    
        
            photo.jpg
            The description of my photo
            2006-12-30
            2007-12-30

Problems with Picasa Feed

If you get the following XML as output, it means that you have specified some invalid information while creating the Picasa feed. Please try again and check if you have the right user ID, album ID, album name, and authorization key.


    HTTP request failed
    HTTP/1.0 500 Internal Server Error. You must have entered some invalid data, please try again and create a new data source.

If you get the following XML as output, it means that there is no problem but that there are no photo's available for display in your album or for your specified user ID.

Flickr Fetch 1.4

Tue, 01 Apr 2008 04:38:14 +1100

Creates data sources to fetch photos from your Flickr account.

Requires you have a Flickr account and API Key, both of which are free.

Change log 1.4

Replaced file_get_contents() with CURL due to many hosts disabling file_get_contents() for security purposes.
A URL parameter (i.e. $param) can now be used in the tags field.

Change log 1.3

Fixed redirect issue upon saving a new data-source
Renamed User ID field to NSID Number (avoid confusion with Flickr name)

Change log 1.2

Updated JavaScript for 1.7
Updated service driver for 1.7
Added the ability to delete data-sources

Getting Your Flickr Details

You need to know your Flickr API key.
You also need to know the corresponding ID for each photo set, user ID, or tags depending upon the method you use to retrieve your photos.

First, you want to install Flickr Fetch through Symphony's admin interface. Next, you'll want to obtain your Flickr details. If you don't already have a free Flickr account, you must sign up before obtaining a Flickr API key. Once you're signed in to your account, get your API key. Once you obtain this key, keep it handy as you will need to input it into the CS form to create your data source.

Filling in the Form

If you have been working with Symphony you'll find the Flickr Photo Set data source creator to be familiar.

Mandatory fields:

Name - corresponds to the name of your data source.
Fetch - drop-down menu allows you to choose if you would like to fetch your photo stream, a photo set, or your photos according to specific tags.
API key - corresponds to your Flickr API key which you can get by going to the address mentioned above.

Some fields mandatory

Photoset ID - corresponds to a photo set ID number. Only one ID.
User ID - corresponds to your Flickr user NSID. Only one NSID.
Tag(s) - corresponds to Flickr tags you have assigned your photos. Multiple tags can be specified, separated with a comma OR use a URL parameter $param. Any tag will be matched.

Optional fields:

Year - filters the photos in the photo set by year.
Month - filters the photos in the photo set by month.
Day - filters the photos in the photo set by day.
Flexible URL

Checking flexible URL will give a URL without .jpg so that you can specify image size fetched from Flickr.

    static.flickr.com/112/304961747_0c48084840_s|t|m|-|b|o.jpg

s small square 75x75
t thumbnail, 100 on longest side
m small, 240 on longest side
- medium, 500 on longest side
b large, 1024 on longest side (only exists for very large original images)
o original image, either a jpg, gif or png, depending on source format

The most popular way to filter these photos using the optional fields will be via URL parameters. For instance, you might want to set up a photo page with a URL schema like "year/month/day". If you entered "$year", "$month", and "$day" for the corresponding optional filter fields, your photo set data source will be filtered based on the URL schema. For example,

http://www.mywebsite.com/photos/2006/10/04/

The above example URL will return only the photos uploaded on October 4, 2006.

Example XML


    
        
            My photo
            2006-12-30
            static.flickr.com/69/12345_76543211.jpg

Additional Info

Resize Flickr images using the built-in image function in Symphony. Check flexible URL to take advantage of the built-in image manipulation Symphony offers. Example:

Textile Text Formatter 1.8

Wed, 19 Mar 2008 18:22:21 +1100

Enables Textile syntax for entry and comment formatting.

Version 1.8

Updated Textile class to latest revision

Version 1.7

Updated for Symphony 1.7

Version 1.6

Uses Textile 2 Engine - http://textile.thresholdstate.com/

Random Number Generator 1.0

Wed, 05 Mar 2008 04:13:35 +1100

Compatibility: Symphony 1.7 To install, copy the folder davethegr8 to the campfire folder. The RNG will show up in your Data Sources under Controllers.

A random number generator. Returns 10 decimal values in the range 0..1. To get an integer value between 1 and 10, do the following.

Why? floor(n * 10) produces, with only one exception*, values from 0-9. To get 1-10, you add on one. So to generalize the code above, take the decimal number, multiply by the range + 1, and then add the minimum number.

When the random number is equal to the absolute max of all possible random numbers, the value will be 1.0. However, given the range of the numbers generated from mt_rand(), it is possible to assume that this will never happen. And even if it does happen, it will also be very unlikely that it will happen again.

Example XML


    0.86000569717028
    0.20898523191408
    0.76803636446969
    0.91541600828777
    0.75782764505494
    0.5689746567835
    0.92996141031848
    0.46307060889111
    0.69052558750404
    0.16715480301862

GeSHi highlighter 1.0

Tue, 26 Feb 2008 05:46:57 +1100

This CS gives you the ability to automatically highlight any code inside any of your symphony pages. It uses GeSHi as parser, and includes a huge amount of pre-defined languages code highlightments.

The usage is really simple. Compose your entries writing code the same way you always have done before, but assign to the tag a classname with the referring language.



I firstly wrote this CS for my personal needs, so you won't find any useful options like the ability to shows up line codes, maybe in a future version. Anyway, it's a really simple CS, feel free to change it if you need.

Notes


Rendered code must have the  syntax, that means no  or  alone.

It works with native DOMDocument of PHP5, however there's also a PHP4 compatibility, make sure to have installed DOMXML PHP module (I've not tested a lot on PHP4, thought).