33
2
mirror of https://github.com/joomla-extensions/jedchecker.git synced 2025-01-25 22:58:25 +00:00
This commit is contained in:
Daniel Dimitrov 2013-11-05 20:52:37 +01:00
parent 12169b03eb
commit dac3bf2429

View File

@ -1,6 +1,7 @@
<?php <?php
/** /**
* @author eaxs * @author eaxs <support@projectfork.net>
* @author Daniel Dimitrov <daniel@compojoom.com>
* @date 07/06/2012 * @date 07/06/2012
* @copyright Copyright (C) 2008 - 2012 compojoom.com . All rights reserved. * @copyright Copyright (C) 2008 - 2012 compojoom.com . All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE * @license GNU General Public License version 2 or later; see LICENSE
@ -8,234 +9,175 @@
defined('_JEXEC') or die('Restricted access'); defined('_JEXEC') or die('Restricted access');
/** /**
* Class JEDcheckerReport
*
* This class is meant to be used by JED rules to * This class is meant to be used by JED rules to
* create a report. * create a report.
* *
* @since 1.0
*/ */
class JEDcheckerReport extends JObject class JEDcheckerReport extends JObject
{ {
/** /**
* Contains the report data. * Contains the report data.
* *
* @see reset * @see reset
* @var array * @var array
*/ */
protected $data; protected $data;
/**
* The absolute path to the target extension.
*
* @var string
*/
protected $basedir;
/**
* The absolute path to the target extension.
*
* @var string
*/
protected $basedir;
/** /**
* Constructor. Initialises variables. * Constructor. Initialises variables.
* *
* @param mixed $properties See JObject::__construct * @param mixed $properties Either and associative array or another
* * object to set the initial properties of the object.
* @return \JEDcheckerReport
*/ */
public function __construct($properties = null) public function __construct($properties = null)
{ {
// Construct JObject // Construct JObject
parent::__construct($properties); parent::__construct($properties);
// Initialise vars // Initialise vars
if(empty($this->data)) $this->reset(); if (empty($this->data))
} {
$this->reset();
}
}
/**
* Resets the report data.
*
* @return void
*/
public function reset()
{
$this->data = array();
/** $this->data['errors'] = array();
* Resets the report data. $this->data['compat'] = array();
* $this->data['info'] = array();
* @return void
*/
public function reset()
{
$this->data = array();
$this->data['errors'] = array(); $this->data['count'] = new stdClass;
$this->data['compat'] = array(); $this->data['count']->total = 0;
$this->data['info'] = array(); $this->data['count']->errors = 0;
$this->data['count']->compat = 0;
$this->data['count'] = new stdClass(); $this->data['count']->info = 0;
$this->data['count']->total = 0; }
$this->data['count']->errors = 0;
$this->data['count']->compat = 0;
$this->data['count']->info = 0;
}
/**
* Adds an error to the report.
*
* @param string $location The location of the error. Can be a path to a file or dir.
* @param string $text An optional description of the error.
* @param integer $line If $location is a file, you may specify the line where the
* error occurred.
*
* @return void
*/
public function addError($location, $text = NULL, $line = 0)
{
$item = new stdClass();
$item->location = $location;
$item->line = $line;
$item->text = $text;
$this->addItem($item, 'errors');
}
/** /**
* Adds an error to the report. * Adds an error to the report.
* *
* @param string $location The location of the error. Can be a path to a file or dir. * @param string $location - The location of the error. Can be a path to a file or dir.
* @param string $text An optional description of the error. * @param string $text - An optional description of the error.
* @param integer $line If $location is a file, you may specify the line where the * @param integer $line - If $location is a file, you may specify the line where the
* error occurred. * error occurred.
* *
* @return void * @return void
*/ */
public function addInfo($location, $text = NULL, $line = 0) public function addError($location, $text = null, $line = 0)
{ {
$item = new stdClass(); $item = new stdClass;
$item->location = $location; $item->location = $location;
$item->line = $line; $item->line = $line;
$item->text = $text; $item->text = $text;
$this->addItem($item, 'errors');
}
/**
* Adds an error to the report.
*
* @param string $location - The location of the error. Can be a path to a file or dir.
* @param string $text - An optional description of the error.
* @param integer $line - If $location is a file, you may specify the line where the
* error occurred.
*
* @return void
*/
public function addInfo($location, $text = null, $line = 0)
{
$item = new stdClass;
$item->location = $location;
$item->line = $line;
$item->text = $text;
$this->addItem($item, 'info'); $this->addItem($item, 'info');
} }
/**
* Adds a compatibility issue to the report.
*
* @param string $location - The location of the issue. Can be a path to a file or dir.
* @param string $text - An optional description of the issue
* @param integer $line - If $location is a file, you may specify the line where the
* issue occurred.
*
* @return void
*/
public function addCompat($location, $text = null, $line = 0)
{
$item = new stdClass;
$item->location = $location;
$item->line = $line;
$item->text = $text;
/** $this->addItem($item, 'compat');
* Adds a compatibility issue to the report. }
*
* @param string $location The location of the issue. Can be a path to a file or dir.
* @param string $text An optional description of the issue
* @param integer $line If $location is a file, you may specify the line where the
* issue occurred.
*
* @return void
*/
public function addCompat($location, $text = NULL, $line = 0)
{
$item = new stdClass();
$item->location = $location;
$item->line = $line;
$item->text = $text;
$this->addItem($item, 'compat'); /**
} * Formats the existing report data into HTML and returns it.
*
* @return string The HTML report data
*/
public function getHTML()
{
$html = array();
if ($this->data['count']->total == 0)
{
// No errors or compatibility issues found
$html[] = '<span class="success">';
$html[] = JText::_('COM_JEDCHECKER_EVERYTHING_SEEMS_TO_BE_FINE_WITH_THAT_RULE');
$html[] = '</span>';
}
else
{
$error_count = $this->data['count']->errors;
$compat_count = $this->data['count']->compat;
$info_count = $this->data['count']->info;
/** // Go through the error list
* Formats the existing report data into HTML and returns it. if ($error_count > 0)
* {
* @return string The HTML report data $html[] = '<strong>' . $error_count . ' ' . JText::_('COM_JEDCHECKER_ERRORS') . '</strong>';
*/ $html[] = '<ul class="jedchecker-rule-errors">';
public function getHTML()
{
$html = array();
if($this->data['count']->total == 0) { foreach ($this->data['errors'] AS $i => $item)
// No errors or compatibility issues found
$html[] = '<span class="success">';
$html[] = JText::_('COM_JEDCHECKER_EVERYTHING_SEEMS_TO_BE_FINE_WITH_THAT_RULE');
$html[] = '</span>';
}
else {
$error_count = $this->data['count']->errors;
$compat_count = $this->data['count']->compat;
$info_count = $this->data['count']->info;
// Go through the error list
if($error_count > 0) {
$html[] = '<strong>'.$error_count. ' '.JText::_('COM_JEDCHECKER_ERRORS').'</strong>';
$html[] = '<ul class="jedchecker-rule-errors">';
foreach($this->data['errors'] AS $i => $item)
{
$num = $i + 1;
// Add the error count number
$html[] = '<li><strong>#'.str_pad($num, 3, '0', STR_PAD_LEFT).':</strong>&nbsp;';
$html[] = $item->location;
// Add line information if given
if($item->line > 0) {
$html[] = ' '.JText::_('COM_JEDCHECKER_IN_LINE').': <strong>'.$item->line.'</strong>';
}
// Add text if given
if(!empty($item->text)) {
$html[] = '<br /><small>'.$item->text.'</small>';
}
$html[] = '</li>';
}
$html[] = '</ul>';
}
// Go through the compat list
if($compat_count > 0) {
$html[] = '<strong>'.$error_count. ' '.JText::_('COM_JEDCHECKER_COMPAT_ISSUES').'</strong>';
$html[] = '<ul class="jedchecker-rule-compat">';
foreach($this->data['compat'] AS $i => $item)
{
$num = $i + 1;
// Add the error count number
$html[] = '<li><p><strong>#'.str_pad($num, 3, '0', STR_PAD_LEFT).'</strong> ';
$html[] = $item->location;
// Add line information if given
if($item->line > 0) {
$html[] = ' '.JText::_('COM_JEDCHECKER_IN_LINE').': <strong>'.$item->line.'</strong>';
}
$html[] = '</p>';
// Add text if given
if(!empty($item->text)) {
$html[] = '<small>'.$item->text.'</small>';
}
$html[] = '</li>';
}
$html[] = '</ul>';
}
// Go through the compat list
if($info_count > 0) {
$html[] = '<strong>'.$info_count. ' '.JText::_('COM_JEDCHECKER_INFO').'</strong>';
$html[] = '<ul class="jedchecker-info-message">';
foreach($this->data['info'] AS $i => $item)
{ {
$num = $i + 1; $num = $i + 1;
// Add the error count number // Add the error count number
$html[] = '<li><p><strong>#'.str_pad($num, 3, '0', STR_PAD_LEFT).'</strong> '; $html[] = '<li><strong>#' . str_pad($num, 3, '0', STR_PAD_LEFT) . ':</strong>&nbsp;';
$html[] = $item->location; $html[] = $item->location;
// Add line information if given // Add line information if given
if($item->line > 0) { if ($item->line > 0)
$html[] = ' '.JText::_('COM_JEDCHECKER_IN_LINE').': <strong>'.$item->line.'</strong>'; {
$html[] = ' ' . JText::_('COM_JEDCHECKER_IN_LINE') . ': <strong>' . $item->line . '</strong>';
} }
$html[] = '</p>';
// Add text if given // Add text if given
if(!empty($item->text)) { if (!empty($item->text))
$html[] = '<small>'.$item->text.'</small>'; {
$html[] = '<br /><small>' . $item->text . '</small>';
} }
$html[] = '</li>'; $html[] = '</li>';
@ -243,35 +185,105 @@ class JEDcheckerReport extends JObject
$html[] = '</ul>'; $html[] = '</ul>';
} }
}
// Go through the compat list
if ($compat_count > 0)
{
$html[] = '<strong>' . $error_count . ' ' . JText::_('COM_JEDCHECKER_COMPAT_ISSUES') . '</strong>';
$html[] = '<ul class="jedchecker-rule-compat">';
return implode('', $html); foreach ($this->data['compat'] AS $i => $item)
} {
$num = $i + 1;
// Add the error count number
$html[] = '<li><p><strong>#' . str_pad($num, 3, '0', STR_PAD_LEFT) . '</strong> ';
$html[] = $item->location;
/** // Add line information if given
* Adds an item to the report data if ($item->line > 0)
* {
* @param object $item The item to add. $html[] = ' ' . JText::_('COM_JEDCHECKER_IN_LINE') . ': <strong>' . $item->line . '</strong>';
* @param string $type Optional item type. Can be 'errors' or 'compat'. }
* Defaults to 'errors'.
*
* @return void
*/
protected function addItem($item, $type = 'errors')
{
// Remove the base dir from the location
if(!empty($this->basedir)) {
$item->location = str_replace($this->basedir, '', $item->location);
if($item->location == '') $item->location = '/'; $html[] = '</p>';
}
// Add the item to the report data // Add text if given
$this->data[$type][] = $item; if (!empty($item->text))
{
$html[] = '<small>' . $item->text . '</small>';
}
$this->data['count']->total++; $html[] = '</li>';
$this->data['count']->$type++; }
}
$html[] = '</ul>';
}
// Go through the compat list
if ($info_count > 0)
{
$html[] = '<strong>' . $info_count . ' ' . JText::_('COM_JEDCHECKER_INFO') . '</strong>';
$html[] = '<ul class="jedchecker-info-message">';
foreach ($this->data['info'] AS $i => $item)
{
$num = $i + 1;
// Add the error count number
$html[] = '<li><p><strong>#' . str_pad($num, 3, '0', STR_PAD_LEFT) . '</strong> ';
$html[] = $item->location;
// Add line information if given
if ($item->line > 0)
{
$html[] = ' ' . JText::_('COM_JEDCHECKER_IN_LINE') . ': <strong>' . $item->line . '</strong>';
}
$html[] = '</p>';
// Add text if given
if (!empty($item->text))
{
$html[] = '<small>' . $item->text . '</small>';
}
$html[] = '</li>';
}
$html[] = '</ul>';
}
}
return implode('', $html);
}
/**
* Adds an item to the report data
*
* @param object $item - The item to add.
* @param string $type - Optional item type. Can be 'errors' or 'compat'.
* Defaults to 'errors'.
*
* @return void
*/
protected function addItem($item, $type = 'errors')
{
// Remove the base dir from the location
if (!empty($this->basedir))
{
$item->location = str_replace($this->basedir, '', $item->location);
if ($item->location == '')
{
$item->location = '/';
}
}
// Add the item to the report data
$this->data[$type][] = $item;
$this->data['count']->total++;
$this->data['count']->$type++;
}
} }