Merge branch 'yireo-patch-1' into develop

Author: amazeika

README.md

@@ -0,0 +1,31 @@
+joomla-catcher
+==============
+
+Catcher is a bundle of plugins and a library for catching and debug Joomla! events.
+
+## Installation
+
+### Composer
+
+You can install this package using [Composer](https://getcomposer.org/). Create a `composer.json` file inside the root directory of your Joomla! site containing the following code:
+
+```
+{
+    "require": {        
+        "nooku/pkg_catcher": "dev-master"
+    },
+    "minimum-stability": "dev"
+}
+```
+
+Run composer install.
+
+### Phing
+
+For convenience, a [phing](http://www.phing.info/) script for building the package is also available under the `/scripts/build` folder of the repo.
+
+After building it, the package may be installed using the Joomla! extension manager.
+
+## Usage
+
+After the package is installed, make sure to enable the plugins and configure them to catch and report events.

packages/lib_catcher/plugin/abstract.php

@@ -42,26 +42,30 @@ protected function _reportEvent($event, $config = array())
 
         if (in_array($event, $events))
         {
-            $message = '<div class="well">';
+            $output = '<div class="well">';
 
             $args = $config['message']['parameters'];
+
             array_unshift($args, $config['message']['text']);
-            $message .= call_user_func_array(array('JText', 'sprintf'), $args);
+
+            $message = call_user_func_array(array('JText', 'sprintf'), $args);
+
+            $output .= $message;
 
             if (isset($config['new']))
             {
                 if ($config['new']) {
-                    $message .= '<br/>' . JText::_('LIB_CATCHER_ITEM_NEW');
+                    $output .= '<br/>' . JText::_('LIB_CATCHER_ITEM_NEW');
                 } else {
-                    $message .= '<br/>' . JText::_('LIB_CATCHER_ITEM_NOT_NEW');
+                    $output .= '<br/>' . JText::_('LIB_CATCHER_ITEM_NOT_NEW');
                 }
             }
 
             if ($this->params->get('show_data') && ($data = $this->_renderData($config['data'])))
             {
                 $signature = sprintf('%s_%s', $event, md5($data . microtime()));
 
-                $message .= '<br/><div class="panel-group" id="accordion">
+                $output .= '<br/><div class="panel-group" id="accordion">
                               <div class="panel panel-default">
                                 <div class="panel-heading">
                                   <h5 class="panel-title" style="margin: 0px;">
@@ -74,14 +78,19 @@ protected function _reportEvent($event, $config = array())
                                 <div id="' . $signature . '" class="panel-collapse collapse">
                                   <div class="panel-body" style="word-break: break-all;">';
 
-                $message .= $data;
+                $output .= $data;
 
-                $message .= '</div></div></div></div>';
+                $output .= '</div></div></div></div>';
             }
 
-            $message .= '</div>';
+            $output .= '</div>';
+
+            JFactory::getApplication()->enqueueMessage($output, 'warning');
 
-            JFactory::getApplication()->enqueueMessage($message, 'warning');
+            // Add a log entry.
+            jimport('joomla.log.log');
+            JLog::addLogger(array('text_file' => 'catcher.php'), JLog::ALL, array('catcher'));
+            JLog::add(strip_tags($message), JLog::DEBUG, 'catcher');
         }
     }
 
@@ -139,4 +148,4 @@ protected function _renderData($data, $level = 0)
 
         return $output;
     }
-}
+}