Hoe installeer ik het project

• Zet een Apache/Nginx webserver met PHP7.4 en MySQL (MariaDB) klaar. Ga dan naar de web folder van je webserver (www, htdocs, enz.) Voer dan vanaf die map het volgende commando in de terminal uit:

  git clone https://github.com/StevenVanRosendaal/curio-uitleensysteem.git

• Maak een database genaamd "uitleensysteem" aan met een gekoppelde nieuwe gebruiker. Het kan ook gedaan worden door de volgende queries uit te voeren over de database:

  CREATE DATABASE uitleensysteem;

  GRANT ALL PRIVILEGES ON uitleensysteem.* TO 'curio_uitleensysteem_admin'@'localhost' identified by '[VUL HIER EEN WACHTWOORD IN]';

  FLUSH PRIVILEGES;

• Kopieer in de root folder van dit project de .env.example file als .env in dezelfde (root) folder. Of voer het volgende commando uit:

  cp .env.example .env

• Open de .env file in een text editor, en zet de instellingen voor de database goed. Gebruik username "uitleensysteem" en het wachtwoord zoals dat in de vorige stap ingesteld is.

• Voer de volgende terminal commando's uit in de root folder van dit project

  composer install

  php artisan key:generate

  npm install

  php artisan storage:link

  npm run prod

  php artisan migrate:fresh

  sudo chown -R www-data:www-data /path/to/your/laravel/root/directory

  sudo find /path/to/your/laravel/root/directory -type f -exec chmod 644 {} \;

  sudo find /path/to/your/laravel/root/directory -type d -exec chmod 755 {} \;

  (Vervang hierboven het stukje /path/to/your/laravel/root/directory naar het pad van de root folder waar dit project in staat. Dit is de folder waar ook de .env file in staat.)

• De site zou nu moeten draaien. Stel je webserver zo in dat er met een URL de site bereikt kan worden. Open dan met de browser die URL.

Inloggen

De login wordt geregeld via Curio Codes. Je moet daarom de waardes in de .env file aanpassen zodat deze werkt voor jouw applicatie. Maak een nieuwe API key aan in Curio Codes, en noteer de Client ID en de Client Secret. Vul deze twee waardes in, in de .env file bij AMO_CLIENT_ID en AMO_CLIENT_SECRET. Laat de rest van de waardes zoals ze al in de .env file staan. Je zou nu in moeten kunnen loggen met je Curio Codes account.

Image Optimizer

Het uitleensysteem komt met een image optimizer die plaatjes verkleint zodat er ruimte op de server schijf wordt bespaard. Zodat dit tooltje werkt, moet het volgende commando als super user uit worden gevoerd op de server:

sudo apt-get install jpegoptim optipng pngquant gifsicle webp

Dit installeert de pakketten die de optimizer gebruikt om de plaatjes te optimalizeren.

Image Import

Voor de image import is het vereist dat php om kan gaan met .zip files. Daarom is de php-zip extensie vereist op de server. Gebruik het volgende commando om deze te installeren.

sudo apt-get install phpx.x-zip -y

Vervang de x.x door het versienummer van php wat momenteel draait op de server.

Credits

Het Curio Uitleensysteem is ontwikkeld door Steven van Rosendaal van Curio Breda. Voor vragen, stuur een mail naar s.vanrosendaal@curio.nl