Rollbar for WordPress
Rollbar full-stack error tracking for WordPress
Description
Rollbar collects errors that happen in your application, notifies you, and analyzes them so you can debug and fix them.
This plugin integrates Rollbar into your WordPress installation.
Find out how Rollbar can help you decrease development and maintenance costs.
See real companies improving their development workflow thanks to Rollbar.
Installation
WordPress Plugin directory
ThroughThe easiest way to install the plugin is from the WordPress Plugin directory. If you have an existing WordPress installation and you want to add Rollbar:
- In your WordPress administration panel go to
Plugins
→Add New
. - Search for "Rollbar" and find
Rollbar
by Rollbar in the search results. - Click
Install Now
next to theRollbar
plugin. - In
Plugins
→Installed plugins
findRollbar
and clickactivate
underneath. - Log into your Rollbar account dashboard.
- Go to
Settings
→Project Access Tokens
. - Copy the token value under
post_client_item
andpost_server_item
. - Navigate to
Tools
→Rollbar
. - Enable
PHP error logging
and/orJavascript error logging
depending on your needs. - Paste the tokens you copied in step 7 in
Access Token
section. - Provide the name of your environment in
Environment
. By default, the environment will be taken fromWP_ENV
environment variable if it's set otherwise it's blank. We recommend to fill this out either withdevelopment
orproduction
. - Pick a minimum logging level. Only errors at that or higher level will be reported. For reference: PHP Manual: Predefined Error Constants.
- Click
Save Changes
.
Warning: This installation method might not be suitable for complex WordPress projects. The plugin installed this way will be self-contained and include all of the required dependencies for itself and rollbar/rollbar-php
library. In complex projects, this might lead to version conflicts between dependencies and other plugins/packages. If this is an issue in your project, we recommend the "Advanced" installation method. For more information why this might be important for you, read Using Composer with WordPress.
wpackagist (if you manage your project with Composer) recommended
ThroughThis is a recommended way to install Rollbar plugin for advanced projects. This way ensures the plugin and all of its' dependencies are managed by Composer.
- If your WordPress project is not managed with Composer yet, we suggest looking into upgrading your WordPress: Using Composer with WordPress.
- In your
composer.json
addwpackagist-plugin/rollbar
to yourrequire
section, i.e.:
"require": {
"php": ">=5.5",
...,
"wpackagist-plugin/rollbar": "*"
}
- Issue command
composer install
in the root directory of your WordPress project. - In
Plugins
→Installed plugins
findRollbar
and clickActivate
underneath. - Log into your Rollbar account dashboard.
- Go to
Settings
→Project Access Tokens
. - Copy the token value under
post_client_item
andpost_server_item
. - Navigate to
Tools
→Rollbar
. - Enable
PHP error logging
and/orJavascript error logging
depending on your needs. - Paste the tokens you copied in step 7 in
Access Token
section. - Provide the name of your environment in
Environment
. By default, the environment will be taken fromWP_ENV
environment variable if it's set otherwise it's blank. - Pick a minimum logging level. Only errors at that or higher level will be reported. For reference: PHP Manual: Predefined Error Constants.
- Click
Save Changes
.
Help / Support
If you run into any issues, please email us at support@rollbar.com
You can also find us on IRC: #rollbar on chat.freenode.net
For bug reports, please open an issue on GitHub.
Special thanks
The original author of this package is @flowdee. This is a fork and continuation of his efforts.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Disclaimer
This plugin is a community-driven contribution. All rights reserved to Rollbar.