###############################################
SharePoint Connector Module
###############################################

Maintainer Contact
-----------------------------------------------
Marcus Nyeholt
<marcus (at) silverstripe (dot) com (dot) au>

Requirements
-----------------------------------------------
SilverStripe 2.4.x
External Content module
SharePoint

Documentation
-----------------------------------------------
Ensure that you have the external-content module installed. 

Place the sharepoint-connector module in your SS root directory and run
/dev/build.


Licensing
-----------------------------------------------
This connector is licensed under the BSD 

Alfresco community is licensed under the GPL, however no Alfresco libraries
are used when connecting to Alfresco


Quick Usage Overview
-----------------------------------------------

* Browse to http://localhost/external-content/admin and login
* Create a new SharePointContentSource from the tree on the left menu. Set the 
following field values:
** name - Alfresco Content
** API Url - The top level URL of your sharepoint instance's soap API. Typically
this is something like ????
** Username - The alfresco instance's username (the public demo system is 'demo')
** Password - The alfresco instance's password (the public demo system is 'demo')
** Root Path - Leave as blank
* Once saved, you will need to reload the External Content page for content to 
start coming through

Be aware that the username and password provided should be a generic 'read-only'
user of the system. Per-user access is on the TODO list.  

== Accessing content on the frontend ==

* Navigate to the "Site Content" tab
* Create a new 'External Content Page' in your site tree
* Change the External Content Source value to the SharePoint Content source created 
earlier
* Save and view the page on the frontend; its url should look something like
http://path.to.silverstripe/extcon/view?ID=1 or similar
* You can also link to external content directly in the WYSIWYG content areas by
selecting "External Content" as the "Link To" option when the Insert Link toolbar
is displayed

== Importing content == 

* First, make sure you have an empty folder called "Incoming" created in the 
"Files & Images" section
* Navigate back to the External Content section, and expand the "SharePoint Content" 
node created earlier. 
* Navigate to a folder (eg Data Dictionary/Scripts) and click on its name, then 
click on the Migrate tab.
* Select the "Incoming" folder, then click the "Include Selected Item in Migration" 
option.
* Click the Migrate button down the bottom. An alert box will shortly appear when
the migrate is complete. 
* Navigate to the "Files and Images" section and click the "Incoming" folder. 

API
-----------------------------------------------

There is no specific API available for working with content from Alfresco 
as yet.