Installation - slacey/humhub GitHub Wiki

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 [email protected]: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.)

8. References for Troubleshooting

  1. A helpful site for installing GIT on an AWS instance: http://devoncmather.com/setting-aws-ec2-instance-lamp-git/
  2. A good tutorial on starting humhub install: http://linuxpitstop.com/install-humhub-on-ubuntu-15-04/
  3. Alternative humhub installation notes: https://www.phoenixpeca.xyz/how-to-install-humhub-on-ubuntu-16-04-in-digitalocean/
  4. On an ubuntu server, the PHP version should be 5.5, not the latest (as of 12JUL2017) (...see: https://askubuntu.com/questions/761713/how-can-i-downgrade-from-php-7-to-php-5-6-on-ubuntu-16-04
  5. Additionally, you will have to do the following: sudo update-alternatives --set php /usr/bin/php5.6 (...see: https://stackoverflow.com/questions/42619312/switch-php-versions-on-commandline-ubuntu-16-04)
  6. Notes for setting up GitHub synchronizing on an AWS EC2 instance can be found here: https://stackoverflow.com/questions/7832586/setting-up-git-on-ec2-to-pull-from-github-repo
  7. To fix CURL and SSL certificate errors: https://snippets.webaware.com.au/howto/stop-turning-off-curlopt_ssl_verifypeer-and-fix-your-php-config/
  8. To install CURL for PHP: https://askubuntu.com/questions/9293/how-do-i-install-curl-in-php5
  9. Curl for PHP 5.6 must be installed via https://stackoverflow.com/questions/38800606/how-to-install-php-curl-in-ubuntu-16-04: sudo apt-get install php5.6-curl, then sudo service apache2 restart
  10. There may be cases with an error noting “ONLY_FULL_GROUP_BY” that requires disabling; if so, use the second noted solution on the following page: https://stackoverflow.com/questions/23921117/disable-only-full-group-by
  11. If images cannot load, try http://www.php.net/manual/en/image.installation.php to install gd 12.If updating from GIT and a database table needs to be added, you need a humhub command that needs to be executed to create tables. Basically, you go to protect folder and run php yii migrate/up --includeModuleMigrations=1