- About
- Features
- Requirements
- Installation Instructions
- Configuration
- Usage
- Routes
- Screenshots
- File Tree
- License
Laravel logger is an activity event logger for your laravel application. It comes out the box with ready to use with dashboard to view your activity. Laravel logger can be added as a middleware or called through a trait. This package is easily configurable and customizable.
Laravel logger can work out the box with or without the following roles packages:
- jeremykenedy/laravel-roles
- spatie/laravel-permission
- Zizaco/entrust
- romanbican/roles
- ultraware/roles
| Laravel Activity Logger Features |
|---|
| Logs login page visits |
| Logs user logins |
| Logs user logouts |
| Routing Events can recording using middleware |
| Records activity timestamps |
| Records activity description |
| Records activity user type with crawler detection. |
| Records activity Method |
| Records activity Route |
| Records activity Ip Address |
| Records activity User Agent |
| Records activity Browser Language |
| Records activity referrer |
| Activity panel dashboard |
| Individual activity drilldown report dashboard |
| Activity Drilldown looks up Id Address meta information |
| Activity Drilldown shows user roles if enabled |
| Activity Drilldown shows associated user events |
| Activity log can be cleared, restored, and destroyed using eloquent softdeletes |
| Cleared activity logs can be viewed and have drilldown ability |
| Uses font awesome, cdn assets can be optionally called in configuration |
| Uses Geoplugin API for drilldown IP meta information |
| Uses Language localization files |
| Lots of configuration options |
- Laravel 5.1, 5.2, 5.3, 5.4, 5.5, and 5.6+
- jaybizzle/laravel-crawler-detect included dependency in composer.json (for crawler detection)
- From your projects root folder in terminal run:
composer require jeremykenedy/laravel-logger- Register the package
-
Laravel 5.5 and up Uses package auto discovery feature, no need to edit the
config/app.phpfile. -
Laravel 5.4 and below Register the package with laravel in
config/app.phpunderproviderswith the following:
'providers' => [ jeremykenedy\LaravelLogger\LaravelLoggerServiceProvider::class, ];- Run the migration to add the table to record the activities to:
php artisan migrate- Note: If you want to specify a different table or connection make sure you update your
.envfile with the needed configuration variables.
-
Optionally Update your
.envfile and associated settings (see Environment File section) -
Optionally publish the packages views, config file, assets, and language files by running the following from your projects root folder:
php artisan vendor:publish --tag=laravelloggerLaravel Activity Logger can be configured in directly in /config/laravel-logger.php if you published the assets. Or you can variables to your .env file.
Here are the .env file variables available:
LARAVEL_LOGGER_DATABASE_CONNECTION=mysql LARAVEL_LOGGER_DATABASE_TABLE=laravel_logger_activity LARAVEL_LOGGER_ROLES_ENABLED=true LARAVEL_LOGGER_ROLES_MIDDLWARE=role:admin LARAVEL_LOGGER_ROLE_MODEL=jeremykenedy\LaravelRoles\Models\Role LARAVEL_LOGGER_MIDDLEWARE_ENABLED=true LARAVEL_LOGGER_USER_MODEL=App\Models\User LARAVEL_LOGGER_PAGINATION_ENABLED=true LARAVEL_LOGGER_PAGINATION_PER_PAGE=25 LARAVEL_LOGGER_DATATABLES_ENABLED=true LARAVEL_LOGGER_DASHBOARD_MENU_ENABLED=true LARAVEL_LOGGER_DASHBOARD_DRILLABLE=true LARAVEL_LOGGER_LOG_RECORD_FAILURES_TO_FILE=true LARAVEL_LOGGER_FLASH_MESSAGE_BLADE_ENABLED=true LARAVEL_LOGGER_JQUERY_CDN_ENABLED=true LARAVEL_LOGGER_JQUERY_CDN_URL=https://code.jquery.com/jquery-2.2.4.min.js LARAVEL_LOGGER_BLADE_CSS_PLACEMENT_ENABLED=false LARAVEL_LOGGER_BLADE_JS_PLACEMENT_ENABLED=false LARAVEL_LOGGER_BOOTSTRAP_JS_CDN_ENABLED=true LARAVEL_LOGGER_BOOTSTRAP_JS_CDN_URL=https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/js/bootstrap.min.js LARAVEL_LOGGER_FONT_AWESOME_CDN_ENABLED=true LARAVEL_LOGGER_FONT_AWESOME_CDN_URL=https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css LARAVEL_LOGGER_BOOTSTRAP_CSS_CDN_ENABLED=true LARAVEL_LOGGER_BOOTSTRAP_CSS_CDN_URL=https://maxcdn.bootstrapcdn.com/bootstrap/4.0.0/css/bootstrap.min.css LARAVEL_LOGGER_POPPER_JS_CDN_URL=https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.12.9/umd/popper.min.jsEvents for laravel authentication scaffolding are listened for as providers and are enabled via middleware. You can add events to your routes and controllers via the middleware:
activityExample to start recording page views using middlware in web.php:
Route::group(['middleware' => ['web', 'activity']], function () { Route::get('/', 'WelcomeController@welcome')->name('welcome'); });This middlware can be enabled/disabled in the configuration settings.
Events can be recorded directly by using the trait. When using the trait you can customize the event description.
To use the trait:
- Include the call in the head of your class file:
use jeremykenedy\LaravelLogger\App\Http\Traits\ActivityLogger;- Include the trait call in the opening of your class:
use ActivityLogger;- You can record the activity my calling the traits method:
ActivityLogger::activity("Logging this activity."); /activity/activity/cleared/activity/log/{id}/activity/cleared/log/{id}
├── .gitignore ├── CODE_OF_CONDUCT.md ├── LICENSE ├── README.md ├── composer.json └── src ├── .env.example ├── LaravelLoggerServiceProvider.php ├── app │ ├── Http │ │ ├── Controllers │ │ │ └── LaravelLoggerController.php │ │ ├── Middleware │ │ │ └── LogActivity.php │ │ └── Traits │ │ ├── ActivityLogger.php │ │ ├── IpAddressDetails.php │ │ └── UserAgentDetails.php │ ├── Listeners │ │ ├── LogAuthenticated.php │ │ ├── LogAuthenticationAttempt.php │ │ ├── LogFailedLogin.php │ │ ├── LogLockout.php │ │ ├── LogPasswordReset.php │ │ ├── LogSuccessfulLogin.php │ │ └── LogSuccessfulLogout.php │ ├── Logic │ │ └── helpers.php │ └── Models │ └── Activity.php ├── config │ └── laravel-logger.php ├── database │ └── migrations │ └── 2017_11_04_103444_create_laravel_logger_activity_table.php ├── resources │ ├── lang │ │ └── en │ │ └── laravel-logger.php │ └── views │ ├── forms │ │ ├── clear-activity-log.blade.php │ │ ├── delete-activity-log.blade.php │ │ └── restore-activity-log.blade.php │ ├── logger │ │ ├── activity-log-cleared.blade.php │ │ ├── activity-log-item.blade.php │ │ ├── activity-log.blade.php │ │ └── partials │ │ └── activity-table.blade.php │ ├── modals │ │ └── confirm-modal.blade.php │ ├── partials │ │ ├── form-status.blade.php │ │ └── styles.blade.php │ └── scripts │ ├── clickable-row.blade.php │ ├── confirm-modal.blade.php │ ├── datatables.blade.php │ └── tooltip.blade.php └── routes └── web.php- Tree command can be installed using brew:
brew install tree - File tree generated using command
tree -a -I '.git|node_modules|vendor|storage|tests
Laravel-logger is licensed under the MIT license. Enjoy!