Skip to content

WordPress SDK

The Nadi WordPress plugin provides error monitoring for WordPress sites.

Requirements

  • PHP 8.1 or higher
  • WordPress 5.0 or higher

Installation

From WordPress Admin

  1. Download the latest release from GitHub
  2. Go to PluginsAdd NewUpload Plugin
  3. Select the downloaded ZIP file
  4. Click Install Now
  5. Click Activate Plugin

Manual Installation

  1. Download and extract the plugin
  2. Upload the nadi-wordpress folder to /wp-content/plugins/
  3. Activate the plugin through the Plugins menu

Via WP-CLI

bash
wp plugin install https://github.com/nadi-pro/nadi-wordpress/releases/latest/download/nadi-wordpress.zip --activate

Quick Start

  1. Activate the plugin
  2. Go to SettingsNadi
  3. Enter your API Key and Application Key in the Credentials tab
  4. Click Save Settings
  5. Go to the Status tab and click Test Connection

How It Works

  1. Exceptions are captured by PHP's exception handler
  2. Exception data (stack trace, context, metrics) is written as a JSON file to the log/ directory
  3. A WordPress cron job runs every minute and triggers the Shipper binary
  4. The Shipper binary reads pending JSON logs and sends them to the Nadi API
  5. Errors appear in your Nadi dashboard

What's Captured

Once configured, the plugin automatically captures:

  • PHP errors and exceptions
  • WordPress-specific errors (WP_Error)
  • Plugin/theme errors
  • Database errors
  • AJAX errors
DataDescription
ErrorMessage, file, line
Stack TraceFull PHP trace
WordPressVersion, active theme, plugins
PHPVersion, memory limit
RequestURL, method, POST data
UserLogged-in user (if any)

Next Steps

Released under the MIT License.