Follow the steps below to install Portflow on your Moodle instance and send over the required details to Drieam to complete the installation.

Installation

I. Add an External Tool

1. Navigate to the Moodle Plugins
   Site administration → Plugins → Manage tools

   

2. Click Configure a tool manually.

3. Fill out the following details

   1. Tool settings

b. Services

c. Privacy

d. Miscellaneous

4. When you’re done, go back to the page Manage tools. You’ll see a new tool in the list.

5. Click on the icon View configuration details.

6. Send over all details to Drieam.

II. Add Portflow Tool

1. Navigate to the homepage

2. Enable Edit Mode

3. Click Add activity or resource

4. Select Portflow

5. Activity Name: Portflow

6. Under Common Module Settings set Availability to Make available but don't show in course page.

7. Click Save and return to course

8. Hover over or open the tool and note the activity ID from the URL
   (last part of the URL, e.g. /mod/lti/view.php?id=## where ## is the activity ID)

9. Send Drieam the activity ID.

III. Allow authenticated users to launch Portflow

In order to allow authenticated users to launch Portflow placed on the site home, we need to change a permission.

1. Click Participants on the homepage

2. In the dropdown, select Permissions

3. For Advanced role override, select Authenticated user on site home

   

4. Find Launch external tool activities (scroll down or use the filter)

   

5. Select Allow

6. Click Save changes

IV. Add Portflow to the navigation

In order to open Portflow, add a link in the main navigation.

1. Go to Site administration → Appearance → Theme settings

2. In the field Custom menu items, add a new line: Portflow|/mod/lti/view.php?id=##

   Replace "##" with the noted activity ID (step II.8).

Send required details to Drieam

Please send over the following information to support@drieam.com, allowing us to complete the installation:

1. Configuration details (step I)

   1. Platform ID

   2. Client ID

   3. Deployment ID

   4. Public keyset URL

   5. Access token URL

   6. Authentication request URL

2. URL of Portflow in Moodle

3. The full URL of Portflow in your Moodle environment, which should look something like this:

   https://[instance-url]/mod/lti/view.php?id=[#]

   Make sure to include the instance URL and the activity ID

4. Primary default language and optional secondary languages (see below)

Optimisation for Portflow in Moodle

To allow Portflow to make use of all available space, you might want to adjust some CSS in Moodle. We have provided an example below.

1. Go to Site administration → Appearance → Boost → Advanced settings (or if another theme is applied, choose that instead of "Boost").

2. In Raw SCSS, add the code below (use the code piece that is relevant to your Moodle version):

/* CSS code for Portflow in Moodle 4.1 */
.cmid-## {
 #topofscroll {
    padding: 0;
 }
 #page.drawers div[role=main] {
    padding: 0;
    height: 100%;

    iframe {
       border: none;
       border-radius: 0;
       position: absolute;
       height: 100% !important;
    }
 }
 #page.drawers .main-inner {
    margin: 0;
    padding: 0;
 }
 #page {
    padding-left: 0;
    padding-right: 0;
 }
 #page-header {
    display: none;
 }
 #page-footer {
    display: none;
 }
 #page-content {
    padding: 0 !important;
    height: 100%;
  }
 .secondary-navigation {
    display: none;
 }
 #region-main-box {
    height: 100%;
 }
 #region-main {
    height: 100%;
 }
 #maincontent {
    display: none;
 }
}

/* CSS code for Portflow in Moodle 4.5 */
.cmid-## {
 #topofscroll {
    padding: 0;
 }
 #page.drawers div[role=main] {
    padding: 0;
    height: 100%;

    iframe {
       border: none;
       border-radius: 0;
       position: absolute;
    }
 }
 #page.drawers .main-inner {
    margin: 0;
    padding: 0;
 }
 #page {
    padding-left: 0;
    padding-right: 0;
 }
 #page-header {
    display: none;
 }
 #page-footer {
    display: none;
 }
 #page-content {
    padding: 0 !important;
    height: 100%;
  }
 .secondary-navigation {
    display: none;
 }
 #region-main-box {
    height: 100%;
 }
 #region-main {
    height: 100%;
 }
 #maincontent {
    display: none;
 }
 .activity-header {
    margin: 0 !important;
 }
}