Jeu de mots

Introduction

This is a client-server solution to host jokes using Angular and PHP/MySQL. Two alternative React/Vue clients are work in progress. The project is deployed at https://jeudemots.42borgata.com,

Angular Frontend | Slideshow capture

Project files

This repository contains source code for different parts of the project:

• server: backend PHP sources files
• client/ng: main Angular frontend sources

WIP:

• client/react-js: alternative React frontend sources (deployed at https://jeudemots.42borgata.com/react)
• client/vue: alternative Vue frontend sources (deployed at https://jeudemots.42borgata.com/vue)
• client/shared: shared code and resources.

Development

Prerequisites

Install the following dependencies:

sudo apt install nodejs npm php libapache2-mod-php php-mysql php-cli

And install the project

npm install

npm run build

Launches the build of the subprojects (server, angular/react frontends). Produce a ./build subfolder in each subprojectfolder (see in client/).

note: the first time, before launching the command, you need to duplicate server/config.sample.php, rename it to config.prod.php and replace the data inside the file with your credentials (depends on your server config). If not, the server build will fail.

npm run pack

Copy the last build files from all subprojects to a global ./dist folder. This folder will contain the files you need to copy to your web server to get the application to work.

note: The first time you will need to install the database. To do that, sign in to the admin page (add /adminto the URL), go to the installation section and click on install. Then, you can optionally restore a previously backed up file.

History

This project started in 2015 during my training at Montpellier Institute of Technology (France), it was developed using AngularJS 1.7.x and has been translated for Angular 2+ in 2019. The old AngularJS repository is still available here).

Later in 2022, I decided to implement a backend in PHP8 to store jokes as a MySQL relational database instead of a JSON file. Additionally, the admin can install/uninstall and restore/backup the table content. After that, I also started to implement alternative frontends using React and Vue, those are still WIP.