Support Joomla!

Joomla! 1.5 Documentation

Packages

Package: Joomla-Framework

License

Content on this site is copyright © 2005 - 2008 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution- NonCommercial- ShareAlike 2.5. Some parts of this website may be subject to other licenses.
Source code for file /joomla/filter/filteroutput.php

Documentation is available at filteroutput.php

  1. <?php
  2. /**
  3.  * @version        $Id:output.php 6961 2007-03-15 16:06:53Z tcp $
  4.  * @package        Joomla.Framework
  5.  * @subpackage    Filter
  6.  * @copyright    Copyright (C) 2005 - 2008 Open Source Matters. All rights reserved.
  7.  * @license        GNU/GPL, see LICENSE.php
  8.  *  Joomla! is free software. This version may have been modified pursuant to the
  9.  *  GNU General Public License, and as distributed it includes or is derivative
  10.  *  of works licensed under the GNU General Public License or other free or open
  11.  *  source software licenses. See COPYRIGHT.php for copyright notices and
  12.  *  details.
  13.  */
  14.  
  15. /**
  16.  * JFilterOutput
  17.  *
  18.  * @static
  19.  * @author        Louis Landry <louis.landry@joomla.org>
  20.  * @package     Joomla.Framework
  21.  * @subpackage    Filter
  22.  * @since        1.5
  23.  */
  24. class JFilterOutput
  25. {
  26.     /**
  27.     * Makes an object safe to display in forms
  28.     *
  29.     * Object parameters that are non-string, array, object or start with underscore
  30.     * will be converted
  31.     *
  32.     * @static
  33.     * @param object An object to be parsed
  34.     * @param int The optional quote style for the htmlspecialchars function
  35.     * @param string|arrayAn optional single field name or array of field names not
  36.     *                      to be parsed (eg, for a textarea)
  37.     * @since 1.5
  38.     */
  39.     function objectHTMLSafe( &$mixed, $quote_style=ENT_QUOTES, $exclude_keys='' )
  40.     {
  41.         if (is_object( $mixed ))
  42.         {
  43.             foreach (get_object_vars( $mixed ) as $k => $v)
  44.             {
  45.                 if (is_array( $v ) || is_object( $v ) || $v == NULL || substr( $k, 1, 1 ) == '_' ) {
  46.                     continue;
  47.                 }
  48.  
  49.                 if (is_string( $exclude_keys ) && $k == $exclude_keys) {
  50.                     continue;
  51.                 } else if (is_array( $exclude_keys ) && in_array( $k, $exclude_keys )) {
  52.                     continue;
  53.                 }
  54.  
  55.                 $mixed->$k = htmlspecialchars( $v, $quote_style, 'UTF-8' );
  56.             }
  57.         }
  58.     }
  59.  
  60.     /**
  61.      * This method processes a string and replaces all instances of & with &amp; in links only
  62.      *
  63.      * @static
  64.      * @param    string    $input    String to process
  65.      * @return    string    Processed string
  66.      * @since    1.5
  67.      */
  68.     function linkXHTMLSafe($input)
  69.     {
  70.         $regex = 'href="([^"]*(&(amp;){0})[^"]*)*?"';
  71.         return preg_replace_callback( "#$regex#i", array('JFilterOutput', '_ampReplaceCallback'), $input );
  72.     }
  73.  
  74.     /**
  75.      * This method processes a string and replaces all accented UTF-8 characters by unaccented
  76.      * ASCII-7 "equivalents", whitespaces are replaced by hyphens and the string is lowercased.
  77.      *
  78.      * @static
  79.      * @param    string    $input    String to process
  80.      * @return    string    Processed string
  81.      * @since    1.5
  82.      */
  83.     function stringURLSafe($string)
  84.     {
  85.         //remove any '-' from the string they will be used as concatonater
  86.         $str = str_replace('-', ' ', $string);
  87.  
  88.         $lang =& JFactory::getLanguage();
  89.         $str = $lang->transliterate($str);
  90.  
  91.         // remove any duplicate whitespace, and ensure all characters are alphanumeric
  92.         $str = preg_replace(array('/\s+/','/[^A-Za-z0-9\-]/'), array('-',''), $str);
  93.  
  94.         // lowercase and trim
  95.         $str = trim(strtolower($str));
  96.         return $str;
  97.     }
  98.  
  99.     /**
  100.     * Replaces &amp; with & for xhtml compliance
  101.     *
  102.     * @todo There must be a better way???
  103.     *
  104.     * @static
  105.     * @since 1.5
  106.     */
  107.     function ampReplace( $text )
  108.     {
  109.         $text = str_replace( '&&', '*--*', $text );
  110.         $text = str_replace( '&#', '*-*', $text );
  111.         $text = str_replace( '&amp;', '&', $text );
  112.         $text = preg_replace( '|&(?![\w]+;)|', '&amp;', $text );
  113.         $text = str_replace( '*-*', '&#', $text );
  114.         $text = str_replace( '*--*', '&&', $text );
  115.  
  116.         return $text;
  117.     }
  118.  
  119.     /**
  120.      * Callback method for replacing & with &amp; in a string
  121.      *
  122.      * @static
  123.      * @param    string    $m    String to process
  124.      * @return    string    Replaced string
  125.      * @since    1.5
  126.      */
  127.     function _ampReplaceCallback( $m )
  128.     {
  129.          $rx = '&(?!amp;)';
  130.          return preg_replace( '#'.$rx.'#', '&amp;', $m[0] );
  131.     }
  132.  
  133.     /**
  134.     * Cleans text of all formating and scripting code
  135.     */
  136.     function cleanText ( &$text )
  137.     {
  138.         $text = preg_replace( "'<script[^>]*>.*?</script>'si", '', $text );
  139.         $text = preg_replace( '/<a\s+.*?href="([^"]+)"[^>]*>([^<]+)<\/a>/is', '\2 (\1)', $text );
  140.         $text = preg_replace( '/<!--.+?-->/', '', $text );
  141.         $text = preg_replace( '/{.+?}/', '', $text );
  142.         $text = preg_replace( '/&nbsp;/', ' ', $text );
  143.         $text = preg_replace( '/&amp;/', ' ', $text );
  144.         $text = preg_replace( '/&quot;/', ' ', $text );
  145.         $text = strip_tags( $text );
  146.         $text = htmlspecialchars( $text );
  147.         return $text;
  148.     }
  149. }
Documentation generated on Tue, 29 Jan 2008 18:45:59 +0000 by phpDocumentor 1.3.1