=== Plugin Name === Contributors: mindvex Donate link: http://www.sattes-faction.de/ Tags: picasa, picasaweb Requires at least: 2.1 Tested up to: 2.5.1 Stable tag: trunk picasaView enables you to view your picasaweb-albums in your blog - simply by specifing a tag in your content. == Description == With picasaView you can easily view your picasaweb-albums in your blog. To achieve this, all you need to do is to insert a placeholder like `[picasaView(album='ALBUMNAME']` in your content where you want your album to appear. To view all your public albums just use `[picasaView()]`. The plugin supports localization (German translation already included) and can be easily skinned by changing the external templates and the stylesheets which reside within the plugin directory in the subfolders 'templates' and 'css'. That means you could use Lightbox or any other image viewer by simply editing the html-templates to suit your needs, for example with [Rupert Morris' excellent Lightbox2 Plugin](http://www.huddletogether.com/projects/lightbox2/) or any other image viewer. Through the backend settings you can additionally adjust the size of the used thumbnails and full size images. More infos can be found at the [picasaView Homepage](http://www.sattes-faction.de/picasaview "PicasaView Plugin"). To get a feeling how those linked galleries feel like visit the [picasaView demo page](http://www.sattes-faction.de/picasaview/picasaview-demo/). == Installation == **Please keep in mind that picasaView requires PHP5 to work. To connect to picasaweb either CURL or the php-setting `allow_url_fopen` set to true or remote connections through sockets are required.** Don't worry, if you're not familiar with it. The admin backend will tell you what options are available. So this is how you install the plugin: 1. Upload the directory 'picasaview' and all of its contents to the '/wp-content/plugins/' directory 2. Activate the plugin through the 'Plugins' menu in WordPress. 3. Specify your connection settings through the settings menu in WordPress (a new submenu called 'picasaview' should have appeared). 4. Place `[picasaView()]` in you content to view all your public albums. That's all. 5. If you like to view a specific album, use `[picasaView(album='ALBUMNAME')]`. Instead of the album name you can also use the unique album id. == Customization == To customize the html output look for the css-files and the templates-directory in the picasaView-plugin dir. The template files mustn't be renamed and have the following functions. With the specific placeholders explained below you can further customize the output. * **album.html**: Used to display the album summary. This is the template that's shown when you insert the picasaView-tag into your content. Supported placeholders: `%LINK%`, `%TITLE%`, `%THUMBNAILPATH%`, `%SUMMARY%`, `%NUMPHOTOS%`, `%NUMPHOTOS_LABEL%` * **albumDetails.html**: This is the template that's used for the image thumbnails when viewing all images of an album: Supported placeholders: `%ALBUMID%`, `%IMAGEPATH%`, `%TITLE%`, `%THUMBNAILPATH%` * **albumDetailsHeader.html**: The header for the album details view before all thumbnails are printed. Supported placeholders: `%TITLE%`, `%SUMMARY%`, `%NUMPHOTOS%`, `%NUMPHOTOS_LABEL%`, `%LOCATION%`, `%LOCATION_LABEL%` * **albumDetailsFooter.html**: The footer for the album details view that's appended after all thumbnails are printed. Supported placeholders: `%TITLE%`, `%SUMMARY%`, `%NUMPHOTOS%`, `%NUMPHOTOS_LABEL%`, `%LOCATION%`, `%LOCATION_LABEL%` The placeholders, which all got their value from the data fetched from picasaweb, have the following meanings: * **`%LINK%`**: The link to the album details page. This placeholder is used in album.html only * **`%TITLE%`**: The album title * **`%SUMMARY%`**: The album summary (plain text) * **`%NUMPHOTOS%`**: The total number of photos in the current album * **`%NUMPHOTOS_LABEL%`**: the localized string "Photos" * **`%ALBUMID%`**: The unique album id (used for Lightbox-"rel"-attributes e.g. as in albumDetails.html * **`%THUMBNAILPATH%`**: The absolute path of the thumbnail * **`%IMAGEPATH%`**: The absolute path of the full-size image * **`%LOCATION%`**: The location where the photos were taken * **`%LOCATION_LABEL%`**: the localized string "Location" == Frequently Asked Questions == = The plugin fails with the message "Could not load data from picasaweb. Please check your connection settings." = That means either your connection settings are wrong (i.e. wrong picasa-url or wrong picasa user-id) or the plugin can't connect to picasaweb. This is most likely the case when you use `file_get_contents()` and your host disabled this function for remote access. Try switching to CURL (which obviously requires CURL to be installed). If this doesn't help, choose `fsockopen()`. If that also doesn't work, it seems like you can't use picasaView due to server restrictions. = I've linked to an album by inserting the tag **[picasaView(album='MY_ALBUMNAME')]** in my content but nothing happened = You most likely specified a non-existing album-name. You must use exactly the same title you have used in picasaWeb (case-sensitive). Please bear in mind that renaming your album in picasaweb requires a renaming in the tags as well. Instead of the name, you can also use the album-id, if you know it. == Changelog == Version Date Changes 0.5 2008/06/18 ADD: socket support which should allow more people to connect to picasaweb if remote access and CURL are not available ADD: more detailed error messages if something went wrong CHG: admin interface now tells what connection options are available 0.4 2008/06/16 initial release