Return to IMAGEUPLOADER.txt CVS log

Up to [Repository] / kupu / doc

Annotation of kupu/doc/IMAGEUPLOADER.txt, revision 1.1.1.1

1.1       dwinter     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