Skip to content

tahirdotz/EL

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EventLink is a comprehensive web platform designed to connect university students with campus events, enabling easy event discovery, registration, participation tracking, and achievement recognition.

Key Features

Student Features

  • Authentication System – Secure signup/login with email verification and password reset
  • Event Discovery – Browse events with advanced filters (university, department, category, date)
  • Event Registration – Seamless registration flow with payment integration
  • My Events Dashboard – Track upcoming and past event participations
  • Achievements & Points – Earn points for participation (10pts) and winning (20pts)
  • Title System – Progress from Bronze → Silver → Gold based on points
  • Certificates – Downloadable PDF certificates with unique codes
  • Leaderboard – Compete with fellow students
  • Profile Management – Edit personal info, interests, and view statistics
  • Notifications – SMS and in-app notifications via Banglalink Applink
  • Subscriber Discounts – Automatic discount application for subscribers

Admin Features

  • Event Management – Create, edit, delete, and moderate events
  • User Management – View, block/unblock users, track participation
  • Registration Management – View all registrations and payments
  • Payment Tracking – Monitor transactions, apply discounts, issue refunds
  • Rewards Management – Approve achievements, adjust points, generate certificates
  • Analytics Dashboard – View stats on events, revenue, participation
  • Notification System – Send SMS/USSD via Banglalink Applink APIs
  • Platform Settings – Configure branding, payment gateways, point rules

Design & Theme

  • Color Scheme: Black (#000000) + Orange (#FF6600)
  • Framework: MDBootstrap for Material Design UI
  • Responsive: Mobile-first design with bottom navigation for mobile
  • Desktop: Professional navbar with sidebar dashboard
  • Mobile: App-like experience with smooth transitions

Technology Stack

  • Frontend: PHP, HTML5, CSS3, JavaScript
  • UI Framework: MDBootstrap 6.4.2
  • Backend: PHP 7.4+
  • Database: MySQL 5.7+
  • Server: Apache (XAMPP recommended)
  • APIs: Banglalink Applink (SMS, USSD, CAAS, Payments)

Project Structure

Event Link/
├── admin/                      # Admin panel files
│   ├── dashboard.php          # Admin dashboard
│   ├── events.php             # Event management
│   ├── users.php              # User management
│   ├── payments.php           # Payment tracking
│   ├── achievements.php       # Rewards management
│   ├── analytics.php          # Reports & analytics
│   ├── settings.php           # Platform settings
│   └── login.php              # Admin login
├── api/                       # API endpoints
│   ├── get-departments.php    # Get departments by university
│   └── ...
├── assets/                    # Static assets
│   ├── css/
│   │   └── style.css          # Custom styles
│   ├── js/                    # JavaScript files
│   └── img/                   # Images and icons
├── config/                    # Configuration files
│   └── config.php             # Main configuration
├── database/                  # Database files
│   └── schema.sql             # Database schema
├── includes/                  # Shared PHP includes
│   ├── database.php           # Database connection class
│   ├── functions.php          # Helper functions
│   ├── header.php             # Header template
│   └── footer.php             # Footer template
├── uploads/                   # User uploaded files
│   ├── posters/               # Event posters
│   ├── certificates/          # Generated certificates
│   └── profiles/              # Profile images
├── index.php                  # Home page
├── events.php                 # Event listing
├── event-details.php          # Event details
├── login.php                  # User login
├── signup.php                 # User registration
├── forgot-password.php        # Password reset request
├── reset-password.php         # Password reset form
├── logout.php                 # Logout
├── profile.php                # User profile
├── my-events.php              # User's registered events
├── achievements.php           # User achievements
├── certificates.php           # User certificates
├── leaderboard.php            # Global leaderboard
└── README.md                  # This file

Installation Guide

Prerequisites

  • XAMPP (or any Apache/MySQL/PHP stack)
  • PHP 7.4 or higher
  • MySQL 5.7 or higher
  • Modern web browser

Step 1: Install XAMPP

  1. Download XAMPP from https://www.apachefriends.org/
  2. Install XAMPP to C:\xampp\
  3. Start Apache and MySQL from XAMPP Control Panel

Step 2: Setup Project Files

  1. The project is already in C:\xampp\htdocs\Event Link
  2. No need to copy files

Step 3: Create Database

  1. Open phpMyAdmin: http://localhost/phpmyadmin
  2. Create a new database named eventlink
  3. Click on the eventlink database
  4. Go to "Import" tab
  5. Choose file: C:\xampp\htdocs\Event Link\database\schema.sql
  6. Click "Go" to execute the SQL

Step 4: Configure Database Connection

Open config/config.php and verify database credentials:

define('DB_HOST', 'localhost');
define('DB_USER', 'root');
define('DB_PASS', '');  // Default XAMPP has no password
define('DB_NAME', 'eventlink');

Step 5: Set File Permissions

Create necessary directories:

mkdir uploads
mkdir uploads/posters
mkdir uploads/certificates
mkdir uploads/profiles

Step 6: Access the Platform

Step 7: Configure APIs (Optional)

To enable SMS and payment features, add your Banglalink Applink API credentials in config/config.php:

define('SMS_API_KEY', 'your_api_key_here');
define('SMS_API_SECRET', 'your_api_secret_here');
define('PAYMENT_API_KEY', 'your_payment_key_here');
define('PAYMENT_API_SECRET', 'your_payment_secret_here');

Database Schema

Main Tables

  • users – Student accounts
  • admins – Administrator accounts
  • universities – University directory
  • departments – Department listings
  • categories – Event categories
  • events – Event information
  • registrations – Event registrations
  • payments – Payment transactions
  • achievements – User achievements
  • certificates – Generated certificates
  • notifications – Notification history
  • settings – Platform configuration

Default Admin Account

Important: Change the default admin password after first login.

User Journey Flow

  1. Sign Up → Create account with university/department
  2. Browse Events → Filter by category, university, department
  3. View Details → See event information, venue, schedule
  4. Register → Complete registration (payment if required)
  5. Receive Confirmation → SMS + in-app notification
  6. Attend Event → Show up and participate
  7. Earn Points → Automatic points on attendance
  8. Get Certificate → Download PDF certificate
  9. Track Progress → View achievements and leaderboard

Points & Titles System

Points

  • Participation: 10 points
  • Winner: 20 points
  • Runner Up: 15 points

Titles

  • Bronze: 0–49 points
  • Silver: 50–99 points
  • Gold: 100+ points

Configuration Options

  • Payment Gateway: Banglalink Applink CAAS, manual payment options
  • Notification Channels: SMS (via Banglalink API), in-app notifications, email (SMTP)
  • Customization: Branding, point values, title thresholds, discount percentages, file upload limits

License

This project is proprietary software developed for university event management.

Credits

  • UI Framework: MDBootstrap
  • SMS/Payment APIs: Banglalink Applink

Version: 1.0.0
Last Updated: December 7, 2025

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors