Plumi is a meta-package that uses other Plone Packages as well as our own code.

REQUIREMENTS
------------

- Zope 2.9.9 - http://www.zope.org/Products/Zope/2.9.9
- Plone 2.5.5 - http://plone.org/products/plone/releases/2.5.5
- Archetypes 1.4.6-final
- ATContentTypes 1.1.8-final
- Tested with Python 2.4.4


Optional Requirements
---------------------
- Twisted networking (for remote bittorrent functionality)
 (Twisted 2.5 - http://twistedmatrix.com/trac/)
- local BitTorrent install (for local bittorrent functionality - see ATMedia/bt-server/INSTALL.txt - these docs may be out of date)

  
INSTALLATION
------------

ASSUMPTIONS
-----------

1. Plone
You have a newly installed Plone site. 
See here for documentation if you need to do that: 
http://plone.org/documentation
http://docs.neuroinf.de/PloneBook/ch2.rst

2. IMSVDEX
This will need to be installed *in the local Python*. ie, the Python used by
your zope instance. If you use the Unified Installer from the Plone site, it
will be /opt/Plone-2.5.x/Python-2.4.x/

At the commandline type:

easy_install imsvdex

if easy_install is not installed, see here:
http://peak.telecommunity.com/DevCenter/EasyInstall

if you are still getting errors, you _may_ need 

easy_install-2.4 imsvdex

PLUMI
-----
You can download the most recent stable release of the Plumi package from http://plone.org/products/plumi 

The archive that you download contains all of the Plone Products that you will need for a functioning video sharing site. 

nb. This is a regular Plone Product install. If you are familiar with this procedure, this section will not teach you anything new. 

1. Unzip the file plumi-x-x-x.tar.bz2 this will create a folder called Plumi-X.X in which all of the necessary products are kept.  

2. Update your Zope instance configuration file (etc/zope.conf) to include a line pointing to the Plumi products. Eg
products /path/to/Plumi-X.X

3. Restart Zope. There should be a restart button inside the Control Panel page in the ZMI.

4. You can now add product in the Plone by going to the "Add/Remove Products" page on your Plone site , or the Quick Installer tool in the ZMI, clicking the relevant radio boxes and then hit "install". You should only need to install 'ATVideo', 'PlumiSkin', 'PressRoom' - all the rest of the products will be pulled in by installers of those two products.

For the set up of individual products please see the README or INSTALL inside each product's directory. 

See especially, ATVideo/README.txt , PlumiSkin/README.txt

For a rough guide for installing from sources, see DEVELOPERS.txt

SKIN AND TEMPLATES
------------------
Plumi comes with a basic skin product called PlumiSkin. The idea is that you build your own skin for your distinct needs by customising PlumiSkin.
The PlumiSkin installer makes typical contents items such as "About Us" pages, and can install custom CSS files into the new skin. It adds vocobularies for genre, countries, and topics which can be extended and customised.

It adds some email notifications based on workflow state changes. When a new video is published by a user an email is sent to the reviewers informing them of a new submission to review. The new content is initally in 'pending' workflow state. The reviwer can accept it for publishing , or reject it.

The default PlumiSkin places videos and other content in listings with a 'published' workflow state. Items in the pending state are however publicly viewable. When any object is accepted by a reviewer an email is sent to the owner of the content item informing them of its acceptance.

Note, Reviewers are any portal user with the 'Manager' role. 

Pre-fabbed Plone skins can be found in the Plone products directory http://plone.org/products/by-category/themes

You can of course change anything you like by customising the templates (ie production of html pages) and CSS. As general practice however, its a good idea to maintain separates instances of your site, doing testing and development on a separate instance to your production ("live") site. 

DEFAULT USER
-------

CHANGE YOUR DEFAULT PASSWORD! By default, PlumiSkin creates a default user called 'Plumi' with password 'plumi123'. You should change this immediately
or delete the user - using your zope admin user you created when you created the zope instance.
The default user is created so that content created during skin install has an owner that represents the user/collective running the site.

USAGE
-----
For instance, how to feature a video on the front page.
For usage documentation please see - http://plone.org/products/plumi/documentation


TRANSCODING
-----------

The automatic transcoder is done by a tool called 'indytube'. It is a python script, relying on the twisted networking framework, and mencoder and others. This means you may need to install external software (such as twisted or mencoder). You will need to configure indytube to point certain directories. For the details please see the README , and INSTALL.plone, in the indytube directory.

Note: this has only been tested on Debian GNU/Linux servers.

Working inside the indytube directory you need to configure the indytube.conf configuration script then run the bash script , run_indytube.sh

The indytube process will be running in the background, mointoring the filesystem, waiting for new video files to transcode.

In the default Plumi video view template, video_view.pt, the transcoding status of the video will be listed, only if the viewer of the page is the owner of the content, or is a Manager on the site (ie has the Manager role). The status also includes links to try retranscoding, or to turn off transcoding, for the video.

THE BUNDLE
----------
The Products used are listed in the EXTERNALS.txt file.

Most of the requirements to run the package are included. For your reference they are

# ATvideo (Engage Branch) : http://dev.plone.org/collective/browser/ATVideo/branches/engage
# ATMediaFile : fat-bt branch https://svn.plone.org/svn/collective/ATMediaFile/branches/fat-bt
# ExternalStorage-0.6 : http://plone.org/products/externalstorage/releases/0.6/ExternalStorage-0.6.tgz
# ATCountryWidget : http://svn.gocept.com/repos/gocept/ATCountryWidget/trunk
# ATVocabularyManager-1.1-beta : http://plone.org/products/atvocabularymanager/releases/1.1/ATVocabularyManager-1.1-beta.tgz
# qRSS2Syndication 0.4.5 : http://svn.quintagroup.com/products/qRSS2Syndication/tags/0.4.5/
# ContentLicensing - http://plone.org/products/contentlicensing/releases/1.0.2/
# CacheFu1.0.2 - http://plone.org/products/cachefu/releases/1.0.2
# basesyndication : https://svn.plone.org/svn/collective/basesyndication/trunk
# fatsyndication : https://svn.plone.org/svn/collective/fatsyndication/trunk
# PloneCaptcha - http://www.partecs.com/downloads/PloneCaptcha-1.0.tar.gz
# AtAudio - http://plone.org/products/ataudio/releases/0.6.0/ 
# PressRoom - http://plone.org/products/pressroom 
# PlumiSkin -  https://svn.plone.org/svn/collective/PlumiSkin/

Latest version of these are listed in the Plumi product SVN , in the EXTERNALS.txt file 
http://dev.plone.org/collective/browser/Plumi/trunk/EXTERNALS.txt 



