<?php
/**
* @version $Id: HTML.php 14401 2010-01-26 14:10:00Z louis $
* @package Joomla.Framework
* @subpackage HTML
* @copyright Copyright (C) 2005 - 2010 Open Source Matters. All rights reserved.
* @license GNU/GPL, see LICENSE.php
* Joomla! is free software. This version may have been modified pursuant
* to the GNU General Public License, and as distributed it includes or
* is derivative of works licensed under the GNU General Public License or
* other free or open source software licenses.
* See COPYRIGHT.php for copyright notices and details.
*/
defined('JPATH_BASE') or die();
/**
* Utility class for all HTML drawing classes
*
* @static
* @package Joomla.Framework
* @subpackage HTML
* @since 1.5
*/
class JHTML
{
/**
* Class loader method
*
* Additional arguments may be supplied and are passed to the sub-class.
* Additional include paths are also able to be specified for third-party use
*
* @param string The name of helper method to load, (prefix).(class).function
* prefix and class are optional and can be used to load custom
* html helpers.
*/
function _( $type )
{
//Initialise variables
$prefix = 'JHTML';
$file = '';
$func = $type;
// Check to see if we need to load a helper file
$parts = explode('.', $type);
switch(count($parts))
{
case 3 :
{
$prefix = preg_replace( '#[^A-Z0-9_]#i', '', $parts[0] );
$file = preg_replace( '#[^A-Z0-9_]#i', '', $parts[1] );
$func = preg_replace( '#[^A-Z0-9_]#i', '', $parts[2] );
} break;
case 2 :
{
$file = preg_replace( '#[^A-Z0-9_]#i', '', $parts[0] );
$func = preg_replace( '#[^A-Z0-9_]#i', '', $parts[1] );
} break;
}
$className = $prefix.ucfirst($file);
if (!class_exists( $className ))
{
jimport('joomla.filesystem.path');
if ($path = JPath::find(JHTML::addIncludePath(), strtolower($file).'.php'))
{
require_once $path;
if (!class_exists( $className ))
{
JError::raiseWarning( 0, $className.'::' .$func. ' not found in file.' );
return false;
}
}
else
{
JError::raiseWarning( 0, $prefix.$file . ' not supported. File not found.' );
return false;
}
}
if (is_callable( array( $className, $func ) ))
{
$temp = func_get_args();
array_shift( $temp );
$args = array();
foreach ($temp as $k => $v) {
$args[] = &$temp[$k];
}
return call_user_func_array( array( $className, $func ), $args );
}
else
{
JError::raiseWarning( 0, $className.'::'.$func.' not supported.' );
return false;
}
}
/**
* Write a <a></a> element
*
* @access public
* @param string The relative URL to use for the href attribute
* @param string The target attribute to use
* @param array An associative array of attributes to add
* @since 1.5
*/
function link($url, $text, $attribs = null)
{
if (is_array( $attribs )) {
$attribs = JArrayHelper::toString( $attribs );
}
return '<a href="'.$url.'" '.$attribs.'>'.$text.'</a>';
}
/**
* Write a <img></amg> element
*
* @access public
* @param string The relative or absoluete URL to use for the src attribute
* @param string The target attribute to use
* @param array An associative array of attributes to add
* @since 1.5
*/
function image($url, $alt, $attribs = null)
{
if (is_array($attribs)) {
$attribs = JArrayHelper::toString( $attribs );
}
if(strpos($url, 'http')!== 0) {
$url = JURI::root(true).'/'.$url;
};
return '<img src="'.$url.'" alt="'.$alt.'" '.$attribs.' />';
}
/**
* Write a <iframe></iframe> element
*
* @access public
* @param string The relative URL to use for the src attribute
* @param string The target attribute to use
* @param array An associative array of attributes to add
* @param string The message to display if the iframe tag is not supported
* @since 1.5
*/
function iframe( $url, $name, $attribs = null, $noFrames = '' )
{
if (is_array( $attribs )) {
$attribs = JArrayHelper::toString( $attribs );
}
return '<iframe src="'.$url.'" '.$attribs.' name="'.$name.'">'.$noFrames.'</iframe>';
}
/**
* Write a <script></script> element
*
* @access public
* @param string The name of the script file
* * @param string The relative or absolute path of the script file
* @param boolean If true, the mootools library will be loaded
* @since 1.5
*/
function script($filename, $path = 'media/system/js/', $mootools = true)
{
// Include mootools framework
if($mootools) {
JHTML::_('behavior.mootools');
}
if(strpos($path, 'http')!== 0) {
$path = JURI::root(true).'/'.$path;
};
$document = &JFactory::getDocument();
$document->addScript( $path.$filename );
return;
}
/**
* Write a <link rel="stylesheet" style="text/css" /> element
*
* @access public
* @param string The relative URL to use for the href attribute
* @since 1.5
*/
function stylesheet($filename, $path = 'media/system/css/', $attribs = array())
{
if(strpos($path, 'http')!== 0) {
$path = JURI::root(true).'/'.$path;
};
$document = &JFactory::getDocument();
$document->addStylesheet( $path.$filename, 'text/css', null, $attribs );
return;
}
/**
* Returns formated date according to current local and adds time offset
*
* @access public
* @param string date in an US English date format
* @param string format optional format for strftime
* @returns string formated date
* @see strftime
* @since 1.5
*/
function date($date, $format = null, $offset = NULL)
{
if ( ! $format ) {
$format = JText::_('DATE_FORMAT_LC1');
}
if(is_null($offset))
{
$config =& JFactory::getConfig();
$offset = $config->getValue('config.offset');
}
$instance =& JFactory::getDate($date);
$instance->setOffset($offset);
return $instance->toFormat($format);
}
/**
* Creates a tooltip with an image as button
*
* @access public
* @param string $tooltip The tip string
* @param string $title The title of the tooltip
* @param string $image The image for the tip, if no text is provided
* @param string $text The text for the tip
* @param string $href An URL that will be used to create the link
* @param boolean depreciated
* @return string
* @since 1.5
*/
function tooltip($tooltip, $title='', $image='tooltip.png', $text='', $href='', $link=1)
{
$tooltip = addslashes(htmlspecialchars($tooltip, ENT_QUOTES, 'UTF-8'));
$title = addslashes(htmlspecialchars($title, ENT_QUOTES, 'UTF-8'));
if ( !$text ) {
$image = JURI::root(true).'/includes/js/ThemeOffice/'. $image;
$text = '<img src="'. $image .'" border="0" alt="'. JText::_( 'Tooltip' ).'"/>';
} else {
$text = JText::_( $text, true );
}
if($title) {
$title = $title.'::';
}
$style = 'style="text-decoration: none; color: #333;"';
if ( $href ) {
$href = JRoute::_( $href );
$style = '';
$tip = '<span class="editlinktip hasTip" title="'.$title.$tooltip.'" '. $style .'><a href="'. $href .'">'. $text .'</a></span>';
} else {
$tip = '<span class="editlinktip hasTip" title="'.$title.$tooltip.'" '. $style .'>'. $text .'</span>';
}
return $tip;
}
/**
* Displays a calendar control field
*
* @param string The date value
* @param string The name of the text field
* @param string The id of the text field
* @param string The date format
* @param array Additional HTML attributes
*/
function calendar($value, $name, $id, $format = '%Y-%m-%d', $attribs = null)
{
JHTML::_('behavior.calendar'); //load the calendar behavior
if (is_array($attribs)) {
$attribs = JArrayHelper::toString( $attribs );
}
$document =& JFactory::getDocument();
$document->addScriptDeclaration('window.addEvent(\'domready\', function() {Calendar.setup({
inputField : "'.$id.'", // id of the input field
ifFormat : "'.$format.'", // format of the input field
button : "'.$id.'_img", // trigger for the calendar (button ID)
align : "Tl", // alignment (defaults to "Bl")
singleClick : true
});});');
return '<input type="text" name="'.$name.'" id="'.$id.'" value="'.htmlspecialchars($value, ENT_COMPAT, 'UTF-8').'" '.$attribs.' />'.
'<img class="calendar" src="'.JURI::root(true).'/templates/system/images/calendar.png" alt="calendar" id="'.$id.'_img" />';
}
/**
* Add a directory where JHTML should search for helpers. You may
* either pass a string or an array of directories.
*
* @access public
* @param string A path to search.
* @return array An array with directory elements
* @since 1.5
*/
function addIncludePath( $path='' )
{
static $paths;
if (!isset($paths)) {
$paths = array( JPATH_LIBRARIES.DS.'joomla'.DS.'html'.DS.'html' );
}
// force path to array
settype($path, 'array');
// loop through the path directories
foreach ($path as $dir)
{
if (!empty($dir) && !in_array($dir, $paths)) {
array_unshift($paths, JPath::clean( $dir ));
}
}
return $paths;
}
}
