/siggen/inc/functions.inc

<?php
/**
 * Project: SigGen - Signature and Avatar Generator for WoWRoster
 * File: /inc/functions.inc
 *
 * @link http://www.wowroster.net
 * @license    http://www.gnu.org/licenses/gpl.html   Licensed under the GNU General Public License v3.
 * @author Joshua Clark
 * @version $Id: functions.inc 542 2011-11-26 20:37:05Z c.treyce@gmail.com $
 * @copyright 2005-2011 Joshua Clark
 * @package SigGen
 * @filesource
 */

if ( !defined('IN_ROSTER') )
{
    exit('Detected invalid access to this file!');
}

/**
 * Common SigConfig Functions Class
 * @package SigGen
 */
class SigConfigClass
{
  var $message;
  var $sql_debug;

  /**
   * Check directory status
   *
   * @param string $dir | directory to check
   * @param bool $writeable | check writable
   * @param bool $chmod | chmod directory
   * @return bool | ( true{dir exists} | false{dir does not exist} )
   */
  function checkDir( $dir , $writeable=0 , $chmod=0 )
  {
    // See if it exists
    if( file_exists($dir) )
    {
      if( $writeable )
      {
        if( !is_writable($dir) )
        {
          if( $chmod )
          {
            return @chmod( $dir,0777 );
          }
          else
          {
            return false;
          }
        }
      }
      return true;
    }
    else
    {
      return false;
    }
  }


  /**
   * Create a directory
   *
   * @param string $dir | name of the directory to create
   * @return bool | ( true{created} | false{not created} )
   */
  function makeDir( $dir )
  {
    return @mkdir($dir);
  }


  /**
   * Set the SigGen Config Messages
   *
   * @param string $message | add string to the messages
   */
  function setMessage( $message )
  {
    $this->message .= $message . '[|]';
  }


  /**
   * Get the Messages
   *
   * @return string | Full HTML table with messages
   */
  function getMessage()
  {
    global $roster;

    $message = $this->message;

    if( !empty($message) )
    {
      // Replace newline feeds with <br />
      $messageArr = explode("[|]",$message);

      $output = '';
      $row=0;
      foreach( $messageArr as $line )
      {
        if( $line != '' )
        {
          $output .= $line . '<br />';
        }
      }

      return $output;
    }
    else
    {
      return '';
    }
  }


  /**
   * Create an HTML option list
   *
   * @param array $values    array ($name => $value)
   * @param string $selected what will be selected
   * @param string $id       what to match selected with
   * @param string $type     What value goes into
   *                         0- name
   *                         1- member_id
   * @param string $param    additional crap for <select> field
   * @return string          an html option list
   */
  function createMemberList( $values , $selected , $id , $type=0 , $param='' )
  {
    if( $selected != '' )
    {
      $select_one = true;
    }

    $option_list = "\n\t<select id=\"{$id}\" name=\"{$id}\" $param>\n\t\t<option value=\"\" style=\"color:grey;\">--None--</option>\n";

    foreach( $values as $value )
    {
      $array[$value['server']][$value['member_id']] = $value['name'];
    }

    foreach( $array as $server => $data )
    {
      $option_list .= "\t\t<optgroup label=\"{$server}\">\n";

      foreach( $data as $member_id => $name )
      {
        $value = ($type ? $member_id : "$name@$server");
        if( $selected == $value && $select_one )
        {
          $option_list .= "\t\t\t<option value=\"{$value}\" selected=\"selected\">{$name}</option>\n";
          $select_one = false;
        }
        else
        {
          $option_list .= "\t\t\t<option value=\"{$value}\">{$name}</option>\n";
        }
      }
      $option_list .= "\t\t</optgroup>\n";
    }
    $option_list .= "\t</select>";

    return $option_list;
  }


  /**
   * Create an HTML option list
   *
   * @param array $values    array ($name => $value)
   * @param string $selected what will be selected
   * @param string $id       what to match selected with
   * @param string $type     how to arrange the value/label
   *                         0- name value (LIST)
   *                         1- value name (LISTREV)
   *                         2- name name (NAME)
   *                         3- value value (VALUE)
   * @param string $param    additional crap for <select> field
   * @return string          an html option list
   */
  function createOptionList( $values , $selected , $id , $type='' , $param='' , $none=true )
  {
    if( $selected != '' )
    {
      $select_one = true;
    }

    $option_list = "\n\t<select id=\"{$id}\" name=\"{$id}\" $param>\n";
    $option_list .= ($none ? "\t\t<option value=\"\" style=\"color:grey;\">--None--</option>\n" : '');

    foreach( $values as $Aname => $Avalue )
    {
      switch ($type)
      {
        case 0: // name value
        case 'list':
          $value = $Avalue;
          $name = $Aname;
          break;

        case 1: // value name
        case 'rev':
          $value = $Aname;
          $name = $Avalue;
          break;

        case 2: // name name
        case 'name':
          $value = $Aname;
          $name = $Aname;
          break;

        case 3: // value value
        case 'value':
          $value = $Avalue;
          $name = $Avalue;
          break;

        default:
          $value = $Avalue;
          $name = $Aname;
          break;
      }

      if( $selected == $value && $select_one )
      {
        $option_list .= "\t\t<option value=\"{$value}\" selected=\"selected\">{$name}</option>\n";
        $select_one = false;
      }
      else
      {
        $option_list .= "\t\t<option value=\"{$value}\">{$name}</option>\n";
      }
    }
    $option_list .= "\t</select>";

    return $option_list;
  }


  /**
   * Create an HTML radio set
   *
   * @param array $values    array ($name => $value)
   * @param string $id       what to match selected with
   * @param string $checked  what will be checked
   * @param string $param    additional crap for <select> field
   * @return string          an html option list
   */
  function createRadioSet( $values , $id , $checked , $param='' )
  {
    if( $checked != '' )
    {
      $select_one = true;
    }

    $radio_set = "\n\t<div class=\"radioset\" $param>\n";

    foreach( $values as $name => $value )
    {
      if( $checked == $value && $select_one )
      {
        $radio_set .= "\t\t<input type=\"radio\" id=\"rd-{$id}-{$value}\" name=\"{$id}\" value=\"{$value}\" checked=\"checked\" /><label for=\"rd-{$id}-{$value}\">{$name}</label>\n";
        $select_one = false;
      }
      else
      {
        $radio_set .= "\t\t<input type=\"radio\" id=\"rd-{$id}-{$value}\" name=\"{$id}\" value=\"{$value}\" /><label for=\"rd-{$id}-{$value}\">{$name}</label>\n";
      }
    }
    $radio_set .= "\t</div>";

    return $radio_set;
  }


  /**
   * Create a color picker input field
   *
   * @param string $id       html name of field
   * @param array $value     value of field
   * @return string          color picker html
   */
  function createColorPicker( $name , $value )
  {
    global $roster;

    // Check for Roster version to determine which color picker to use
    if (version_compare(ROSTER_VERSION, '2.1.9', '<')) {
      $color = '<input type="text" maxlength="7" size="10" class="colorinput" style="background-color:' . $value . ';" value="' . $value . '" name="' . $name . '" id="' . $name . '" />'
        . '<img src="' . $roster->config['theme_path'] . '/images/color/select_arrow.gif" style="cursor:pointer;vertical-align:middle;margin-bottom:2px;" onclick="showColorPicker(this,document.getElementById(\'' . $name . '\'))" alt="" />';
    }
    else
    {
      $color = '<input type="text" maxlength="7" size="8" class="color-picker" value="' . $value . '" name="' . $name . '" id="' . $name . '" />'
        . '<div class="color-display" style="background-color:' . $value . ';"></div>' . "\n";
    }

    return $color;
  }


  /**
   * Get a list of files from a directory
   *
   * @param string $dir | directory to get list of files
   * @param mixed $ext | get files with this extention can be an array
   * @return array | $file => $name
   */
  function listFiles( $dir , $ext )
  {
    $arrFiles = array();

    // Open the directory
    $tmp_dir = @opendir( $dir );

    if( !empty($tmp_dir) )
    {
      // Read the files
      while( $file = readdir($tmp_dir) )
      {
        $pfad_info = pathinfo($file);

        if( is_array($ext) )
        {
          if( in_array(strtolower($pfad_info['extension']),$ext))
          {
            $name = str_replace('.' . $pfad_info['extension'],'',$file);
            $arrFiles += array($file => $name);
          }
        }
        else
        {
          if( strtolower($pfad_info['extension']) == strtolower($ext) )
          {
            $name = str_replace('.' . $pfad_info['extension'],'',$file);
            $arrFiles += array($file => $name);
          }
        }
      }
      // close the directory
      closedir($tmp_dir);

      //sort the list
      asort($arrFiles);
    }
    return $arrFiles;
  }


  /**
   * Get a list of directories from a directory
   *
   * @param string $dir | directory to get list of directories
   * @return array | $file => $name
   */
  function listDir( $dir )
  {
    $arrFiles = array();

    // Open the directory
    $tmp_dir = @opendir( $dir );

    if( !empty($tmp_dir) )
    {
      // Read the files
      while( $file = readdir($tmp_dir) )
      {
        if( is_dir($dir . $file) && $file != '.' && $file != '..' )
        {
          $arrFiles += array($file => $file);
        }
      }
      // close the directory
      closedir($tmp_dir);

      //sort the list
      asort($arrFiles);
    }
    return $arrFiles;
  }


  /**
   * Check if a table exists
   *
   * @param string $table | db table to check
   * @return array ( $name => $value )
   */
  function checkDb( $table )
  {
    global $roster;

    $sql_str = "SHOW TABLES LIKE '$table';";

    $result = $roster->db->query($sql_str);

    $r = $roster->db->fetch($result, SQL_ASSOC);

    if( empty($r) )
    {
      return false;
    }
    else
    {
      return true;
    }
  }


  /**
   * Get Data from the database
   *
   * @param string $table | table to get data from
   * @param string $field | field to get data from ( default *{all} )
   * @param string $where | where statement ( default ''{blank} )
   * @param string $order | order by statement ( default ''{blank} )
   * @return array ( $name => $value )
   */
  function getDbData( $table , $field , $where='', $order='' )
  {
    global $roster;

    if( !empty($table) )
    {
      if( !empty($where) )
      {
        $where = ' WHERE ' . $where;
      }

      if( !empty($order) )
      {
        $order = ' ORDER BY ' . $order;
      }

      if( empty($field) )
      {
        $field = '*';
      }

      // SQL String
      $sql_str = "SELECT $field FROM `$table`$where$order;";

      $result = $roster->db->query($sql_str);

      if ( $result )
      {
        if( $roster->db->num_rows() > 1 )
        {
          $data = array();
          for( $i=0; $i<$roster->db->num_rows(); $i++)
          {
            $row = $roster->db->fetch($result, SQL_ASSOC);
            $data[] = $row;
          }
          return $data;
        }
        else
        {
          $data = $roster->db->fetch($result, SQL_ASSOC);
          return $data;
        }
      }
    }
  }


  /**
   * Get list of a field from the database
   *
   * @param string $table | table to get data from
   * @param string $field | field to get data from ( default *{all} )
   * @param string $where | where statement ( default ''{blank} )
   * @param string $order | order by statement ( default ''{blank} )
   * @return array ( $name => $value )
   */
  function getDbList( $table , $field , $where='', $order='' )
  {
    global $roster;

    if( !empty($table) )
    {
      if( !empty($where) )
      {
        $where = ' WHERE ' . $where;
      }

      if( !empty($order) )
      {
        $order = ' ORDER BY ' . $order;
      }

      if( empty($field) )
      {
        $field = '*';
      }
      else
      {
        $field = "`$field`";
      }

      // SQL String
      $sql_str = "SELECT $field FROM `$table`$where$order;";

      $result = $roster->db->query($sql_str);

      while( $r = $roster->db->fetch($result, SQL_ASSOC) )
      {
        $list[] = $r[trim($field,'`')];
      }
      return $list;
    }
  }


  /**
   * Get a list of tables from a database
   *
   * @param string $table | name of db table
   * @return array ( $name => $value )
   */
  function getDbColumns( $table )
  {
    global $roster;

    if( !empty($table) )
    {
      // SQL String
      $sql_str = "SHOW COLUMNS FROM `$table`";

      $result = $roster->db->query($sql_str);

      while( $row = $roster->db->fetch($result,SQL_NUM) )
      {
        $col_names[] = $row[0];
      }
      return $col_names;
    }
  }


  /**
   * Upload Images to a folder
   *
   * @param string $dir | directory to upload image to
   * @param string $filename | filename of final uploaded image
   * @return bool
   */
  function uploadImage( $dir , $filename )
  {
    global $roster;

    $accepted_files = array('png','gif','jpg','jpeg');

    $uploaded_filename = $_FILES['userfile']['name'];
    $uploaded_fileext = strtolower(ltrim(strrchr($uploaded_filename,'.'),'.'));

    $userfile_name = ( isset($_FILES['userfile']['name']) ? $filename . '.' . $uploaded_fileext : '' );

    if( isset($_FILES['userfile']) )
    {
      if( empty($_FILES['userfile']['name']) )
      {
        $this->setMessage($roster->locale->act['select_image_upload']);
        return false;
      }
      elseif( empty( $filename ) )
      {
        $this->setMessage($roster->locale->act['select_name_upload']);
        return false;
      }
      else
      {
        $userfile_name = $_POST['image_type'] . $userfile_name;

        if( !in_array( $uploaded_fileext,$accepted_files ) )
        {
          $this->setMessage($roster->locale->act['image_mustbe_right']);
          return false;
        }

        if( file_exists($dir . $userfile_name) )
        {
          if( md5_file($dir . $userfile_name) == md5_file($_FILES['userfile']['tmp_name']) )
          {
            $this->setMessage($roster->locale->act['image_a_copy']);
            return false;
          }
        }

        if( !move_uploaded_file( $_FILES['userfile']['tmp_name'],$dir . $userfile_name ) || !chmod( $dir . $userfile_name,0777 ) )
        {
          $this->setMessage(sprintf($roster->locale->act['image_upload_failed'],$userfile_name,str_replace( '\\','/',$dir )));
          return false;
        }
        else
        {
          $this->setMessage(sprintf($roster->locale->act['image_upload_success'],$userfile_name,str_replace( '\\','/',$dir )));
          return true;
        }
      }
    }
    else
    {
      return false;
    }
  }


  /**
   * Delete an image from a folder
   *
   * @param string $dir | directory to delete image from
   * @param string $filename | filename of image to delete
   * @return bool
   */
  function deleteImage( $dir , $filename )
  {
    global $roster;

    if( empty($filename) )
    {
      $this->setMessage($roster->locale->act['select_image_delete']);
      return false;
    }
    else
    {
      if( file_exists($dir . $filename) )
      {
        if( unlink($dir . $filename) )
        {
          $this->setMessage(sprintf($roster->locale->act['image_deleted'],str_replace( '\\','/',$dir ) . $filename));
          return true;
        }
        else
        {
          $this->setMessage(sprintf($roster->locale->act['image_delete_failed'],str_replace( '\\','/',$dir ) . $filename));
          return false;
        }
      }
    }
  }


  /**
   * Process Data for entry to the database
   *
   * @param array $post | $_POST array
   * @param string $config_name | db id to process
   */
  function processData( $post , $config_name, $data )
  {
    global $roster;

    $configData = $data;

    // Array for color fixing
    $color_fix = array(
      'backg_fill_color',
      'expbar_color_border',
      'expbar_color_inside',
      'expbar_color_bar',
      'expbar_color_maxbar',
      'expbar_font_color',
      'expbar_text_shadow',
      'lvl_font_color',
      'lvl_text_shadow',
      'skills_font_color',
      'skills_shadow',
      'text_name_font_color',
      'text_name_shadow',
      'text_class_font_color',
      'text_class_shadow',
      'text_honor_font_color',
      'text_honor_shadow',
      'text_guildname_font_color',
      'text_guildname_shadow',
      'text_guildtitle_font_color',
      'text_guildtitle_shadow',
      'text_servername_font_color',
      'text_servername_shadow',
      'text_sitename_font_color',
      'text_sitename_shadow',
      'text_talpoints_font_color',
      'text_talpoints_shadow',
      'text_custom_font_color',
      'text_custom_shadow',
    );
    // Update only the changed fields
    $sqlarray = array();
    foreach( $post as $settingName => $settingValue )
    {
      // Fix colors
      if( in_array($settingName,$color_fix) && $settingValue != '' )
      {
        if( substr($settingValue, 0, 1) != '#' )
        {
          $settingValue = '#' . strtoupper($settingValue);
        }
        else
        {
          $settingValue = strtoupper($settingValue);
        }
      }

      // Fix directories
      if( substr($settingName, -4, 4) == '_dir' )
      {
        // Replace slashes
        $settingValue = str_replace( '\\\\','/',$settingValue );
        $settingValue = str_replace( '\\','/',$settingValue );

        // Check for directories defined with no '/' at the end
        // and with a '/' at the beginning
        if( substr($settingValue, -1, 1) != '/' )
        {
          $settingValue .= '/';
        }
        if( substr($settingValue, 0, 1) == '/' && $settingName != 'save_images_dir' )
        {
          $settingValue = substr($settingValue, 1);
        }
      }

      if( $settingName != 'sc_op' && $settingValue != $configData[$settingName] )
      {
        $sqlarray += array($settingName => $settingValue);
      }
    }

    // Update DataBase
    if( count($sqlarray) > 0 )
    {
      $update_sql = 'UPDATE `' . ROSTER_SIGCONFIGTABLE . "` SET " . $roster->db->build_query('UPDATE',$sqlarray) . " WHERE `config_id` = '" . $config_name . "'";

      $roster->db->query($update_sql) or errorMode( 'processData: ' . $roster->db->error() );

      $this->setMessage( $roster->locale->act['settings_changed'] );
    }
  }


  /**
   * Resets the config to defaults
   *
   * @param bool $confirm | Confirmation to reset
   * @param sting $config_id | db id to process
   */
  function resetDefaults( $confirm , $config_id )
  {
    global $roster;

    $sql_file = SIGGEN_DIR . 'inc/sql.inc';

    if( $confirm )
    {
      if( file_exists($sql_file) )
      {
        include_once( $sql_file );

        if( in_array($config_id,array('avatar','signature')) )
        {
          $sql = $create_sql['reset'][$config_id];
        }
        else
        {
          $sql = sprintf($create_sql['reset']['default'],$config_id);
        }

        $roster->db->query($sql) or errorMode( 'resetDefaults: ' . $roster->db->error() );

        $this->setMessage($roster->locale->act['settings_reset']);
      }
      else
      {
        $this->setMessage(sprintf($roster->locale->act['cannot_find_file'],$sql_file));
      }
    }
    else
    {
      $this->setMessage($roster->locale->act['reset_checkbox']);
    }
  }



  /**
   * Creates a new config mode
   *
   * @param string  Config ID
   * @return bool   Success or not
   */
  function new_config( $name )
  {
    global $roster;

    $exists = $this->getDbData(ROSTER_SIGCONFIGTABLE , '`config_id`' , "`config_id` = '$name'");

    if( $exists == '' )
    {
      if( preg_match('/[^a-z0-9_-]/', $name) )
      {
        $this->setMessage($roster->locale->act['config_invalid']);
        return false;
      }
      else
      {
        $sql_file = SIGGEN_DIR . 'inc/sql.inc';

        if( file_exists($sql_file) )
        {
          include_once( $sql_file );

          $sql = sprintf($create_sql['reset']['default'],$name);

          $roster->db->query($sql) or errorMode( 'new_config: ' . $roster->db->error() );

          $this->setMessage(sprintf($roster->locale->act['config_created'],$name));
          return true;
        }
        else
        {
          $this->setMessage(sprintf($roster->locale->act['cannot_find_file'],$sql_file));
          return false;
        }
      }
    }
    else
    {
      $this->setMessage(sprintf($roster->locale->act['config_exists'],$name));
      return false;
    }
  }



  /**
   * Deletes a config mode
   *
   * @param string  Config ID
   * @return bool   Success or not
   */
  function delete_config( $name )
  {
    global $roster;

    if( in_array($name,array('avatar','signature')) )
    {
      $this->setMessage($roster->locale->act['config_cannot_delete_default']);
      return false;
    }
    else
    {
      $exists = $this->getDbData(ROSTER_SIGCONFIGTABLE , '`config_id`' , "`config_id` = '$name'");

      if( $exists != '' )
      {
        $sql = "DELETE FROM `" . ROSTER_SIGCONFIGTABLE . "` WHERE `config_id` = '$name';";
        $roster->db->query($sql) or errorMode( 'delete_config: ' . $roster->db->error() );

        $this->setMessage(sprintf($roster->locale->act['config_deleted'],$name));
        return true;
      }
      else
      {
        $this->setMessage(sprintf($roster->locale->act['config_cannot_delete'],$name));
        return false;
      }
    }
  }



  /**
   * Grabs settings from a file, exported from SigGen
   *
   * @param string  Config ID to import
   * @return bool   Success or not
   */
  function importSettings( $checkData , $config_id )
  {
    global $roster, $sc_db_ver;

    $accepted_file = "siggen_$config_id.txt";

    $uploaded_filename = $_FILES['userfile']['name'];
    $temp_file = $_FILES['userfile']['tmp_name'];

    $ignore = array('config_id','db_ver');

    if( isset($_FILES['userfile']) )
    {
      if( empty($_FILES['userfile']['name']) )
      {
        $this->setMessage(sprintf($roster->locale->act['select_import_file'],$accepted_file));
        return false;
      }
      else
      {
        if( $accepted_file != $uploaded_filename )
        {
          $this->setMessage($roster->locale->act['import_mustbe_right']);
          return false;
        }

        if( file_exists($temp_file) && is_readable($temp_file) )
        {
          $file_as_array = file($temp_file);

          $firstline = true;
          $settingsArray = array();
          foreach( $file_as_array as $file_line )
          {
            $file_line = trim($file_line);
            list($value,$setting) = explode('|',$file_line);

            if( $firstline )
            {
              if( version_compare($sc_db_ver, $value, '<') )
              {
                $this->setMessage(sprintf($roster->locale->act['import_upload_failed_ver'],$value,$sc_db_ver));
                return false;
              }
              $firstline = false;
            }
            elseif( !in_array($value,$ignore) )
            {
              $settingsArray[$value] = $setting;
            }
          }
          $this->processData($settingsArray,$config_id,$checkData);

          $this->setMessage($roster->locale->act['import_upload_success']);

          return true;
        }
        else
        {
          $this->setMessage($roster->locale->act['import_upload_failed']);
          return false;
        }
      }
    }
    else
    {
      return false;
    }
  }



  /**
   * Grabs settings from SigGen, exports them to a file
   *
   * @param array  $checkData    SigGen Data
   * @param string $config_id    Current config
   */
  function exportSettings( $checkData , $config_id )
  {
    global $sc_db_ver;

    $file = "$sc_db_ver|$config_id\n";

    foreach( $checkData as $name => $value )
    {
      $file .= "$name|$value\n";
    }

    header('Content-Type: text/x-delimtext; name="siggen_' . $config_id . '.txt"');
    header('Content-disposition: attachment; filename="siggen_' . $config_id . '.txt"');

    // We need to stripslashes no matter what the setting of magic_quotes_gpc is
    echo stripslashes($file);

    exit;
  }


  /**
   * Create a tooltip
   *
   * @param string $content | Content in tooltip
   * @param string $caption | Text in the caption
   * @return string ( Overlib styled tooltip )
   */
  function createTip( $content , $caption )
  {
    $tipsettings = ",WRAP";

    if( !empty($caption) )
    {
      $caption2 = ",CAPTION,'$caption'";
    }

    $tip = "<span class=\"ui-icon ui-icon-help\" style=\"cursor:help;\" onmouseover=\"overlib('$content'$caption2$tipsettings);\" onmouseout=\"return nd();\"></span>$caption";

    return $tip;
  }


  /**
   * Create a tooltip icon
   *
   * @param string $content | Content in tooltip
   * @param string $caption | Text in the caption
   * @return string ( Overlib styled tooltip )
   */
  function createTipIcon( $content , $caption )
  {
    $tipsettings = ",WRAP";

    if( !empty($caption) )
    {
      $caption2 = ",CAPTION,'$caption'";
    }

    $tip = "<span class=\"ui-icon ui-icon-help\" style=\"cursor:help;\" onmouseover=\"overlib('$content'$caption2$tipsettings);\" onmouseout=\"return nd();\"></span>";

    return $tip;
  }


  /**
   * Creates a table for viewing image packs
   *
   * @param string $dir
   */
  function imagePreview($dir)
  {
    global $roster, $addon;

    $return = '<table cellpadding="0" cellspacing="0" style="font-size:10px;">';

    $dirname = '.';
    $pattern = "(\\.png$)"; // valid image extensions
    $columns = 2;
    $drawIndex = 0;

    if($handle = opendir($dirname))
    {
      while(false !== ($file = readdir($handle)))
      {
        if(eregi($pattern, $file)) //if this file is a valid image
        {
          if($drawIndex == 0)
          {
            $return .= '<tr>';
          }

          $return .= '<td align="center"><img src="' . $addon['url_path'] . 'img/' . $file . '" style="border:0;"><br />' . $file . '</td>';
          $drawIndex++;

          if($drawIndex == $columns)
          {
            $return .= '</tr>';
            $drawIndex = 0;
          }
        }
      }

      if($drawIndex !== 0)
      {
        $finishDraw = $columns - $drawIndex;
        while($finishDraw !== 0)
        {
          $return .= '<td>&nbsp;</td>';
          $finishDraw--;
        }
        $return .= '</tr>';
      }
    }
    closedir($handle);

    $return .= '</table>';
  }

}