Custom Logging Service
Dieses Plugin ist von dem nocht länger unterstützten WordPress Logging Service abgeleitet. Ungeachtet dessen ist es nicht damit kompatibel, und es existiert auch kein Upgrade-Pfad vom einen zum anderen.
Zusatzfunktionen
- Vom Plugin selbst werden keine Log-Einträge generiert, alle haben ihren Urprung in externen API-Aufrufen
- Organisation der Log-Einträge in frei benennbaren Kategorien
- Schweregrade
- Freitext-Nachrichten
- Einträge können als gesehen markiert werden und von der wiederholten Anzeige ausgenommen werden
- Filtern nach dem kleinsten Schweregrad
- Sortieren nach Datum, Kategorie, Benutzername, Schweregrad oder Blogname (in Multisite-Installationen)
- Zugriff auf die Logseite kann nach Benutzerrollen gesteuert werden
API
Konstanten
Check to test if the plugin is active:
CLGS = true
Defined severity levels:
CLGS_NOSEVERITY = 0
CLGS_INFO = 1
CLGS_NOTICE = 2
CLGS_WARNING = 3
CLGS_ERROR = 4
CLGS_FATALERROR = 5
Functions
clgs_is_registered ( $category )
string $category
returns true if $category is registered.
clgs_register ( $category, $description )
registers $category as a log category. $description will be shown in the
management page.
It is good practice to use unique categories for each plugin that publishes
log messages.
string $categoryAt most 190 (unicode) charactersstring $descriptioncan contain HTML same as comments (filtered by wp_kses_data)
returns false if the category is already registered or it is too long.
clgs_clear ( $category )
deletes all log entries of $category.
string $descriptionexisting category
returns number of deleted entries or false if action failed.
clgs_unregister( $category );
deletes all log entries and then removes $category.
string $descriptionexisting category
returns false if false if action failed.
clgs_log( $category, $text, $severity = null, $user = null, $blog_id = null, $date = null );
writes a new log entry in the specified category
string $descriptiona registered category namestring $textthe logged message, can contain HTML same as comments (filtered bywp_kses_data)int $severityone of defined severity levels (see above); if missing defaults to CLGS_NOCATEGORYint | string | WP_User $useruser id, slug or WP user object are aceptable; if missing defaults to current user (or a placeholder if none is logged in)int $blog_idblog id; if missing defaults to current blogint | double | string $datea UNIX timestamp or a string recognized bystrtotime(); if missing defaults to current time
returns false if entering the log failed.