Support Joomla!

Joomla! 1.5 Documentation

Packages

Package: Joomla-Framework

Developer Network License

The Joomla! Developer Network content is © copyright 2006 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution- NonCommercial- ShareAlike 2.5
Source code for file /joomla/html/html.php

Documentation is available at html.php

  1. <?php
  2. /**
  3. * @version        $Id: html.php 6749 2007-03-01 22:54:50Z hackwar $
  4. * @package        Joomla.Framework
  5. * @subpackage    HTML
  6. * @copyright    Copyright (C) 2005 - 2007 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
  9. *  to the GNU General Public License, and as distributed it includes or
  10. *  is derivative of works licensed under the GNU General Public License or
  11. *  other free or open source software licenses.
  12. *  See COPYRIGHT.php for copyright notices and details.
  13. */
  14.  
  15. /**
  16.  * Utility class for all HTML drawing classes
  17.  *
  18.  * @static
  19.  * @package     Joomla.Framework
  20.  * @subpackage    HTML
  21.  * @since        1.5
  22.  */
  23. class JHTML
  24. {
  25.     /**
  26.      * Write a <a></a> element
  27.      *
  28.      *  @access public
  29.      * @param string     The relative URL to use for the href attribute
  30.      * @param string    The target attribute to use
  31.      * @param array        An associative array of attributes to add
  32.      * @param integer    Set the SSL functionality
  33.      * @since 1.5
  34.      */
  35.  
  36.     function Link($url, $text, $attribs = null, $ssl = 0)
  37.     {
  38.         $href = JRoute::_($url, $ssl);
  39.  
  40.         if (is_array($attribs)) {
  41.             $attribs = JHTML::_implode_assoc('=', ' ', $attribs);
  42.          }
  43.  
  44.         return '<a href="'.$href.'" '.$attribs.'>'.$text.'</a>';
  45.     }
  46.  
  47.     /**
  48.      * Write a <img></amg> element
  49.      *
  50.      * @access public
  51.      * @param string     The relative URL to use for the src attribute
  52.      * @param string    The target attribute to use
  53.      * @param array        An associative array of attributes to add
  54.      * @since 1.5
  55.      */
  56.     function Image($url, $alt, $attribs = null)
  57.     {
  58.         global $mainframe;
  59.  
  60.         $src = substr( $url, 0, 4 ) != 'http' ? $mainframe->getCfg('live_site') . $url : $url;
  61.  
  62.          if (is_array($attribs)) {
  63.             $attribs = JHTML::_implode_assoc('=', ' ', $attribs);
  64.          }
  65.  
  66.         return '<img src="'.$src.'" alt="'.$alt.'" '.$attribs.' />';
  67.  
  68.     }
  69.  
  70.     /**
  71.      * Write a <script></script> element
  72.      *
  73.      * @access public
  74.      * @param string     The relative URL to use for the src attribute
  75.      * @param string    The target attribute to use
  76.      * @param array        An associative array of attributes to add
  77.      * @since 1.5
  78.      */
  79.     function Script($url, $attribs = null)
  80.     {
  81.         global $mainframe;
  82.  
  83.         $src = $mainframe->getCfg('live_site') . $url;
  84.  
  85.          if (is_array($attribs)) {
  86.             $attribs = JHTML::_implode_assoc('=', ' ', $attribs);
  87.          }
  88.  
  89.         return '<script type="text/javascript" src="'.$src.'" '.$attribs.'></script>';
  90.     }
  91.  
  92.     /**
  93.      * Write a <iframe></iframe> element
  94.      *
  95.      * @access public
  96.      * @param string     The relative URL to use for the src attribute
  97.      * @param string    The target attribute to use
  98.      * @param array        An associative array of attributes to add
  99.      * @param integer    Set the SSL functionality
  100.      * @since 1.5
  101.      */
  102.     function Iframe($url, $name, $attribs = null, $ssl = 0)
  103.     {
  104.         $src = JRoute::_($url, $ssl);
  105.  
  106.          if (is_array($attribs)) {
  107.             $attribs = JHTML::_implode_assoc('=', ' ', $attribs);
  108.          }
  109.  
  110.         return '<iframe src="'.$src.'" '.$attribs.' />';
  111.  
  112.     }
  113.  
  114.     /**
  115.      * Returns formated date according to current local and adds time offset
  116.      *
  117.      * @access public
  118.      * @param string date in an US English date format
  119.      * @param string format optional format for strftime
  120.      * @returns formated date
  121.      * @see strftime
  122.      * @since 1.5
  123.      */
  124.     function Date($date, $format = DATE_FORMAT_LC, $offset = NULL)
  125.     {
  126.         jimport('joomla.utilities.date');
  127.  
  128.         if(is_null($offset))
  129.         {
  130.             $config =& JFactory::getConfig();
  131.             $offset = $config->getValue('config.offset');
  132.         }
  133.         $instance = new JDate($date);
  134.         $instance->setOffset($offset);
  135.  
  136.         return $instance->toFormat($format);
  137.     }
  138.  
  139.  
  140.  
  141.     /**
  142.     * @param int The row index
  143.     * @param int The record id
  144.     * @param boolean 
  145.     * @param string The name of the form element
  146.     * @return string 
  147.     */
  148.     function idBox( $rowNum, $recId, $checkedOut=false, $name='cid' )
  149.     {
  150.         if ( $checkedOut ) {
  151.             return '';
  152.         } else {
  153.             return '<input type="checkbox" id="cb'.$rowNum.'" name="'.$name.'[]" value="'.$recId.'" onclick="isChecked(this.checked);" />';
  154.         }
  155.     }
  156.  
  157.     /**
  158.     * simple Javascript Cloaking
  159.     * email cloacking
  160.      * by default replaces an email with a mailto link with email cloacked
  161.     */
  162.     function emailCloaking( $mail, $mailto=1, $text='', $email=1 )
  163.     {
  164.         // convert text
  165.         $mail             = JHTML::_encoding_converter( $mail );
  166.         // split email by @ symbol
  167.         $mail            = explode( '@', $mail );
  168.         $mail_parts        = explode( '.', $mail[1] );
  169.         // random number
  170.         $rand            = rand( 1, 100000 );
  171.  
  172.         $replacement     = "\n <script language='JavaScript' type='text/javascript'>";
  173.         $replacement     .= "\n <!--";
  174.         $replacement     .= "\n var prefix = '&#109;a' + 'i&#108;' + '&#116;o';";
  175.         $replacement     .= "\n var path = 'hr' + 'ef' + '=';";
  176.         $replacement     .= "\n var addy". $rand ." = '". @$mail[0] ."' + '&#64;';";
  177.         $replacement     .= "\n addy". $rand ." = addy". $rand ." + '". implode( "' + '&#46;' + '", $mail_parts ) ."';";
  178.  
  179.         if ( $mailto ) {
  180.             // special handling when mail text is different from mail addy
  181.             if ( $text ) {
  182.                 if ( $email ) {
  183.                     // convert text
  184.                     $text             = JHTML::_encoding_converter( $text );
  185.                     // split email by @ symbol
  186.                     $text             = explode( '@', $text );
  187.                     $text_parts        = explode( '.', $text[1] );
  188.                     $replacement     .= "\n var addy_text". $rand ." = '". @$text[0] ."' + '&#64;' + '". implode( "' + '&#46;' + '", @$text_parts ) ."';";
  189.                 } else {
  190.                     $replacement     .= "\n var addy_text". $rand ." = '". $text ."';";
  191.                 }
  192.                 $replacement     .= "\n document.write( '<a ' + path + '\'' + prefix + ':' + addy". $rand ." + '\'>' );";
  193.                 $replacement     .= "\n document.write( addy_text". $rand ." );";
  194.                 $replacement     .= "\n document.write( '<\/a>' );";
  195.             } else {
  196.                 $replacement     .= "\n document.write( '<a ' + path + '\'' + prefix + ':' + addy". $rand ." + '\'>' );";
  197.                 $replacement     .= "\n document.write( addy". $rand ." );";
  198.                 $replacement     .= "\n document.write( '<\/a>' );";
  199.             }
  200.         } else {
  201.             $replacement     .= "\n document.write( addy". $rand ." );";
  202.         }
  203.         $replacement     .= "\n //-->";
  204.         $replacement     .= '\n </script>';
  205.  
  206.         // XHTML compliance `No Javascript` text handling
  207.         $replacement     .= "<script language='JavaScript' type='text/javascript'>";
  208.         $replacement     .= "\n <!--";
  209.         $replacement     .= "\n document.write( '<span style=\'display: none;\'>' );";
  210.         $replacement     .= "\n //-->";
  211.         $replacement     .= "\n </script>";
  212.         $replacement     .= JText::_('CLOAKING');
  213.         $replacement     .= "\n <script language='JavaScript' type='text/javascript'>";
  214.         $replacement     .= "\n <!--";
  215.         $replacement     .= "\n document.write( '</' );";
  216.         $replacement     .= "\n document.write( 'span>' );";
  217.         $replacement     .= "\n //-->";
  218.         $replacement     .= "\n </script>";
  219.  
  220.         return $replacement;
  221.     }
  222.  
  223.     /**
  224.      * Keep session alive, for example, while editing or creating an article.
  225.      */
  226.     function keepAlive()
  227.     {
  228.         $js = "
  229.                 function keepAlive() {
  230.                     setTimeout('frames[\'keepAliveFrame\'].location.href=\'index.php?option=com_admin&tmpl=component&task=keepalive\';', 60000);
  231.                 }";
  232.  
  233.         $html = "<iframe id=\"keepAliveFrame\" name=\"keepAliveFrame\" " .
  234.                 "style=\"width:0px; height:0px; border: 0px\" " .
  235.                 "src=\"index.php?option=com_admin&tmpl=component&task=keepalive\" " .
  236.                 "onload=\"keepAlive();\"></iframe>";
  237.  
  238.         $doc =& JFactory::getDocument();
  239.         $doc->addScriptDeclaration($js);
  240.         echo $html;
  241.     }
  242.  
  243.     function _encoding_converter( $text )
  244.     {
  245.         // replace vowels with character encoding
  246.         $text     = str_replace( 'a', '&#97;', $text );
  247.         $text     = str_replace( 'e', '&#101;', $text );
  248.         $text     = str_replace( 'i', '&#105;', $text );
  249.         $text     = str_replace( 'o', '&#111;', $text );
  250.         $text    = str_replace( 'u', '&#117;', $text );
  251.  
  252.         return $text;
  253.     }
  254.  
  255.     function _implode_assoc($inner_glue = "=", $outer_glue = "\n", $array = null, $keepOuterKey = false)
  256.     {
  257.         $output = array();
  258.  
  259.         foreach($array as $key => $item)
  260.         if (is_array ($item)) {
  261.             if ($keepOuterKey)
  262.                 $output[] = $key;
  263.             // This is value is an array, go and do it again!
  264.             $output[] = JHTML::_implode_assoc($inner_glue, $outer_glue, $item, $keepOuterKey);
  265.         } else
  266.             $output[] = $key . $inner_glue . $item;
  267.  
  268.         return implode($outer_glue, $output);
  269.     }
  270. }
  271.  
  272. /**
  273.  * Utility class for creating HTML select lists
  274.  *
  275.  * @static
  276.  * @package     Joomla.Framework
  277.  * @subpackage    HTML
  278.  * @since        1.5
  279.  */
  280. class JHTMLSelect
  281. {
  282.     function option( $value, $text='', $value_name='value', $text_name='text' )
  283.     {
  284.         $obj = new stdClass;
  285.         $obj->$value_name = $value;
  286.         $obj->$text_name = trim( $text ) ? $text : $value;
  287.         return $obj;
  288.     }
  289.  
  290.     /**
  291.     * Generates an HTML select list
  292.     *
  293.     * @param array An array of objects
  294.     * @param string The value of the HTML name attribute
  295.     * @param string Additional HTML attributes for the <select> tag
  296.     * @param string The name of the object variable for the option value
  297.     * @param string The name of the object variable for the option text
  298.     * @param mixed The key that is selected (accepts an array or a string)
  299.     * @returns string HTML for the select list
  300.     */
  301.     function genericList( $arr, $tag_name, $tag_attribs, $key, $text, $selected=NULL, $idtag=false, $flag=false )
  302.     {
  303.         // check if array
  304.         if ( is_array( $arr ) ) {
  305.             reset( $arr );
  306.         }
  307.  
  308.         $id = $tag_name;
  309.         if ( $idtag ) {
  310.             $id = $idtag;
  311.         }
  312.         $id = str_replace('[','',$id);
  313.         $id = str_replace(']','',$id);
  314.  
  315.         $html = '<select name="'. $tag_name .'" id="'. $id .'" '. $tag_attribs .'>';
  316. //        for ($i=0, $n=count( $arr ); $i < $n; $i++ ) {
  317.         while(current($arr) !== FALSE) {
  318.             $element =& $arr[key($arr)]; // since current doesn't return a reference, need to do this
  319.  
  320.             $isArray = is_array( $element );
  321.             if ($isArray) {
  322.                 $k         = $element[$key];
  323.                 $t         = $element[$text];
  324.                 $id     = ( isset( $element['id'] ) ? $element['id'] : null );
  325.             } else {
  326.                 $k         = $element->$key;
  327.                 $t         = $element->$text;
  328.                 $id     = ( isset( $element->id ) ? $element->id : null );
  329.             }
  330.  
  331.             // This is real dirty, open to suggestions,
  332.             // barring doing a propper object to handle it
  333.             if ($k === '<OPTGROUP>') {
  334.                 $html .= '<optgroup label="' . $t . '">';
  335.             } else if ($k === '</OPTGROUP>') {
  336.                 $html .= '</optgroup>';
  337.             } else {
  338.                 //if no string after hypen - take hypen out
  339.                 $splitText = explode( " - ", $t, 2 );
  340.                 $t = $splitText[0];
  341.                 if(isset($splitText[1])){ $t .= " - ". $splitText[1]; }
  342.  
  343.                 $extra = '';
  344.                 //$extra .= $id ? ' id="' . $arr[$i]->id . '"' : '';
  345.                 if (is_array( $selected )) {
  346.                     foreach ($selected as $obj) {
  347.                         $k2 = $obj->$key;
  348.                         if ($k == $k2) {
  349.                             $extra .= ' selected="selected"';
  350.                             break;
  351.                         }
  352.                     }
  353.                 } else {
  354.                     $extra .= ( $k == $selected ? ' selected="selected"' : '' );
  355.                 }
  356.                 //if flag translate text
  357.                 if ($flag) {
  358.                     $t = JText::_( $t );
  359.                 }
  360.  
  361.                 $html .= '<option value="'. $k .'" '. $extra .'>' . $t . '</option>';
  362.             }
  363.             next($arr);
  364.         }
  365.         $html .= '</select>';
  366.  
  367.         return $html;
  368.     }
  369.  
  370.     /**
  371.     * Generates a select list of integers
  372.     *
  373.     * @param int The start integer
  374.     * @param int The end integer
  375.     * @param int The increment
  376.     * @param string The value of the HTML name attribute
  377.     * @param string Additional HTML attributes for the <select> tag
  378.     * @param mixed The key that is selected
  379.     * @param string The printf format to be applied to the number
  380.     * @returns string HTML for the select list
  381.     */
  382.     function integerList( $start, $end, $inc, $tag_name, $tag_attribs, $selected, $format="" )
  383.     {
  384.         $start     = intval( $start );
  385.         $end     = intval( $end );
  386.         $inc     = intval( $inc );
  387.         $arr     = array();
  388.  
  389.         for ($i=$start; $i <= $end; $i+=$inc) {
  390.             $fi = $format ? sprintf( "$format", $i ) : "$i";
  391.             $arr[] = JHTMLSelect::option( $fi, $fi );
  392.         }
  393.  
  394.         return JHTMLSelect::genericList( $arr, $tag_name, $tag_attribs, 'value', 'text', $selected );
  395.     }
  396.  
  397.     /**
  398.     * Generates an HTML radio list
  399.     *
  400.     * @param array An array of objects
  401.     * @param string The value of the HTML name attribute
  402.     * @param string Additional HTML attributes for the <select> tag
  403.     * @param mixed The key that is selected
  404.     * @param string The name of the object variable for the option value
  405.     * @param string The name of the object variable for the option text
  406.     * @returns string HTML for the select list
  407.     */
  408.     function radioList( $arr, $tag_name, $tag_attribs, $selected=null, $key='value', $text='text', $idtag=false )
  409.     {
  410.         reset( $arr );
  411.         $html = '';
  412.  
  413.         $id_text = $tag_name;
  414.         if ( $idtag ) {
  415.             $id_text = $idtag;
  416.         }
  417.  
  418.         for ($i=0, $n=count( $arr ); $i < $n; $i++ ) {
  419.             $k = $arr[$i]->$key;
  420.             $t = $arr[$i]->$text;
  421.             $id = ( isset($arr[$i]->id) ? @$arr[$i]->id : null);
  422.  
  423.             $extra = '';
  424.             $extra .= $id ? " id=\"" . $arr[$i]->id . "\"" : '';
  425.             if (is_array( $selected )) {
  426.                 foreach ($selected as $obj) {
  427.                     $k2 = $obj->$key;
  428.                     if ($k == $k2) {
  429.                         $extra .= " selected=\"selected\"";
  430.                         break;
  431.                     }
  432.                 }
  433.             } else {
  434.                 $extra .= ($k == $selected ? " checked=\"checked\"" : '');
  435.             }
  436.             $html .= "\n\t<input type=\"radio\" name=\"$tag_name\" id=\"$id_text$k\" value=\"".$k."\"$extra $tag_attribs />";
  437.             $html .= "\n\t<label for=\"$id_text$k\">$t</label>";
  438.         }
  439.         $html .= "\n";
  440.         return $html;
  441.     }
  442.  
  443.     /**
  444.     * Generates a yes/no radio list
  445.     *
  446.     * @param string The value of the HTML name attribute
  447.     * @param string Additional HTML attributes for the <select> tag
  448.     * @param mixed The key that is selected
  449.     * @returns string HTML for the radio list
  450.     */
  451.     function yesnoList( $tag_name, $tag_attribs, $selected, $yes='yes', $no='no', $id=false ) {
  452.  
  453.         $arr = array(
  454.             JHTMLSelect::Option( '0', JText::_( $no ) ),
  455.             JHTMLSelect::Option( '1', JText::_( $yes ) )
  456.         );
  457.         return JHTMLSelect::radioList( $arr, $tag_name, $tag_attribs, (int) $selected, 'value', 'text', $id );
  458.     }
  459. }
  460.  
  461. /**
  462.  * Utility class for drawing common HTML elements
  463.  *
  464.  * @static
  465.  * @package     Joomla.Framework
  466.  * @subpackage    HTML
  467.  * @since        1.5
  468.  */
  469. class JCommonHTML
  470. {
  471.     /*
  472.      * Function is only used in the administrator
  473.      */
  474.     function ContentLegend( )
  475.     {
  476.         ?>
  477.         <table cellspacing="0" cellpadding="4" border="0" align="center">
  478.         <tr align="center">
  479.             <td>
  480.             <img src="images/publish_y.png" width="16" height="16" border="0" alt="<?php echo JText::_( 'Pending' ); ?>" />
  481.             </td>
  482.             <td>
  483.             <?php echo JText::_( 'Published, but is' ); ?> <u><?php echo JText::_( 'Pending' ); ?></u> |
  484.             </td>
  485.             <td>
  486.             <img src="images/publish_g.png" width="16" height="16" border="0" alt="<?php echo JText::_( 'Visible' ); ?>" />
  487.             </td>
  488.             <td>
  489.             <?php echo JText::_( 'Published and is' ); ?> <u><?php echo JText::_( 'Current' ); ?></u> |
  490.             </td>
  491.             <td>
  492.             <img src="images/publish_r.png" width="16" height="16" border="0" alt="<?php echo JText::_( 'Finished' ); ?>" />
  493.             </td>
  494.             <td>
  495.             <?php echo JText::_( 'Published, but has' ); ?> <u><?php echo JText::_( 'Expired' ); ?></u> |
  496.             </td>
  497.             <td>
  498.             <img src="images/publish_x.png" width="16" height="16" border="0" alt="<?php echo JText::_( 'Finished' ); ?>" />
  499.             </td>
  500.             <td>
  501.             <?php echo JText::_( 'Not Published' ); ?>
  502.             </td>
  503.         </tr>
  504.         <tr>
  505.             <td colspan="8" align="center">
  506.             <?php echo JText::_( 'Click on icon to toggle state.' ); ?>
  507.             </td>
  508.         </tr>
  509.         </table>
  510.         <?php
  511.     }
  512.  
  513.     /*
  514.      * Function is only used in the administrator
  515.      */
  516.     function checkedOut( &$row, $overlib=1 )
  517.     {
  518.         $hover = '';
  519.         if ( $overlib ) {
  520.  
  521.             $text = addslashes(htmlspecialchars($row->editor));
  522.  
  523.             $date                 = JHTML::Date( $row->checked_out_time, '%A, %d %B %Y' );
  524.             $time                = JHTML::Date( $row->checked_out_time, '%H:%M' );
  525.  
  526.             $hover = '<span class="editlinktip hasTip" title="'. JText::_( 'Checked Out' ) .'::'. $text .'<br />'. $date .'<br />'. $time .'">';
  527.         }
  528.         $checked = $hover .'<img src="images/checked_out.png"/></span>';
  529.  
  530.         return $checked;
  531.     }
  532.  
  533.     /*
  534.      * Creates a tooltip with an image as button
  535.      */
  536.     function ToolTip($tooltip, $title='', $image='tooltip.png', $text='', $href='', $link=1)
  537.     {
  538.         global $mainframe;
  539.  
  540.         $tooltip    = addslashes(htmlspecialchars($tooltip));
  541.         $title        = addslashes(htmlspecialchars($title));
  542.  
  543.         $url = $mainframe->isAdmin() ? $mainframe->getSiteURL() : JURI::base();
  544.  
  545.         if ( !$text ) {
  546.             $image     = $url . 'includes/js/ThemeOffice/'. $image;
  547.             $text     = '<img src="'. $image .'" border="0" alt="'. JText::_( 'Tooltip' ) .'"/>';
  548.         } else {
  549.             $text     = JText::_( $text, true );
  550.         }
  551.  
  552.         if($title) {
  553.             $title = $title.'::';
  554.         }
  555.  
  556.         $style = 'style="text-decoration: none; color: #333;"';
  557.  
  558.         if ( $href ) {
  559.             $href = ampReplace( $href );
  560.             $style = '';
  561.         }
  562.         if ( $link ) {
  563.             $tip = '<span class="editlinktip hasTip" title="'.$title.$tooltip.'" '. $style .'><a href="'. $href .'">'. $text .'</a></span>';
  564.         } else {
  565.             $tip = '<span class="editlinktip hasTip" title="'.$title.$tooltip.'" '. $style .'>'. $text .'</span>';
  566.         }
  567.  
  568.         return $tip;
  569.     }
  570.  
  571.     /*
  572.     * Loads all necessary files for JS Calendar
  573.     */
  574.     /*
  575.      * Function is used in the administrator/site : move into JCalendar
  576.      */
  577.     function loadCalendar()
  578.     {
  579.         global $mainframe;
  580.  
  581.         $doc =& JFactory::getDocument();
  582.         $lang =& JFactory::getLanguage();
  583.         $url = $mainframe->isAdmin() ? $mainframe->getSiteURL() : JURI::base();
  584.  
  585.         $doc->addStyleSheet( $url. 'includes/js/calendar/calendar-mos.css', 'text/css', null, array(' title' => JText::_( 'green' ) ,' media' => 'all' ));
  586.         $doc->addScript( $url. 'includes/js/calendar/calendar_mini.js' );
  587.         $langScript = JPATH_SITE.DS.'includes'.DS.'js'.DS.'calendar'.DS.'lang'.DS.'calendar-'.$lang->getTag().'.js';
  588.         if( file_exists( $langScript ) ){
  589.             $doc->addScript( $url. 'includes/js/calendar/lang/calendar-'.$lang->getTag().'.js' );
  590.         } else {
  591.             $doc->addScript( $url. 'includes/js/calendar/lang/calendar-en-GB.js' );
  592.         }
  593.     }
  594.  
  595.     /*
  596.      * Function is used only in the administrator : move to JHTMLGrid
  597.      */
  598.     function AccessProcessing( &$row, $i, $archived=NULL )
  599.     {
  600.         if ( !$row->access ) {
  601.             $color_access = 'style="color: green;"';
  602.             $task_access = 'accessregistered';
  603.         } else if ( $row->access == 1 ) {
  604.             $color_access = 'style="color: red;"';
  605.             $task_access = 'accessspecial';
  606.         } else {
  607.             $color_access = 'style="color: black;"';
  608.             $task_access = 'accesspublic';
  609.         }
  610.  
  611.         if ($archived == -1) {
  612.             $href = JText::_( $row->groupname );
  613.         } else {
  614.             $href = '
  615.             <a href="javascript:void(0);" onclick="return listItemTask(\'cb'. $i .'\',\''. $task_access .'\')" '. $color_access .'>
  616.             '. JText::_( $row->groupname ) .'
  617.             </a>'
  618.             ;
  619.         }
  620.  
  621.         return $href;
  622.     }
  623.  
  624.     /*
  625.      * Function is used only in the administrator : move to JHTMLGrid
  626.      */
  627.     function CheckedOutProcessing( &$row, $i, $identifier = 'id' )
  628.     {
  629.         $user   =& JFactory::getUser();
  630.         $userid = $user->get('id');
  631.  
  632.         $result = false;
  633.         if(is_a($row, 'JTable')) {
  634.             $result = $row->isCheckedOut($userid);
  635.         } else {
  636.             $result = JTable::isCheckedOut($userid, $row->checked_out);
  637.         }
  638.  
  639.         $checked = '';
  640.         if ( $result ) {
  641.             $checked = JCommonHTML::checkedOut( $row );
  642.         } else {
  643.             $checked = JHTML::idBox( $i, $row->$identifier );
  644.         }
  645.  
  646.         return $checked;
  647.     }
  648.  
  649.     /*
  650.      * Function is used only in the administrator : move to JHTMLGrid
  651.      */
  652.     function PublishedProcessing( &$row, $i, $imgY='tick.png', $imgX='publish_x.png', $prefix='' )
  653.     {
  654.         $img     = $row->published ? $imgY : $imgX;
  655.         $task     = $row->published ? 'unpublish' : 'publish';
  656.         $alt     = $row->published ? JText::_( 'Published' ) : JText::_( 'Unpublished' );
  657.         $action = $row->published ? JText::_( 'Unpublish Item' ) : JText::_( 'Publish item' );
  658.  
  659.         $href = '
  660.         <a href="javascript:void(0);" onclick="return listItemTask(\'cb'. $i .'\',\''. $prefix.$task .'\')" title="'. $action .'">
  661.         <img src="images/'. $img .'" border="0" alt="'. $alt .'" />
  662.         </a>'
  663.         ;
  664.  
  665.         return $href;
  666.     }
  667.  
  668.     /*
  669.      * Function is used only in the administrator : move to JHTMLGrid
  670.      */
  671.     function selectState( $filter_state='*', $published='Published', $unpublished='Unpublished', $archived=NULL )
  672.     {
  673.         $state[] = JHTMLSelect::option( '', '- '. JText::_( 'Select State' ) .' -' );
  674.         $state[] = JHTMLSelect::option( '*', JText::_( 'Any' ) );
  675.         $state[] = JHTMLSelect::option( 'P', JText::_( $published ) );
  676.         $state[] = JHTMLSelect::option( 'U', JText::_( $unpublished ) );
  677.  
  678.         if ($archived) {
  679.             $state[] = JHTMLSelect::option( 'A', JText::_( $archived ) );
  680.         }
  681.  
  682.         return JHTMLSelect::genericList( $state, 'filter_state', 'class="inputbox" size="1" onchange="submitform( );"', 'value', 'text', $filter_state );
  683.     }
  684.  
  685.     /*
  686.      * Function is used only in the administrator : move to JHTMLGrid
  687.      */
  688.     function saveorderButton( $rows, $image='filesave.png', $task="saveorder" )
  689.     {
  690.         $image = JAdminMenus::ImageCheckAdmin( $image, '/images/', NULL, NULL, JText::_( 'Save Order' ), '', 1 );
  691.         ?>
  692.         <a href="javascript:saveorder(<?php echo count( $rows )-1; ?>, '<?php echo $task; ?>')" title="<?php echo JText::_( 'Save Order' ); ?>">
  693.             <?php echo $image; ?></a>
  694.         <?php
  695.     }
  696.  
  697.     /*
  698.      * Function is used only in the administrator : move to JHTMLGrid
  699.      */
  700.     function tableOrdering( $text, $ordering, &$lists, $task=NULL )
  701.     {
  702.         ?>
  703.         <a href="javascript:tableOrdering('<?php echo $ordering; ?>','<?php echo $lists['order_Dir']; ?>','<?php echo $task; ?>');" title="<?php echo JText::_( 'Order by' ); ?> <?php echo JText::_( $text ); ?>">
  704.             <?php echo JText::_( $text ); ?>
  705.             <?php JCommonHTML::tableOrdering_img( $ordering, $lists ); ?></a>
  706.         <?php
  707.     }
  708.  
  709.     /*
  710.      * Function is used only in the administrator : move to JHTMLGrid
  711.      */
  712.     function tableOrdering_img( $current, &$lists )
  713.     {
  714.         if ( $current == $lists['order']) {
  715.             if ( $lists['order_Dir'] == 'ASC' ) {
  716.                 $image = 'sort_desc.png';
  717.             } else {
  718.                 $image = 'sort_asc.png';
  719.             }
  720.             echo JAdminMenus::ImageCheckAdmin( $image, '/images/', NULL, NULL, '', '', 1 );
  721.         }
  722.     }
  723. }
  724.  
  725. /**
  726.  * Utility class for drawing admin menu HTML elements
  727.  *
  728.  * @static
  729.  * @package     Joomla.Framework
  730.  * @subpackage    HTML
  731.  * @since        1.0
  732.  */
  733. class JAdminMenus
  734. {
  735.     /**
  736.     * build the select list for Menu Ordering
  737.     */
  738.     /*
  739.      * Function is only used in administrator/component/com_menus/views/item/tmpl/form.php
  740.      */
  741.     function Ordering( &$row, $id )
  742.     {
  743.         $db =& JFactory::getDBO();
  744.  
  745.         if ( $id ) {
  746.             $query = 'SELECT ordering AS value, name AS text'
  747.             . ' FROM #__menu'
  748.             . ' WHERE menutype = \''.$row->menutype
  749.             . '\' AND parent = '.$row->parent
  750.             . ' AND published != -2'
  751.             . ' ORDER BY ordering';
  752.             $order = JAdminMenus::GenericOrdering( $query );
  753.             $ordering = JHTMLSelect::genericList( $order, 'ordering', 'class="inputbox" size="1"', 'value', 'text', intval( $row->ordering ) );
  754.         } else {
  755.             $ordering = '<input type="hidden" name="ordering" value="'. $row->ordering .'" />'. JText::_( 'DESCNEWITEMSLAST' );
  756.         }
  757.         return $ordering;
  758.     }
  759.  
  760.     /**
  761.     * build the select list for access level
  762.     */
  763.     /*
  764.      * Function is used in administrator/site (com_content) : move into parameters
  765.      */
  766.     function Access( &$row )
  767.     {
  768.         $db =& JFactory::getDBO();
  769.  
  770.         $query = 'SELECT id AS value, name AS text'
  771.         . ' FROM #__groups'
  772.         . ' ORDER BY id'
  773.         ;
  774.         $db->setQuery( $query );
  775.         $groups = $db->loadObjectList();
  776.         $access = JHTMLSelect::genericList( $groups, 'access', 'class="inputbox" size="3"', 'value', 'text', intval( $row->access ), '', 1 );
  777.  
  778.         return $access;
  779.     }
  780.  
  781.     /**
  782.     * build the multiple select list for Menu Links/Pages
  783.     */
  784.     /*
  785.      * Function is only used in the administrator (multiple components)
  786.      */
  787.     function MenuLinkOptions( $all=false, $unassigned=false )
  788.     {
  789.         $db =& JFactory::getDBO();
  790.  
  791.         // get a list of the menu items
  792.         $query = 'SELECT m.id, m.parent, m.name, m.menutype'
  793.         . ' FROM #__menu AS m'
  794.         . ' WHERE m.published = 1'
  795.         . ' ORDER BY m.menutype, m.parent, m.ordering'
  796.         ;
  797.         $db->setQuery( $query );
  798.         $mitems = $db->loadObjectList();
  799.         $mitems_temp = $mitems;
  800.  
  801.         // establish the hierarchy of the menu
  802.         $children = array();
  803.         // first pass - collect children
  804.         foreach ( $mitems as $v )
  805.         {
  806.             $id = $v->id;
  807.             $pt = $v->parent;
  808.             $list = @$children[$pt] ? $children[$pt] : array();
  809.             array_push( $list, $v );
  810.             $children[$pt] = $list;
  811.         }
  812.         // second pass - get an indent list of the items
  813.         $list = mosTreeRecurse( intval( $mitems[0]->parent ), '', array(), $children, 9999, 0, 0 );
  814.  
  815.         // Code that adds menu name to Display of Page(s)
  816.         $mitems_spacer     = $mitems_temp[0]->menutype;
  817.  
  818.         $mitems = array();
  819.         if ($all | $unassigned) {
  820.             $mitems[] = JHTMLSelect::option( '<OPTGROUP>', JText::_( 'Menus' ) );
  821.  
  822.             if ( $all ) {
  823.                 $mitems[] = JHTMLSelect::option( 0, JText::_( 'All' ) );
  824.             }
  825.             if ( $unassigned ) {
  826.                 $mitems[] = JHTMLSelect::option( -1, JText::_( 'Unassigned' ) );
  827.             }
  828.  
  829.             $mitems[] = JHTMLSelect::option( '</OPTGROUP>' );
  830.         }
  831.  
  832.         $lastMenuType    = null;
  833.         $tmpMenuType    = null;
  834.         foreach ($list as $list_a)
  835.         {
  836.             if ($list_a->menutype != $lastMenuType)
  837.             {
  838.                 if ($tmpMenuType) {
  839.                     $mitems[] = JHTMLSelect::option( '</OPTGROUP>' );
  840.                 }
  841.                 $mitems[] = JHTMLSelect::option( '<OPTGROUP>', $list_a->menutype );
  842.                 $lastMenuType = $list_a->menutype;
  843.                 $tmpMenuType  = $list_a->menutype;
  844.             }
  845.  
  846.             $mitems[] = JHTMLSelect::option( $list_a->id, $list_a->treename );
  847.         }
  848.         if ($lastMenuType !== null) {
  849.             $mitems[] = JHTMLSelect::option( '</OPTGROUP>' );
  850.         }
  851.  
  852.         return $mitems;
  853.     }
  854.  
  855.     /**
  856.     * build the select list to choose an image
  857.     */
  858.     /*
  859.      * Function is only used in the administrator (multiple components) : duplicate with JElementImagelist
  860.      */
  861.     function Images( $name, &$active, $javascript=NULL, $directory=NULL )
  862.     {
  863.         if ( !$directory ) {
  864.             $directory = '/images/stories/';
  865.         }
  866.  
  867.         if ( !$javascript ) {
  868.             $javascript = "onchange=\"javascript:if (document.forms[0]." . $name . ".options[selectedIndex].value!='') {document.imagelib.src='..$directory' + document.forms[0]." . $name . ".options[selectedIndex].value} else {document.imagelib.src='../images/blank.png'}\"";
  869.         }
  870.  
  871.         jimport( 'joomla.filesystem.folder' );
  872.         $imageFiles = JFolder::files( JPATH_SITE.DS.$directory );
  873.         $images     = array(  JHTMLSelect::option( '', '- '. JText::_( 'Select Image' ) .' -' ) );
  874.         foreach ( $imageFiles as $file ) {
  875.             if ( eregi( "bmp|gif|jpg|png", $file ) ) {
  876.                 $images[] = JHTMLSelect::option( $file );
  877.             }
  878.         }
  879.         $images = JHTMLSelect::genericList( $images, $name, 'class="inputbox" size="1" '. $javascript, 'value', 'text', $active );
  880.  
  881.         return $images;
  882.     }
  883.  
  884.     /**
  885.      * Description
  886.      *
  887.       * @param string SQL with ordering As value and 'name field' AS text
  888.       * @param integer The length of the truncated headline
  889.       * @since 1.5
  890.       */
  891.       /*
  892.      * Function is only used in the administrator (com_plugins)
  893.      */
  894.     function GenericOrdering( $sql, $chop='30' )
  895.     {
  896.         $db =& JFactory::getDBO();
  897.         $order = array();
  898.         $db->setQuery( $sql );
  899.         if (!($orders = $db->loadObjectList())) {
  900.             if ($db->getErrorNum()) {
  901.                 echo $db->stderr();
  902.                 return false;
  903.             } else {
  904.                 $order[] = JHTMLSelect::option( 1, JText::_( 'first' ) );
  905.                 return $order;
  906.             }
  907.         }
  908.         $order[] = JHTMLSelect::option( 0, '0 '. JText::_( 'first' ) );
  909.         for ($i=0, $n=count( $orders ); $i < $n; $i++) {
  910.  
  911.             if (JString::strlen($orders[$i]->text) > $chop) {
  912.                 $text = JString::substr($orders[$i]->text,0,$chop)."...";
  913.             } else {
  914.                 $text = $orders[$i]->text;
  915.             }
  916.  
  917.             $order[] = JHTMLSelect::option( $orders[$i]->value, $orders[$i]->value.' ('.$text.')' );
  918.         }
  919.         $order[] = JHTMLSelect::option( $orders[$i-1]->value+1, ($orders[$i-1]->value+1).' '. JText::_( 'last' ) );
  920.  
  921.         return $order;
  922.     }
  923.  
  924.     /**
  925.     * build the select list for Ordering of a specified Table
  926.     */
  927.     /*
  928.      * Function is only used in the administrator (multiple components)
  929.      */
  930.     function SpecificOrdering( &$row, $id, $query, $neworder=0 )
  931.     {
  932.         $db =& JFactory::getDBO();
  933.  
  934.         if ( $id ) {
  935.             $order = JAdminMenus::GenericOrdering( $query );
  936.             $ordering = JHTMLSelect::genericList( $order, 'ordering', 'class="inputbox" size="1"', 'value', 'text', intval( $row->ordering ) );
  937.         } else {
  938.             if ( $neworder ) {
  939.                 $text = JText::_( 'descNewItemsFirst' );
  940.             } else {
  941.                 $text = JText::_( 'descNewItemsLast' );
  942.             }
  943.             $ordering = '<input type="hidden" name="ordering" value="'. $row->ordering .'" />'. $text;
  944.         }
  945.         return $ordering;
  946.     }
  947.  
  948.     /**
  949.     * Select list of active users
  950.     */
  951.     /*
  952.      * Function is only used in the administrator (multiple components) : function could create preformance issues
  953.      */
  954.     function UserSelect( $name, $active, $nouser=0, $javascript=NULL, $order='name', $reg=1 )
  955.     {
  956.         $db =& JFactory::getDBO();
  957.  
  958.         $and = '';
  959.         if ( $reg ) {
  960.         // does not include registered users in the list
  961.             $and = ' AND gid > 18';
  962.         }
  963.  
  964.         $query = 'SELECT id AS value, name AS text'
  965.         . ' FROM #__users'
  966.         . ' WHERE block = 0'
  967.         . $and
  968.         . ' ORDER BY '. $order
  969.         ;
  970.         $db->setQuery( $query );
  971.         if ( $nouser ) {
  972.             $users[] = JHTMLSelect::option( '0', '- '. JText::_( 'No User' ) .' -' );
  973.             $users = array_merge( $users, $db->loadObjectList() );
  974.         } else {
  975.             $users = $db->loadObjectList();
  976.         }
  977.  
  978.         $users = JHTMLSelect::genericList( $users, $name, 'class="inputbox" size="1" '. $javascript, 'value', 'text', $active );
  979.  
  980.         return $users;
  981.     }
  982.  
  983.     /**
  984.     * Select list of positions - generally used for location of images
  985.     */
  986.     /*
  987.      * Function is only used in the administrator (com_categories, com_sections)
  988.      */
  989.     function Positions( $name, $active=NULL, $javascript=NULL, $none=1, $center=1, $left=1, $right=1, $id=false )
  990.     {
  991.         if ( $none ) {
  992.             $pos[] = JHTMLSelect::option( '', JText::_( 'None' ) );
  993.         }
  994.         if ( $center ) {
  995.             $pos[] = JHTMLSelect::option( 'center', JText::_( 'Center' ) );
  996.         }
  997.         if ( $left ) {
  998.             $pos[] = JHTMLSelect::option( 'left', JText::_( 'Left' ) );
  999.         }
  1000.         if ( $right ) {
  1001.             $pos[] = JHTMLSelect::option( 'right', JText::_( 'Right' ) );
  1002.         }
  1003.  
  1004.         $positions = JHTMLSelect::genericList( $pos, $name, 'class="inputbox" size="1"'. $javascript, 'value', 'text', $active, $id );
  1005.  
  1006.         return $positions;
  1007.     }
  1008.  
  1009.     /**
  1010.     * Select list of active categories for components
  1011.     */
  1012.     /*
  1013.      * Function is used in the site/administrator : duplicate in JElementCategory
  1014.      */
  1015.     function ComponentCategory( $name, $section, $active=NULL, $javascript=NULL, $order='ordering', $size=1, $sel_cat=1 )
  1016.     {
  1017.         global $mainframe;
  1018.  
  1019.         $db =& JFactory::getDBO();
  1020.  
  1021.         $query = 'SELECT id AS value, name AS text'
  1022.         . ' FROM #__categories'
  1023.         . ' WHERE section = "'. $section . '"'
  1024.         . ' AND published = 1'
  1025.         . ' ORDER BY '. $order
  1026.         ;
  1027.         $db->setQuery( $query );
  1028.         if ( $sel_cat ) {
  1029.             $categories[] = JHTMLSelect::option( '0', '- '. JText::_( 'Select a Category' ) .' -' );
  1030.             $categories = array_merge( $categories, $db->loadObjectList() );
  1031.         } else {
  1032.             $categories = $db->loadObjectList();
  1033.         }
  1034.  
  1035.         if ( count( $categories ) < 1 ) {
  1036.             $mainframe->redirect( 'index.php?option=com_categories&section='. $section, JText::_( 'You must create a category first.' ) );
  1037.         }
  1038.  
  1039.         $category = JHTMLSelect::genericList( $categories, $name, 'class="inputbox" size="'. $size .'" '. $javascript, 'value', 'text', $active );
  1040.  
  1041.         return $category;
  1042.     }
  1043.  
  1044.     /**
  1045.     * Select list of active sections
  1046.     */
  1047.     /*
  1048.      * Function is only used in the administrator : duplicate in JElementSection
  1049.      */
  1050.     function SelectSection( $name, $active=NULL, $javascript=NULL, $order='ordering' )
  1051.     {
  1052.         $db =& JFactory::getDBO();
  1053.  
  1054.         $categories[] = JHTMLSelect::option( '-1', '- '. JText::_( 'Select Section' ) .' -' );
  1055.         $categories[] = JHTMLSelect::option( '0', JText::_( 'Uncategorized' ) );
  1056.         $query = 'SELECT id AS value, title AS text'
  1057.         . ' FROM #__sections'
  1058.         . ' WHERE published = 1'
  1059.         . ' ORDER BY ' . $order
  1060.         ;
  1061.         $db->setQuery( $query );
  1062.         $sections = array_merge( $categories, $db->loadObjectList() );
  1063.  
  1064.         $category = JHTMLSelect::genericList( $sections, $name, 'class="inputbox" size="1" '. $javascript, 'value', 'text', $active );
  1065.  
  1066.         return $category;
  1067.     }
  1068.  
  1069.     /**
  1070.     * Checks to see if an image exists in the current templates image directory
  1071.      * if it does it loads this image.  Otherwise the default image is loaded.
  1072.     * Also can be used in conjunction with the menulist param to create the chosen image
  1073.     * load the default or use no image
  1074.     */
  1075.     /*
  1076.      * Function is only used in the site/administrator : move to JHTML::Image
  1077.      */
  1078.     function ImageCheck( $file, $directory='/images/M_images/', $param=NULL, $param_directory='/images/M_images/', $alt=NULL, $name='image', $type=1, $align='top' )
  1079.     {
  1080.         static $paths;
  1081.         global $mainframe;
  1082.  
  1083.         if (!$paths)
  1084.         {
  1085.             $paths = array();
  1086.         }
  1087.  
  1088.         $cur_template = $mainframe->getTemplate();
  1089.  
  1090.         // strip html
  1091.         $alt    = html_entity_decode( $alt );
  1092.  
  1093.         if ( $param ) {
  1094.             $image = $param_directory . $param;
  1095.             if ( $type ) {
  1096.                 $image = '<img src="'. $image .'" align="'. $align .'" alt="'. $alt .'" border="0" />';
  1097.             }
  1098.         } else if ( $param == -1 ) {
  1099.             $image = '';
  1100.         } else {
  1101.             $path = JPATH_SITE .'/templates/'. $cur_template .'/images/'. $file;
  1102.             if (!isset( $paths[$path] ))
  1103.             {
  1104.                 if ( file_exists( JPATH_SITE .'/templates/'. $cur_template .'/images/'. $file ) ) {
  1105.                     $paths[$path] = 'templates/'. $cur_template .'/images/'. $file;
  1106.                 } else {
  1107.                     // outputs only path to image
  1108.                     $paths[$path] = $directory . $file;
  1109.                 }
  1110.             }
  1111.             $image = $paths[$path];
  1112.         }
  1113.  
  1114.         if (substr($image, 0, 1 ) == "/") {
  1115.             $image = substr_replace($image, '', 0, 1);
  1116.         }
  1117.  
  1118.         // outputs actual html <img> tag
  1119.         if ( $type ) {
  1120.             $image = '<img src="'. $image .'" alt="'. $alt .'" align="'. $align .'" border="0" />';
  1121.         }
  1122.  
  1123.         return $image;
  1124.     }
  1125.  
  1126.     /**
  1127.     * Checks to see if an image exists in the current templates image directory
  1128.     * if it does it loads this image.  Otherwise the default image is loaded.
  1129.     * Also can be used in conjunction with the menulist param to create the chosen image
  1130.     * load the default or use no image
  1131.     */
  1132.     /*
  1133.      * Function is only used in the site/administrator : move to JHTML::Image (combine with ImageCheck)
  1134.      */
  1135.     function ImageCheckAdmin( $file, $directory='/images/', $param=NULL, $param_directory='/images/', $alt=NULL, $name=NULL, $type=1, $align='middle' )
  1136.     {
  1137.         global $mainframe;
  1138.  
  1139.         $cur_template = $mainframe->getTemplate();
  1140.  
  1141.         // strip html
  1142.         $alt    = html_entity_decode( $alt );
  1143.  
  1144.         if ( $param ) {
  1145.             $image = $param_directory . $param;
  1146.         } else if ( $param == -1 ) {
  1147.             $image = '';
  1148.         } else {
  1149.             if ( file_exists( JPATH_ADMINISTRATOR .'/templates/'. $cur_template .'/images/'. $file ) ) {
  1150.                 $image = 'templates/'. $cur_template .'/images/'. $file;
  1151.             } else {
  1152.                 // compability with previous versions
  1153.                 if ( substr($directory, 0, 14 )== "/administrator" ) {
  1154.                     $image = substr($directory,15) . $file;
  1155.                 } else {
  1156.                     $image = $directory . $file;
  1157.                 }
  1158.             }
  1159.         }
  1160.  
  1161.         if (substr($image, 0, 1 ) == "/") {
  1162.             $image = substr_replace($image, '', 0, 1);
  1163.         }
  1164.  
  1165.         // outputs actual html <img> tag
  1166.         if ( $type ) {
  1167.             $image = '<img src="'. $image .'" alt="'. $alt .'" align="'. $align .'" border="0" />';
  1168.         }
  1169.  
  1170.         return $image;
  1171.     }
  1172. }
  1173. ?>
Documentation generated on Mon, 05 Mar 2007 21:06:34 +0000 by phpDocumentor 1.3.1