PicasaView free WordPress plugin
Description
PicasaView free WordPress plugin
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 [picasaView].
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.
Customization
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
you can further customize the output. Just be sure to keep the class-attributes (they are needed for the JavaScript frontend functionality)
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: %ALBUMLINK%, %ALBUMTITLE%, %THUMBNAILPATH%, %ALBUMSUMMARY%, %TOTAL_RESULTS%, %TOTAL_RESULTS_LABEL%, %CREATIONDATE%, %CREATIONDATE%
albumDetails.html: This is the template that’s used for the image thumbnails when viewing all images of an album:
Supported placeholders: %ALBUMID%, %IMAGEID%, %IMAGEPATH%, %IMAGETITLE%, %THUMBNAILPATH%, %IMAGEDESCRIPTION%, %INDEX%
albumDetailsHeader.html: The header for the album details view before all thumbnails are printed.
Supported placeholders: %ALBUMTITLE%, %ALBUMSUMMARY%, %TOTAL_RESULTS%, %TOTAL_RESULTS_LABEL%, %LOCATION%, %LOCATION_LABEL%, %PREVIOUS_PAGE_LINK%, %PREVIOUS_PAGE_LABEL%, %NEXT_PAGE_LINK%, %NEXT_PAGE_LABEL%, %SHOWING_RESULTS%, %SHOWING_RESULTS_LABEL%, %TOTAL_RESULTS_LABEL%, %TOTAL_RESULTS%, %BACKTOPOST_LINK%, %BACKTOPOST_LABEL%
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:
%IF_LOCATION% and %ENDIF_LOCATION%
%IF_PREVIOUS_PAGE% and %ENDIF_PREVIOUS_PAGE%
%IF_NEXT_PAGE% and %ENDIF_NEXT_PAGE%
%IF_BACKTOPOST% and %ENDIF_BACKTOPOST%
Please do not rename the used CSS-classes if you’re using the quick paging option as it will break the functionality.
To Do
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