Skip to content

Commit

Permalink
Changelog & readme
Browse files Browse the repository at this point in the history
  • Loading branch information
janhenckens committed Oct 27, 2024
1 parent e35b60f commit 7af9a6a
Show file tree
Hide file tree
Showing 3 changed files with 61 additions and 0 deletions.
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# Release Notes for Flare

## 4.0.0
- Initial release
56 changes: 56 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Flare

Flareapp.io integration for Craft CMS

## Requirements

This plugin requires Craft CMS 4.12.0 or later, and PHP 8.1 or later - <br>and an account at [flareapp.io](https://flareapp.io/?via=studioespresso) *(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:

```shell
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
<?php

return [
'*' => [
'enabled' => false,
'apiKey' => \craft\helpers\App::env('FLARE_API_KEY'),
'excludedExceptions' => [
ErrorException::class,
]
],
'production' => [
'enabled' => true,
]
];
````

## 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:

````shell
(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
````
1 change: 1 addition & 0 deletions composer.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
"description": "Flare.io integration for Craft CMS",
"type": "craft-plugin",
"license": "mit",
"version": "4.0.0",
"support": {
"email": "[email protected]",
"issues": "https://github.com/studioespresso/craft-flare/issues?state=open",
Expand Down

0 comments on commit 7af9a6a

Please sign in to comment.