PHPackages chrishardie/laravel-calendar-crawler - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. chrishardie/laravel-calendar-crawler ActiveLibrary[Utility & Helpers](/categories/utility) chrishardie/laravel-calendar-crawler ==================================== Laravel package to enable crawling web pages for event data, generating corresponding ICS feeds v1.0.0(4y ago)06MITPHPPHP ^7.4|^8.0 Since Oct 16Pushed 2y ago1 watchersCompare [ Source](https://github.com/ChrisHardie/laravel-calendar-crawler)[ Packagist](https://packagist.org/packages/chrishardie/laravel-calendar-crawler)[ Docs](https://github.com/chrishardie/laravel-calendar-crawler)[ GitHub Sponsors](https://github.com/ChrisHardie)[ RSS](/packages/chrishardie-laravel-calendar-crawler/feed)WikiDiscussions main Synced 2d ago READMEChangelog (1)Dependencies (11)Versions (5)Used By (0) Laravel package to enable crawling web pages for event data, generating corresponding ICS feeds =============================================================================================== [](#laravel-package-to-enable-crawling-web-pages-for-event-data-generating-corresponding-ics-feeds) [![Latest Version on Packagist](https://camo.githubusercontent.com/7a197b33d02e49cd1c80f9e50e848a794875fa774b14b3fbb684f46bbe3aed03/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f63687269736861726469652f6c61726176656c2d63616c656e6461722d637261776c65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chrishardie/laravel-calendar-crawler)[![GitHub Tests Action Status](https://camo.githubusercontent.com/0a41b5c6b3de1b17d5b2579e8e6114456c2db0c9c1a629465147ae474bc79963/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f63687269736861726469652f6c61726176656c2d63616c656e6461722d637261776c65722f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/chrishardie/laravel-calendar-crawler/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/2309a19ca99b6520922f2caa127287dd920dfc4afb515956951452b5395c1c82/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f63687269736861726469652f6c61726176656c2d63616c656e6461722d637261776c65722f436865636b253230262532306669782532307374796c696e673f6c6162656c3d636f64652532307374796c65)](https://github.com/chrishardie/laravel-calendar-crawler/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/0de9389c92630b50f72871bb9a617f2e82488530156c862ad0df18ecc04eae79/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f63687269736861726469652f6c61726176656c2d63616c656e6461722d637261776c65722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/chrishardie/laravel-calendar-crawler) Installation ------------ [](#installation) You can install the package via composer: ``` composer require chrishardie/laravel-calendar-crawler ``` You can publish and run the migrations with: ``` php artisan vendor:publish --provider="ChrisHardie\CalendarCrawler\CalendarCrawlerServiceProvider" --tag="calendar-crawler-migrations" php artisan migrate ``` You can publish the config file with: ``` php artisan vendor:publish --provider="ChrisHardie\CalendarCrawler\CalendarCrawlerServiceProvider" --tag="calendar-crawler-config" ``` This is the contents of the published config file: ``` return [ 'default_update_frequency' => 720, // Refresh every 12 hours 'calendar_name' => 'Calendar of Events', 'calendar_description' => 'A calendar of events from various sources.', // Default URL of calendar ICS feed 'stream_url' => '/calendar/calendar.ics', // Source-specific authentication information 'auth' => [ 'google' => [ 'api_key' => env('GOOGLE_CAL_API_KEY'), ] ], ]; ``` You can add a web route for a calendar ICS feed of all stored events: ``` Route::calendarstream(); ``` Usage ----- [](#usage) 1. Use an admin interface, artisan tinker session, DB seeder file or direct database call to add calendar sources. The main fields needed are: - Name - Type (currently, `GoogleCalendar` or `FacebookPage`) - Home URL - Location (either the Google Calendar calendar ID or the Facebook Page's numeric page ID) ``` DB::table('calendar_sources')->insert([ 'name' => 'Your Local Government', 'type' => 'GoogleCalendar', 'home_url' => 'https://www.government.gov/', 'location' => 'googlecalendarid@gmail.com', ]); DB::table('calendar_sources')->insert([ 'name' => 'Cool Nonprofit Organization', 'type' => 'FacebookPage', 'home_url' => 'https://www.facebook.com/orgname/', 'location' => '12345678', ]); ``` 2. If you specify any GoogleCalendar sources, you will need to [create an API key](https://console.cloud.google.com/apis/credentials) and then define a `GOOGLE_CAL_API_KEY` with that key as the value in your `.env` file. 3. The sources provided will be crawled according to the update frequency specified. 4. Use the event data elsewhere within your Laravel application directly, or retrieve an ICS calendar feed of events at the `stream_url` location specified. Crawling issues, errors and notices will be written to the log stack configured. Consider using a Slack channel for convenience. Uninstalling ------------ [](#uninstalling) Remove any web routes created during installation. Remove the package and any dependencies: ``` composer remove chrishardie/laravel-calendar-crawler ``` Remove `config/calendar-crawler.php`. Drop the related tables in a new migration: ``` Schema::dropIfExists('calendar_sources'); Schema::dropIfExists('events'); ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Credits ------- [](#credits) - [Chris Hardie](https://github.com/ChrisHardie) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 25 — LowBetter than 37% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity4 Limited adoption so far Community7 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 1669d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/1d92b67d645c17b1cda59ab8c5e1251b7e646e3a74ceecb63244f3c3fb82a9d9?d=identicon)[ChrisHardie](/maintainers/ChrisHardie) --- Top Contributors [![ChrisHardie](https://avatars.githubusercontent.com/u/311772?v=4)](https://github.com/ChrisHardie "ChrisHardie (47 commits)") --- Tags laravelChrisHardielaravel-calendar-crawler ### Code Quality TestsPest Static AnalysisPsalm Type Coverage Yes ### Embed Badge ![Health badge](/badges/chrishardie-laravel-calendar-crawler/health.svg) ``` [![Health](https://phpackages.com/badges/chrishardie-laravel-calendar-crawler/health.svg)](https://phpackages.com/packages/chrishardie-laravel-calendar-crawler) ``` ### Alternatives [spatie/laravel-data Create unified resources and data transfer objects 1.7k28.9M627](/packages/spatie-laravel-data)[spatie/laravel-livewire-wizard Build wizards using Livewire 4061.0M4](/packages/spatie-laravel-livewire-wizard)[hirethunk/verbs An event sourcing package that feels nice. 513162.9k6](/packages/hirethunk-verbs)[worksome/exchange Check Exchange Rates for any currency in Laravel. 123544.7k](/packages/worksome-exchange)[ralphjsmit/livewire-urls Get the previous and current url in Livewire. 82270.3k4](/packages/ralphjsmit-livewire-urls)[hydrat/filament-table-layout-toggle Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts. 6292.3k1](/packages/hydrat-filament-table-layout-toggle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)