Skip to content

Files

Latest commit

 

History

History
77 lines (54 loc) · 3.52 KB

README.md

File metadata and controls

77 lines (54 loc) · 3.52 KB

LTT Team Members Log

Overview

This PHP-based project is designed to monitor changes in the team members listed on a specific webpage. The application periodically scrapes the webpage to detect updates such as additions or removals of team members. It logs these changes over time, providing a detailed history, including when a team member was first seen, and when they were last seen. The current and former members are displayed in a user-friendly interface, along with a chart that shows the number of staff members over time.

Features

  • Web Scraping: Periodically scrapes the specified webpage to detect team member changes.
  • Logging and History Tracking: Logs each team member's first seen date, last seen date, and current status.
  • Chart Visualization: Displays a chart of the total staff count over time using Chart.js.
  • Former and Current Members Overview: Lists current team members, with a dedicated section for former team members.
  • Prioritization: Ensures Linus and Yvonne Ho are always shown at the top of the current members list.

Technologies Used

  • PHP: Server-side language for scraping the webpage, logging, and rendering the interface.
  • JavaScript (Chart.js): For displaying the historical data of staff count over time.
  • HTML/CSS: For structuring and styling the interface.

Installation

  1. Clone the Repository:

    git clone https://github.com/evenwebb/ltt-staff-tracker.git
cd ltt-staff-tracker

  2. Set Up Environment:

    • Ensure you have PHP installed (PHP 7.4 or later recommended).
    • Set up a web server such as Apache or Nginx to serve the PHP files.

  3. Configure the Project:

    • Update the $url variable in scraper.php with the URL of the webpage you want to monitor.

  4. Run the Script:

    • You can run the scraper manually by executing the following command: 
      php scraper.php
    • Optionally, set up a cron job to automate the scraping process.

  5. Access the Dashboard:

    • Navigate to display.php in your browser to view the current and former team members along with the staff count chart.

Usage

  • Manual Scraping: Run php scraper.php to fetch and log the latest team member data.
  • Automated Scraping: Use a cron job to execute the scraper at regular intervals.
  • Dashboard: Open display.php to view the list of current and former team members, along with the staff count chart.

File Structure

  • scraper.php: The main scraper script that fetches and logs team member data.
  • index.php: The user interface that displays the current and former members, as well as the chart of staff count over time.
  • webpage_history.json: Stores the history of all team members, including first and last seen dates.
  • current_members.json: Stores details of the current team members.
  • staff_count.json: Logs the staff count over time for chart visualization.

Example Output

  • Current Team Members: Displays all current members, including their name, role, and image.
  • Former Team Members: Lists all members who have been removed, along with relevant information such as when they were last seen.
  • Staff Count Chart: A line chart showing the change in the number of team members over time.

Contributing

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature-branch).
  3. Commit your changes (git commit -m 'Add a new feature').
  4. Push to the branch (git push origin feature-branch).
  5. Open a pull request.

License

This project is licensed under the MIT License.