Crowdsourcing Web Application

Laravel 5.7 web application for Crowdsourcing Projects and Questionnaires

This project is used by the European Citizen Action Service (ECAS) in order to facilitate questionnaires for the FAIR EU project.

Project URL

Installation Instructions:

First time install (setup database and install dependencies)

Make sure php 7.1.3 (or newer) is installed.

Install graphics library

 sudo apt-get install php7.1-gd

After cloning the project, create an .env file (should be a copy of .env.example), containing the information about your database name and credentials. Then run php artisan migrate to create the DB schema and php artisan db:seed --class=DatabaseSeederRunOnEmptyDB in order to insert the starter data to the DB
Install laravel/back-end dependencies

composer install

Install front-end dependencies

npm install

Create symbolic link for uploaded images By default images are stored at app/storage/public. Run

php artisan storage:link

to link this folder with the public directory

Apache configuration:

The following assumes that the website will be rendered under dev.ecas url. You can edit the /etc/hosts/ file and add a record

127.0.0.1  dev.ecas

% sudo touch /etc/apache2/sites-available/ecas.conf
% sudo nano /etc/apache2/sites-available/ecas.conf
<VirtualHost *:80>
       
        ServerName dev.ecas
        ServerAlias dev.ecas
        DocumentRoot "/home/path/to/project/public"
        <Directory "/home/path/to/project/public">
            Require all granted
            AllowOverride all
        </Directory>
       
        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Make the symbolic link:

% cd /etc/apache2/sites-enabled && sudo ln -s ../sites-available/ecas.conf

Enable mod_rewrite, mod_ssl and restart apache:

% sudo a2enmod rewrite && sudo a2enmod ssl && sudo service apache2 restart

Fix permissions for storage directory:

sudo chown -R user:www-data storage
chmod 775 storage
cd storage/
find . -type f -exec chmod 664 {} \;
find . -type d -exec chmod 775 {} \;

Change host file so ecas.dev points to to localhost

sudo nano /etc/hosts
127.0.0.1       dev.ecas

Social Login - Sign Up with Socialite

This app uses Socialite Laravel Plugin to handle social login.

In order to get it working in your development environment, you need to make sure that you have API keys and secrets for Facebook and Twitter (guides here and here), and that you can access https://dev.ecas/ (notice the https) on your machine.

A guide for enabling https on your local machine can be found here.

Basically, you need to run

openssl req -new -sha256 -newkey rsa:2048 -nodes \
-keyout dev.ecas.key -x509 -days 365 \
-out dev.ecas.crt

And then reference the 2 files generated in the ecas.conf file of the application. Make sure you change the port to 443 as shown below:

% sudo touch /etc/apache2/sites-available/ecas.conf
% sudo nano /etc/apache2/sites-available/ecas.conf
<VirtualHost *:443>
	SSLEngine on
	SSLCertificateFile "/etc/apache2/sites-available/dev.ecas.crt"
	SSLCertificateKeyFile "/etc/apache2/sites-available/dev.ecas.key"

        ServerName dev.ecas
        ServerAlias dev.ecas
        DocumentRoot "/home/alex/Projects/crowdsourcing-platform-backend/public"
        <Directory "/home/alex/Projects/crowdsourcing-platform-backend/public">
            Require all granted
            AllowOverride all
        </Directory>
       
        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Also, make sure to restart Apache, by running

sudo service apache2 restart

Related HTML Template

This project uses the free AdminLTE template. More specifically, it makes use of Laravel-AdminLTE for easier integration.

How to debug

Install and configure Xdebug on your machine
At Chrome install Xdebug helper
At PhpStorm/IntelliJ click the "Start listening for PHP debug connections"

charitablehumans / Crowdsourcing-Platform