With picasaView you can easily view your picasaweb-albums in your blog. To achieve this, all you need to do is to insert
a shorttag like
[picasaView album='ALBUMNAME'] in your content where you want your album to appear. To view
all your public albums just use
The plugin supports localization, paging 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 or
any other image viewer. picasaView is already configured to work with LightBox (if installed), so there is no need
for further adjustments.
Through the backend settings you can additionally adjust the size of the used thumbnails and full size images and how
much images are shown on a page at once.
More info can be found at the picasaView Homepage.
To see what those linked galleries look like, visit the picasaView demo page.
To customize, create a subdirectory named ‘picasaview’ in your WordPress theme-directory (e.g. ‘/wp-content/themes/default/picasaview)’ and copy the contents of the ‘template’ subdirectory in the picasaview plugin-dir into it.
** Don’t edit the templates in the plugin directory as they will be overwritten if you auto-update to a new version **
The template files mustn’t be renamed and have the following functions. With the specific placeholders explained below
- album.html: Used to display the album summary. This is the template that’s shown when you insert the picasaView-tag into your content.
- albumDetails.html: This is the template that’s used for the image thumbnails when viewing all images of an album:
- albumDetailsHeader.html: The header for the album details view before all thumbnails are printed.
- albumDetailsFooter.html: The footer for the album details view that’s appended after all thumbnails are printed.
Supported placeholders: same as in albumDetailsHeader.html above
The placeholders, which mainly got their value from the data fetched from picasaweb, have the following meanings:
%ALBUMLINK%: The link to the album details page. This placeholder is used in album.html only
%ALBUMTITLE%: The album title
%ALBUMSUMMARY%: The album summary (plain text)
%ALBUMID%: The unique album id (used for Lightbox-“rel”-attributes e.g. as in albumDetails.html
%CREATIONDATE%: the date, the album was published for the first time
%MODIFICATIONDATE%: the date, the album was modified the last time
%THUMBNAILPATH%: The absolute path of the thumbnail
%IMAGEID%: Unique image-id (taken from picasaweb)
%IMAGEPATH%: The absolute path of the full-size image
%IMAGETITLE%: The image title (like ‘image-023.jpg’)
%IMAGEDESCRIPTION%: The image description
%IMAGEPATH%: The absolute path of the full-size image
%LOCATION%: The location where the photos were taken
%LOCATION_LABEL%: the localized string “Location”
%TOTAL_RESULTS%: The total number of photos in the current album
%TOTAL_RESULTS_LABEL%: the localized string “Photos”
%PREVIOUS_PAGE_LABEL%: the localized string “Previous (Page)”
%NEXT_PAGE_LABEL%: the localized string “Next (Page)”
%SHOWING_RESULTS_LABEL%: the localized string “Viewing images”
%TOTAL_RESULTS_LABEL%: the localized string “of” (in the string “viewing images 1-10 of 90” e.g.)
%NEXT_PAGE_LINK%: the href-link to the next page of the album
%PREVIOUS_PAGE_LINK%: the href-link to the previous page of the album
%BACKTOPOST_LINK%: the permalink of the page where the picasaView has been called
%BACKTOPOST_LABEL%: the localized string “Back to post”
%INDEX%: the index number of each image starting with 1 and counting up
Furthermore there are some IF-Blocks which can be used in the templates albumDetailsHeader.html and *albumDetailsFooter.html
to let picasaView hide blocks which make no sense in the current context (for example, a “previous”-link would not make sense
on the first page). If such a block becomes unnecessary it will be removed. The following examples are named like the placeholders
above. Currently, the following statements are supported:
Please do not rename the used CSS-classes if you’re using the quick paging option as it will break the functionality.
- pagination on album overview
- add link to the original album on picasaweb
- anchor link to the detail view of an album
- sidebar widget with random images
- directly insert single images in your posts
- add caching of images
- commenting of photos
- support for speaking URLs
- 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. The failure message from picasaweb should appear below. If you have problems
troubleshooting, don’t hesitate to contact me (along with as many infos as possible, like your config settings, WordPress-
and PHP-Version and so on).
- The plugin fails with the message “picasaView plugin: template file ‘$template.html’ not found or not readable.”
This means that neither a custom template nor the default templates were found or not readable. If you use custom templates
please ensure they are placed in ‘WP_DIR/wp_content/picasaview_templates’ and have the same name like in
the default templates dir in the picasaView-plugin directory.
- I’m sure I entered the correct User-Id and URL but I get a message saying no album exist for this user
If you’re really sure your data is correct, ensure that the albums of your picasaweb-user are made public or you specified an authkey
for private albums.
- I’ve specified an album in the tag but get an error message saying this album was not available
Be sure to use the shorted album name picasaweb generates, not the original one. For example the album “Cats And Dogs” is shrinked to “CatsAndDogs”.
You can see the shortened album name if you click on an album in picasaweb and look at the url: “http://picasaweb.google.com/username/CatsAndDogs”.
For a complete history please look here.
Changes in this version: