https://github.com/cphyc/easy_poll
A polling web service for professors
https://github.com/cphyc/easy_poll
enseignement interactive poll professor student-management students
Last synced: 5 months ago
JSON representation
A polling web service for professors
- Host: GitHub
- URL: https://github.com/cphyc/easy_poll
- Owner: cphyc
- License: lgpl-3.0
- Created: 2016-01-13T08:44:36.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-05-03T11:59:33.000Z (about 4 years ago)
- Last Synced: 2024-11-09T19:46:41.055Z (7 months ago)
- Topics: enseignement, interactive, poll, professor, student-management, students
- Language: JavaScript
- Size: 231 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
README
# easy_poll
A polling web service for professors.
This tool let professors create interactively nice polls, export and view the results.
## Features:
* Easy-to-use front-end
* Export results as .csv files (compatible with Excel, LibreOffice Calc, …)
* Administrator accounts, student accounts
* Prevent students from answering twice
*
## Requirements:
You need to install Node.js v8 or above (see https://nodejs.org/) and mongodb (see https://www.mongodb.org/) as well as a python2 distribution (https://python.org)
**Optional**: install git (https://git-scm.com/).
## Install (Linux, command line users)
First, get a copy of the software:
```bash
# Go to the directory where you want to install it
cd /path/to/install/directory
# Get a copy of the software
git clone https://github.com/cphyc/easy_poll.git
# if you don't have git, you can do the three following steps:
wget https://github.com/cphyc/easy_poll/archive/master.zip
unzip master.zip
mv easy_poll-master easy_poll
# Get into the newly installed directory
cd easy_poll
# Install dependencies automatically
npm install
```
## Install (other platform)
This has *not* been tested until now. Post a pull-request [here](https://github.com/cphyc/easy_poll/pulls).
## Configure
Open the file `server/config/local.env.sample.js`.
- Replace `DOMAIN`'s value (http://localhost:9000) by your domain name (for example: http://mydomain.com).
- Replace `SESSION_SECRET` by some random value (for example [here](https://duckduckgo.com/?q=random+password&ia=answer)).
- If you want to enable login through google accounts, change `GOOGLE_ID` and `GOOGLE_SECRET` to match your google credentials.
- Replace `ROOTS` by a comma-separated list of objects (objects are delimited by '{}') containing a name, a password and an optional email address.
### Extra configurations
You can pass extra configurations to the server using environment variables. Here is a list of environment variables you can change:
- `PORT` the port on which to serve (defaults to 9000)
- `IP`: ip to accept connections froms (default to 0.0.0.0, serve only from local)
- `GOOGLE_ID`: google login id (same as in previous paragraph)
- `GOOGLE_SECRET`: google login secret key
## Start the server
In the command line, go into the install directory and start the server:
```bash
cd /path/to/install/directory/easy_poll
# Do this if you want to test
grunt serve
# Do this if you want to use it
grunt serve:dist
```
The server should start. You can then access it at .
# Remarks
Is is not advised to serve directly for the Internet. Instead, you'd rather serve it through a webserver (Apache, nginx). Here is a sample configuration for Apache with the application served on port 9000
```apache
ServerAdmin
ServerName
ProxyPass / http://localhost:9000/
ProxyPassReverse / http://localhost:9000/
#Logfiles
ErrorLog
```
You can then access your site at ``.
# License
The program is provided under the GNU Lesser Leneral Public License. See the LICENSE file for more information.