ℹ️ Introduction: European Digital Credentials for Learning

This is a web application designed for managing and exporting JSON files to obtain microcredentials using the “European Digital Credentials for Learning” (EDC) system.

The project includes optional integration with the Moodle platform to retrieve user data for credential issuance.

Official Europass Platform: To access the Europass Digital Credentials platform, click on the following link: https://europa.eu/europass/digital-credentials/issuer/#/home

📋 Prerequisites

Ensure your server meets the following requirements before starting the installation.

Server Environment

• Web server (Apache, Nginx, etc.)

• PHP (Recommended version: 8.3 or higher)

• MySQL or MariaDB database

• Console/terminal access to the server.

🛠️ Operating System Dependencies

For the project to function correctly, the following system dependencies must be installed and configured on your server:

1. Image Generation from HTML (wkhtmltoimage)

This tool is required to generate image files (PNG, JPG, etc.) from HTML content.

• Dependency: wkhtmltoimage

• Typical Installation (Debian/Ubuntu):

  The wkhtmltopdf package usually includes both wkhtmltopdf and wkhtmltoimage.

  sudo apt update
  sudo apt install wkhtmltopdf
  

2. PHP ZIP Extension

This PHP extension is essential for handling ZIP file compression and decompression.

• Dependency: php8.3-zip (or the PHP version you are using)

• Typical Installation (Debian/Ubuntu with PHP 8.3):

  sudo apt install php8.3-zip
  sudo systemctl restart apache2  # Or php-fpm, depending on your setup
  

Important: Make sure to replace php8.3-zip with your specific PHP version (e.g., php7.4-zip, php8.2-zip).

🚀 Installation and Configuration

Follow these steps to get the project up and running.

1. Upload Files

Clone the repository or upload all project files to the root folder of your web hosting (for example, public_html, htdocs, or the directory specified by your provider).

2. Database Configuration

The project requires one or two MySQL databases, depending on whether Moodle integration is enabled.

A. Edit the config.php file

Edit the config.php file in the project root and replace the example values with your actual credentials.

Main Configuration:

Application Administrator User:

Moodle Integration (Optional):

If Moodle integration is enabled (HAS_MOODLE set to true):

B. Create the Main Database

To set up the main database structure, you have two options:

Option 1: Run the Script (Recommended)

Run the included create_db.php script from the command line (SSH terminal) in the project’s root directory.

php create_db.php

Note: For this script to work, the DB_HOST, DB_USERNAME, and DB_PASSWORD parameters in config.php must be correct, and the user must have permissions to create databases (CREATE DATABASE).

Option 2: Manual Import

Alternatively, you can import the database.sql file directly using a management tool like phpMyAdmin or by running the following command in your terminal (after creating the database manually):

mysql -u YOUR_USERNAME -p YOUR_DATABASE_NAME < database.sql