alleyinteractive / logger
A Monolog-based logging tool for WordPress. Supports storing log message in a custom post type or in individual posts and terms.
Installs: 20 376
Dependents: 0
Suggesters: 1
Security: 0
Stars: 26
Watchers: 50
Forks: 4
Open Issues: 6
Type:wordpress-plugin
Requires
- php: ^8.1
- alleyinteractive/composer-wordpress-autoloader: ^1.0
- mantle-framework/support: ^1.0
- monolog/monolog: ^2.8
- psr/log: ^1.0|^2.0|^3.0
- spatie/backtrace: ^1.6
Requires (Dev)
This package is auto-updated.
Last update: 2024-11-04 01:56:31 UTC
README
Providing a WordPress integration with Monolog, allowing site-wide and post and term specific logging.
Documentation
See the wiki for complete information and more examples.
Installation
Logger requires PHP 8.1 and Composer to run properly.
composer require alleyinteractive/logger
You can also install the plugin as a submodule by using the *-built
tag of a
release.
Usage
AI Logger is a complete interface to Monolog with some nice WordPress handlers built in.
// Log site-wide to the ai_log post type. ai_logger()->info( 'Log message...' ); \AI_Logger\AI_Logger::info( 'Another format for logging.' );
Logging to a Specific Post
Logs will be appended to a post's meta for review.
ai_logger_to_post( $post_id, 'meta-key' )->info( 'This will log to the <meta-key> for a specific post.' );
Logging to a Specific Term
Logs will be appended to a term's meta for review.
ai_logger_to_term( $term_id, 'meta-key' )->info( 'This will log to the <meta-key> for a specific term.' );
Logging to Query Monitor
ai_logger_to_qm()->info( 'This will show up in Query Monitor!' );
Logging with Default Context
ai_logger()->with_context( 'example-context' )->info( 'This will log to the example-context.' );
Also supports an array of default log context:
ai_logger()->with_context( [ 'context' => 'example-context', 'key' => 'value', ] )->info( 'This will log to the example-context with key=>value.' );
You can also pass the context to ai_logger()
directly:
ai_logger( 'example-context' )->info( 'This will log to the example-context.' );
Changelog
Please see CHANGELOG for more information on what has changed recently.
Maintainers
This project is actively maintained by Alley Interactive. Like what you see? Come work with us.
License
This software is released under the terms of the GNU General Public License version 2 or any later version.