
-----------------------------------------------
Shutterfly Upload Plug-in for Adobe Lightroom 2
-----------------------------------------------

  This plug-in allows you to export images from Lightroom 2 directly into
  your Shutterfly account.  It was developed using Shutterfly's Open API,
  but is in no other way affiliated with Shutterfly, .  Please don't ask
  Shutterfly if you have questions about, or problems with, this
  plug-in -- they won't have a clue what you're talking about.

-------------
Compatibility
-------------

  This plug-in was developed and tested on Windows, but should work fine
  on a Mac (please let me know if that's not the case!).  It has been
  tested with Lightroom 2.1 and 2.3.
  
  The plug-in appears to be working with the Lightroom 3 beta.  If you
  give it a try on the Lightroom 3 beta platform, I'd appreciate hearing
  about any problems you encounter, though I may not be able to fix any
  LR3-specific issues until after LR3 is officially released (and Adobe
  publishes updated documentation for their new code).
  
------------
Installation
------------

  1. Unzip the contents of this zip file to a location of your choice.
     Be sure that the internal folder structure is preserved (the
     plug-in contents should all be inside of a folder that ends with
     ".lrplugin" or ".lrdevplugin"). Check your zip tool documentation
     to see what you need to do.

  2. Start Lightroom, and launch the Plug-in Manager either from the File
     menu, or from the "Plug-in Manager..." button on the Export Dialog.
     
  3. Click the "Add" button, then locate the directory unzipped in step
     1., above (it will end with ".lrplugin" or ".lrdevplugin").
     
  4. Press "OK" to finalize your selection.
  
  5. If you receive a "Confirm" dialog telling you that
  
        The plug-in "Shutterfly Upload" needs to update the catalog to
        support its plug-in properties.
        
     press "Update".
     
  6. Press "Done", and you'll be good to go!
  

-------
Updates
-------

  The installation zip file is designed to be unzipped directly over the
  top of an existing installation of the plug-in.  The easiest way to update
  is to unzip the contents to the same place you did initially, then restart
  Lightroom or reload the plug-in from the Plug-in Manager.
  
  When you install an update, a "Confirm" dialog may pop up to let you know
  that the Shutterfly Upload plug-in "... needs to update the catalog ...."
  The plug-in uses your catalog you keep information about your uploads so
  you can find it later if you need to.  Press "Update" to dismiss the
  dialog.
  
  You may also install an update along side of an existing installation,
  making it easy to return to the original version if you want to.  If you
  want to go this route, follow the "Installation" instructions, above, but
  be sure to unzip the file to a *new* location.
  
  Lightroom will detect that you're installing a newer version and disable
  the older copy.  If you want to switch back, use the Plug-in Manager to
  Disable the more recent version, then Enable the older one.
  
  When you decide which version you want to keep, you can use the Plug-in
  Manager to Remove the other from Lightroom, but the plug-in files will
  remain in your file system.  You'll need to delete them manually if you
  want to remove them from your machine.
  
  
---
Use
---

  ------
  Export
  ------

  After following the installation steps, the Shutterfly Upload will be
  available as an export target.  In the Export dialog, click anywhere
  on the banner image located near the top and select "Shutterfly
  Upload" from the menu that appears.
  
  There are three settings groups specific to the Shutterfly Upload
  plug-in (the others are standard with most export plug-ins):
  
  1. Shutterfly Account
  
     If you would like to see a list of your Shutterfly albums, enter
     your Shutterfly user ID and password, and press the "Login" button.
     If you aren't logged on to Shutterfly prior to starting the export,
     you will be prompted for your login information.
     
     If you would like to save your password for the next time you use
     Lightroom, or to be able to save your password in an export preset,
     check the "Save password?" box before pressing "Login".  Be aware
     that when checked, your password will be saved as clear text in
     Lightroom's preferences file, and it may be visible in debug logs.
     
  2. Shutterfly Upload Settings
  
     This is where you can specify the Shutterfly album to export to.
     Either select "Add to new album" and fill in an album name, or
     select "Add to existing album" and choose one from the list.  The
     "Add to existing album" option will only be available when you're
     logged on to Shutterfly (see above).
     
     If you don't provide an album name, today's date will be used as
     a default name (e.g. "2009-03-24").
     
  3. Post-processing
  
     There are three actions to choose from that can be performed once
     your export completes:
     
       Do Nothing
        
         I guess this would be better termed an "inaction".
           
       Visit Shutterfly.
        
         The Shutterfly "Album View" will be opened in your browser.
         Note that if your browser is already logged on to a Shutterfly
         account, it is *that* account that will be displayed, not
         necessarily the one used for the Lightroom export.
           
       Show in [Explorer | Finder]
        
         Show the exported images in Explorer (Windows) or Finder (Mac).
         This choice only makes sense if you chose other than "Temporary
         folder" in the standard "Export Location" section.
           
   Note: in the "File Settings" group, be sure to choose "sRGB" for the
         "Color Space" selection!

  --------
  Metadata
  --------

  When you export images to Shutterfly, the plug-in adds information to
  the Lightroom catalog for those images that is visible in the Lightroom
  metadata panel and can be used as a filter for creating Smart Collections,
  or for Libary module viewing. The information saved includes:

    * the upload status,
    * the Shutterfly user ID active at the time of upload,
    * the Shutterfly album name the photo was uploaded to, and
    * the upload date and time.

  If a given image is uploaded more than once, the metadata reflects the
  status of the most recent upload.

  Some basic metadata maintenance can be performed using the "Shutterfly
  Upload extras" panel, accessible from Lightroom's "File > Plug-in Extras"
  and "Library > Plug-in Extras" menu options.

  The options on this panel give you the ability to:

    * remove the Shutterfly Upload metadata from the selected photos,
    * set the Shutterfly Upload status flag for the selected photos, and
    * edit some Shutterfly Upload metadata fields for the selected photos.

  These actions can be "undone" using Lightroom's standard undo capability
  if the undo is performed immediately.


-----         
Terms
----- 

  This plug-in is provided for your use, free of charge.  However, if you
  find it useful, donations are gladly accepted!  If you would like to
  donate a trinket to express your gratitude, open Lightroom's Plug-in
  Manager, select "Shutterfly Upload" in your list of installed plug-ins,
  and then click on the "Donation" link.
        
-------
Contact
-------

  If you have questions, comments, or problems, please visit the plug-in's
  web page at
  
      http://www.don-mckee.com/lightroom/shutterfly-upload/
      
  or send a message to Don@don-mckee.com and I'll do what I can to help.
  Be sure to include the version and build stamp (found in the plug-in's
  "Status" section of the Plug-in Manager), error messages, or log file if
  applicable.

