studioespresso / craft-flare
Flare.io integration for Craft CMS
Installs: 2
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 1
Open Issues: 0
Type:craft-plugin
Requires
- craftcms/cms: ^5.0.0
- spatie/flare-client-php: ^1.8.0
Requires (Dev)
- craftcms/ecs: dev-main
- craftcms/phpstan: dev-main
This package is auto-updated.
Last update: 2024-12-08 19:00:28 UTC
README
Requirements
- Craft CMS 4.12 or later, or Craft CMS 5.0 or later.
- An account at flareapp.io (Affiliate link, you're supporting further maintenance of this plugin by signing up through that link - thanks! ❤️)
Installation
You can install this plugin from the Plugin Store or with Composer.
From the Plugin Store
Go to the Plugin Store in your project’s Control Panel and search for “Flare”. Then press “Install”.
With Composer
Open your terminal and run the following commands:
cd /path/to/my-project.test
(ddev/php) composer require studioespresso/craft-flare
(ddev/php) craft plugin/install flare
Configuration
Create a project in your Flare account, copy the API key and add it in the plugin settings.
Alternatively, you can use the flare.php
configuration file to manage this. This file is environment-aware, like any other Craft CMS configuration. You can find an example below.
<?php return [ '*' => [ 'enabled' => false, 'apiKey' => \craft\helpers\App::env('FLARE_API_KEY'), 'excludedExceptions' => [ ErrorException::class, ] ], 'production' => [ 'enabled' => true, ] ];
Bootstrap (optional)
In order to load the plugin as soon as possible (to make sure you’re tracking the most errors), you can add the following snippet to your `app.php
return [ // If you’re app.php contains multiple environments, make sure to add this to the ‘*’ one. 'bootstrap' => [ 'studioespresso\flare\Bootstrap' ] ]
Testing
Once you've added the API key for your Flare project, you can use a built-in console command to send a test exception to Flare:
(ddev/php) craft flare/test/index # That should result on the following message: Exception reported to flareapp.io, check your project there to see if it shows up