docs/include/jscripts/infusion/components/uploader/ReadMe.txt

   1 Infusion Uploader Read Me\r
   2 \r
   3 1) Upgrading\r
   4 2) Known Issues\r
   5 3) Troubleshooting\r
   6 4) Running the Uploader with out a Server\r
   7 \r
   8 --------------------------------------\r
   9 \r
  10 UPGRADING from previous versions:\r
  11 \r
  12 Before upgrading from Infusion 0.5 or earlier, please refer to the Uploader API documentation and the \r
  13 latest example code. The Fluid Uploader was extensively refactored in the 0.6 release, and a fresh new \r
  14 API has been introduced.\r
  15 \r
  16 Please refer to the Uploader API documentation on the Fluid Wiki and the \r
  17 Infusion 1.0 example code before using the Uploader with an existing integration. \r
  18 http://wiki.fluidproject.org/display/fluid/Uploader+API\r
  19 \r
  20 --------------------------------------\r
  21 \r
  22 KNOWN ISSUES: \r
  23 \r
  24 * To support Flash 10 (released on 9/26/2008), the Uploader required a new version of the SWFUpload \r
  25   Flash component (2.2.0 beta 3). This new version, still in beta, still has numerous bugs. We have \r
  26   worked around many of the bugs and inconsistencies in the SWFUpload code, but there are still \r
  27   significant compromises and issues in this release. For this reason we do not consider this version \r
  28   of the Uploader to be production-ready. \r
  29 \r
  30   In the previous version of the Uploader, the Flash component worked completely "behind the scenes". \r
  31   To support Flash 10, the Uploader displays a Flash-based "Browse files..." button in place of a \r
  32   HTML button. The Flash-based button presents the following quirks:\r
  33   \r
  34       In Firefox and IE, the Flash-based Browse button does not size correctly when the text/page \r
  35       is resized or zoomed.\r
  36 \r
  37       In Firefox (FF):\r
  38       - The AIRA role for the Browse button is read correctly as "button" but the text of the button, \r
  39         "Browse Files", is ignored.\r
  40       - The Flash-based Browse button traps keyboard navigation, refusing to give up focus without a \r
  41         mouse click. \r
  42       \r
  43       In Internet Explorer (IE):\r
  44       - AIRA is not supported by Internet Explorer.\r
  45 \r
  46     We are exploring work-arounds for most of these issues, and will have a patch out as soon \r
  47     as possible to fix them.\r
  48 \r
  49 * In previous versions of the Uploader the upload process would stop immediately at the moment that \r
  50   the Stop Upload button was clicked.\r
  51    \r
  52   With Infusion 0.8, we wait for the current file to complete or to error before we stop the upload \r
  53   process. This avoids a serious bug in the SWFUploader where the Upload process could get stuck when \r
  54   the Upload process as resumed.\r
  55 \r
  56 \r
  57 --------------------------------------\r
  58 \r
  59 TROUBLE SHOOTING:\r
  60 \r
  61 * When running the Uploader sample code on a local system without a server, check to make \r
  62   sure that you have followed the instructions below under "RUNNING THE UPLOADER ON A \r
  63   LOCAL SYSTEM WITHOUT A SERVER". \r
  64 \r
  65 * If you see this error in your console: \r
  66   [Exception... "'Invalid function name' when calling method: [nsIDOMEventListener::handleEvent]" \r
  67   nsresult: "0x8057001e (NS_ERROR_XPC_JS_THREW_STRING)" location: "<unknown>" data: no]\r
  68 \r
  69   The flashUrl option is probably wrong. Check that first. \r
  70 \r
  71 \r
  72 --------------------------------------\r
  73 \r
  74 RUNNING THE UPLOADER ON A LOCAL SYSTEM WITHOUT A SERVER\r
  75 \r
  76 Running the Uploader locally without a server is intended for basic testing purposes only. The \r
  77 DemoUploadManager provides a simulated conversation with the server, but it doesn't represent a\r
  78 fully accurate picture of the component's behaviour when used in a real deployment environment.\r
  79 \r
  80 So see the Uploader in action with a real server, have a look at Fluid's Image Gallery demo:\r
  81 \r
  82 http://build.fluidproject.org:8080/sakai-imagegallery2-web/site/AddImages/\r
  83 \r
  84 \r
  85 Additionally, you may need to modify some of your Flash settings to allow the local SWFUpload \r
  86 object to access your file system. To do so, follow these directions:\r
  87 \r
  88 1. Open your browser\r
  89 2. Browse to:\r
  90    http://www.macromedia.com/support/documentation/en/flashplayer/help/settings_manager04.html\r
  91 3. In the Flash Settings panel, click "Edit locations..."\r
  92 4. Select "Add location..."\r
  93 5. Click "Browse for folder..."\r
  94 6. Select the local /src/webapp/lib/swfupload/flash/ directory that contains the swfupload.swf file\r
  95 7. Restart your browser\r
  96 \r
  97 You should be good to go! \r
  98 \r
  99 However, if you move your installation, you'll need to do this all over again. There are settings \r
 100 that will allow the file to be run from any location on your local machine but these instructions \r
 101 are the minimum settings and therefor pose the least security risk.\r
 102 \r
 103 These settings are global and do not need to repeated for every browser on a given system. \r