Installing CpExtra

CpExtra requires no special installation, unless you wish it to appear in the Learning Interactions list.

If you do not want it to appear in the Learning Interactions list, proceed to the next help topic to learn how CpExtra can be inserted into your project.

Make CpExtra Appear in the Learning Interactions Menu

In your download zip is a file named Infosemantics_CpExtra.wdgt. Copy this file and paste it into the following folder (depending on your operating system)

For Windows 

Paste Infosemantics_CpExtra.wdgt into: C:\Program Files\Adobe\Adobe Captivate 9 x64\Gallery\Interactions

For Mac

Paste Infosemantics_CpExtra.wdgt into: Applications/Adobe Captivate 9/Gallery/Interactions

CpExtra should now appear in the Learning Interactions menu.

Load CpExtra Headlessly

Headless loading is a method of installing CpExtra directly into Captivate's program files. The end result being that whenever you export a HTML5 project (including responsive projects) CpExtra will automatically be included. There is no need to add the CpExtra widget to the project.

Fors and Againsts

There are many benefits to loading CpExtra this way.

  • No need to include the CpExtra widget.
  • A course using self-paced learning or certain LMS resume features would always successfully load CpExtra. On the other hand, if you were loading CpExtra as a widget, these features would potentially skip the slide that the CpExtra widget was placed on, thereby causing interactions that used CpExtra further along in the project to fail. 

However, there are a number of downsides to this approach

  • If you share a project using headless CpExtra with another developer who does not have CpExtra installed in this way, then the projects they publish will not include CpExtra. This would not be an issue if CpExtra is loaded as a widget.
  • You can not see from the CpExtra widget interface what the current version or build number is, nor can you see if there is a newer version of CpExtra available for download.
  • Every time you update Captivate, you will need to redo the process of installing CpExtra headlessly

Installing CpExtra into the Captivate Program Files

First of all, locate the Infosemantics_CpExtra.js file that was included in the download files for CpExtra. Copy that file.

Next open the following folder.

On Windows: C:\Program Files\Adobe\Adobe Captivate 9 x64\HTML\assets

On MAC: Applications/Adobe Captivate 9/HTML/assets

Create a new folder named libraries. Paste the Infosemantics_CpExtra.js into the new libraries folder.

Move up two folders. You should now be in a folder named HTML. There should be a file named index.html. Copy that file and paste a copy of it into the same folder. Name that file index_old.html. We will be making modifications to the original index.html file. If after these edits you find that Captivate does not work properly, return to this file, delete index.html and then rename index_old.html back to index.html. This should restore your installation of Captivate back to its original condition.

Open the index.html file in a text editor such as notepad. Note: You may need to run the text editor as an administrator to make changes to this file.

Find the line of code that reads: var lJSFiles = [ @JSFILES_ARRAY ]; 

Rewrite the code to be: var lJSFiles = [ @JSFILES_ARRAY , 'assets/libraries/Infosemantics_CpExtra.js' ];

Important note: The space between @JSFILES_ARRAY and the comma that follows it is absolutely essential. If there is no space, then any Captivate HTML5 projects will fail to load entirely.

Another important note: Make sure that you use forwardslashes (/) in the file path rather than backslashes (\). Writing the path as 'assets\libraries\Infosemantics_CpExtra.js' will cause an error which prevents the Captivate project from loading. Forwardslashes (/) are your friends.

Save the file and close.

If administrator privledges prevent you from saving the file inside of the Captivate program files, copy the index.html file onto your desktop, make the changes there, then copy it back into the program files.

From now on, any HTML5 projects you publish will automatically include CpExtra.

When you download an update for Cp Extra, don't forget to replace the Infosemantics_CpExtra.js file located inside of the Captivate program files.

IF YOU LIKE WHAT YOU'VE READ ABOVE, THERE'S PLENTY MORE!

Join more than 2500 other Adobe Captivate users just like yourself and receive regular troubleshooting tips, illustrated tutorials, technical information, and creative solutions to real-world e-learning development issues. (See an example here.) Click the button below to join our community.  It's completely FREE!