= eduCommons Development - Getting Started =

== Installing the Latest Development Version ==

Instructions how to check out the latest sources and run the existing code are below.

Checkout the eduCommons buildout script:

{{{
svn co https://educommons.com/svn/eduCommons.buildout/trunk eduCommons
}}}

Change directories and run the bootstrap script:

{{{
cd eduCommons
/usr/local/python2.4 bootstrap.py
(in some envoronments the command will be /usr/local/bin/python2.4 bootstrap.py)
}}}


Then run the buildout script to download all the required packages and set up the eduCommons application:

{{{
bin/buildout
}}}

Or run the same buildout script above, plus the Selenium test runner (needed to run SeleniumTests):

{{{
bin/buildout -c tests.cfg
}}} 

Once you have the buildout ready you can launch it using the following:

{{{
bin/instance start
}}}

Or to launch in the foreground of your console:

{{{
bin/instance fg
}}}

You should now be able to open a browser and go to the ZMI with the following URL
(assuming that you configured Zope to run on port 8080)

{{{
http://<server name>:8080/manage
}}}

You should then get a dialog prompt asking for your Zope admin username and password. The default username/password for the buildout is admin/test1234.

== Install eduCommons Product in Your Zope Instance ==

Once you have logged into the ZMI via the management interface, you are now ready 
to create the site. Start by creating a plone site with the pull down menu in the 
top right corner. Give the plone site an ID and title. The ID will be used in the 
URL to access the site, so name it appropriately. The title will appear several 
places within the eduCommons install, and should be based on your group or institution.</p>
Under "Extension Profiles" you need to do a multi-select (hold down the CTRL or the 
Command key). Select the following so they are all highlighted:
 1. PloneBookmarklets
 1. ContentLicensing
 1. IMSTransport
 1. OpenSearch
 1. OAI Intercom
 1. SearchAndReplace
 1. Zip File Transport
 1. Left Skin
 1. Static Site
 1. eduCommons
 1. wordpressexchange
 1. iw.fss (FileSystemStorage)
 1. Working Copy Support (Iterate)
 1. CacheSetup
 1. LinguaPlone

Then click "Add Plone Site."

If you wish to localize content in other languages you will need to select your supported languages.

In the ZMI:
 1. Navigate to your eduCommons instance
 1. Navigate to portal_languages
 1. Select one or more Allowed languages (use the control or apple key to multi-select)
 1. Click Save 

Additional instructions for localizing content using LinguaPlone are available at .
Finally, you need to reorder the Layers in your eduCommons Skins Selections.
In the ZMI:

 1. Navigate to your eduCommons instance
 1. Navigate to portal_skins
 1. Click on the Properties tab
 1. Under the Skins Selections, in the Layers textbox for LeftSkin, cut the LinguaPlone entry 
   and paste it one a new line below the eduCommons entry 
 1. Click Save (be sure to click the Save button for the Skins selection section)

== Configure eduCommons ==

Additional configuration information is provided in SETUP.txt (or online at
[http://educommons.com/documentation/how-to/educommons-setup-instructions]).
This will help you to further customize eduCommons.