Support development of Shashin
Shashin is a powerful WordPress plugin that enables you display Picasa images and videos anywhere in your WordPress site. It has many features:
- Embed a gallery of your Picasa albums, and all the photos and videos in each album, with customizable pagination of photos.
- Highslide comes included with Shashin, for displaying your images and videos. You can configure Shashin to work with other viewers as well, such as Lightbox, Thickbox, Fancybox, etc.
- Pick individual photos or videos to display, in any size supported by Picasa.
- Pick photos and videos from any combination of albums to display in groups of thumbnails.
- Show thumbnails of your newest photos and videos, from one or more albums.
- Display album thumbnails for albums you choose, or all your albums, sorted however you like. Includes links to Google Maps.
- Display any number of random photos and videos, from one or more albums. You can also choose to exclude certain photos or albums from random display.
- Use widgets for all of the above!
- Optionally include camera EXIF data in photo captions.
- Dynamically set thumbnail sizes or columns to suit the width of your theme (useful if you change themes in the future).
- Internationalization: Shashin is designed to support translations into other languages, and comes with several translations (please contribute a translation if you're bilingual!).
- Customize the Shashin and Highslide stylesheets to suit the theme of your site.
- Schedule daily automatic synchronization of Shashin with your Picasa albums.
Examples
See my personal [p2p type="slug" value="photo-albums" text="photos page"] for an example of displaying albums and their photos. See [p2p type="slug" value="shinjuku-gyoen-national-garden" text="my post on the Shinjuku gardens"] for an example of using Shashin to display individual images and groups of images in a post.
Help!
Please use the comments section in [p2p type="cat_slug" value="shashin" text="my most recent blog post about Shashin"] for questions.
Commercial Use of Highslide
Shashin comes bundled with Highslide. Although I do not charge anything for using Shashin on a commercial site, Highslide is free for non-commercial use only. If you are using Shashin for commercial purposes, you must either 1. deactivate Shashin's Highslide option or 2. pay the appropriate fee for Highslide to its creator.
- Wordpress 2.1 or higher
- PHP 4 or higher
- Important: mySQL 4.1 or higher
⇑ top
- Download the Shashin zip file, unzip it, and copy the "shashin" folder to your plugins directory. Then activate it from your plugin panel. After successful activation, Shashin will appear under your "Tools" menu and under your "Settings" menu.
- If you are upgrading from a previous version, it's important to deactivate and then reactivate Shashin. This ensures that new settings will be configured correctly.
- Go to the "Settings" menu, review the default settings, and make whatever changes you like. If your Picasa server is outside the US, it is especially important that you change the server (e.g. to http://picasaweb.google.co.uk).
- Go to the "Tools" menu and follow the directions to add your first album!
Note: Shashin will add two tables to your WordPress database, named wp_shashin_album and wp_shashin_photo. You should include these tables when making backups of your WordPress tables. The Shashin tags rely on key numbers from these tables that you won't get back if you lose the data in these tables.
⇑ top
If you add albums to your Picasa account or make changes to them, you need to let Shashin know. On the Shashin "Tools" page, click the icon to sync an album whenever you update it in Picasa. You can also use the "Sync All" option to sync all your albums at once, or activate the option to have Shashin automatically synchronize all your albums daily (this option is on the "Settings" page).
The synchronization is smart: if you move a photo from one album to another, Shashin will update its information on that photo (as opposed to deleting it and adding it again). This way references you have to the moved photo in your posts won't break.
Note that "Sync All" will not automatically pull in new albums to Shashin. It only synchronizes albums you've already added to Shashin. For new albums, you need to use the "Add Albums" form on the Shashin "Tools" page. This allows you to selectively control which of your Picasa albums are added to Shashin.
If you have an extremely large number of albums or photos, see the Known Issues section below concerning the limits of the "Sync All" option.
⇑ top
Shashin comes bundled with a specially configured version of Highslide, so you don't need to download Highslide separately. After installing Shashin, you'll want to specify your desired settings for Highslide in the Shashin Settings menu. You also have the option of linking your photos directly to Picasa and not using Highslide, or using a different image viewer.
Do not upgrade Highslide independently of Shashin, as that may cause it to stop working with Shashin. Note that Highslide is free for non-commercial use only.
⇑ top
Shashin provides settings that allow you to configure it for use image viewers other than Highslide. If you want to use another viewer, there are several things to consider:
- If you choose to use an image viewer other than Highslide, you are responsible for installing it, configuring it, and understanding it yourself. I am happy to consider making adjustments to Shashin for supporting other viewers, but I can not help you with setting up Lightbox, Fancybox, Thickbox, etc.
- The Shashin Settings menu lets you control the "id", "class", and "title" attributes of Shashin's image tags and anchor tags. You will need to know how to structure the values for these attributes for your viewer.
- If you use a viewer that does not support Flash videos, your Picasa videos will not display correctly. In that case you may want to install and configure an additional viewer for videos, such as Videobox.
⇑ top
There are a number of options available in Shashin's tags. The easiest thing to do is to keep two windows or tabs open in your browser - one for writing your post and one for the Shashin "Tools" page. It has example markup for Shashin tags that you can copy and paste into your post. After pasting a tag, you can edit it as needed.
An important thing to note is that Shashin assigns its own numbers to Picasa albums and photos. In the documentation below these are referred to as "album keys" and "photo keys". This is mainly to avoid the impracticality of you having to type the extremely long Picasa ID numbers when you use Shashin tags.
A Shashin tag will be translated into an xhtml "div" container. Always use a Shashin tag on a line by itself in your post or page. This is important because of how WordPress auto-formats your posts. If you put a Shashin tag on the same line as other text, then it will get wrapped in the paragraph tag that WordPress adds to the line. This will result in invalid xhtml, as nesting a div tag inside a paragraph tag is not allowed (although in most cases browsers will still display it correctly).
⇑ top
All the Shashin tags have options that let you center or float thumbnails, and control the clearing of margins.
- Positioning: if you specify "left", "right", or "none" for the position in a tag, then Shashin will apply it as a CSS float value. If you specify "center" then Shashin will center the thumbnails using the CSS "margin-left: auto; margin-right: auto;" technique.
- Clearing margins: you can specify any valid CSS clear value in a Shashin tag. For most layout purporses you will not need to clear margins, but the option is there if you need it.
Remember that the purpose of floating an image is to have it flow around other elements on the page. If you float an image near the end of your post, it may flow down below the post. To avoid this, put a <br clear="all" /> tag at the very end of your post.
⇑ top
Picasa supports only a specific set of image sizes. If you try to use a size not listed, your image will not display at all. The sizes are:
32, 48, 64, 72, 144, 160, 200, 288, 320, 400, 512, 576, 640, 720, 800
Note that these sizes represent a "maximum dimension." This means if you pick 640, and your picture has a landscape orientation, then it will be 640 pixels wide. If it has a portrait orientation, then it will be 640 tall. Shashin automatically calculates the correct size for the other dimension.
Note that 32, 48, 64, and 160 are special sizes. Picasa will crop them to a square shape. This makes them good sizes for displaying tables of thumbnails.
The Shashin tags also allow you to use the word "max" as an image size. In the Shashin Settings menu, if you provide the maximum width of your theme's content area, Shashin will use that to dynamically determine the largest image size it can use. It will even take into account the number of thumbnail columns. See below for more information.
⇑ top
In a post or page, use the [simage] tag:
[simage=photo_key,max_size,caption_yn,position,clear,alt_thumb]
- photo_key: (required) the Photo Key listed for the image in the album's page in the Shashin "Tools" menu
- max_size: (required) the size you want, chosen from the list above or the keyword "max"
- caption_yn: (optional, defaults to 'n') use 'y' or 'n' to indicate whether you want the caption to appear under the image (you can also use 'c' to have a "Click to enlarge" caption applied to every image)
- position: (optional) position options
- clear: (optional) margin clearing options
- alt_thumb: (optional) a Photo Key for an image to substitute as the thumbnail (this is useful for videos, as Picasa sometimes does not generate good thumbnails)
Tag examples
This displays the photo with Shashin key 17, maximum possible size, show the caption, centered (the size of the image depends on the width of your theme's content area):
[simage=17,max,y,center]
Displays the video with Shashin key 22, thumbnail size of 200 pixels, no caption, float left, do not clear margins, use photo with Shashin key 33 as the thumbnail:
[simage=22,200,n,left,none,33]
Displaying in the sidebar
You can pick the Shashin Single Image widget in your widgets menu, or if you're not using widgets, use this code and substitute the desired values:
<?php echo Shashin::getSingle(photo_key,max_size,'caption_yn','position','clear'); ?>
⇑ top
In a post or page, use the [salbumthumbs] tag:
[salbumthumbs=to_show,max_cols,location_yn,pubdate_yn,position,clear]
- to_show: (required) see the examples below (you can provide album keys or a sort order)
- max_cols: (required) the number of columns for the table, or the keyword "max"
- location_yn: (optional, defaults to n) use y or n to indicate whether you want the location to appear under the title. A Google Maps icon will also be added
- pubdate_yn: (optional, defaults to n) use y or n to indicate whether you want the album's pubdate to appear under the title
- position: (optional) position options
- clear: (optional) margin clearing options
Tag examples
Show all albums in the reverse of the picasa order, 3 columns of thumbnails, show albums locations, don't show publication dates, center on the page:
[salbumthumbs=pub_date desc,3,y,n,center]
You can use "pub_date", "title", "location", or "last_updated" for the order. If you add " desc" then they will be put in reverse order.
Show albums with Shashin keys 2, 24, and 33 only, 1 column of thumbnails, don't show album locations, show publication dates, float left:
[salbumthumbs=2|24|33,1,n,y,left]
Displaying in the sidebar
For your sidebar, you can pick the Album Thumbnails widget, or if you're not using widgets, use this code and substitute the desired values:
<?php echo Shashin::getAlbumThumbs('to_show',max_cols,'location_yn','pubdate_yn','position','clear'); ?>
The arguments are the same as in the tag examples above.
Notes
- The tag settings control the layout of the album thumbnails. When you click a thumbnail, the page will reload and show the photos in that album (unless you picked Picasa in the Shashin settings menu for "expanded image display" - then it will link directly to Picasa). The layout of the album photos is controlled in the Shashin Settings menu.
- Album thumbnail sizes are fixed by Picasa at 160x160, so adjusting the size is not an option.
- Shashin automatically displays the album title below the thumbnail.
- Album thumbnails in your sidebar will always link to Picasa, regardless of your selections on the Shashin settings menu, as it's not practical to show all the album photos in the narrow space available in most sidebar designs.
⇑ top
With the default layout, the album thumbnails are displayed in a two column layout, with the album titles and descriptions to the right of the thumbnails. You can adjust shashin_album_list* in shashin.css if you want a different layout.
In a post or page, use the [salbumlist] tag:
[salbumlist=to_show,max_cols,info_yn]
- to_show: (required) see the examples for [salbumthumbs] above.
- info_yn: (optional, defaults to n) if 'y', will display the album photo count, publication date, and location between the title and the description.
Tag examples
All albums ordered by when they were last updated, with additional album information shown between the title and description (photo count, publication date, and location):
[salbumlist=last_updated,y]
Albums with Shashin keys 2, 24, and 33 only, no additional information shown:
[salbumlist=2|24|33,n]
Displaying in the sidebar
There is no widget for [salbumlist], but you can put it in your sidebar with this code:
<?php echo Shashin::getAlbumList('to_show','info_yn'); ?>
Notes
The notes for [salbumthumbs] also apply to the salbumlist tag.
⇑ top
You can display all the photos from a specific album, without having to click an album thumbnail first. The title for the album is shown above the photos:
[salbumphotos=album_key,max_size,max_cols,caption_yn,description_yn,order_by,position,clear]
- album_key: (required) the Album Key listed for an album on the Shashin admin page
- max_size: (required) the image size, chosen from the list above, or the keyword "max"
- max_cols: (required) the number of columns for the table, or the keyword "max"
- caption_yn: (optional, defaults to n) use y or n to indicate whether you want captions to appear under the images (you can also use "c" to have a "Click to enlarge" caption applied to every image)
- description_yn: (optional, defaults to n) use y or n to indicate whether you want to append the album description to the caption for the table
- order_by: (optional) a field to order the photos by. Choices are: "picasa_order", "title" (which is the filename), "taken_timestamp", and "uploaded_timestamp". Add " desc" for reverse ordering.
- position: (optional) position options
- clear: (optional) margin clearing options
Tag example
Album with album key 9, 160 pixels thumbnail size, maximum number of columns, no thumbnail captions, show the album description along with the album title, sort in reverse order by filename (title):
[salbumphotos=9,160,max,n,y,title desc]
Notes
Since most themes have sidebars that are too narrow to display tables of thumbnails, there is no salbumphotos widget.
⇑ top
In a post or page, use the [sthumbs] tag:
[sthumbs=photo_key1|photo_key2|etc,max_size,max_cols,caption_yn,position,clear]
- photo_key1|photo_key2|etc: (required) as many photo keys as you want, separated by the | character
- max_size: (required) the image size, chosen from the list above, or the keyword "max"
- max_cols: (required) the number of columns for the table, or the keyword "max"
- caption_yn: (optional, defaults to n) use y or n to indicate whether you want captions to appear under the images (you can also use "c" to have a "Click to enlarge" caption applied to every image)
- position: (optional) position options
- clear: (optional) margin clearing options
Tag examples
Display photos with Shashin keys 5, 202, 115, 84, 33, and 189, size of 160 pixels for each image, display in 2 columns, no captions, float right (this is a 2x3 grid of pictures, floating to the right of the page's main content)
[sthumbs=5|202|115|84|33|189,160,2,n,right]
Display photos with Shashin keys 5, 202, 115, and 84, use the maximum possible size, 2 columns, show captions, centered (the size of the images depends on the width of your theme's content area)
[sthumbs=5|202|115|84,max,2,y,center]
Displaying in the sidebar
You can pick the Image Thumbnails widget, or use this code and substitute the desired values:
<?php echo Shashin::getThumbs('photo_key1|photo_key2|etc',max_size,max_cols,'caption_yn','position','clear'); ?>
The arguments are the same as the tag examples above.
⇑ top
In a post or page, use the [srandom] tag:
[srandom=source,max_size,max_cols,how_many,caption_yn,position,clear]
- source: (required) either the word "any" or a list of album keys separated by the | character
- max_size: (required) the image size, chosen from the list above, or the keyword "max"
- max_cols: (required) the number of columns for the table, or the keyword "max"
- how_many: (required) the number of random photos to display in the table
- caption_yn: (optional, defaults to n) use y or n to indicate whether you want captions to appear under the images (you can also use "c" to have a "Click to enlarge" caption applied to every image)
- position: (optional) position options
- clear: (optional) margin clearing options
Tag examples
Pick random photos from albums with Shashin keys 3, 7, and 9, size of 288 pixels for each image, display in 2 columns, 6 pictures total, no captions, float left (this will display a 2x3 grid of pictures, floating to the left of the main content)
[srandom=3|7|9,288,2,6,n,left]
Pick random photos from any album, size of 160 pixels for each image, create the maximum number of columns possible, 10 pictures total, show captions, centered (the number of columns depends on the width of your theme's content area)
[srandom=any,160,max,10,y,center]
Displaying in the sidebar
You can pick the Random Images widget, or use this code and substitute the desired values:
<?php echo Shashin::getRandom(album_key,max_size,max_cols,how_many,'caption_yn','position','clear'); ?>
The arguments are the same as the tag examples above.
Notes
If you change an album's "Include in Random" flag to "No" on the Shashin Tools page, then its photos will not appear in random image displays. The same is true for individual images where you set the flag to "No."
⇑ top
In a post or page, use the [snewest] tag:
[snewest=source,max_size,max_cols,how_many,caption_yn,position,clear]
See the documentation and examples for the [srandom] tag above. [snewest] works exactly the same way, but shows the newest photos instead of random photos.
Displaying in the sidebar
You can use the Newest Images widget, or use this code and substitute the desired values:
<?php echo Shashin::getNewest(album_key,max_size,max_cols,how_many,'caption_yn','position','clear'); ?>
Notes
[snewest] uses the upload date of photos to determine which ones are newest.
⇑ top
The CSS for styling Shashin is in your plugin directory at shashin/display/shashin.css. If you want to customize it, copy it to your active theme folder, and edit it there. Shashin automatically looks for a copy of shashin.css in your active theme folder first. This way you won't lose your customizations the next time you upgrade Shashin.
Important Note: if you change the padding for ".shashin_image img" or ".shashin_thumb img" you will need to go to the "Settings" page for Shashin and adjust the "Image div padding" and "Thumbnail div padding" accordingly.
There's also a stylesheet for Highslide, at shashin/display/highslide.css. Like shashin.css, you can put a customized version of it in your active theme directory. You can find documentation on the Highslide CSS rules here.
⇑ top
Highslide settings are managed in an "hs" JavaScript object. Its API is extensively documented at highslide.com. With Shashin, the place to make adjustments to the Highslide settings is in the shashin/display/highslide_settings.js file.
⇑ top
- Dynamic image sizing: If you indicate the width of your theme's content area in the Shashin settings menu, you can use the word "max" instead of specifying a Picasa image size in your Shashin tags. Shashin will then figure out which Picasa image size to use. This is very useful because it means you won't have to go back and edit all your tags if you change to a wider or narrower theme in the future. For example, if the width of your theme's content area is 610 pixels, and you use "max" with the simage tag for a single image, Shashin will pick 576 as the image size (the largest Picasa size that will fit in the available space). If you use "max" as the image size with sthumbs, srandom, or snewest, Shashin will do the math to determine the correct size for the thumbnails based on the number of columns you specified. Note that "max" doesn’t work well for photos with a portrait orientation, as the size will be applied to the height instead of the width.
- Dynamically setting the number of thumbnail columns: You can also use "max" to indicate the number of columns with the sthumbs, srandom, and snewest tags. Shashin will figure out the number of columns based on the image size. For example, if you set the image size to 160, and your content width is 610, your thumbnails will be displayed in 3 columns.
You cannot use "max" for the image size and the number of columns at the same time. Shashin needs one to be a number so it can calculate the other.
⇑ top
- There are several WordPress plugins for Google Analytics, some or all of which conflict with Shashin. They overwrite Shashin's javascript "onclick" code in the Highslide links with their own Analytics tracking code, causing the Highslide links to not function properly. If you're using one of these plugins, see if it has an option where you can tell it to ignore links to certain domains. If so, tell it to not track links to "ggpht.com" (that's the Picasa domain where the images are served).
- Shashin's "sync all" option may fail if you have hundreds of Picasa albums, or dozens of albums with several hundred photos per album. Your results will vary depending on the speed of the connection between your web server and your Picasa server, your server's memory and processor speed, etc. In Shashin 2.3.3 I re-wrote the syncing code to improve its performance, so if you had trouble with "sync all" in an earlier version, it may work better for you now. But if you have consistent trouble, you can try adding the following line of code after the initial comment block in Shashin.php:
set_time_limit(120);
Your server might not honor this setting, but if it does, then it will allow more time for Shashin to process all your albums' RSS feeds.
- If you start a Highslide slideshow and set it to run automatically, and there are videos in the slideshow, the videos will not play to the end. If each pictures is displayed for, say, 5 seconds, then you will get only 5 seconds of a video before it moves on to the next picture or video. Currently Highsldie has no means for handling this situation.
⇑ top
Not at this time, but there is a workaround - see [p2p type="slug" value="workaround-for-using-unlisted-picasa-albums-in-shashin" text="this post on how to get unlisted albums to work in Shashin"].
⇑ top
Three reasons:
- Flexibility: doing things like showing your newest photos or random photos from across multiple albums wouldn't be practical if you had to parse through all the album feeds in real time. Also, by storing data locally, Shashin can store additional information about your photos that's not in Picasa, like whether or not you want to exclude certain photos when making a random photo display.
- Performance: parsing a feed, especially one for a large album, is slower than local database queries.
- Scalability: if you happen to have a very popular site with a lot of images, hitting the Picasa RSS feed dozens or hundreds of times per minute would likely result in Picasa automatically blocking your access to the feed for a period of time (most RSS feeders do this to protect themselves against malicious or misconfigured feed readers).
⇑ top
Yes, there are other good plugins for Picasa too. IMHO, Shashin is the most flexible and feature rich, but, as you can see from this page, there's a learning curve. If you don't need all of Shashin's features, then you may want to consider a more lightweight plugin - browse the Picasa plugins at wordpress.org.
⇑ top
I've thoroughly documented the Shashin code in PHPDoc. Shashin is released under GPL, so feel free to extend it. I'd like to hear about any features you add.
Please be aware of the GPL rules, especially these two: 1. you cannot use Shashin, or portions of it, in proprietary software; and 2. if you re-use portions of Shashin code, you must include my copyright statement in your files. I've already had a problem with one person who re-used several parts of Shashin, and just replaced my copyright statement with his own. This is not only a violation of the GPL, it's also not cool.
⇑ top
I started working on this plugin while living in Tokyo. Shashin is the Japanese word for photograph, so it seemed fitting.
⇑ top
- 2.4.2: Added back missing Shashin::getAlbumList() function
- 2.4.1: corrected version numbers used with wp_enqueue_script calls
- 2.4
- Support for image viewers other than Highslide, such as Lightbox, Fancybox, etc.
- Display album photos using the order you've set in Picasa.
- Customizable pagination of album photos.
- New settings for customizing Highslide's borders, navigation bar, and background color/opacity.
- Dynamically set thumbnail sizes and the number of thumbnail columns to suit your WordPress theme (this means you don't have to worry about images being too large or small if you switch to a wider or narrower theme).
- Show camera EXIF data in Highslide captions.
- Improved usability for the Shashin admin screens, with detailed examples of Shashin tags.
- Align images and groups of thumbnails to the center.
- Specify an alternate image to use as a thumbnail - this is often useful for videos.
- Includes the latest version of Highslide (4.1.4)
- 2.3.5: Bug fixes: Fixed incomplete localization code for widget menus; In the album photo admin menu, now correctly saves whether photos should be included in random display; The salbumphotos tag can now handle sort order options with spaces (e.g. "pub_date desc"); The salbumphotos tag no longer shows a "go back" link, as there’s nothing to go back to.
- 2.3.4: Bug fix: photos lacking a date indicating when they were taken failed to add in mySQL on Windows (Shashin now adds a 0 timestamp to them). Bug fix: the code for the [salbumlist] tag was not updated in the 2.3 rewrite so it was broken (I overlooked it in my previous testing). Bug fix: you can now put more than one [salbumthumbs] or [salbumlist] tag on a page (it never occurred to me to try this before, but someone wanted to, and now it'll work).
- 2.3.3: Rewrote album photo syncing method for faster performance. Bug fix: was not correctly handling photos when they were moved from one Picasa album to another. Can now handle # character at end of Picasa URLs when adding an album (these were tripping up the RSS feed URL). Improvements to localization file.
- 2.3.2: Changed album thumbnail widget to always point to Picasa for viewing photos, instead of trying to load them all in the sidebar. Bug fix: was adding duplicate entries for albums when they were synced. Added Dutch localization file.
- 2.3.1: Bug fix: correctly loads language localization files. Bug fix: was reporting a database error on album syncs when there wasn't one.
- 2.3
- A complete rewrite of Shashin, with better security and better error handling
- Added option for daily automatic synchronization with Picasa
- Added internationalization support
- Simplified [salbumthumbs] so that, when you click an album thumbnail, the page will reload and display all the photos for that album
- Added options to control the layout of album photos when an album thumbnail is clicked
- Re-purporsed the [salbumphotos] tag so that it can be used to display all the photos for a specified album, without having to click an album thumbnail first
- [srandom] and [snewest] now support multiple album keys
- Improved usability of admin menus
- Added "float" and "clear" options for each of the widgets
- Added an uninstall option
- Bug fix: when listing photo keys or album keys in tags, they'll now always appear in the order they were listed
- Several minor bug fixes to the widgets
- 2.2
- Includes the latest version of Highslide
- Added ability to play Picasa videos in Highslide
- New option for autoplaying Highslide slideshows
- Checks for custom versions of shashin.css and highslide.css in your active theme directory
- Smarter about handling the CSS paths to Highslide images, for WordPress installations in a subdirectory
- Added "c" option for displaying captions
- Added option to make thumbnails unclickable
- 2.1
- Simplified methods for displaying album photos. The page containing the [salbumphotos] tag now displays all your album thumbnails by default, instead of breaking if you call it without arguments. It then displays photos for the specified album if you do call it with arguments. Also, no longer tries to manipulate the page title (there is currently no clean way to do this in WordPress).
- Bug fix: thumbnails in the admin panels display correctly again now (this broke after I added Highslide support)
- Bug fix: with certain Highslide settings, captions weren't always showing on the page when requested.
- Bug fix: fixed minor XHTML validation error in [salbumlist] markup.
- 2.0.4: Added "global $wpdb" to the top of Shashin.php - necessary for compatibility with WordPress 2.5 (otherwise the Shashin table names come out wrong). Also added mp4 as a supported video type.
- 2.0.3: Adjusted for new location of video data in the Picasa RSS feed.
- 2.0.2: Adjusted for new location of the content_url in the Picasa RSS feed.
- 2.0.1
- Bug fix: if you select the option to display your photos at Picasa in a new browser window, it actually works now (the formatting of the anchor tag was incorrect).
- Bug fix: now performs a preg_escape on the URL for the page containing your salbumphotos tag. This fixes a warning that was being displayed for some URLs in PHP 5.
- Bug fix: Shashin now correctly detects your WordPress installation directory if you've installed it in a subdirectory (except for paths in shashin/display/highslide.css which are hardcoded - you'll need to edit those by hand).
- Added a full copy of the GPL license.
- 2.0
- 3 options for image display: link to Picasa (as before), link to Picasa in a new window, or show in Highslide (note videos still display at Picasa).
- Show thumbnails for all photos in an album, linked from the album thumbnail (salbumphotos tag).
- Show album thumbnails side-by-side with the album descriptions (salbumlist tag).
- Option to prefix album titles on photo captions.
- For database table changes, now analyzes tables directly instead of just checking the Shashin version number.
- Bug fix: Album "sync all" feature wasn't working properly when there was more than one username.
- 1.2.3: Bug fix: on the admin page, there was a foreach loop error, trying to display Picasa album usernames even if no albums were loaded yet in Shashin.
- 1.2.2: Bug fix: users upgrading to v1.2 correctly had a new unique index set on their photo table's photo_ids, but new user's didn't, which could cause problems when syncing albums.
- 1.2.1
- Bug fix: specifying "any" album when displaying random photos will no longer fail because of the function randomly selecting an album with too few photos.
- Complete rewrite of the algorithm for selecting random photos. If you specify "any" album, it will now return a random set of photos from across all your albums (previously it would select a random album, and then return random photos only from that album).
- Now sets the character set for the Shashin tables to UTF-8, as not all mysql configurations use UTF-8 by default. This may fix reported bugs with multibyte (e.g. Chinese) characters.
- 1.2
- Wrote a completely knew parser for the Picasa RSS feed. This fixes an incompatibility with Wordpress 2.3.3. Shashin is no longer dependent on the constantly changing Wordpress RSS tools (yay!).
- Can now sync and add all of your albums at once (i.e. per Picasa username).
- Added display of multiple album thumbnails (for selected albums, or all your albums with a sort order you choose) - can be done in posts, pages, or as a widget.
- Bug fix: the sthumbs tag now displays the photos in the order you specified.
- Soft delete of photos: if pictures are removed from a Picasa album, they are now flagged as deleted in Shashin, but are not actually removed from the database.
- Smarter album syncing: if you move photos from one Picasa album to another, you can now do this without the original Shashin photo key being lost.
- 1.1
- Added widgets for all the Shashin functions (single photos, random photos, newest photos, photo thumbnail tables, and album thumbnails)
- Bug fix: ShashinPhoto::getRandomMarkup() was including photos from excluded albums when the album key was set to "any"
- Fixed notification: if an album sync or album add fails, this is now correctly reported as a temporary failure to read the Picasa RSS feed, not as a Shashin database error.
- Added wrapper methods for calling Shashin functions directly. This means, if you want to use Shashin in your sidebar and you're not using widgets, the code you have to include is now less complicated.
- 1.0.7 - bug fix: ShashinPhoto::getRandomMarkup() was failing when only 1 photo was requested
- 1.0.6 - fixed documentation for sthumbs tag, and help link now points to the Shashin FAQ at wordpress.org
- 1.0.5 - bug fix: fixed display of icons on Shashin admin page; added this change log
- 1.0.2 - 1.0.4 - updates to readme.txt and minor code cleanup
- 1.0.1 - bug fix: support arbitrary name for Shashin plugin directory
- 1.0
- Added "snewest" tag, which displays a table of thumbnails for a variable number of the latest photos in an album you specify (or from all albums). Thumbnail size, display of captions, and CSS "float" and "clear" for the table also can be specified.
- "sthumbs" now includes option for showing a caption. Note this change is not backwards compatible, as the argument order has been changed slightly. You only need to change existing sthumbs tags if you set values for float or clear.
- Changed "srandom" to display a table of random thumbnails for a variable number of photos in an album you specify (or any album). Note this change is not backwards compatible as the arguments have been changed to support the new features.
- Added options admin menu: can now set options for your Picasa server URL, image div padding, and thumbnail div padding.
- Set default values for options listed above when installing
- Bug fix: now use htmlspecialchars on image alt text (which comes from the Picasa image description)
- Bug fix: now reads the Picasa feed with the correct character set (UTF-8)
- 0.6 - Beta version. First public release.
⇑ top