Ferret

Ferret is a simple wrapper for the Sentry PHP and JavaScript SDKs. It will catch all PHP errors, as well as JavaScript errors if the option is switched on. It utilizes the legacy PHP library by Sentry intentionally, in an effort to maximize compatibility. The newest SDK requires PHP^7.1 whereas the legacy requires minimum of 5.6

There are four settings that you can adjust.

• The DSN – Your DSN key, this is required
• Project ID – The project key, this is also required
• Enable JavaScript Logging – Enable logging of JavaScript errors
• Ignore WP Core Errors – Prevent sending events to Sentry that originate from WordPress core (wp-admin, wp-includes)
• Debug Environment – Switch the Sentry environment to Debug, turning this off puts the environment to Production

All three are accessible on the plugin settings page located in the Settings -> Ferret Settings page.

In the future we will add the ability to selectively ignore specific themes or plugins in a convenient way. We would also like to expose an internal API that can be used by other plugins/themes to capture errors or add context.

1. Upload wordpress-sentry.php to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Go to the settings page through Settings -> Ferret Settings and enter your Sentry DSN and Project ID

2.1.0

• Fix JavaScript script element tag
• Upgrade JavaScript SDK to 5.14

2.0.0

• Complete overhaul of plugin structure
• Now requires PHP^7.1
• Add Sentry Unified SDK

1.2.6

• Add WordPress.org assets

1.2.5

• Adding Github Actions workflow

1.2.4

• Remove ?? operators
• Fix PHP version error notice to reflect 5.6 requirement
• Code formatting

1.2.3

• Fix the required PHP version
• Fix typos in README

1.2.0

• Documentation
• Remove PHP7 features, specifically null coalesce operators
• Downgrade minimum PHP version to 5.6
• Add error handling to Sentry initialization

1.1.6

• Documentation

1.1.5

• Fix some issues related to file naming
• Sort out some kinks with adjusting to svn workflow

1.0.0

• Initial commit