=== Fotobook === Contributors: aaron_guitar Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=aaron%40freshwebs%2enet&item_name=Fotobook%20Donation&no_shipping=0&no_note=1&tax=0¤cy_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8 Tags: facebook, photos, images, gallery, fotobook, import, widget, media Requires at least: 2.3.3 Tested up to: 2.7 Stable tag: 3.1.6 Fotobook is a WordPress plugin that will link to your Facebook account(s) and import all of your photo albums for use in your WordPress installation. It uses the Facebook's API so importing your photos is a breeze. == Description == Fotobook is a WordPress plugin that will link to your Facebook account(s) and import all of your photo albums for use in your WordPress installation. It uses the Facebook's API so importing your photos is a breeze. **Features:** * Interfaces with Facebook's API * Displays photo albums on a WordPress page * Import photos from mulitple Facebook accounts * Sidebar widgets for displaying random or recent photos & albums * Creates an album of photos that the user's tagged in * Insert individual photos into posts/pages * Easy-to-use Ajax album management panel * Frontend validates as XHTML 1.0 Strict * Works with PHP5 & PHP4 ![Fotobook](http://www.aaronharp.com/wp-content/uploads/2007/07/fotobook_logo.png) == Installation == 1. Download and unzip the most recent version of Fotobook 2. Upload the entire fotobook folder to /your-wordpress-install-dir/wp-content/plugins/ 3. Login to your WP Admin panel, click Plugins, and activate Fotobook 4. Go to Options and then click the Fotobook link. Follow the two steps for linking the plugin to a Facebook account. 5. Now import your albums on the Manage / Fotobook page. 6. That's it! To upgrade simply replace the old Fotobook directory with the newest version. Re-import all of your albums to complete the upgrade. == Frequently Asked Questions == = Fotobook isn't working, what's wrong? Before contacting me, make sure your host is running PHP 5. If not, contact their support to see if it can be changed or switch to a [host](http://www.dreamhost.com/r.cgi?275020/hosting.html|fotobook) that does have PHP 5. = Can this plugin import photos from Facebook groups or pages? = No. Facebook's API doesn't currently allow for this. = How do I create a new style for Fotobook? = To create a new style, simply duplicate and rename one of the existing styles and modify the files. = My theme doesn't support widgets. How do I add the Fotobook widgets manually? = Use the following template functions: `fb_photos_widget(count, mode, size) fb_albums_widget(count, mode)` *Parameters* * $count: number of photos/albums to display (default: 4) * $mode: method for selecting photos/albums to display. Can either by random or recent * $size: size of square thumbnails (default: 80) *Examples* ` ` = I have the Lightbox style selected but the images pop up in another window. = The [Lightbox plugin](http://wordpress.org/extend/plugins/lightbox-2-wordpress-plugin/) must be installed and activated. == Screenshots == Check out my [photo gallery](http://www.aaronharp.com/photo-gallery/). == Support == Submit any problems, questions, suggestions, or compliments on the [Facebook Discussion Board](http://www.facebook.com/board.php?uid=2254862517). Become a fan of the [Fotobook Application](http://www.facebook.com/apps/application.php?id=2254862517) to be notified when updates are available. == Change History == 2009.02.15 - v3.1.6 * Fixed bug where changes to album order were not saved * Fixed other small bugs 2008.11.20 - v3.1.5 * Added cron script for automatically updating albums (see settings panel) * Readied Fotobook for WP 2.7 * Fixed duplicate key bug when importing photos of multiple users (props Darrell) 2008.11.19 - v3.1.4 * Fixed bug where album pages were showing 404 errors * Hopefully resolved some conflicts with WordBook * Error handling for empty albums * WP Ajax hook is now used for requests 2008.07.30 - v3.1.3 * Widget can now be added manually to the sidebar. See FAQ section * Added confirmation when user tries to leave manage page before applying permissions * Updated to latest version of Facebook platform * Fixed path to SimpleXML for Facebook PHP 4 platform * Fixed safe mode error * Fixed management display issue in Internet Explorer 7 * Added debug info to the settings page 2008.07.04 - v3.1.1 * Fixed error when user is not tagged in any photos * Fixed some display/formatting issues 2008.06.13 - v3.1 * Fotobook now creates an album of photos that the user is tagged in * Added an option to hide albums from showing up where pages are listed in your theme * Password protected albums are now protected * Restyled the admin panels to look better with WP 2.5 * Fixed problem with UTF8 encoding in photo captions * Fixed conflict with other plugins that tried to hide pages * Fixed wp_rewrite issue when importing albums * Fixed fatal exception in PHP 5 when the session key became invalid * Other small tweaks and fixes 2008.05.17 - v3.0.7 * Disabled output buffering for albums because it was causing too many issues. 2008.04.29 - v3.0.6 * Fixed fatal error on activation with some setups. 2008.04.12 - v3.0.5 * Modified feature for inserting photos into posts to work with WP 2.5's new media library. * Really fixed fatal error bug when upgrading to version 3. * Photo gallery can now be a sub-page. * Improved error reporting. * Cleaned up the code. 2008.04.06 - v3.0.3 * Disabled Wordbook actions when adding and deleting album pages to prevent Wordbook from re-instantiating the Facebook API class. * Fixed fatal 'Session key invalid or no longer valid' error when upgrading to version 3. 2008.03.20 - v3.0.2 * Updated to the latest versions of the PHP4 & 5 Facebook API clients. Huge speed boost for photo imports with PHP5. 2008.03.19 - v3.0.1 * Fixed bug where albums would be imported but it would still say "There are no albums." * Fixed issue with local scope of $table_prefix during plugin activation in WP2.5. 2008.03.15 - v3.0 * Added support for linking to multiple Facebook accounts * Major improvements on the photos widget display. Thumbnails are now squares for clean display. * Photo widget links go to the actual photo. * Added module in the post/page upload iframe for inserting individual photos. * Ajaxified the management panel so that the user is more aware of what's going on. There is a progress bar while albums are being imported. * Streamlined the way that the albums are requested from Facebook resulting in far fewer requests. * Added "Embedded Width" option to fix overlapping problems with the embedded style on narrower themes. * Added stylesheet editor to options panel. * Removed the popup style because it's kinda old school. * Cleaned up the code a bit. 2007.09.03 - v2.1 * Photos from hidden albums are no longer shown in sidebars. And hidden albums are no longer accessible by their permalink. * Hopefully fixed the escaped quotes problem. * It detects changed albums/photos a little better now. * Lightbox will go through all photos in an album, not just the current page. * Fixed the fatal error if the isterLogger class is already present on the server. * Sidebar thumbnails can be larger than 130px (uses full image instead of thumbnail). * Added “Remove All” button in the manage page to get rid of all albums and photos and start over (some people have had problems with partial imports). 2007.07.10 - v2.0.1 * Fixed an array_slice backwards compatibility issue with pre PHP 5.0.2 servers 2007.07.09 - v2.0 * Revamped to work with Facebook’s API * Multiple display styles are now supported * Added widgets for displaying photos or albums in the sidebar * Got rid of all the messy cURL and regex stuff. 2007.04.11 - v1.3.1 * Fixed to work with Facebook’s new look 2007.03.27 - v1.3 * IMPORTANT: You must deactivate and reactivate the Fotobook plugin after installing this version. * Fixed the bug that caused the whole first page of photos to be imported twice. Just re-cache your albums and you should be good to go. * Added pagination to the albums page * Better error reporting * Other minor changes 2007.01.28 - v1.2.1 * The long-awaited WP 2.1 compatibility fix. * Fixed bug with the ‘Prev’ button * IMPORTANT: If you already have albums imported, you will need to re-cache them all after installing this update. If you still have problems, then try deleting them and adding them again. If it still doesn’t work, let me know =) 2007.01.04 - v1.2 * Fixed bug that was causing the main album page to not load * Fixed bug where an extra broken image was sometimes displayed * Cleaned up the code so that it is easier to make layout changes to the albums * New albums are now added to the top instead of bottom 2006.12.18 - v1.1.1 * Small layout bug fixes 2006.12.14 - v1.1 * cURL is no longer required * Added pagination to bottom of gallery as well * Cleaned up the code 2006.11.29 - v1.0 * First release == Help Out! == To be honest, this takes up a lot of time. I enjoy doing it, but some money for it here and there would be nice. Here are a few ways you can help out (and encourage me to work on it more =) ): First, you could sign up for a [DreamHost](http://www.dreamhost.com/r.cgi?275020/signup|fotobook) account and use the promo code Fotobook. This not only helps me out but also waives the $50 setup fee when you pay monthly (only $10.95/month). If you choose one of the other payment periods you’ll get $25.00 off. I’ve hosted with them for a couple years and I’ve had no problems. They have all sorts of [features](http://www.dreamhost.com/r.cgi?275020/hosting.html|fotobook) (500gb storage, unlimited domains, PHP4&5) and, best of all, they have one-click WordPress installs and upgrades. If you are satisfied with your hosting and want to help out, you can send some cash over [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_xclick&business=aaron%40freshwebs.net&item_name=Fotobook%20Donation&buyer_credit_promo_code=&buyer_credit_product_category=&buyer_credit_shipping_method=&buyer_credit_user_address_change=&no_shipping=0&no_note=1&tax=0¤cy_code=USD&lc=US&bn=PP-DonationsBF&charset=UTF-8).