Installation

You need to install two plugins in order to use Inokufu Search in your Moodle™ platform:

1. Repository Plugin: this plugin connects your Moodle™ platform to Inokufu Learning Object API. Once installed, you will see Inokufu Search as a new repository in your Moodle™ platform.

2. Text editor Plugin : this plugin adds a button in the text editor to easily search and add a learning object with Inokufu Search. There are currently two plugins : one for Atto text editor and one for TinyMCE.

We offer two options to install those plugins in your Moodle™ platform:

• From a zip file.

• From the plugin Github repository.

  
  

Inokufu Search - Repository plugin

Installation from ZIP file

1. Download the zip file of the plugin from this link.

2. Log in to your Moodle™ platform as an administrator.

3. Go to Site Administration > Plugins > Install plugins.

4. Upload the zip file that you downloaded and follow the on-screen instructions.

5. Fill out and confirm the forms to complete the plugin installation.

Installation from Github

1. Establish a SSH connection to your Moodle™ platform.

2. Clone the source files from this GitHub repository directly into your Moodle™ platform source files.

3. Rename the cloned folder to inokufu.

4. Move the inokufu folder into the repository folder of your Moodle™ installation. Make sure the plugin folder is named inokufu.

5. Log in to your Moodle™ platform as an administrator.

6. Go to Site Administration > Notifications to finalise the plugin installation.

Configuration

Once the plugin has been added to your Moodle™ platform, you'll need to get an API key to connect your plugin to our Learning Object API.

Here are the steps to get an API key:

Create an account

1. Go to Inokufu APIs Gateway

2. Click on "Create an account" and fill out the form. Then validate your email to finalise your registration.

Configure the API

1. Return to the login page and log in.

2. On the homepage, click on "Create an application".

   
   

3. In "Application name", make sure to mention the name of your organisation. In "Description", indicate the purpose of the API for your organisation. Click on "Next".

   
   

4. Select "simple". In type, fill in "web" and click on "Next".

   
   

5. In the search bar that appears on the next screen, select "Learning Object API".

   
   

Subscribe to a plan

1. Once the Learning Object API is selected, our price offers are displayed. If you don't know your needs yet, we advise you to select the "Quota Plan" offer and we will get back to you to study your need.

   
   

2. Click on "Subscribe". You can then leave us a comment.

   
   

3. The procedure is now complete. You can click on "Create the application".

Subscription validation

1. Find the management page of your API by clicking on "Applications" in the menu bar.

   
   

2. In the menu of this space (black bar), click on "Subscription".

3. You can check the status of your subscription. If it says "Waiting", this means that we have not yet validated your subscription.

   
   

4. When the status shows "accepted", you can retrieve your API key. You also receive an email confirming that the subscription has been validated.

5. Click on the "Accepted" status to display the box containing your API key.

   
   

If needed, you can renew your API key.

You can also end your subscription, by clicking on "Revoke".

Add your API key in Moodle

1. Copy the key and go to the "site administration" menu of your Moddle platform.

2. Click on the "Plugin" tab.

3. Scroll down the page to select "Manage Repositories" under "Repositories".

   
   

4. On the line of the API "Inokufu Search", click on "Settings". Make sure the "Enabled and visible" options are selected.

   
   

5. Paste your API key in the intended field and click on "Save".

   
   

   
   

Inokufu Search - Text editor plugin

In order to integrate Inokufu Search into the editor of your Moodle™ platform, you need to install a second plugin.

If you are using the TinyMCE editor, please download the Inokufu Search Moodle TinyMCE plugin.

Otherwise, we recommend installing the Inokufu Search - Atto plugin.

To find out if the TinyMCE editor is enabled on your Moodle™ platform, go to Site administration > Plugins > Text editor > Editor management.

Installation from ZIP

1. Download the text editor plugin zip file:

   • For TinyMCE here,

   • Or for Atto here.

2. Log in to your Moodle™ platform as an administrator.

3. Navigate to Site administration > Plugins > Install plugins.

4. Upload the zip file you downloaded and follow the on-screen instructions.

5. Complete and confirm the forms to finish the plugin installation.

Installation from Github

1. Establish a SSH connection to your Moodle™ platform.

2. Depending the text editor you want to install:

   • For TinyMCE:

     • Clone the source files from this GitHub repository directly into your Moodle™ platform source files.

     • Move the inokufu folder into the lib/editor/tiny/plugins directory of your Moodle installation.

   • For Atto:

     • Clone the source files from this GitHub repository directly into your Moodle™ platform source files.

     • Move the inokufu folder into the lib/editor/atto/plugins directory of your Moodle installation.

3. Ensure that the plugin folder is named inokufu.

4. Log in to your Moodle site as an administrator.

5. Navigate to Site administration > Notifications to finalize the plugin installation.

Configuration

1. After successful installation, navigate to Site administration > Plugins > Text Editors > Atto Toolbar Settings to configure the plugin settings.

   
   

2. In the Toolbar Configuration text field, add a new row : search = inokufu, above the raw files = (...).

3. Save changes, and start using our atto plugin.

Your API is now installed and usable by your users. 🥳