Dependencies
============

Required Products
------------------

* Plone 2.0.4, 2.05, 2.1, 2.1.1
* Archetypes >= 1.3.0
* AttachmentField (For file indexing and preview)

Installation
============

Installing AttachmentField
--------------------------

* Unpack it into your Zope Products Folder
* Restart Zope
* Use Plone Setup -> Plone Configuration -> Add/Remove Products
  to install AttachmentField. You can also use the portal_quickinstaller
  in the ZMI
* Now you can test upload, indexing and previewing of your favourite file types
  in the AttachmentField configlet in Plone Setup -> Plone Configuration ->
  Add-on Product Configuration -> AttachmentField Preferences

Installing PloneExFile
----------------------

* Unpack it into your Zope Products Folder
* Restart Zope
* Use Plone Setup -> Plone Configuration -> Add/Remove Products
  to install PloneExFile. You can also use the portal_quickinstaller
  in the ZMI
* Now you can add a PloneExFile through the Plone Interface.

Migration
---------

Migration from PloneExFile 2.x is possible with the scripts in 
PloneExFile/migration, but they are not yet very polished. 

Overview
========

  PloneExFile : A Plone file that can incorporate an attachment with indexing
  and preview.

  Behaves mostly like the standard Plone File type. When you add a PloneExFile,
  you can enter the name, title, description and text information.

  When you look at the Plone Article, the images will appear in the right
  column as a thumbnail and optionally with their title. When you click on
  the thumbnail, a popup window will appear with the image at its actual size.
  Attachments will be listed below the article for download in rows of three.

  You will notice two tabs that don't exist on the standard Plone Document:
  images and attachments.

    The Images Tab:

      This interface shows the Images that you have uploaded to the article, and
      allows you to add new images as well as deleting them. Images can have an
      optional title. The position of images as they will appear in the right
      column of the Plone Article View can be changed with up and down arrows
      that allow you to individually move images up or down one step.
    
      Thanks to the ImageTag hotfix, Images are shown as a thumbnail on all
      pages, and only when you click on them, a popup window will appear with
      the original size of the image.
    
    Attachments Tab:
    
      This interface shows the Attachments that you have uploaded to the article,
      and allows you to add new attachments as well as deleting them. If no title
      is given, the name of the uploaded file is taken in its place. 

    Links Tab:
    
      This interface shows the Links that you have added to the article,
      and allows you to add new links as well as deleting them.

    The Models Tab:

      Here you can choose from the stock layout models that come with PloneArticle,
      and also the models that you have created somewhere in the skins path.

Additional tools
----------------

  Articles summary

    A Page Template called 'plonearticle_summary' is provided as an example to have a
    brief summary of the five most recent published articles in a website, along
    with their first image if available.

  Article tool

    An article tool (portal_article) is installed by the installer. It provides a
    few configuration options so that you can customize PloneArticle's behaviour.

  Lock support

    An optional lock support can be enabled in the article tool. If enabled, any
    authorized user (ie. having edit permission) must LOCK an article to edit it.
    Only the user who locked the article, the Reviewer and the Manager can UNLOCK
    an article. A locked article cannot be edited but apart from this you can
    do anything you want on it.


Performance issues
------------------

  PloneArticle has been tuned so 
  that caching is efficient.

  Thumbnail tags

    Thumbnail tags displayed in an article can be cached by a RAMCacheManager,
    for the plonearticle_get_thumb_tag() PythonScript with 'image_id' as variable parameter.

    
Addition for new content types developers
-----------------------------------------
 
  There is an external method to unindex content types contained in PloneArticle. 
  This external method is called : unindex_plonearticle_contents
  You can find this script in Extensions/toolbox.py
  
