- md5
- 2380e74b187a218e587a04dd7a26a890
- sha1
- 3b5b72e2db6b985446761bd658791178a84ae735
- sha256
- 2f921d9b91edf5dde9082ea16b1ae28ae95ac98f8f034c255027773c4fa4bd66
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103
<?php
/**
* Joomla! Content Management System
*
* @copyright (C) 2009 Open Source Matters, Inc. <https://www.joomla.org>
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\Form\Field;
use Joomla\CMS\Factory;
use Joomla\CMS\HTML\HTMLHelper;
use Joomla\CMS\Language\Text;
use Joomla\CMS\Log\Log;
// phpcs:disable PSR1.Files.SideEffects
\defined('JPATH_PLATFORM') or die;
// phpcs:enable PSR1.Files.SideEffects
/**
* Form Field class for the Joomla Platform.
* Supports an HTML select list of categories
*
* @since 1.6
*/
class CategoryField extends ListField
{
/**
* The form field type.
*
* @var string
* @since 1.6
*/
public $type = 'Category';
/**
* Method to get the field options for category
* Use the extension attribute in a form to specify the.specific extension for
* which categories should be displayed.
* Use the show_root attribute to specify whether to show the global category root in the list.
*
* @return object[] The field option objects.
*
* @since 1.6
*/
protected function getOptions()
{
$options = [];
$extension = $this->element['extension'] ? (string) $this->element['extension'] : (string) $this->element['scope'];
$published = (string) $this->element['published'];
$language = (string) $this->element['language'];
// Load the category options for a given extension.
if (!empty($extension)) {
// Filter over published state or not depending upon if it is present.
$filters = [];
if ($published) {
$filters['filter.published'] = explode(',', $published);
}
// Filter over language depending upon if it is present.
if ($language) {
$filters['filter.language'] = explode(',', $language);
}
if ($filters === []) {
$options = HTMLHelper::_('category.options', $extension);
} else {
$options = HTMLHelper::_('category.options', $extension, $filters);
}
// Verify permissions. If the action attribute is set, then we scan the options.
if ((string) $this->element['action']) {
// Get the current user object.
$user = Factory::getUser();
foreach ($options as $i => $option) {
/*
* To take save or create in a category you need to have create rights for that category
* unless the item is already in that category.
* Unset the option if the user isn't authorised for it. In this field assets are always categories.
*/
if ($user->authorise('core.create', $extension . '.category.' . $option->value) === false) {
unset($options[$i]);
}
}
}
if (isset($this->element['show_root'])) {
array_unshift($options, HTMLHelper::_('select.option', '0', Text::_('JGLOBAL_ROOT')));
}
} else {
Log::add(Text::_('JLIB_FORM_ERROR_FIELDS_CATEGORY_ERROR_EXTENSION_EMPTY'), Log::WARNING, 'jerror');
}
// Merge any additional options in the XML definition.
$options = array_merge(parent::getOptions(), $options);
return $options;
}
}
The same content is in 37 releases, Joomla 4.4.0-alpha1 to 4.4.14. See them all, or every version of this file.