1 <?php
  2 /**
  3  * @package     Joomla.Libraries
  4  * @subpackage  HTML
  5  *
  6  * @copyright   Copyright (C) 2005 - 2017 Open Source Matters, Inc. All rights reserved.
  7  * @license     GNU General Public License version 2 or later; see LICENSE.txt
  8  */
  9 
 10 defined('JPATH_PLATFORM') or die;
 11 
 12 /**
 13  * Extended Utility class for all HTML drawing classes.
 14  *
 15  * @since  1.6
 16  */
 17 abstract class JHtmlAccess
 18 {
 19     /**
 20      * A cached array of the asset groups
 21      *
 22      * @var    array
 23      * @since  1.6
 24      */
 25     protected static $asset_groups = null;
 26 
 27     /**
 28      * Displays a list of the available access view levels
 29      *
 30      * @param   string  $name      The form field name.
 31      * @param   string  $selected  The name of the selected section.
 32      * @param   string  $attribs   Additional attributes to add to the select field.
 33      * @param   mixed   $params    True to add "All Sections" option or an array of options
 34      * @param   mixed   $id        The form field id or false if not used
 35      *
 36      * @return  string  The required HTML for the SELECT tag.
 37      *
 38      * @see    JFormFieldAccessLevel
 39      * @since  1.6
 40      */
 41     public static function level($name, $selected, $attribs = '', $params = true, $id = false)
 42     {
 43         $db = JFactory::getDbo();
 44         $query = $db->getQuery(true)
 45             ->select($db->quoteName('a.id', 'value') . ', ' . $db->quoteName('a.title', 'text'))
 46             ->from($db->quoteName('#__viewlevels', 'a'))
 47             ->group($db->quoteName(array('a.id', 'a.title', 'a.ordering')))
 48             ->order($db->quoteName('a.ordering') . ' ASC')
 49             ->order($db->quoteName('title') . ' ASC');
 50 
 51         // Get the options.
 52         $db->setQuery($query);
 53         $options = $db->loadObjectList();
 54 
 55         // If params is an array, push these options to the array
 56         if (is_array($params))
 57         {
 58             $options = array_merge($params, $options);
 59         }
 60 
 61         // If all levels is allowed, push it into the array.
 62         elseif ($params)
 63         {
 64             array_unshift($options, JHtml::_('select.option', '', JText::_('JOPTION_ACCESS_SHOW_ALL_LEVELS')));
 65         }
 66 
 67         return JHtml::_(
 68             'select.genericlist',
 69             $options,
 70             $name,
 71             array(
 72                 'list.attr' => $attribs,
 73                 'list.select' => $selected,
 74                 'id' => $id,
 75             )
 76         );
 77     }
 78 
 79     /**
 80      * Displays a list of the available user groups.
 81      *
 82      * @param   string   $name      The form field name.
 83      * @param   string   $selected  The name of the selected section.
 84      * @param   string   $attribs   Additional attributes to add to the select field.
 85      * @param   boolean  $allowAll  True to add "All Groups" option.
 86      * @param   mixed    $id        The form field id
 87      *
 88      * @return  string   The required HTML for the SELECT tag.
 89      *
 90      * @see     JFormFieldUsergroup
 91      * @since   1.6
 92      */
 93     public static function usergroup($name, $selected, $attribs = '', $allowAll = true, $id = false)
 94     {
 95         $options = array_values(JHelperUsergroups::getInstance()->getAll());
 96 
 97         for ($i = 0, $n = count($options); $i < $n; $i++)
 98         {
 99             $options[$i]->value = $options[$i]->id;
100             $options[$i]->text = str_repeat('- ', $options[$i]->level) . $options[$i]->title;
101         }
102 
103         // If all usergroups is allowed, push it into the array.
104         if ($allowAll)
105         {
106             array_unshift($options, JHtml::_('select.option', '', JText::_('JOPTION_ACCESS_SHOW_ALL_GROUPS')));
107         }
108 
109         return JHtml::_('select.genericlist', $options, $name, array('list.attr' => $attribs, 'list.select' => $selected, 'id' => $id));
110     }
111 
112     /**
113      * Returns a UL list of user groups with checkboxes
114      *
115      * @param   string   $name             The name of the checkbox controls array
116      * @param   array    $selected         An array of the checked boxes
117      * @param   boolean  $checkSuperAdmin  If false only super admins can add to super admin groups
118      *
119      * @return  string
120      *
121      * @since   1.6
122      */
123     public static function usergroups($name, $selected, $checkSuperAdmin = false)
124     {
125         static $count;
126 
127         $count++;
128 
129         $isSuperAdmin = JFactory::getUser()->authorise('core.admin');
130 
131         $groups = array_values(JHelperUsergroups::getInstance()->getAll());
132 
133         $html = array();
134 
135         for ($i = 0, $n = count($groups); $i < $n; $i++)
136         {
137             $item = &$groups[$i];
138 
139             // If checkSuperAdmin is true, only add item if the user is superadmin or the group is not super admin
140             if ((!$checkSuperAdmin) || $isSuperAdmin || (!JAccess::checkGroup($item->id, 'core.admin')))
141             {
142                 // Setup  the variable attributes.
143                 $eid = $count . 'group_' . $item->id;
144 
145                 // Don't call in_array unless something is selected
146                 $checked = '';
147 
148                 if ($selected)
149                 {
150                     $checked = in_array($item->id, $selected) ? ' checked="checked"' : '';
151                 }
152 
153                 $rel = ($item->parent_id > 0) ? ' rel="' . $count . 'group_' . $item->parent_id . '"' : '';
154 
155                 // Build the HTML for the item.
156                 $html[] = ' <div class="control-group">';
157                 $html[] = '     <div class="controls">';
158                 $html[] = '         <label class="checkbox" for="' . $eid . '">';
159                 $html[] = '         <input type="checkbox" name="' . $name . '[]" value="' . $item->id . '" id="' . $eid . '"';
160                 $html[] = '                 ' . $checked . $rel . ' />';
161                 $html[] = '         ' . JLayoutHelper::render('joomla.html.treeprefix', array('level' => $item->level + 1)) . $item->title;
162                 $html[] = '         </label>';
163                 $html[] = '     </div>';
164                 $html[] = ' </div>';
165             }
166         }
167 
168         return implode("\n", $html);
169     }
170 
171     /**
172      * Returns a UL list of actions with checkboxes
173      *
174      * @param   string  $name       The name of the checkbox controls array
175      * @param   array   $selected   An array of the checked boxes
176      * @param   string  $component  The component the permissions apply to
177      * @param   string  $section    The section (within a component) the permissions apply to
178      *
179      * @return  string
180      *
181      * @see     JAccess
182      * @since   1.6
183      */
184     public static function actions($name, $selected, $component, $section = 'global')
185     {
186         static $count;
187 
188         $count++;
189 
190         $actions = JAccess::getActionsFromFile(
191             JPATH_ADMINISTRATOR . '/components/' . $component . '/access.xml',
192             "/access/section[@name='" . $section . "']/"
193         );
194 
195         $html = array();
196         $html[] = '<ul class="checklist access-actions">';
197 
198         for ($i = 0, $n = count($actions); $i < $n; $i++)
199         {
200             $item = &$actions[$i];
201 
202             // Setup  the variable attributes.
203             $eid = $count . 'action_' . $item->id;
204             $checked = in_array($item->id, $selected) ? ' checked="checked"' : '';
205 
206             // Build the HTML for the item.
207             $html[] = ' <li>';
208             $html[] = '     <input type="checkbox" name="' . $name . '[]" value="' . $item->id . '" id="' . $eid . '"';
209             $html[] = '         ' . $checked . ' />';
210             $html[] = '     <label for="' . $eid . '">';
211             $html[] = '         ' . JText::_($item->title);
212             $html[] = '     </label>';
213             $html[] = ' </li>';
214         }
215 
216         $html[] = '</ul>';
217 
218         return implode("\n", $html);
219     }
220 
221     /**
222      * Gets a list of the asset groups as an array of JHtml compatible options.
223      *
224      * @return  mixed  An array or false if an error occurs
225      *
226      * @since   1.6
227      */
228     public static function assetgroups()
229     {
230         if (empty(static::$asset_groups))
231         {
232             $db = JFactory::getDbo();
233             $query = $db->getQuery(true)
234                 ->select('a.id AS value, a.title AS text')
235                 ->from($db->quoteName('#__viewlevels') . ' AS a')
236                 ->group('a.id, a.title, a.ordering')
237                 ->order('a.ordering ASC');
238 
239             $db->setQuery($query);
240             static::$asset_groups = $db->loadObjectList();
241         }
242 
243         return static::$asset_groups;
244     }
245 
246     /**
247      * Displays a Select list of the available asset groups
248      *
249      * @param   string  $name      The name of the select element
250      * @param   mixed   $selected  The selected asset group id
251      * @param   string  $attribs   Optional attributes for the select field
252      * @param   array   $config    An array of options for the control
253      *
254      * @return  mixed  An HTML string or null if an error occurs
255      *
256      * @since   1.6
257      */
258     public static function assetgrouplist($name, $selected, $attribs = null, $config = array())
259     {
260         static $count;
261 
262         $options = static::assetgroups();
263 
264         if (isset($config['title']))
265         {
266             array_unshift($options, JHtml::_('select.option', '', $config['title']));
267         }
268 
269         return JHtml::_(
270             'select.genericlist',
271             $options,
272             $name,
273             array(
274                 'id' => isset($config['id']) ? $config['id'] : 'assetgroups_' . (++$count),
275                 'list.attr' => $attribs === null ? 'class="inputbox" size="3"' : $attribs,
276                 'list.select' => (int) $selected,
277             )
278         );
279     }
280 }
281 

Joomla! Framework TM API documentation generated by ApiGen 2.8.0
Joomla!® and Joomla! Framework™ are trademarks of Open Source Matters, Inc. in the United States and other countries.