========================================================================================================================
					   D O O R - Digital Open Object Repository
					
				PLUGIN FOR MOODLE 1.8.x OR NEWER - v 1.8 (: KEEPING DOOR ALIVE :)
						   
						   	   README
========================================================================================================================

Here is a basic outline of the installation process:

1)  INTRODUCTION

    1.1) There are in fact 2 plugins:

	 - DOOR to MOODLE plugin
         - MOODLE to DOOR plugin

    1.2) DOOR to MOODLE plugin
	 
	 This plugin let you import LOs from DOOR to moodle. LOs are exported from the DOOR server as IMS CP and copyed to the 
         MOODLE server. There they are parsed and imported as DOOR resources.

         IMPORTANT: THIS PLUGIN IS NOT AN ACTIVITY, IT'S A RESOURCE TYPE. THE ACTIVITY PART IS AN HACK TO LET THE PLUGIN BE 
                    CONFIGURABLE (PARTICULARLY TO LET YOU MANAGE CONNECTION OF REPOSITORIES TO MOODLE)


    1.3) MOODLE to DOOR plugin

	 This plugin let you export single resources or the entire course (all assets) to a repositories.


    1.4) NOTES:

	 the two plugins must be both installed in order to work correctly

    

2)  REQUIREMENTS
    
    2.1) A moodle server with php5 (Moodle version 1.8.x or later, please visit http://www.moodle.org)

    2.2) A DOOR Server with php5 (DOOR 1.8.x, please visit http://door.sourceforge.net)

    2.3) To be able to use the plugins you need the CURL library on each server (enable it and recompile php)

    2.4) NOTES: you can have DOOR and MOODLE on the same server if you wish.

    
3)  SETUP

    3.1) SETUP (STEP 1)

         To perform this step you can use the new installer (for bash) or do it in the old way (copying each file)
    
         3.1.1) Using the Moodle Plugin Installer

                - Give the right permission to the installer ("chmod +x moodle_plugin_installer.sh")
                - Execute the installer ("./moodle_plugin_installer.sh")
		
		NOTES: the installer automatically remove a previous version of the plugin
	 
	 3.1.2) Doing it in the Old way (manually copy the files)
    
    		- Core
    			- Copy the "moodle_plugin/mod/resources/type/door" directory to moodle/mod/resources/type/
    			- Copy the "moodle_plugin/mod/door" directory to moodle/mod/
    			- Copy the "moodle_plugin/blocks/export_door" directory to moodle/blocks/
    		- Language
     			- Copy moodle_plugin/lang/SELECTED_LANGUAGE/help/door to moodle/lang/SELECTED_LANGUAGE/help/door 
			  in the moodle tree
    			- Copy moodle_plugin/lang/SELECTED_LANGUAGE/help/resource/type/door.html to 
			  moodle/lang/SELECTED_LANGUAGE/help/resource/type/door.html in the moodle tree
    			- Copy moodle_plugin/lang/SELECTED_LANGUAGE/door.php to moodle/lang/SELECTED_LANGUAGE/door.php
			- Copy moodle_plugin/lang/SELECTED_LANGUAGE/block_export_door.php to moodle/lang/SELECTED_LANGUAGE/
   

    3.2) SETUP (STEP 2) 
	
	 For each installed language do as follows:

	 3.2.1) Modify the file moodle/lang/SELECTED_LANGUAGE/resource.php and add the following entry (eventually translated): 
    	 	$string['resourcetypedoor'] = 'Link to a Learning Object';


    3.3) SETUP (STEP 3) 
    
    	 3.3.1) Login as administrator and go to "Notifications".
    	 3.3.2) Go to the modules section and clic on the door "settings". Here you can add as many Learning Object repositories as 
		you want. For each repository that you add you have to specify an authentication type. Choose 'all' to let people 
		choose the authentication system on DOOR. Choose 'local' or 'shibboleth' to force the authentication on DOOR.
	 3.3.3) Add the "Export resources to repository" block to your course.

    
4)  USAGE
    
    It's now possible to add Learning Objects to a course as resources (import plugin) and save resources to repositories
    (export plugin).


5)  BUGS

    For a strange reason when you backup moodle courses DOOR resources files are lost. If you know how to solve this issue please
    contact me so that I can fix this problem.
    

The eLab Team

========================================================================================================================