https://github.com/debruine/experimentum
Web-based software for building, deploying, and managing psychology studies http://doi.org/10.5281/zenodo.4010579
https://github.com/debruine/experimentum
experiment online psychology
Last synced: 6 months ago
JSON representation
Web-based software for building, deploying, and managing psychology studies http://doi.org/10.5281/zenodo.4010579
- Host: GitHub
- URL: https://github.com/debruine/experimentum
- Owner: debruine
- Created: 2018-10-14T16:15:13.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-05-14T11:02:31.000Z (over 3 years ago)
- Last Synced: 2025-04-18T23:54:31.299Z (6 months ago)
- Topics: experiment, online, psychology
- Language: PHP
- Homepage: https://debruine.github.io/experimentum/
- Size: 82.6 MB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- Citation: CITATION
Awesome Lists containing this project
README
# Experimentum
## Install Experimentum
From the terminal, go to the directory where you want to keep the experimentum files. For example, if you want to keep the files in a directory called `html` in your home folder, type:
```
cd ~/html/
```
Clone Experimetum
```
git clone https://github.com/debruine/experimentum.git
```
You can rename the directory from `experimentum` to the name of your website.
## Server Setup (Mac OS X)
Install XCode
```
xcode-select --install
```
Install Homebrew
You may be asked to change permissions on `/usr/local/Cellar`. Do this and re-run the command below.
```
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
Install Homebrew core
```
brew tap homebrew/homebrew-core
```
Unload old PHP/Apache and install via homebrew
There will be a few minutes of installation and output while dependencies are installed.
```
sudo apachectl stop
sudo launchctl unload -w /System/Library/LaunchDaemons/org.apache.httpd.plist 2>/dev/null
brew install httpd24
brew services start httpd
brew install php72
```
At the end of installation, you will get some output that starts with:
```
==> php@7.2
To enable PHP in Apache add the following to httpd.conf and restart Apache:
```
Copy this text and edit httpd.conf file. We'll edit this with `nano`; if you have a preferred editor, use that instead.
```
nano /usr/local/etc/httpd/httpd.conf
```
Search for `DocumentRoot` using control-W. Change it to the directory you put the experimentum directory inside. Also add MultiViews to the as below.
```
DocumentRoot "/Users/lisad/html"
#
# Possible values for the Options directive are "None", "All",
# or any combination of:
# Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
#
# Note that "MultiViews" must be named *explicitly* --- "Options All"
# doesn't give it to you.
#
# The Options directive is both complicated and important. Please see
# http://httpd.apache.org/docs/2.4/mod/core.html#options
# for more information.
#
Options Indexes FollowSymLinks MultiViews
MultiviewsMatch Any
#
# AllowOverride controls what directives may be placed in .htaccess files.
# It can be "All", "None", or any combination of the keywords:
# AllowOverride FileInfo AuthConfig Limit
#
AllowOverride None
#
# Controls who can get stuff from this server.
#
Require all granted
Allow from 127.0.0.1
```
Search for `php7_module` using control-W. Replace it with the text you copied. If you don't find that, go to the end of the file (control-V until you get there) and add the text you copied (which will look something like this):
```
LoadModule php7_module /usr/local/opt/php@7.2/lib/httpd/modules/libphp7.so
SetHandler application/x-httpd-php
```
Search for `DirectoryIndex` (ctrl-W) and edit it to look like:
```
DirectoryIndex index.php index.html
```
Search for `mod_negotiation` and make sure this line is not commented (remove the #).
```
LoadModule negotiation_module lib/httpd/modules/mod_negotiation.so
```
Save this file and exit (crtl-O, ctrl-X).
Set date.timezone in `php.ini`
```
nano /usr/local/etc/php/7.2/php.ini
```
Search for "date.timezone" using control-W. Look up your timezone at https://www.php.net/manual/en/timezones.php and set `date.timezone` (e.g., `date.timezone = Europe/London`). Save with control-O and exit with control-X.
Edit hosts file
```
sudo nano /etc/hosts
```
Do not delete anything, just add a line with the URL of your new test site, e.g.:
```
127.0.0.1 experimentum.test
```
Save with ctrl-O, ctrl-X
Edit the vhosts file
```
nano /usr/local/etc/httpd/extra/httpd-vhosts.conf
```
Edit the first example for your test server. The important parts are getting the ServerName the same as in the hosts file and the DocumentRoot the same the directory where you put Experimentum in Step 1 (you may have renamed the directory). It should look something like this:
```
ServerAdmin experimentum@glasgow.ac.uk
DocumentRoot "/Users/lisad/html/experimentum"
ServerName experimentum.test
ErrorLog "/private/var/log/apache2/experimentum-error_log"
CustomLog "/private/var/log/apache2/experimentum-access_log" common
```
Restart apache
```
brew services start httpd
```
## Databases
Install MariaDB
```
brew install mariadb
```
Lunch MariaDB
```
brew services start mariadb
```
Set your admin password
```
mysqladmin -u root password 'MYPASSWORD'
```
Create databases:
Go to the directory where you saved experimentum and into the `setup/mysql` directory
```
cd /Users/lisad/experimentum/setup/mysql
```
Create the exp database
```
mysql -u root -pMYPASSWORD
CREATE DATABASE exp;
USE exp;
\. exp_setup.sql
```
Edit config file:
Change `config_edit_this.php` to `config.php` and edit everything with `**EDIT THIS**`
Set the MYSQL_USER to `root` and MYSQL_PSWD` to the admin password you set above for both researchers and users (for your test site only). For your actual site, create MySQL users for researchers and users who have appropriate permissions (*LISA EDIT THIS*).
Look at your website at http://name.test:8080
Sign up for an account, requesting researcher status.
Log into MySQL from the command line:
```
mysql -u root -p
USE exp;
SELECT * from user;
UPDATE user SET status = "admin" WHERE user_id = 1;
```
Log out and log back into your website. It should take you straight to the resaercher section.