* @git Joomla Component Builder * @copyright Copyright (C) 2015 Vast Development Method. All rights reserved. * @license GNU General Public License version 2 or later; see LICENSE.txt */ namespace VDM\Component\Componentbuilder\Administrator\View\Joomla_components; use Joomla\CMS\Factory; use Joomla\CMS\Language\Text; use Joomla\CMS\Toolbar\Toolbar; use Joomla\CMS\Form\FormHelper; use Joomla\CMS\Session\Session; use Joomla\CMS\Uri\Uri; use Joomla\CMS\Component\ComponentHelper; use Joomla\CMS\HTML\HTMLHelper as Html; use Joomla\CMS\Layout\FileLayout; use Joomla\CMS\MVC\View\HtmlView as BaseHtmlView; use Joomla\CMS\Plugin\PluginHelper; use Joomla\CMS\Toolbar\ToolbarHelper; use Joomla\CMS\Document\Document; use VDM\Component\Componentbuilder\Administrator\Helper\ComponentbuilderHelper; use VDM\Joomla\Utilities\ArrayHelper; use VDM\Joomla\Utilities\StringHelper; // No direct access to this file \defined('_JEXEC') or die; /** * Componentbuilder Html View class for the Joomla_components * * @since 1.6 */ class HtmlView extends BaseHtmlView { /** * Joomla_components view display method * * @param string $tpl The name of the template file to parse; automatically searches through the template paths. * * @return void * @since 1.6 */ public function display($tpl = null) { // Assign data to the view $this->items = $this->get('Items'); $this->pagination = $this->get('Pagination'); $this->state = $this->get('State'); $this->styles = $this->get('Styles'); $this->scripts = $this->get('Scripts'); $this->user ??= Factory::getApplication()->getIdentity(); // Load the filter form from xml. $this->filterForm = $this->get('FilterForm'); // Load the active filters. $this->activeFilters = $this->get('ActiveFilters'); // Add the list ordering clause. $this->listOrder = $this->escape($this->state->get('list.ordering', 'a.id')); $this->listDirn = $this->escape($this->state->get('list.direction', 'desc')); $this->saveOrder = $this->listOrder == 'a.ordering'; // set the return here value $this->return_here = urlencode(base64_encode((string) Uri::getInstance())); // get global action permissions $this->canDo = ComponentbuilderHelper::getActions('joomla_component'); $this->canEdit = $this->canDo->get('joomla_component.edit'); $this->canState = $this->canDo->get('joomla_component.edit.state'); $this->canCreate = $this->canDo->get('joomla_component.create'); $this->canDelete = $this->canDo->get('joomla_component.delete'); $this->canBatch = ($this->canDo->get('joomla_component.batch') && $this->canDo->get('core.batch')); // If we don't have items we load the empty state if (is_array($this->items) && !count((array) $this->items) && $this->isEmptyState = $this->get('IsEmptyState')) { $this->setLayout('emptystate'); } // We don't need toolbar in the modal window. if ($this->getLayout() !== 'modal') { $this->addToolbar(); } // Check for errors. if (count($errors = $this->get('Errors'))) { throw new \Exception(implode("\n", $errors), 500); } // Set the html view document stuff $this->_prepareDocument(); // Display the template parent::display($tpl); } /** * Add the page title and toolbar. * * @return void * @since 1.6 */ protected function addToolbar(): void { ToolbarHelper::title(Text::_('COM_COMPONENTBUILDER_JOOMLA_COMPONENTS'), 'joomla'); if ($this->canCreate) { ToolbarHelper::addNew('joomla_component.add'); } // Only load if there are items if (ArrayHelper::check($this->items)) { if ($this->canEdit) { ToolbarHelper::editList('joomla_component.edit'); } if ($this->canState) { ToolbarHelper::publishList('joomla_components.publish'); ToolbarHelper::unpublishList('joomla_components.unpublish'); ToolbarHelper::archiveList('joomla_components.archive'); if ($this->canDo->get('core.admin')) { ToolbarHelper::checkin('joomla_components.checkin'); } } if ($this->state->get('filter.published') == -2 && ($this->canState && $this->canDelete)) { ToolbarHelper::deleteList('', 'joomla_components.delete', 'JTOOLBAR_EMPTY_TRASH'); } elseif ($this->canState && $this->canDelete) { ToolbarHelper::trash('joomla_components.trash'); } } if ($this->user->authorise('joomla_component.clear_tmp', 'com_componentbuilder')) { // add Clear tmp button. ToolbarHelper::custom('joomla_components.clearTmp', 'purge custom-button-cleartmp', '', 'COM_COMPONENTBUILDER_CLEAR_TMP', false); } // set help url for this view if found $this->help_url = ComponentbuilderHelper::getHelpUrl('joomla_components'); if (StringHelper::check($this->help_url)) { ToolbarHelper::help('COM_COMPONENTBUILDER_HELP_MANAGER', false, $this->help_url); } // add the options comp button if ($this->canDo->get('core.admin') || $this->canDo->get('core.options')) { ToolbarHelper::preferences('com_componentbuilder'); } } /** * Prepare some document related stuff. * * @return void * @since 1.6 */ protected function _prepareDocument(): void { // Load jQuery Html::_('jquery.framework'); $this->getDocument()->setTitle(Text::_('COM_COMPONENTBUILDER_JOOMLA_COMPONENTS')); // add styles foreach ($this->styles as $style) { Html::_('stylesheet', $style, ['version' => 'auto']); } // add scripts foreach ($this->scripts as $script) { Html::_('script', $script, ['version' => 'auto']); } } /** * Escapes a value for output in a view script. * * @param mixed $var The output to escape. * @param bool $shorten The switch to shorten. * @param int $length The shorting length. * * @return mixed The escaped value. * @since 1.6 */ public function escape($var, bool $shorten = true, int $length = 50) { if (!is_string($var)) { return $var; } return StringHelper::html($var, $this->_charset ?? 'UTF-8', $shorten, $length); } /** * Returns an array of fields the table can be sorted by * * @return array containing the field name to sort by as the key and display text as value * @since 1.6 */ protected function getSortFields() { return array( 'a.ordering' => Text::_('JGRID_HEADING_ORDERING'), 'a.published' => Text::_('JSTATUS'), 'a.system_name' => Text::_('COM_COMPONENTBUILDER_JOOMLA_COMPONENT_SYSTEM_NAME_LABEL'), 'a.name_code' => Text::_('COM_COMPONENTBUILDER_JOOMLA_COMPONENT_NAME_CODE_LABEL'), 'a.short_description' => Text::_('COM_COMPONENTBUILDER_JOOMLA_COMPONENT_SHORT_DESCRIPTION_LABEL'), 'a.companyname' => Text::_('COM_COMPONENTBUILDER_JOOMLA_COMPONENT_COMPANYNAME_LABEL'), 'a.created' => Text::_('COM_COMPONENTBUILDER_JOOMLA_COMPONENT_CREATED_LABEL'), 'a.modified' => Text::_('COM_COMPONENTBUILDER_JOOMLA_COMPONENT_MODIFIED_LABEL'), 'a.id' => Text::_('JGRID_HEADING_ID') ); } }