README.md

Archived

This plugin is now archived.

See: https://johnhenry.ie/articles/2024/08/error-reporting-with-rollbar-and-craft-cms for an alternative implementation of Rollbar.

Rollbar plugin for Craft CMS

This plugin provides an Rollbar integration for Craft CMS v3.x.

Features

• PHP Exception reporting to Rollbar
• JS Exception reporting to Rollbar (optional)

Requirements

This plugin requires Craft CMS 3.1 or later

Installation

Plugin Store

To install Rollbar, navigate to the Plugin Store section of your Craft control panel, search for Rollbar, and click the Try button.

Composer

You can also add the package to your project using Composer.

1. Open your terminal and go to your Craft project:

    cd /path/to/project
   

2. Then tell Composer to load the plugin:

    composer require newism/craft-rollbar
   

3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Rollbar.

Configuration

First you'll need to setup a Rollbar account.

Once you have an account you'll be provided with an Access Key.

To add the Afterpay payment gateway, go to Settings → Plugins → Rollbar and enter the access key.

You may then decide to configure your Rollbar gateway using a config file. An example file looks like:

<?php
return [
    // Your project's post_server_item access token, which you can find in the Rollbar.com interface.
    "accessToken" => '',

    // See: https://docs.rollbar.com/docs/browser-js
    "enableJs" => '',

    // Your project's post_client_item access token, which you can find in the Rollbar.com interface.
    'postClientItemAccessToken' => '',
    
    // If you wish Rollbar to ignore any exception types, please provide the fully qualified name here, separated by a comma
    'exceptionIgnoreList' => '',
]; 

Roadmap

1. Implement logging levels
2. More configuration options

Support

GitHub

If you've found a bug, or would like to make a feature request, head to the GitHub Repo and file an issue. Pull requests are also most welcome!

Twitter

Get our attention on Twitter by using the #craftcms hashtag and mentioning @newism

Stack Exchange

Ask a question via the Craft Stack Exchange and tag your question with plugin-newism-craft-rollbar.

Email

Any feedback, comments, questions or suggestions please email us at support at newism.com.au.

Licensing

You can try this plugin in a development environment for as long as you like.

For more information, see Craft's Commercial Plugin Licensing.

---

Brought to you by Newism