Title: Ferret
Author: Leap Spark
Published: <strong>January 11, 2019</strong>
Last modified: March 16, 2020

---

Search plugins

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/ferret/assets/icon-256x256.png?rev=2115753)

# Ferret

 By [Leap Spark](https://profiles.wordpress.org/leapspark/)

[Download](https://downloads.wordpress.org/plugin/ferret.2.1.0.zip)

 * [Details](https://pcd.wordpress.org/plugins/ferret/#description)
 * [Reviews](https://pcd.wordpress.org/plugins/ferret/#reviews)
 *  [Installation](https://pcd.wordpress.org/plugins/ferret/#installation)
 * [Development](https://pcd.wordpress.org/plugins/ferret/#developers)

 [Support](https://wordpress.org/support/plugin/ferret/)

## Description

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.

## Installation

 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

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Ferret” is open source software. The following people have contributed to this 
plugin.

Contributors

 *   [ Leap Spark ](https://profiles.wordpress.org/leapspark/)

[Translate “Ferret” into your language.](https://translate.wordpress.org/projects/wp-plugins/ferret)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/ferret/), check out
the [SVN repository](https://plugins.svn.wordpress.org/ferret/), or subscribe to
the [development log](https://plugins.trac.wordpress.org/log/ferret/) by [RSS](https://plugins.trac.wordpress.org/log/ferret/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 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

## Meta

 *  Version **2.1.0**
 *  Last updated **6 years ago**
 *  Active installations **10+**
 *  WordPress version ** 3.0.1 or higher **
 *  Tested up to **5.3.21**
 *  PHP version ** 7.1 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/ferret/)
 * Tags
 * [debugging](https://pcd.wordpress.org/plugins/tags/debugging/)[error handling](https://pcd.wordpress.org/plugins/tags/error-handling/)
   [errors](https://pcd.wordpress.org/plugins/tags/errors/)[logging](https://pcd.wordpress.org/plugins/tags/logging/)
   [sentry](https://pcd.wordpress.org/plugins/tags/sentry/)
 *  [Advanced View](https://pcd.wordpress.org/plugins/ferret/advanced/)

## Ratings

No reviews have been submitted yet.

[Add my review](https://wordpress.org/support/plugin/ferret/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/ferret/reviews/)

## Contributors

 *   [ Leap Spark ](https://profiles.wordpress.org/leapspark/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/ferret/)