Rollbar Plugin
Official Rollbar full-stack error tracking for WordPress supported by Rollbar, Inc.
Installation
The installation and configuration of the plugin are as simple as it can be.
Through [WordPress Plugin directory](https://wordpress.org/plugins/rollbar/)
The 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 the Rollbar
plugin. - In
Plugins
→Installed plugins
find Rollbar
and click activate
underneath. - Log into your Rollbar account dashboard.
- Go to
Settings
→Project Access Tokens
. - Copy the token value under
post_client_item
and post_server_item
. - Navigate to
Tools
→Rollbar
. - Enable
PHP error logging
and/or Javascript 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 from WP_ENV
environment variable if it’s set otherwise it’s blank. We recommend to fill this out either with development
or production
. - 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.
Through [wpackagist](https://wpackagist.org/) (if you manage your project with Composer) *recommended*
This 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
add wpackagist-plugin/rollbar
to your require
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
find Rollbar
and click Activate
underneath. - Log into your Rollbar account dashboard.
- Go to
Settings
→Project Access Tokens
. - Copy the token value under
post_client_item
and post_server_item
. - Navigate to
Tools
→Rollbar
. - Enable
PHP error logging
and/or Javascript 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 from WP_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
.
Screenshots
Settings page
FAQ
Multisite supported? Yes of course. Additionally, you can assign different environments to each of your blogs.
I have a complex WordPress project and use composer for managing dependencies. Is your plugin composer friendly? Yes. It’s actually the recommended method of installation.
Changelog
= Version 2.7.1 (September 13 2023)
* Fix issue that could lead to fatal error with some settings (https://github.com/rollbar/rollbar-php-wordpress/pull/120)
= Version 2.7.0 (September 11 2023)
* Updated PHP Dependencies including loading seperate dependencies for PHP7 and PHP8. (https://github.com/rollbar/rollbar-php-wordpress/pull/114)
* Updated node development dependencies (https://github.com/rollbar/rollbar-php-wordpress/pull/115)
Version 2.6.4 (June 13th 2022)
- Updated admin test results to show a skipped test as a success (https://github.com/rollbar/rollbar-php-wordpress/pull/110)
- Fixed new session being created on every request (https://github.com/rollbar/rollbar-php-wordpress/pull/111)
- Added search for WP_ENV as a constant or the environment (https://github.com/rollbar/rollbar-php-wordpress/pull/108)
- Added a link to settings from the plugins page (https://github.com/rollbar/rollbar-php-wordpress/pull/109)
Version 2.6.3 (April 18th 2022)
- Update the tested WP versions
Version 2.6.2 (March 4th 2020)
- don’t start a session for wp-cron (https://github.com/rollbar/rollbar-php-wordpress/pull/88)
Version 2.6.1 (December 27th 2019)
- fix(initPhpLogging): Moving fetch settings to before settings check. (https://github.com/rollbar/rollbar-php-wordpress/pull/84)
Version 2.5.1 (February 20th 2019)
- Fixed a call to Rollbar\Wordpress\Defaults for enableMustUsePlugin (https://github.com/rollbar/rollbar-php-wordpress/pull/75)
Version 2.5.0 (February 19th 2019)
- Moved Rollbar initialization from
plugins_loaded
hook to the invocation of the main plugin file (https://github.com/rollbar/rollbar-php-wordpress/issues/73) - Added support for running the plugin as a Must-Use plugin (https://github.com/rollbar/rollbar-php-wordpress/issues/73)
- Added
Enable as a Must-Use plugin
settings (https://github.com/rollbar/rollbar-php-wordpress/issues/73) - UI improvements
Version 2.4.10 (February 5th 2019)
- Added support for ROLLBAR_ACCESS_TOKEN constant and respecting the ROLLBAR_ACCESS_TOKEN environment variable (https://github.com/rollbar/rollbar-php-wordpress/issues/72)
- Fixed tests
- Updated dependencies
Version 2.4.9 (January 24th 2019)
- Fix for issue #69 (https://github.com/rollbar/rollbar-php-wordpress/issues/69)
Version 2.4.8 (January 17th 2019)
- Update rollbar-php to v1.7.4
Version 2.4.7 (August 14th 2018)
- Update rollbar-php to v1.6.2
Version 2.4.6 (August 13th 2018)
- Configuration option custom_data_method doesn’t exist in Rollbar (https://github.com/rollbar/rollbar-php-wordpress/issues/66)
Version 2.4.5 (August 7th 2018)
- Update rollbar-php to v1.6.1
- Remove mentions of IRC channel from README.md and readme.txt
Version 2.4.4 (June 18th 2018)
- Update rollbar-php to v1.5.3
Version 2.4.3 (June 11th 2018)
- Update rollbar-php to v1.5.2
- Use rollbar-php:v1.5.2 new defaults methods to handle restoring default settings.
Version 2.4.2 (25th May 2018)
- Fixed the plugin not always respecting the boolean true settings (https://github.com/rollbar/rollbar-php-wordpress/issues/58)
Version 2.4.1 (19th May 2018)
- Updated rollbar-php dependency to v1.5.1
Version 2.4.0 (17th May 2018)
- Added capture_ip, capture_email and capture_username to the config options.
- Fixed populating config options from the database to the plugin for boolean values.
- Updated rollbar-php dependency to v1.5.0
Version 2.3.1 (10th April 2018)
- Fixed a bug in strict PHP setups (https://github.com/rollbar/rollbar-php-wordpress/issues/44)
Version 2.3.0 (5th April 2018)
- Added
rollbar_plugin_settings
filter - Added majority of Rollbar PHP config options to the User Interface.
- Moved the settings from Tools -> Rollbar to Settings -> Rollbar
Version 2.2.0 (4th December 2017)
- Fixed the logging level to correctly inlude errors from specified level and up.
- Changed the default logging level setting.
- Added instructions on tagging the repo to the README.md file.
- Added tests for logging level.
- Set up a PHPUnit test suite.
- Add rollbar_js_config filter for JS config data customization.
- Updated dependencies.
Version 2.1.2 (11th October 2017)
- Use the default rest route instead of permalink /wp-json
- Dynamically build the Rollbar JS snippet URL
Version 2.1.1 (11th October 2017)
- Fixed location of the Rollbar JS snippet
Version 2.1.0 (11th October 2017)
- Added “Send test message to Rollbar” button
- Fixed the plugin’s name inconsistency between WordPress plugin directory and composer.
Version 2.0.1 (6th October 2017)
- Fixed RollbarJsHelper class loading bug in src/Plugin.php (https://github.com/rollbar/rollbar-php-wordpress/issues/23)
Version 2.0.0 (9th September 2017)
- Added support for the WP_ENV environment variable
- Organized the code into namespaces
- Moved helper functions into static methods
- Updated Rollbar PHP library
- Included dependencies to make the plugin self-contained when installing through WP plugin directory
- Rewrote readme files
Version 1.0.3 (12th August 2016)
- Updated rollbar php lib to latest v0.18.2
- Added .pot translation file
- Removed WP.org assets from plugin folder
Version 1.0.2 (28th March 2016)
- Updated rollbar js lib
- Added escaping for setting values
Version 1.0.0 (4th November 2015)