# wp-reporting

Utility for sending log reports in Wordpress themes & plugins

Include it in your own plugin or theme:

```bash
composer require agencenous/wp-reporting
```

## Usage

### Report PHP errors

```php
<?php

add_action ('plugins_loaded', function(){
    require 'vendor/autoload.php';

    // Register each project
    \WPReporting()->register('project-name', [
        'label' => 'Project name', // translate it with __('Project name', 'project-textdomain')
        'description' => 'Send logs by emails', // translate it with __('Description', 'project-textdomain')
        'category' => 'plugin', // plugin, theme, main
        'to' => 'bm91c0BhdmVjbm91cy5ldQ==', // email addresse, plain or BASE64 encoded (to prevent spam when source is open)
        'only_in_dir' => __DIR__, // Limit error reporting to this directory for this project
        'javascript' => true, // Enable javascript error reporting
    ]);
});

// Add it in any function or class
try{
    // Your code goes here
}
catch(\Throwable $e){ // For PHP 7
    \WPReporting()->send($e, 'project-name');
}
catch(\Exception $e){ // For PHP 5
    \WPReporting()->send($e, 'project-name');
}
?>
```

If you need to catch warnings or notices

```php
<?php
// Add it in any function or class
\WPReporting()->listen('project-name', E_WARNING);

// Your code goes here

\WPReporting()->stop();
?>
```

### Report Javascript errors

```html
<script type="text/javascript">
try{
    // Your code goes here
}
catch(err){
    wp_reporting.log_error('project-name', err);
}
</script>
```

In a normal context, you can use the `wp_reporting` global variable.

In case of the script is not loaded automatically, you can use the `wp_reporting` function.

```php
\WPReporting()->load_scripts();
```

## Privacy

Email addresses can be base64 encoded. So you do not expose theme directly in source-code.

Emails are sent using the `wp_mail()` function.

Calling `WPReporting()` will automatically add a setting page in the Wordpress dashboard to let admin enable/disable error reporting for each registered project.  
Reports will only be sent if the admin has enabled it.

after installing wp-reporting, you can use the bin command to encode an email address:
    
```bash
vendor/bin/wp-reporting-encode-email xxxxx@xx.xx
```

## Moreover

Enable settings on network in a multisite context.

Just add this line in your `wp-config.php` file.

```php
defined('WP_REPORTING_NETWORK', true);
```