{"id":41793,"date":"2016-02-08T16:05:40","date_gmt":"2016-02-08T16:05:40","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/custom-logging-service\/"},"modified":"2016-12-09T18:11:53","modified_gmt":"2016-12-09T18:11:53","slug":"custom-logging-service","status":"closed","type":"plugin","link":"https:\/\/pl.wordpress.org\/plugins\/custom-logging-service\/","author":13770142,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.3","stable_tag":"trunk","tested":"4.7.33","requires":"4.0","requires_php":"","requires_plugins":"","header_name":"Custom Logging Service","header_author":"Claus Colloseus","header_description":"","assets_banners_color":"","last_updated":"2016-12-09 18:11:53","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/ccprog\/custom-logging-service","header_author_uri":"https:\/\/browser-unplugged.net","rating":0,"author_block_rating":0,"active_installs":10,"downloads":1485,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1345977","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1345977","resolution":"2","location":"assets"}},"screenshots":{"1":"Settings screen","2":"Log page"}},"plugin_section":[],"plugin_tags":[1522],"plugin_category":[36,59],"plugin_contributors":[87972],"plugin_business_model":[],"class_list":["post-41793","plugin","type-plugin","status-closed","hentry","plugin_tags-logging","plugin_category-analytics","plugin_category-utilities-and-tools","plugin_contributors-ccprog","plugin_committers-ccprog"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/custom-logging-service.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/custom-logging-service\/assets\/screenshot-1.png?rev=1345977","caption":"Ustawienia g\u0142\u00f3wne screen"},{"src":"https:\/\/ps.w.org\/custom-logging-service\/assets\/screenshot-2.png?rev=1345977","caption":"Log page"}],"raw_content":"<!--section=description-->\n<p>This plugin is derived from the no longer supported\n<a href=\"https:\/\/wordpress.org\/plugins\/wordpress-logging-service\">Wordpress Logging Service<\/a>.\nDespite that it is not compatiple with it, and there is no upgrade path from one\nto the other.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>No log entries generated by the plugin itself, all come from external API calls<\/li>\n<li>Organisation of log entries in freetext categories<\/li>\n<li>Severity levels<\/li>\n<li>Freetext log messages<\/li>\n<li>Entries can be marked as seen and then filtered from being displayed again<\/li>\n<li>Filtering by minimum severity level<\/li>\n<li>Sort by date, category, user name, severity or blog name (in Multisite installations)<\/li>\n<li>Access to the log page can be granted by user role<\/li>\n<\/ul>\n\n<h3>API<\/h3>\n\n<h4>Constants<\/h4>\n\n<p>Check to test if the plugin is active:<\/p>\n\n<pre><code>CLGS = true\n<\/code><\/pre>\n\n<p>Defined severity levels:<\/p>\n\n<pre><code>CLGS_NOSEVERITY = 0\nCLGS_INFO = 1\nCLGS_NOTICE = 2\nCLGS_WARNING = 3\nCLGS_ERROR = 4\nCLGS_FATALERROR = 5\n<\/code><\/pre>\n\n<h4>Functions<\/h4>\n\n<pre><code>clgs_is_registered ( $category )\n<\/code><\/pre>\n\n<ul>\n<li><code>string $category<\/code><\/li>\n<\/ul>\n\n<p><em>returns<\/em> <code>true<\/code> if <code>$category<\/code> is registered.<\/p>\n\n<pre><code>clgs_register ( $category, $description )\n<\/code><\/pre>\n\n<p>registers <code>$category<\/code> as a log category. <code>$description<\/code> will be shown in the\nmanagement page.<br \/>\nIt is good practice to use unique categories for each plugin that publishes\nlog messages.<\/p>\n\n<ul>\n<li><code>string $category<\/code> At most 190 (unicode) characters<\/li>\n<li><code>string $description<\/code> can contain HTML same as comments (filtered by\n  wp_kses_data)<\/li>\n<\/ul>\n\n<p><em>returns<\/em> <code>false<\/code> if the category is already registered or it is too long.<\/p>\n\n<pre><code>clgs_clear ( $category )\n<\/code><\/pre>\n\n<p>deletes all log entries of <code>$category<\/code>.<\/p>\n\n<ul>\n<li><code>string $description<\/code> existing category<\/li>\n<\/ul>\n\n<p><em>returns<\/em> number of deleted entries or <code>false<\/code> if action failed.<\/p>\n\n<pre><code>clgs_unregister( $category );\n<\/code><\/pre>\n\n<p>deletes all log entries and then removes <code>$category<\/code>.<\/p>\n\n<ul>\n<li><code>string $description<\/code> existing category<\/li>\n<\/ul>\n\n<p><em>returns<\/em> <code>false<\/code> if false if action failed.<\/p>\n\n<pre><code>clgs_log( $category, $text, $severity = null, $user = null, $blog_id = null, $date = null );\n<\/code><\/pre>\n\n<p>writes a new log entry in the specified category<\/p>\n\n<ul>\n<li><code>string $description<\/code> a registered category name<\/li>\n<li><code>string $text<\/code> the logged message, can contain HTML same as comments (filtered\nby <code>wp_kses_data<\/code>)<\/li>\n<li><code>int $severity<\/code> one of defined severity levels (see above); if missing defaults to\n  CLGS_NOCATEGORY<\/li>\n<li><code>int | string | WP_User $user<\/code> user id, slug or WP user object are aceptable; if missing\ndefaults to current user (or a placeholder if none is logged in)<\/li>\n<li><code>int $blog_id<\/code> blog id; if missing defaults to current blog<\/li>\n<li><code>int | double | string $date<\/code> a UNIX timestamp or a string recognized by <code>strtotime()<\/code>;\nif missing defaults to current time<\/li>\n<\/ul>\n\n<p><em>returns<\/em> <code>false<\/code> if entering the log failed.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install from <em>Plugins -&gt; Add New<\/em><\/li>\n<li>Or download the .zip and extract to <code>wp-content\/plugins<\/code><\/li>\n<li>Activate the plugin from the <em>Plugins<\/em> menu. In Multisite installations, feel free\nto activate as a network plugin or to leave it to individual blogs.<\/li>\n<li>Go to <em>Settings -&gt; Custom Logging Service<\/em> for the next steps<\/li>\n<\/ol>\n\n<h4>Settings<\/h4>\n\n<ul>\n<li><strong>Minimum severity for notification:<\/strong> You will see the number of unseen log entries\nof that level or above next to the menu entry for the log page.<\/li>\n<li><strong>Default minimum severity filter:<\/strong> Which severity levels you will see in the log page.\nYou can change this filter later on the page.<\/li>\n<li><strong>Roles that can manage Custom Logs:<\/strong> Decide who can see and interact with the log page.<\/li>\n<li><strong>Log entries per page:<\/strong> Set the number of entries per page.<\/li>\n<\/ul>\n\n<h4>Generating Log messages<\/h4>\n\n<p>This plugin does not generate any log messages by itself. You need other plugins to\ninteract with it through the API; see the API section for details.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt>Where are the logs?<\/dt>\n<dd><p>Find them under Dashboard -&gt; Selected Logs.<\/p><\/dd>\n<dt>I can't find the option to add roles for log management!<\/dt>\n<dd><p>If the plugin has been installed network-wide in Multisite, only the Super Admin\nhas access to the logs. Sorry, I don't understand role management in Multisite.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.3<\/h4>\n\n<p>Compatibility with WP 4.7<\/p>\n\n<h4>1.0.2<\/h4>\n\n<p>Compatibility with WP 4.6<\/p>\n\n<h4>1.0.1<\/h4>\n\n<p>Compatibility with WP 4.5<\/p>\n\n<h4>1.0.0<\/h4>\n\n<p>First version, derived from <a href=\"https:\/\/profiles.wordpress.org\/zaantar\/\">zaantar's<\/a>\n<a href=\"https:\/\/wordpress.org\/plugins\/wordpress-logging-service\">Wordpress Logging Service<\/a><\/p>","raw_excerpt":"Provides a simple API for storing miscellaneous log entries and displays them in a Dashboard subpage.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/41793","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=41793"}],"author":[{"embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ccprog"}],"wp:attachment":[{"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=41793"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=41793"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=41793"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=41793"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=41793"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/pl.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=41793"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}