/*----------------------------------------------------------------------------- Plugin Name: JAlbum plugin for Wordpress Plugin URI: http://michael.hinnerup.net/jalbum-plugin Description: Integrate JAlbum photoalbums into Wordpress. Uses the ButtonSnap class by Owen Winkler. Version: 1.0 Author: Michael Schøler Author URI: http://michael.hinnerup.net Open source, LGPL - http://www.gnu.org/licenses/lgpl.html -----------------------------------------------------------------------------*/ JAlbum for Wordpress introduction With this plugin you can easily integrate your existing and new JAlbum's into Wordpress. All you need to do is write a blog post and, using the Wordpress editor, bring up the JAlbum wizard and select one or more albums to go into your post. The plugin gives you the opportunity to show the album as it was generated by JAlbum, or, to show it using your Wordpress theme (regardless of the generated JAlbum theme). It also enabled you to link to protected albums, showing only the thumbnails in your post without authentication requirements - even though the album is access protected. Installation 1. Download the WP_JAlbum plugin from the Wordpress plugin database. 2. Unzip the WP_JAlbum archive into your Wordpress plugins folder (/wp-contents/plugins/). 3. Bring up your Wordpress administration view. 4. Under "Wordpress options for JAlbum" set the configuration values for the plugin as you like. 5. In the options view, make sure the "Absolute server path to default JAlbum folder" path must point to your web servers absolute root path. This can be somewhat tricky to locate if you are hosted at a web hotel. If the plugin has not set the path automatically, make a PHP script file containing "" and browse it. Look for the value of SERVER["SCRIPT_FILENAME"]. Do not use a subfolder as the root path, or any other path for that matter, as this will cause the plugin to fail with regards to the two modes "Full album" and "Single photo". The "IFrame full album" is not affected by this value as it does not use it. 6. That's it! Usage 1. Write a new post, or manage an existing post. 2. Click the JAlbum icon, now present in the Wordpress editor (available in rich editor mode). 3. Choose an album mode: 3.1 Full album mode This mode displays the album using the Wordpress theme. It allows for both public and protected albums. 3.1.1 Access restriction Choose "Public access" if you have not made the album login protected. Or, choose "Login required" if you have placed a .htaccess file or require Windows Integrated Authentication etc. 3.1.2 Number of thumbnails to display Choose 1, 2, 4, 8 or 16 if you wish to only display a limited number of thumbnails from your album in the post. Or choose "All photos" for the whole shabang. Choosing a limited number is a good idea for large albums. 3.1.3 Webserver root filepath Here you should enter the absolute web server root path (see notes for installation above). The value is defaulted from the JAlbum options value. You can provide an alternate path here - if for instance yóur machine is running multiple web servers (multiple document roots). If this is the case you most likely know what you're doing, and should have no trouble entering an alternate path. Just mind that again, it has to be the root of the web server (public_html folder, www or inetpub are typical root folder names) - and not the album subpath! 3.1.4 Root relative JAlbum filepath Here you should enter the root relative subpath of the album. If for instance you are situated on a Linux Apache web server and have uploaded a generated JAlbum here: /data/myDomain.com/public_html/2007/myAlbum/ ... you should enter "/data/myDomain.com/public_html" as the root, and "/2007/myAlbum" as the root relative path. On a Windows IIS web server the scenario could be: C:\Documents and Settings\User name\Documents\inetpub\2007\myAlbum\ ... in which case you should enter "C:\Documents and Settings\User name\Documents\inetpub" and "\2007\myAlbum" respectively. 3.2 Single photo This mode displays the album using the Wordpress theme. It allows for both public and protected albums. 3.2.1 Access restriction Choose "Public access" if you have not made the album login protected. Or, choose "Login required" if you have placed a .htaccess file or require Windows Integrated Authentication etc. 3.2.2 Webserver root filepath See section 3.1.3 above. 3.2.3 Root relative JAlbum filepath See section 3.1.4 above. 3.2.4 Enter photo filename Here you should enter the original photo filename of the photo you wish to display. Say for example that you wish to blog this photo (Linux Apache): /data/myDomain.com/public_html/2007/myAlbum/DSC_3233.JPG You would have to enter: Webserver root: "/data/myDomain.com/public_html" Root relative JAlbum filepath: "/2007/myAlbum" Photo filename: "DSC_3233.JPG" And vise versa for a Windows webserver. 3.3 IFrame full album This mode displays the album using the generated JAlbum theme. It allows for public albums only. 3.3.1 JAlbum URL Here you should enter the URL (not filepath) for the desired JAlbum to blog. The album does not need to be hosted on your webserver, it may just as well be placed on another server. Provide the URL you would enter to view the JAlbum in a browser - or provide an URL for any of the slides of the album. 3.3.2 Width Enter the desired width of the integrated JAlbum in your post. 100% is the default value. This will make the album as wide as your post column, and is most likely the preferred way to go always. 3.3.3 Height Enter the desired height for the integrated JAlbum in your post. Default is 600px. Vary it as you see fit for your blog post. Requirements A PHP capable webserver running a Wordpress 2.0+ blog. Download Download the most recent version from the Wordpress Plugin Database. History Version 1.0 released (18 july 2007) The first official release version of the plugin. This version is even promoted by the team behind JAlbum! Yaaiiee =) Alpha versions 0.1 - 0.4 (june/july 2007) Draft versions of the plugin, steadily building a stable ground for the v1.0 release. Contact The JAlbum plugin for Wordpress is written and maintained by Michael Schøler (michael@famschoeler.dk). Contact me with bug reports, ideas and any comments you may have for the plugin. Remember this is free of charge and 100% voluntery work for my part, so naturally my efforts sometimes reflect an otherwise busy schedule. But I am actively involved in the improvement and continous enhancement of this plugin, using whatever spare time I may have to throw at it =) License The JAlbum for Wordpress is licensed under the LGPL, or Lesser Gnu Public License. This basically means that the software is absolutely free of charge, and that you use at at your own risk and that you may do with it what you want - including making your own modifications to it, as long as I am creditted for the original work. Another important note is that I cannot be held responsible for any damages caused by direct og indirect use of this software.