ads/statistics

Tracks basic user information to generate statistical data on page usage. Also provides additional information to debug 500 errors

3.0.16 2024-11-02 10:59 UTC

Requires

• php: ^7.3|^8.0|^8.1|^8.2|^8.3
• illuminate/support: ^7.0|^8.0|^9.0|^10.0|^11.0

GPL-3.0-or-later

• SCS Grand Rapids

• laravel
• administrative site usage statistics
• additional error debugging

README

Audit/Error Logging Module for Laravel

The module will track the page view history for all users of the associated website. The module will log 500 error statistics to help with debugging code. Additionaly, the posted data for form submission will be saved in the database. The settings file has an array option that allows you to remove sensitive files from being saved in the tracking table.

Once configired, this plugin will automatically save page viewing history to the database.

(Make sure to run "php artisan migrate" if updating)

Step 1:

Set up composer, add the package to your require tag:

composer require ads/statistics

Step 2:

Publish and run migrations:

php artisan vendor:publish --provider=Ads\\Statistics\\StatisticsServiceProvider
php artisan migrate

Step 3:

Add Statistic logging to 'web' middleware in app\Http\Kernel.php:

    protected $middlewareGroups = [
        'web' => [
            ...
            \Ads\Statistics\Statistic::class,
        ],

Step 4:

In order to log 500 errors, you'll need to add some code to the app/Exceptions/Handler.php Add this interceptor to the register function Add to or create the report function before the return:

public function register()
{
	$this->reportable(function (Throwable $e) {
	    //
	});

	$this->reportable(function (\Exception $e) {
	    \Statistic::error($e);
	});
}

* Step 5 is only necessary if you have user authentication

Step 5:

Edit the config/statistics.php file.

Please enter the column names from your user database table.

For example:

  'user_id' => 'email',
  'first_name' => 'first_name',
  'last_name' => 'last_name',
  'protected_fields' => ['password'],