#Warpwire Sakai 11 Install Instructions
The steps to add the Warpwire Sakai plugin to a Sakai 11 instance are as follows:
-
Locate the
<sakai-installation-location>/webapps/portal-render/vm/<skin>/site.vm
file in your Sakai instance, where<skin>
is the current skin in use for Sakai – in the default Sakai installation, this is the ‘neoskin’ -
Within the
site.vm
file, locate the<script>$PBJQ = jQuery;</script>
block, and add the following line immediately after the closing</script>
tag:<script type="text/javascript" src="/portal/scripts/warpwire.js"></script>
-
Within the
<tomcat-installation-directory>/sakai
directory, create a folder named 'portlets', if it does not already exist (Resulting folder location will be<tomcat-installation-directory>/sakai/portlets
) -
Copy the
IMSBLTIPortlet.xml
file (located atxml/IMSBLTIPortlet.xml
in the included archive) into the folder from the previous step (<tomcat-installation-location>/sakai/portlets
). This is the xml configuration file that allows the Warpwire plugin to exist as an LTI tool within your Sakai installation. -
Replace the
[[WW_LAUNCH_URL]]
,[[WW_SECRET]]
, and[[WW_CONSUMER_KEY]]
within the newly created<tomcat-installation-location>/sakai/portlets/IMSBLTIPortlet.xml
file with the applicable values provided by Warpwire. -
Copy the
warpwire.js
file (located atjs/warpwire.js
in the included archive) to the applicable location within your Sakai installation (<sakai-installation-location>/webapps/portal/scripts/warpwire.js
) -
Copy the
warpwire
directory (located within theplugin
folder) into theckextraplugins
folder within your Sakai installation (Resulting folder location will be<sakai-installation-location>/webapps/library/editor/ckextraplugins/warpwire
). -
Locate the
<sakai-installation-location>/webapps/library/editor/ckeditor.launch.js
file, and add the following line to the ckconfig variable within the file:warpwireURL: '[[WW_ROOT_DOMAIN]]',
-
Replace the
[[WW_ROOT_DOMAIN]]
within the<sakai-installation-location>/webapps/library/editor/ckeditor.launch.js
file with the applicable value provided by Warpwire. An example of the necessary changes is located on line 62 of the file located atjs/ckeditor.launch.js
in the included archive. -
Add ‘warpwire’ to the
sakai.editor.enableResourceSearch
array, the extraPlugins variable, and within the addExternal plugin function in theckeditor.launch.js
file (located at<sakai-installation-location>/webapps/library/editor/ckeditor.launch.js
). An example of the changes necessary are located in the attached folder on lines 91, 92, 145, and 158 of the file located atjs/ckeditor.launch.js
.
Note: After following the provided steps, a restart of Sakai will be necessary in order for the Warpwire Site Tool to be accessible from within Sakai.