Installation

Installation Guide

1. Clone Evoke
2. Get the default config files
3. Humhub default installation
4. Enable Evoke Modules in order
5. Change Humhub design theme for Evoke
6. Additional Setup

1. Clone Evoke

Type in your command line: git clone git@github.com:EvokeNet/humhub.git folder_name

folder_name must be replaced by your humhub folder name

Make sure you are on the stable branch before continuing (this is vanilla humhub).

2. Default Config Files

Create these files and add them to humhub_folder/protected/config/:

2.1 common.php

<?php

  return [
];

2.2 console.php

<?php

  return [
];

2.3 dynamic.php

<?php

  return [
];

2.4 web.php

<?php

  return [
    'modules' => [
      'gii' => [
        'class' => 'yii\gii\Module',
        'allowedIPs' => ['127.0.0.1',  '::1', '192.168.1.*'],
    ],
  ]

];

3. Humhub Default Installation

• Follow the instructions here to install humhub on your server
• Access your humhub url
• You should see the Humhub installation wizard
• Choose your language and click on Next
• You should see the System Check view, correct the issues and click on Check Again until you're able to click on Next
• Configure your database (Ensure it has the same name and user you created in the above installation guide) and click on Next
• Name your app Evoke and click on Next
• Configuration: Choose Skip this step, I want to set up everything manually and click on Next
• Set your admin account data and click on Create Admin Account
• Example Contents: Uncheck Set up example content
• Done! Sign in to continue the Evoke Installation

System Check common issues:

• Permissions: Access in the command line the folder where your humhub folder is located and type this command: sudo chmod -R 777 folder_name

folder_name must be replaced by your humhub folder name

4. Modules Order

• Access Administration page, then click on Modules
• Enable one by one:

1. Evoke MultiLanguage
2. Evoke Matching
3. Evoke Powers
4. Coin
5. Evoke Teams
6. Evoke Achievements
7. Evoke Marketplace
8. Evoke Missions
9. Evoke Library
10. Evoke Stats
11. Evoke Static Pages for Static Content
12. Evoke Alliances
13. Evoke Graphic Novel

5. Change Humhub Design Theme

• Access Administration page, then click on Design
• Change Theme for Evoke and save it

6. Set Up User Groups

You will also need to create a user group for mentors for certain Evoke features to work. To do this, go to the admin panel, then click Groups and Create new group. The Mentors group MUST be called Mentors for the Evoke modules to properly locate it.

7. Additional Setup

1. Ensure the initial flow (survey success page) references the correct default space guid
2. Confirm email settings are correct (email sender, email subject line)
3. Add hidden profile fields via admin for tracking data, such as student id. Set to hidden.
4. Update hard-coded content. Some content is hard-coded: update email file, messages during onboarding, and survey success text.
5. Make sure new players have to read the novel content & complete the survey (setting in admin)
6. Add reference documents to library (how-to, evokation template, etc.)