Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lorentzazweena/election-of-student-council-president
"Leadership is not about being in charge, it's about taking care of those in your charge. Vote wisely, for your vote shapes the future of our school and the leaders of tomorrow."
https://github.com/lorentzazweena/election-of-student-council-president
php web-application
Last synced: about 7 hours ago
JSON representation
"Leadership is not about being in charge, it's about taking care of those in your charge. Vote wisely, for your vote shapes the future of our school and the leaders of tomorrow."
- Host: GitHub
- URL: https://github.com/lorentzazweena/election-of-student-council-president
- Owner: LorentzaZweena
- Created: 2024-09-04T12:19:24.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-09-05T01:43:23.000Z (5 months ago)
- Last Synced: 2024-09-06T14:10:34.146Z (5 months ago)
- Topics: php, web-application
- Language: CSS
- Homepage:
- Size: 1.13 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Election of Student Council President
This project is a web-based application built using PHP native to manage the election of a student council president. It allows students to cast votes for their preferred candidates, view real-time voting results, and see an overview of the voting process.
## Features
- **Voting System**: Students can vote for their desired candidate, with each vote properly recorded in the database.
- **Candidate List**: Displays a list of candidates, with each candidate's details (e.g., name, picture, and bio).
- **Vote Count**: Each vote increments the candidate's total in the database.
- **Modal Popup for Confirmation**: After voting, a modal popup displays the chosen candidate’s name.
- **Real-Time Results**: Results are displayed using Chart.js in the form of a pie chart, showcasing live voting statistics.
- **Bootstrap Alerts**: Notifications are provided to the users for actions such as successful voting, errors, or other interactions.
## Technologies Used
- **PHP** (Native): Core backend logic.
- **MySQL**: Database to store votes, candidates, and results.
- **AJAX**: For seamless voting experience without page reload.
- **Chart.js**: To visualize the voting results in a pie chart.
- **Bootstrap**: For responsive design and alerts.
## Installation
1. Clone the repository:
```bash
git clone https://github.com/LorentzaZweena/election-of-student-council-president.git
```
2. Move to the project directory:
```bash
cd election-of-student-council-president
```
3. Create a database in MySQL:
```sql
CREATE DATABASE student_council_election;
```
4. Import the database from the provided SQL file:
```bash
mysql -u LorentzaZweena -p student_council_election < database.sql
```
5. Configure the database connection in the project:
- Open `config.php` and update the database credentials.
6. Run the application on your local server:
- Use a local server like XAMPP or WAMP to host the project.
- Move the project files to the `htdocs` folder and visit `http://localhost/election-of-student-council-president` to access the application.
## Usage
- **Admin Panel**: Add, edit, and manage candidate details. Admin can also reset the votes and view detailed reports.
- **Student Voting**: Each student is allowed to vote once. After voting, the student is shown a confirmation modal with their chosen candidate’s details.
- **Results Page**: Displays real-time voting results in a visual format.
## Contributing
Feel free to fork this repository and submit pull requests for any enhancements or bug fixes. Contributions are welcome!
## License
This project is open-source and available under the [MIT License](LICENSE).