Calendar Sync Scraper

Overview

The Calendar Sync Scraper is a WordPress plugin designed to scrape calendar data from a specified URL and synchronize it with Google Calendar. It supports automated scheduling and maintains logs for tracking each run. This plugin enhances event management by integrating external calendar data into your WordPress site seamlessly.

Requirements

• WordPress: Version 5.8 or higher
• PHP: Version 7.4 or higher

Installation

1. Download the plugin from the GitHub repository.
2. Upload the calendar-sync-scraper folder to the /wp-content/plugins/ directory on your WordPress site.
3. Activate the plugin through the 'Plugins' menu in WordPress.
4. Upon activation, the plugin will automatically create necessary database tables and insert initial data.

Usage

• After activation, the plugin sets up an admin interface accessible via the WordPress admin dashboard.
• Configure the scraper settings to specify the target URL and Google Calendar integration details.
• The plugin will periodically scrape data and sync events, with logs available for monitoring.

Features

• Data Scraping: Fetches calendar events from a specified URL.
• Google Calendar Sync: Integrates scraped data with Google Calendar.
• Automated Scheduling: Supports automated event updates.
• Logging: Tracks each run for debugging and auditing.
• Database Management: Creates and manages tables for seasons, regions, age groups, tournament levels, pools, logs, colors, and teams.

File Structure

    calendar-sync-scraper/
    ├── build/
    ├── css/
    ├── includes/
    │   ├── class-admin-ui.php
    │   ├── class-scraper.php
    │   ├── class-logger.php
    │   ├── class-db-init.php
    │   ├── class-data-loader.php
    │   ├── class-google-calendar.php
    │   └── class-events-calendar.php
    ├── node_modules/
    ├── src/
    ├── vendor/
    ├── calendar-sync-scraper.php
    ├── composer.json
    ├── package.json
    

Configuration

Edit the calendar-sync-scraper.php file to adjust plugin constants or include additional configurations. Use the admin UI to set up scraping schedules and Google Calendar credentials.

Contributing

Contributions are welcome! Please fork the repository at https://github.com/ndegwamoche/calendar-sync-scraper and submit pull requests for any improvements or bug fixes.

License

This plugin is licensed under the GPL-2.0-or-later.

Author

• Martin Ndegwa Moche
• GitHub Profile

Support

For issues or questions, please open an issue on the GitHub repository or contact the author directly.

Changelog

• 1.0.0: Initial release with basic scraping, Google Calendar sync, and logging functionality.

Last updated: 06:22 PM EAT, Tuesday, June 24, 2025