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.
Características
- PHP & Javascript error logging
- Define an environment for each single WordPress installation or Multisite blog
- Specify your desired logging level
- Regular updates and improvements!
Please note
In order to use this plugin, a Rollbar account is required.
Soporte
- Browse issue tracker on GitHub and report new issues
- If you run into any issues, please email us at support@rollbar.com
- For bug reports, please open an issue on GitHub.
You like it?
You can at least support the plugin development and rate it up!
Disclaimer
This plugin is a community-driven contribution. All rights reserved to Rollbar.
Screenshots
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 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.
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
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
.
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.
Reviews
Contributors & Developers
“Rollbar” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Rollbar” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
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)
- Initial release!