Installing Grav CMS ePortfolio Blog on Reclaim

Grav CMS ePortfolio Blog with Git Sync is designed to give tech-savvy students control of their content and publishing workflow using modern open Web services.

Why use the Grav OER Content Space Project?

  • To quickly leverage a modern flat-file CMS (i.e. Grav) for the creation and presentation of OER content
  • To make OER content future-ready by keeping it always directly accessible (vs. within a specific platform)
  • To provide direct access to OER content for site visitors (in Markdown or HTML format) to facilitate easier reuse
  • To support collaboration and version control of OER content with the Git service (e.g. GitHub) of your choice
  • To quickly and easily update OER content online or locally using the tools of your choice
  • To provide a mobile and multi-device friendly visual presentation of your OER content
  • To easily customize the presentation of your OER content using a visual theme builder (i.e. Gantry 5)

The Grav CMS ePortfolio Blog, along with my other Grav open education projects Course Hub and OER Content Space, are also documented at learn.hibbittsdesign.org.

Example ePortfolio Blog workflow

Step-by-Step Video (no audio)



The following install and configuration process usually takes under 5 minutes.

Grav CMS ePortfolio Blog with Git Sync - Install and Configure on Reclaim Hosting

1. Getting Ready

1.1 If you do not already have a Git service account (i.e. GitHub, GitLab, BitBucket, etc.) then sign up for one

1.2 Download ePortfolio Blog skeleton package

From the getgrav.org site at https://getgrav.org/downloads/skeletons or via this direct link: http://hibbittsdesign.org/blog/downloads/grav-skeleton-course-hub-site.zip

1.3 Log into your Reclaim Hosting cPanel and go to the File Manager area

2. Installing the ePortfolio Blog

2.1 Tap the "Upload" button

2.2 Tap "Select File"

2.3 Choose the downloaded ePortfolio Blog ZIP file

2.4 Return to the file listing view

2.5 Right-tap on the Course Hub ZIP file and choose "Extract"

2.6 Tap "Extract File(s)" button

2.7 Tap the "Close" button

2.8 Copy the folder name to your clipboard (but first, change it to what you would like)

2.9 Enter the URL to your ePortfolio Blog

2.10 Complete the Admin config form

2.11 Tap on the arrow-circle to preview site

3. Configure Git Sync Plugin

3.1 Scroll down to the bottom of the page

3.2 Tap on the "Setup Git Sync Plugin" link

3.3 Tap the "Next" button

3.4 Choose the Git service and enter your username and password for it

3.5 Scroll down (if needed) and tap the "Next" button

3.6 Before continuing, you will need to create a repository on your Git service.

If you have already created a Git repository (with at least one commit, for example a ReadMe file) you may skip to step 3.11

3.7 Create a new repository in your choosen Git service (GitHub example shown)

3.8 Enter repository name

3.9 Choose to include a ReadMe file

3.10 Create the new repository

3.11 Copy the HTTPS URL of the repository to your clipboard

3.12 Paste the Git repository HTTPS URL into the "Git Repository" field and tap "Test Connection"

3.13 Tap the "Next" button

3.14 Select the displayed Webhook URL and copy it to your clipboard

3.15 Add the Webhook to your Git repository settings, in GitHub tap "Settings"

3.16 Tap "Webhooks"

3.17 Tap "Add Webhook"

3.18 Paste the copied Course Hub Webhook URL into the "Payload URL" field

3.19 Scroll down, and tap "Webhook"

3.20 Once the new Webhook is displayed, return to your ePortfolio Blog site

3.21 Tap the "Save" button

3.22 Tap the arrow-circle button to once again preview your site

3.23 Scroll down to the bottom of the page

3.24 Ad a final test, tap on the "View Repostory" link

3.25 Open the "pages" folder within your Git repository

3.26 Open the "01.home" folder

3.27 Open the "default.md" file

3.28 The content of the ePortfolio Blog homepage is now displayed in GitHub

4. Congratulations! You now have your ePortfolio Blog with Git Sync installed and configured.

1 Like