[Sommaire] [Imprimer]

   1  ===============================
   2  Local image upload enhancement
   3  ===============================
   4  
   5  This document gives an overview of the enhancement and describes how
   6  to add support for other back-end servers or CMSes.
   7  
   8  Overview
   9  ---------
  10  
  11  Usage of the enhancement should be practically self-evident. Use the
  12  image drawer to navigate to the folder/directory you want to upload
  13  the image to, click "upload", which opens up an upload form, select an
  14  image from your computer, enter a title for it, and click "insert".
  15  
  16  
  17  Installation
  18  -------------
  19  
  20  By default, the enhancement is disabled. This is because initially,
  21  there is only back-end server / CMS support for plone. Once we get
  22  support for a few other backends, the enhancement will be enabled by
  23  default.
  24  
  25  To enable the enhancement include a tag `<uploadbutton>` in the xml
  26  for the folder. See plone/kupu_plone_layer/kupucollection.xml.pt for
  27  an example.
  28  
  29  Technical notes
  30  ----------------
  31  
  32  The image uploader adds new code to the following files:
  33  
  34   * common/kupudrawers.js
  35  
  36   * common/kupudrawerstyles.css
  37   
  38   * common/kupudrawers/drawer.xsl
  39  
  40  
  41  It adds the following:
  42  
  43   * this file
  44  
  45   * plone/kupu_plone_layer/kupuUploadImage.py
  46  
  47   * plone/kupu_plone_layer/kupuUploadImage.py.metadata
  48  
  49  
  50  See kupuUploadImage.py on how to add support for uploading images to
  51  another server/CMS.
  52  
  53  
  54  Bugs, caveats et cetera
  55  ------------------------
  56  
  57  * After image upload, the library/collection of images does not get
  58    reloaded if you're using a Mozilla browser, such as FireFox. In order
  59    for the uploaded image(s) to be listed in the image drawer, save your
  60    changes and reload kupu (ie. "edit" the document again by clicking the
  61    "edit" tab on plone.
  62  
  63  * Because of the above problem, there's an extra "reload current"
  64    button to manually refresh the image drawer contents