https://github.com/csev/apps

The top level page for umsi apps
https://github.com/csev/apps

Last synced: 6 days ago
JSON representation

The top level page for umsi apps

• Host: GitHub
• URL: https://github.com/csev/apps
• Owner: csev
• Created: 2019-11-17T15:29:43.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-10-28T14:28:03.000Z (16 days ago)
• Last Synced: 2024-10-28T17:20:26.150Z (16 days ago)
• Language: PHP
• Size: 21.5 KB
• Stars: 1
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
UMSI Learning Applications

==========================

Course materials for apps.sites.uofmhosting.net

Setup On Localhost

------------------

Here are the steps to set this up on localhost on a Macintosh using MAMP.

Install MAMP (or similar) using https://www.wa4e.com/install

Check out this repo into a top level folder in htdocs

    cd /Applications/MAMP/htdocs

    git clone https://github.com/csev/apps.git

Go into the newly checked out folder and get a copy of Tsugi:

    cd apps

    git clone https://github.com/csev/tsugi.git

Create a database in your SQL server:

    CREATE DATABASE tsugi DEFAULT CHARACTER SET utf8;

    GRANT ALL ON tsugi.* TO 'ltiuser'@'localhost' IDENTIFIED BY 'ltipassword';

    GRANT ALL ON tsugi.* TO 'ltiuser'@'127.0.0.1' IDENTIFIED BY 'ltipassword';

Still in the tsugi folder set up config.php:

    cp config-dist.php config.php

Edit the config.php file, scroll through and set up all the variables.  As you scroll through the file

some of the following values are the values I use on my MAMP:

    $wwwroot = 'http://localhost:8888/apps/tsugi';   // Embedded Tsugi localhost

    

    ...

    

    $CFG->pdo = 'mysql:host=127.0.0.1;port=8889;dbname=tsugi'; // MAMP

    $CFG->dbuser    = 'ltiuser';

    $CFG->dbpass    = 'ltipassword';

    

    ...

    

    $CFG->adminpw = 'short';

    

    ...

    

    $CFG->apphome = 'http://localhost:8888/apps';

    $CFG->context_title = "Web Applications for Everybody";

    $CFG->lessons = $CFG->dirroot.'/../lessons.json';

    

    ... 

    

    $CFG->tool_folders = array("admin", "../tools", "../mod");

    $CFG->install_folder = $CFG->dirroot.'./../mod'; // Tsugi as a store

    

    ...

    

    $CFG->servicename = 'UMSI Apps';

Then go to https://console.developers.google.com/apis/credentials and

create an "OAuth Client ID".  Make it a "Web Application", give it a name,

put the following into "Authorized JavaScript Origins":

        http://localhost

And these into Authorized redirect URIs:

    http://localhost/apps/tsugi/login.php

    http://localhost/apps/tsugi/login

Note: You do not need port numbers for either of these values in your Google

configuration.

Google will give you a 'client ID' and 'client secret', add them to `config.php`

as follows:

    $CFG->google_client_id = '96..snip..oogleusercontent.com';

    $CFG->google_client_secret = 'R6..snip..29a';

While you are there, you could "Create credentials", select "API

key", and name the key "My Google MAP API Key" and put the API

key into `config.php` like the following:

    $CFG->google_map_api_key = 'AIza..snip..9e8';

Starting the Application

------------------------

After the above configuration is done, navigate to your application:

    http://localhost:8888/apps/

It should complain that you have not created tables and suggest you 

use the Admin console to do that:

    http://localhost:8888/apps/tsugi/admin

It will demand the `$CFG->adminpw` from `config.php` (above) before 

unlocking the admin console.  Run the "Upgrade Database" option and

it should create lots of tables in the database and the red warning

message about bad database, should go away.

Got into the database and the `lti_key` table, find the row with the `key_key`

of google.com and put a value in the `secret` column - anything will do - 

just don't leave it empty or the internal LTI tools will not launch.

Next use the administrator interface to install the peer-grading tool

from the github repository:

    http://localhost:8888/apps/tsugi/admin/install

Click on "Available Modules" and install https://github.com/tsugitools/peer-grade

Using the Application

---------------------

Navigate to:

    http://localhost:8888/apps/

You should click around without logging in and see if things work.

Then log in with your Google account and the UI should change.  In particular you should

see 'Assignments' and in Lessons you should start seeing LTI autograders.