WordPress.org

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