Responsive Resources and Event Management System for small organisations and clubs. Form Generator, Mailer, Certificate Generator and much more :)
We are running a chapter (club) at our college. We organize 20+ events for our 1500+ participants. It was a tedious process to manually make forms, certificates, advertising via mail so we decided to automate that process. Any organization, clubs or institutions looking for a similar service can fork our project and tweak it according to their needs.
What things you need to run the software:
- A web server with PHP preferably Apache2.
- A MySQL Database Server. (Done and tested on 10.4.8-MariaDB)
- Download the latest stable release from here
- Create and Import the Main Database dump for MySQL-MariaDB from here
- Create a Forms Database.
- Copy the files from this repository to a location in the root directory of the web server
- Rename
member/secrets.php_
tomember/secrets_.php
- Update your database credentials, databases names (Main and Forms) and API Keys in
member/secrets.php
andpublic/cds-public.php
- With your Web Server and MySQL server running, visit the site
-
Default Username: admin Default Password: admin
-
- If any error occurs, check your configurations in
member/secrets.php
andpublic/cds-public.php
and try again
- Installation guide for Docker and docker-compose.
- Modify the default values in
docker-compose.yml
,docker/mysql/database.sql
anddocker/secrets_.php
to your requirement. - By default, exposes to host port
8080
. Akrishnaalagiri/rems
andmariadb
container would be configured and deployed. - For only the first time, the stack needs to be restarted due
initdb
in database containers. From the second time, you can directly start the stack.
# From the root of the repository
docker-compose up -d
sleep 60
docker-compose restart
Tested on Apache/2.4.41 (Win64) OpenSSL/1.1.1c PHP/7.3.11 with 10.4.8-MariaDB
A two-ended system (Both for admin and public) that'll automatically generate certificates and make them available for distribution. The admin will have to upload a Certificate Template and a CSV file with Participant Names, Position Awarded, and Event Name. The generated certificates would be later automatically made for distribution.
CDS Public (Collection) | CDS Admin (Generation) | Generated Certificates |
---|---|---|
This is an interface for the databases that are used. The administrator can update, insert and delete values from any table of the databases without having to risk cluttering with the structure or format. The interface is made as generic possible to support future development and extensions.
Database Manager | Modify Tuples | If Error Occurs |
---|---|---|
This tool is used to generate forms for events. Initially, the specifications of the event must be selected and a form is generated with the designated fields and a table is automatically created in forms-db
. The form also has built-in validation for all the fields (emails, URLs, etc) and Markdown support for event descriptions. Once the form is sent out, the entered values are updated in the database.
Form Generator | Sample Generated Form |
---|---|
The mailer can send automatically send emails to a specific mailing list. It supports HTML emails and comes with a pre-designed template. The parameters for the pre-defined template can be modified for the specifications of the organization. There is also a feature to create mailing lists to use with these mailers. A CSV of the emails and names has to be uploaded ana a mailing list is created.
Bulk Mailer Interface | Mailing List Generator | Sample Sent Mail |
---|---|---|
To view all the Responses for generated forms with an option to download the responses as a CSV
.
View Form Responses |
---|
A link shortener that uses the short.io
API to render shortened links for distribution. It can make shortened link either with a custom slug or can automatically generate slugs for links.
Link Shortener with short.io API |
---|
Perhaps our most desired feature, it gives an option to toggle the page between dark mode and light mode. Saves your eyes in the night ๐
Dark Mode Preview |
---|
Krishnakanth Alagiri | Mahalakshumi V |
---|---|
@bearlike | @mahavisvanathan |
Contributors | Profile Links | PR |
---|---|---|
Dhiraj V | dhirajv2000 | #28 |
- Hat tip to anyone whose code was used.