Marcus Downing

<p>Enable system logging for WordPress plugin and theme development. This can make it easier to know what your code is doing.</p>
<p>Features include:</p>
<ul>
<li>Log to the system log or to a file</li>
<li>Easily append or embed any value in log messages</li>
<li>Coloured logs indicating strings, numbers, arrays, objects, null values etc.</li>
<li>Extract values from arrays of objects</li>
<li>Optionally exclude AJAX, Javascripts, CSS and any other pattern of URLs.</li>
<li>Intercept PHP errors and log strict warnings</li>
<li>Measure memory usage between two points, or the time taken by various parts of your code</li>
<li>Easy to switch off for production sites</li>
</ul>
<h4>How to use</h4>
<p>Using it is as simple as calling the <code>'log'</code> action in your templates or plugin.</p>
<pre><code><?php do_action('log', 'Some log message'); ?>
</code></pre>
<p>This will produce a line in your system log:</p>
<pre><code>Jun  4 11:23:08 myserver php/mysite.com[1553]: b8e mysite.com/path-to-page: Some log message
</code></pre>
<p>This includes:</p>
<ul>
<li><code>Jun  4 11:23:08</code> – The date and time of the log message</li>
<li><code>myserver</code> – The name of this computer</li>
<li><code>php</code> – The program that produced the message</li>
<li><code>mysite.com</code> – The domain name of the site</li>
<li><code>1553</code> – The process ID of the running PHP process</li>
<li><code>b8e</code> – A random 3-digit code identifying each page request</li>
<li><code>mysite.com/path-to-page</code> – The URL of the request</li>
<li><code>Some log message</code> – Your message</li>
</ul>
<p>For more detailed instructions, see the <strong>How to use</strong> tab.</p>
<h3>How to use</h3>
<p>To log a message, use the <code>'log'</code> action in your templates or plugins:</p>
<pre><code><?php do_action('log', 'Some log message'); ?>
</code></pre>
<p>This will output the log message:</p>
<pre><code>Some log message
</code></pre>
<h4>Embedding values</h4>
<p>If you include extra parameters, they’ll be added at the end of the log message:</p>
<pre><code><?php do_action('log', 'A number and a string', 17, 'foo'); ?>
</code></pre>
<p>This will produce the log message:</p>
<pre><code>A number and a string: 17, foo
</code></pre>
<p>The value will be formatted correctly depending on its type: integers, strings, arrays, objects, booleans etc.<br />
You don’t need to check if values are null or empty, they’ll still be output safely.</p>
<p>If you put the code <code>%s</code> into your log message, then one of the arguments will be dropped into the message:</p>
<pre><code><?php do_action('log', 'I have %s numbers', count($numbers), $numbers); ?>
</code></pre>
<p>This will produce the log message:</p>
<pre><code>I have 4 numbers: [9, 16, 307, 1]
</code></pre>
<h4>Selecting fields</h4>
<p>Logging a complete object – such as a WordPress post – can be very large, and sometimes it’s only one or two fields you need.<br />
If you put a string starting with an exclamation point <code>"!"</code> followed by a list of field names, they will be selected from the following object.<br />
The following will only show the <code>ID</code> and <code>post_title</code> fields of the post:</p>
<pre><code><?php do_action('log', 'Loaded the post', '!ID,post_title', $post); ?>
</code></pre>
<p>This will produce the log message:</p>
<pre><code>Loaded the post: {ID: 1932, post_title: Test page}
</code></pre>
<p>If you do this with an array of objects, those fields will be selected from each of them. The following will output a list of post <code>ID</code>s:</p>
<pre><code><?php do_action('log', 'Loaded %s posts', count($posts), '!ID', $posts); ?>
</code></pre>
<p>This will produce the log message:</p>
<pre><code>Loaded 3 posts: [1932, 1594, 1103]
</code></pre>
<h4>Coloured logs</h4>
<p>If you have coloured logging switched on, values will appear in different colours to indicate their type.<br />
This can make for quicker scanning of log files.<br />
To enable coloured logs, tick the <em>Coloured logs</em> checkbox on the settings page.<br />
Then use the <code>log.sh</code> script, included with this plugin, to decode and display the coloured log files.</p>


Bang System Logging

Enable system logging for WordPress plugin and theme development.

niknetniko

<p>NextCellent Simple History logs events related to NextCellent in the <a href="https://wordpress.org/plugins/simple-history/" rel="ugc">Simple History</a> plugin.</p>
<p>Currently, it logs following events:</p>
<ul>
<li>Adding galleries</li>
<li>Updating galleries</li>
<li>Deleting galleries</li>
<li>Adding pages for galleries</li>
<li>Adding images to galleries</li>
<li>Adding albums</li>
<li>Editing albums</li>
<li>Deleting albums</li>
<li>Updating the NextCellent options</li>
<li>Deleting images</li>
<li>Updating images</li>
</ul>
<p>Note: this only works with NextCellent Gallery, not with NextGEN Gallery.</p>
<h4>Requirements</h4>
<p>NextCellent Simple History has some requirements to be able to run:</p>
<ul>
<li><a href="https://wordpress.org/plugins/nextcellent-gallery-nextgen-legacy/" rel="ugc">NextCellent</a> 1.9.27 or higher</li>
<li>PHP 5.4 or higher (5.5 or higher is recommended, since 5.4 is no longer supported by PHP)</li>
<li>WordPress 4.0 or higher</li>
</ul>
<h4>Languages</h4>
<p>So far NextCellent Simple History is available to:</p>
<ul>
<li>Dutch</li>
<li>English</li>
<li>Polish (thanks to <a href="http://fw2s.com/" rel="nofollow ugc">Frank P. Walentynowicz</a>)</li>
<li>Danish (<a href="https://profiles.wordpress.org/ThomasDK81" rel="nofollow ugc">thomasdk81</a>)</li>
</ul>
<p>If you want to help, please contact me.</p>
<h4>Source code</h4>
<p>The source code is available on <a href="https://bitbucket.org/niknetniko/ngg-simplehistory" rel="nofollow ugc">BitBucket</a>.</p>
<p>Feel free to contribute.</p>
<h4>Credits</h4>
<p>The plugin icon was adapted from an icon made by <a href="http://www.freepik.com" rel="nofollow ugc">Freepik</a> from <a href="http://www.flaticon.com" rel="nofollow ugc">www.flaticon.com</a> is licensed under <a href="http://creativecommons.org/licenses/by/3.0/" rel="nofollow ugc">Creative Commons BY 3.0</a>.</p>


NextCellent Simple History

Add Simple History integration for NextCellent.

Bang System Logging vs NextCellent Simple History