🗳️ Sistem Pengundian Elektronik (e-Vote) — Online Voting System

A complete, ready-to-deploy online voting application designed for schools, colleges, universities, and organizations. This white-label system lets you rebrand everything > app name, banner, footer, theme colors, fonts, with just one configuration file. No modifications to the core code required.

✨ Key Features

🎨 White-Label & Theming

• Fully rebrandable: app name, banner text, subtitle, and footer text controlled from a single config.php
• 3 built-in themes (Classic Elegant, Modern Blue, Dark Mode) — switch with one line
• No image dependencies — all themes use pure CSS gradients, patterns, and colors
• Changeable voting deadline, signup toggle, and session timeout from config

📱 Mobile Responsive

• Works perfectly on phones, tablets, and desktops
• Responsive navigation with hamburger menu on mobile
• Tables and forms automatically adapt to small screens
• Fluid typography scales across all devices

🗳️ Complete Voting System

• Voter registration (manual signup or bulk TXT import)
• Candidate registration with photo upload
• Unlimited vote positions (e.g., President, Vice President, Secretary)
• One vote per voter per position (prevents duplicate voting)
• Live countdown timer to voting deadline
• Admin cannot vote — separate admin and voter roles

📊 Election Reports

• View results filtered by position or full results
• Automatically highlights the winning candidate(s) per position
• Vote counts displayed for every candidate
• Print-friendly report layout

🛡️ Security-First Design

• Bcrypt password hashing (never stored in plaintext)
• SQL injection protection — all queries use prepared statements
• CSRF token protection on every form
• XSS prevention — all output escaped
• Secure session management with HttpOnly cookies and timeout
• Admin-only protected pages

⚙️ System Requirements

• PHP 7.4+ (PHP 8+ recommended)
• MySQL 5.7+ / MariaDB 10.3+
• Any web server (Apache, Nginx) or local dev tool (Laragon, XAMPP)

🚀 Quick Installation (3 Steps)

Step 1 — Create the Database

1. Open phpMyAdmin (or your MySQL client)
2. Create a new database (e.g., evote)
3. Select the database and import db-import.sql (creates tables + default admin/voter accounts)

Step 2 — Upload Files

1. Copy all project files to your web server directory:
   • Laragon/XAMPP → C:\laragon\www\evote\ or htdocs\evote\
   • Online host → public_html / www folder
2. If needed, edit config.php to match your database credentials (host, user, password, database name)

Step 3 — Configure & Launch

1. Open config.php and customize:
   • app_name → your voting app name
   • banner_title / banner_subtitle → your school/organization name
   • theme → style1, style2, or style3
   • voting_deadline → set your election end date/time
2. Open the site in your browser: http://localhost/evote/ or https://yourdomain.com/evote/
3. Login as admin (default: 0123456789 / admin123) — change the password immediately

🔑 Default Accounts (from fresh install)

📁 What’s Included

• Complete PHP source code (no frameworks, no license fees)
• Database import file with default schema
• 3 professionally designed theme stylesheets
• Comprehensive readme.md documentation
• Bulk voter upload feature (TXT format)
• Countdown timer, election reports, print support
• 3-months free updates & download

💰 Perfect For

• School / college club committee elections
• Student council voting
• Organization & association committee ballots
• Club president/treasurer elections
• Any group needing a simple, secure digital vote

💡 Pro Tips

• Use a MySQL value-added service from your web host — this script uses standard MySQL/MariaDB
• Mobile-friendly — your voters can cast ballots from their phones
• Reuse every term — just update voting_deadline in config.php before each new election