Christmas Invitation Management Tool

Version 1.01 :: Created by Grahf 2024 (Dean Thomson)

Welcome to the Christmas Invitation Management Tool! This web application is designed to help manage the guest list for our upcoming holiday celebration. It provides an intuitive interface to add, edit, and organize guest information efficiently.

Table of Contents

• Features
• Getting Started
  • Prerequisites
  • Installation
• Usage
  • Viewing Guest Lists
  • Adding a New Guest
  • Editing Guest Details
  • Sorting the Lists
  • Deleting a Guest
  • Saving Changes
  • Undoing Actions
  • Exporting the Guest List
• Web Server Configuration
  • Nginx Configuration
  • Apache Configuration
• Security
• Contributing
• License
• Acknowledgments

Features

• Guest Management: Add, edit, and remove guests from the attending or not attending lists.
• Sorting: Sort guests by name or company.
• Data Persistence: Guest data is securely saved and loaded from the server.
• Export Options: Export the guest list as a PDF or Excel spreadsheet.
• Undo Functionality: Undo the most recent action.
• Responsive Design: Optimized for both desktop and mobile devices.

Getting Started

These instructions will help you set up and run the project on your local machine for development and testing purposes.

Prerequisites

• Web Server: Apache, Nginx, or any web server capable of running PHP scripts.
• PHP: Version 7.0 or higher with OpenSSL extension enabled.
• Browser: A modern web browser (Google Chrome, Mozilla Firefox, Microsoft Edge).

Installation

1. Clone the repository:

   git clone https://github.com/grahfmusic/online-christmas-list.git

2. Navigate to the project directory:

   cd christmas-invitation-tool

3. Set up the web server:

   • Place the project files (index.html, save_guest_list.php, load_guest_list.php) in the web server's root directory or a virtual host directory.

4. Set file permissions:

   • Ensure the server has write permissions to create and modify the guest_list.dat file.

   chmod 660 guest_list.dat

5. Configure the encryption key:

   • Open save_guest_list.php and load_guest_list.php.
   • Replace 'your-secret-key' with a strong, secure key.
   • Important: Keep this key confidential and do not expose it publicly.

Usage

Viewing Guest Lists

• The main interface displays two lists:
  • Attending: Guests who have confirmed their attendance.
  • Not Attending: Guests who are not attending.

Adding a New Guest

• To the Attending List:

  1. Click "Add Attendee".
  2. Enter the guest's name.
  3. The guest will appear in the Attending list.

• To the Not Attending List:

  1. Click "Add Not Attending".
  2. Enter the guest's name.
  3. The guest will appear in the Not Attending list.

Editing Guest Details

1. Click the checkbox next to the guest's name to enter edit mode.
2. Edit the Name, Company, and Comments fields.
3. Uncheck the checkbox to save changes.

Sorting the Lists

• Click "Sort by Name" or "Sort by Company" to sort the list accordingly.

Deleting a Guest

• Click the "Delete" button next to the guest's entry.

Saving Changes

• Click "Save List" to save all changes to the server.

Undoing Actions

• Click "Undo" to reverse the most recent action.

Exporting the Guest List

• As PDF: Click "Save as PDF" to download a PDF version.
• As Spreadsheet: Click "Save as Spreadsheet" to download an Excel file.

Web Server Configuration

Nginx Configuration

To set up Nginx to properly handle PHP requests and serve this tool, add the following configuration block to your Nginx server block:

server {
    listen 80;
    server_name yourdomain.com;

    root /path/to/christmas-invitation-tool;
    index index.html index.php;

    location / {
        try_files $uri $uri/ =404;
    }

    location ~ \\.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
    }

    location ~ /guest_list\\.dat$ {
        deny all;
    }
}

Apache Configuration

To set up Apache to properly handle PHP requests and serve this tool, add the following configuration to your virtual host:

<VirtualHost *:80>
    ServerName yourdomain.com
    DocumentRoot /path/to/christmas-invitation-tool

    <Directory /path/to/christmas-invitation-tool>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    <Files "guest_list.dat">
        Require all denied
    </Files>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Security

• Data Encryption: Guest data is encrypted on the server using AES-256-CBC encryption.
• Secure Key Management: The encryption key should be stored securely and not exposed publicly.
• HTTPS Recommended: Use HTTPS to encrypt data transmission between the client and server.

Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository.

2. Create a new branch:

   git checkout -b feature/your-feature-name

3. Commit your changes:

   git commit -m "Add your message"

4. Push to the branch:

   git push origin feature/your-feature-name

5. Open a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Front-End Libraries:
  • jsPDF
  • jsPDF-AutoTable
  • SheetJS (XLSX)
• Fonts:
  • Overpass
  • Ubuntu Mono