WordPress Sentry

WordPress Sentry

A (unofficial) WordPress plugin to report PHP errors and Browser (JavaScript) errors to Sentry.

  • Frequently updated
    Very good! This plugin is actively maintained and the last update was released 6 days ago.
  • This plugin is tested with the last major release of WordPress
    Content for list item
  • Compatible with the latest major PHP release
    This plugin requieres PHP 7.2.5 or higher. The latest stable PHP 8.3.8 was released on 06 June 2024
  • No information about vulnerabilities and unfixed security issues is available.
    Content for list item

Ratings

15

Active installs

9K

Total Downloads

529K

Support Threads

2

Last updated

08 June 2024

Added

27 October 2016

Versions

6.2%12.4%6.61%5.21%24.38%45.2%
  • Version 6.16
  • Version 7.13
  • Version 7.14
  • Version 7.15
  • Version 7.16
  • Version other

About WordPress Sentry

Changelog

7.16.0

7.15.0

This update bumps the minimum PHP version to 7.2.5, this used to be 7.2.0.
This is unlikely to affect you, but if you are still running PHP 7.2.0 you should upgrade to at least 7.2.5.
The change was made to allow upgrading some libraries and prevent deprecation warnings on newer PHP versions.

7.14.0

7.13.0

7.12.0

7.11.0

7.10.0

7.9.0

7.8.0

7.7.0

7.6.0

7.5.1

7.5.0

7.4.0

7.3.1

7.3.0

7.2.1

7.2.0

7.1.0

7.0.0

Note: This is a breaking release for the PHP SDK, please test it well and read the migration guides if applicable before upgrading!

If you are doing anything more than just have this plugin installed and a DSN configured in your wp-config.php, check out the upgrade docs:

6.28.0

6.27.0

6.26.0

6.25.0

6.24.0

6.23.0

6.22.1

6.22.0

6.21.0

6.20.0

6.19.0

6.18.1

6.18.0

6.17.0

6.16.0

6.15.0

6.14.0

6.13.0

6.12.0

6.11.0

If you are using an HTTP proxy in WordPress but don’t want Sentry to use it you should configure WP_PROXY_BYPASS_HOSTS to include the Sentry domain.

6.10.0

6.9.0

6.8.0

6.7.0

6.6.0

6.5.0

6.4.0

6.3.0

6.2.0

6.1.0

6.0.0

Note: This is a breaking release for the Browser/JavaScript SDK

Since 5.0.0 of this plugin, which bundles the Browser SDK version 7, the whitelistUrls and blacklistUrls are no longer working. They are renamed to allowUrls and denyUrls respectively, please update your code if you are using those options.

Since this version of the plugin we no longer bundle the ES5 versions of the Browser SDK by default, which means that if you still need to support older browsers (Internet Explorer 11 mainly) you need to enable the new WP_SENTRY_BROWSER_USE_ES5_BUNDLES option by setting it to true. Enabling the ES5 bundles will also loads an externally hosted polyfill library for the needed polyfills.

If you are still on a WP Sentry version older than version 5.0.0 don’t forget to see the Browser SDK v7 migration guide.

5.2.0

5.1.0

5.0.0

Note: This is a breaking release for the Browser/JavaScript SDK, please test it well and read the migration guides if applicable before upgrading!
Note: The v7 version of the JavaScript SDK requires a self-hosted version of Sentry 20.6.0 or higher. If you are using a version of self-hosted Sentry (aka onpremise) older than 20.6.0 then you will need to upgrade.

Version 7 of the Sentry JavaScript SDK brings a variety of features and fixes including bundle size and performance improvements, brand new integrations, support for the attachments API, and key bug fixes.
This release does not change or remove any top level public API methods (captureException, captureMessage), and only requires changes to certain configuration options or custom clients/integrations/transports.
For detailed overview of all the changes, please see the v7 migration guide.

4.18.0

4.17.0

4.16.0

4.15.0

4.14.0

4.13.1

4.13.0

4.12.0

4.11.0

4.10.3

4.10.2

4.10.1

4.10.0

4.9.0

4.8.0

4.7.0

4.6.0

4.5.0

4.4.1

4.4.0

4.3.0

4.2.0

4.1.1

4.1.0

4.0.1

Rereleased 4.0.0 to fix issue with missing dependencies folder, see 4.0.0 changelog for changes!

4.0.0

Note: This is a breaking release for the PHP SDK, please test it well and read the migration guides if applicable before upgrading!

If you are doing anything more than just have this plugin installed and a DSN defined on your wp-config.php, check out the upgrade docs:

Becasue of the upgrade to the 3.x version of the PHP SDK this plugin now has the requirement that it runs on at least PHP 7.2, for older PHP versions stick to version 3.x.

3.11.1

3.11.0

3.10.0

3.9.0

3.8.0

3.7.0

3.6.0

3.5.1

3.5.0

3.4.6

3.4.5

3.4.4

3.4.3

3.4.2

3.4.1

Important: In this release we start using a process to prefix our dependencies to prevent conflicts with other WordPress plugins.
This should cause no problems, but if they do please open up a support ticket or GitHub issue with details about your environment.

3.4.0

Important: In this release we start using a process to prefix our dependencies to prevent conflicts with other WordPress plugins.
This should cause no problems, but if they do please open up a support ticket or GitHub issue with details about your environment.

3.3.0

3.2.0

3.1.0

3.0.4

3.0.3

3.0.2

3.0.1

3.0.0

Note: This is a breaking release for both the PHP SDK and the Browser SDK, please test it well and read the migration guides if applicable before upgrading!

If you are doing anything more than just have this plugin installed and a DSN defined on your wp-config.php, check out the upgrade docs:

Becasue of the upgrade to the 2.x version of the PHP SDK this plugin now has the requirement that it runs on at least PHP 7.1, for older PHP versions stick to version 2.x.

2.8.0

2.7.2

2.7.1

2.7.0

This release might contain breaking changes if you are using the wp_sentry_public_options filter.

2.6.1

2.6.0

If you are doing custom calls to Sentry from your front-end make sure you check out the new docs and migration instructions: https://github.com/getsentry/sentry-javascript/releases/tag/4.0.0

If you are not doing anything custom to the JS side of the SDK you can safely upgrade to this version.

2.5.0

2.4.0

This version allows the usage of the new private key-less DSN introduced in Sentry 9.

2.3.0

2.2.0

2.1.5

2.1.4

2.1.3

2.1.2

2.1.0

2.0.18

2.0.17

2.0.16

2.0.15

2.0.14

2.0.13

2.0.12

2.0.11

2.0.10

2.0.9

2.0.8

2.0.7

2.0.6

2.0.4

2.0.0

1.0.1

1.0.0

How to install WordPress Sentry

It is recommended to use the plugins interface in WordPress to install this plugin.

If manual installation is required, please make sure that the plugin files are in a folder named “wp-sentry-integration” in the WordPress plugins folder, usually “wp-content/plugins”.

To start using the plugin first setup the DSN for either the PHP side or the Browser side or both.

All other configuration options are optional but it’s advised you read through them to see if any are applicable to you or are thing you’d like to configure.

You can find more information and the full documentation: here. The following are the basics.

Note: When configuring constants in your wp-config.php do this before the That's all, stop editing! Happy publishing. line, otherwise they won’t work!

Note: this plugin does not do anything by default and has only a admin interface to test the integration and view it’s configuration. A Sentry DSN must be configured in your wp-config.php.

Sentry uses something called a DSN (read more) to configure the SDK.

To track PHP errors add this snippet to your wp-config.php and replace PHP_DSN with your actual DSN that you find inside Sentry in the project settings under “Client Keys (DSN)”:

define( 'WP_SENTRY_PHP_DSN', 'PHP_DSN' );

Note: Do not set this constant to disable the PHP tracker.

To track Browser (JavaScript) errors add this snippet to your wp-config.php and replace JS_DSN with your actual DSN that you find inside Sentry in the project settings under “Client Keys (DSN)”:

define( 'WP_SENTRY_BROWSER_DSN', 'JS_DSN' );

// You can _optionally_ enable or disable the JavaScript tracker in certain parts of your site with these constants:
define('WP_SENTRY_BROWSER_ADMIN_ENABLED', true);    // Add the JavaScript tracker to the admin area. Default: true
define('WP_SENTRY_BROWSER_LOGIN_ENABLED', true);    // Add the JavaScript tracker to the login page. Default: true
define('WP_SENTRY_BROWSER_FRONTEND_ENABLED', true); // Add the JavaScript tracker to the front end.  Default: true

Note: Do not set this constant to disable the Browser (JavaScript) tracker.

You can find more information and the full documentation: here. The above are the basics.