1190 lines
29 KiB
PHP
1190 lines
29 KiB
PHP
<?php
|
||
/**
|
||
* @package FOF
|
||
* @copyright Copyright (c)2010-2022 Nicholas K. Dionysopoulos / Akeeba Ltd
|
||
* @license GNU General Public License version 3, or later
|
||
*/
|
||
|
||
namespace FOF40\Toolbar;
|
||
|
||
defined('_JEXEC') || die;
|
||
|
||
use FOF40\Container\Container;
|
||
use FOF40\Controller\Controller;
|
||
use FOF40\Toolbar\Exception\MissingAttribute;
|
||
use FOF40\Toolbar\Exception\UnknownButtonType;
|
||
use FOF40\View\DataView\DataViewInterface;
|
||
use FOF40\View\View;
|
||
use Joomla\CMS\HTML\HTMLHelper;
|
||
use Joomla\CMS\Language\Text;
|
||
use Joomla\CMS\Toolbar\ToolbarHelper as JoomlaToolbarHelper;
|
||
use Joomla\Utilities\ArrayHelper;
|
||
|
||
/**
|
||
* The Toolbar class renders the back-end component title area and the back-
|
||
* and front-end toolbars.
|
||
*
|
||
* @since 1.0
|
||
*/
|
||
class Toolbar
|
||
{
|
||
/** @var array Permissions map, see the __construct method for more information */
|
||
public $perms = [];
|
||
|
||
/** @var Container Component container */
|
||
protected $container;
|
||
|
||
/** @var array The links to be rendered in the toolbar */
|
||
protected $linkbar = [];
|
||
|
||
/** @var bool Should I render the submenu in the front-end? */
|
||
protected $renderFrontendSubmenu = false;
|
||
|
||
/** @var bool Should I render buttons in the front-end? */
|
||
protected $renderFrontendButtons = false;
|
||
|
||
/** @var bool Should I use the configuration file (fof.xml) of the component? */
|
||
protected $useConfigurationFile = false;
|
||
|
||
/** @var null|bool Are we rendering a data-aware view? */
|
||
protected $isDataView;
|
||
|
||
/**
|
||
* Public constructor.
|
||
*
|
||
* The $config array can contain the following optional values:
|
||
*
|
||
* renderFrontendButtons bool Should I render buttons in the front-end of the component?
|
||
* renderFrontendSubmenu bool Should I render the submenu in the front-end of the component?
|
||
* useConfigurationFile bool Should we use the configuration file (fof.xml) of the component?
|
||
*
|
||
* @param Container $c The container for the component
|
||
* @param array $config The configuration overrides, see above
|
||
*/
|
||
public function __construct(Container $c, array $config = [])
|
||
{
|
||
// Store the container reference in this object
|
||
$this->container = $c;
|
||
|
||
// Get a reference to some useful objects
|
||
$input = $this->container->input;
|
||
$platform = $this->container->platform;
|
||
|
||
// Get default permissions (can be overridden by the view)
|
||
$perms = (object) [
|
||
'manage' => $this->container->platform->authorise('core.manage', $input->getCmd('option', 'com_foobar')),
|
||
'create' => $this->container->platform->authorise('core.create', $input->getCmd('option', 'com_foobar')),
|
||
'edit' => $this->container->platform->authorise('core.edit', $input->getCmd('option', 'com_foobar')),
|
||
'editstate' => $this->container->platform->authorise('core.edit.state', $input->getCmd('option', 'com_foobar')),
|
||
'delete' => $this->container->platform->authorise('core.delete', $input->getCmd('option', 'com_foobar')),
|
||
];
|
||
|
||
// Save front-end toolbar and submenu rendering flags if present in the config
|
||
if (array_key_exists('renderFrontendButtons', $config))
|
||
{
|
||
$this->renderFrontendButtons = $config['renderFrontendButtons'];
|
||
}
|
||
|
||
if (array_key_exists('renderFrontendSubmenu', $config))
|
||
{
|
||
$this->renderFrontendSubmenu = $config['renderFrontendSubmenu'];
|
||
}
|
||
|
||
// If not in the administrative area, load the JoomlaToolbarHelper
|
||
if (!$platform->isBackend())
|
||
{
|
||
// Needed for tests, so we can inject our "special" helper class
|
||
if (!class_exists('\Joomla\CMS\Toolbar\Toolbar'))
|
||
{
|
||
$platformDirs = $platform->getPlatformBaseDirs();
|
||
$path = $platformDirs['root'] . '/administrator/includes/toolbar.php';
|
||
require_once $path;
|
||
}
|
||
|
||
// Things to do if we have to render a front-end toolbar
|
||
if ($this->renderFrontendButtons)
|
||
{
|
||
// Load back-end toolbar language files in front-end
|
||
$platform->loadTranslations('');
|
||
|
||
// Needed for tests (we can fake we're not in the backend, but we are still in CLI!)
|
||
if (!$platform->isCli())
|
||
{
|
||
// Load the core Javascript
|
||
HTMLHelper::_('behavior.core');
|
||
HTMLHelper::_('jquery.framework', true);
|
||
}
|
||
}
|
||
}
|
||
|
||
// Store permissions in the local toolbar object
|
||
$this->perms = $perms;
|
||
}
|
||
|
||
/**
|
||
* Renders the toolbar for the current view and task
|
||
*
|
||
* @param string|null $view The view of the component
|
||
* @param string|null $task The exact task of the view
|
||
*
|
||
* @return void
|
||
*/
|
||
public function renderToolbar(?string $view = null, ?string $task = null): void
|
||
{
|
||
$input = $this->container->input;
|
||
|
||
$render_toolbar = $input->getCmd('tmpl', '') != 'component';
|
||
|
||
// If there is a render_toolbar=0 in the URL, do not render a toolbar
|
||
$render_toolbar = $input->getBool('render_toolbar', $render_toolbar);
|
||
|
||
if (!$render_toolbar)
|
||
{
|
||
return;
|
||
}
|
||
|
||
// Get the view and task
|
||
$controller = $this->container->dispatcher->getController();
|
||
$autoDetectedView = 'cpanel';
|
||
$autoDetectedTask = 'main';
|
||
|
||
if (is_object($controller) && ($controller instanceof Controller))
|
||
{
|
||
$autoDetectedView = $controller->getName();
|
||
$autoDetectedTask = $controller->getTask();
|
||
}
|
||
|
||
if (empty($view))
|
||
{
|
||
$view = $input->getCmd('view', $autoDetectedView);
|
||
}
|
||
|
||
if (empty($task))
|
||
{
|
||
$task = $input->getCmd('task', $autoDetectedTask);
|
||
}
|
||
|
||
// If there is a fof.xml toolbar configuration use it and return
|
||
$view = $this->container->inflector->pluralize($view);
|
||
$toolbarConfig = $this->container->appConfig->get('views.' . ucfirst($view) . '.toolbar.' . $task);
|
||
|
||
$oldValues = [
|
||
'renderFrontendButtons' => $this->renderFrontendButtons,
|
||
'renderFrontendSubmenu' => $this->renderFrontendSubmenu,
|
||
'useConfigurationFile' => $this->useConfigurationFile,
|
||
];
|
||
|
||
$newValues = [
|
||
'renderFrontendButtons' => $this->container->appConfig->get(
|
||
'views.' . ucfirst($view) . '.config.renderFrontendButtons',
|
||
$oldValues['renderFrontendButtons']
|
||
),
|
||
'renderFrontendSubmenu' => $this->container->appConfig->get(
|
||
'views.' . ucfirst($view) . '.config.renderFrontendSubmenu',
|
||
$oldValues['renderFrontendSubmenu']
|
||
),
|
||
'useConfigurationFile' => $this->container->appConfig->get(
|
||
'views.' . ucfirst($view) . '.config.useConfigurationFile',
|
||
$oldValues['useConfigurationFile']
|
||
),
|
||
];
|
||
|
||
foreach ($newValues as $k => $v)
|
||
{
|
||
$this->$k = $v;
|
||
}
|
||
|
||
if (!empty($toolbarConfig) && $this->useConfigurationFile)
|
||
{
|
||
$this->renderFromConfig($toolbarConfig);
|
||
|
||
return;
|
||
}
|
||
|
||
// Check for an onViewTask method
|
||
$methodName = 'on' . ucfirst($view) . ucfirst($task);
|
||
|
||
if (method_exists($this, $methodName))
|
||
{
|
||
$this->$methodName();
|
||
|
||
return;
|
||
}
|
||
|
||
// Check for an onView method
|
||
$methodName = 'on' . ucfirst($view);
|
||
|
||
if (method_exists($this, $methodName))
|
||
{
|
||
$this->$methodName();
|
||
|
||
return;
|
||
}
|
||
|
||
// Check for an onTask method
|
||
$methodName = 'on' . ucfirst($task);
|
||
|
||
if (method_exists($this, $methodName))
|
||
{
|
||
$this->$methodName();
|
||
|
||
return;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Renders the toolbar for the component's Control Panel page
|
||
*
|
||
* @return void
|
||
*/
|
||
public function onCpanelsBrowse(): void
|
||
{
|
||
if ($this->container->platform->isBackend() || $this->renderFrontendSubmenu)
|
||
{
|
||
$this->renderSubmenu();
|
||
}
|
||
|
||
if (!$this->container->platform->isBackend() && !$this->renderFrontendButtons)
|
||
{
|
||
return;
|
||
}
|
||
|
||
$option = $this->container->componentName;
|
||
|
||
JoomlaToolbarHelper::title(Text::_(strtoupper($option)), str_replace('com_', '', $option));
|
||
|
||
if (!$this->isDataView())
|
||
{
|
||
return;
|
||
}
|
||
|
||
JoomlaToolbarHelper::preferences($option);
|
||
}
|
||
|
||
/**
|
||
* Renders the toolbar for the component's Browse pages (the plural views)
|
||
*
|
||
* @return void
|
||
*/
|
||
public function onBrowse(): void
|
||
{
|
||
// On frontend, buttons must be added specifically
|
||
if ($this->container->platform->isBackend() || $this->renderFrontendSubmenu)
|
||
{
|
||
$this->renderSubmenu();
|
||
}
|
||
|
||
if (!$this->container->platform->isBackend() && !$this->renderFrontendButtons)
|
||
{
|
||
return;
|
||
}
|
||
|
||
// Setup
|
||
$option = $this->container->componentName;
|
||
$view = $this->container->input->getCmd('view', 'cpanel');
|
||
|
||
// Set toolbar title
|
||
$subtitle_key = strtoupper($option . '_TITLE_' . $view);
|
||
JoomlaToolbarHelper::title(Text::_(strtoupper($option)) . ': ' . Text::_($subtitle_key), str_replace('com_', '', $option));
|
||
|
||
if (!$this->isDataView())
|
||
{
|
||
return;
|
||
}
|
||
|
||
// Add toolbar buttons
|
||
if ($this->perms->create)
|
||
{
|
||
JoomlaToolbarHelper::addNew();
|
||
}
|
||
|
||
if ($this->perms->edit)
|
||
{
|
||
JoomlaToolbarHelper::editList();
|
||
}
|
||
|
||
if ($this->perms->create || $this->perms->edit)
|
||
{
|
||
JoomlaToolbarHelper::divider();
|
||
}
|
||
|
||
// Published buttons are only added if there is a enabled field in the table
|
||
try
|
||
{
|
||
$model = $this->container->factory->model($view);
|
||
|
||
if ($model->hasField('enabled') && $this->perms->editstate)
|
||
{
|
||
JoomlaToolbarHelper::publishList();
|
||
JoomlaToolbarHelper::unpublishList();
|
||
JoomlaToolbarHelper::divider();
|
||
}
|
||
}
|
||
catch (\Exception $e)
|
||
{
|
||
// Yeah. Let's not add the buttons if we can't load the model...
|
||
}
|
||
|
||
if ($this->perms->delete)
|
||
{
|
||
$msg = Text::_($option . '_CONFIRM_DELETE');
|
||
JoomlaToolbarHelper::deleteList(strtoupper($msg));
|
||
}
|
||
|
||
// A Check-In button is only added if there is a locked_on field in the table
|
||
try
|
||
{
|
||
$model = $this->container->factory->model($view);
|
||
|
||
if ($model->hasField('locked_on') && $this->perms->edit)
|
||
{
|
||
JoomlaToolbarHelper::checkin();
|
||
}
|
||
|
||
}
|
||
catch (\Exception $e)
|
||
{
|
||
// Yeah. Let's not add the button if we can't load the model...
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Renders the toolbar for the component's Read pages
|
||
*
|
||
* @return void
|
||
*/
|
||
public function onRead(): void
|
||
{
|
||
// On frontend, buttons must be added specifically
|
||
if ($this->container->platform->isBackend() || $this->renderFrontendSubmenu)
|
||
{
|
||
$this->renderSubmenu();
|
||
}
|
||
|
||
if (!$this->container->platform->isBackend() && !$this->renderFrontendButtons)
|
||
{
|
||
return;
|
||
}
|
||
|
||
$option = $this->container->componentName;
|
||
$componentName = str_replace('com_', '', $option);
|
||
$view = $this->container->input->getCmd('view', 'cpanel');
|
||
|
||
// Set toolbar title
|
||
$subtitle_key = strtoupper($option . '_TITLE_' . $view . '_READ');
|
||
JoomlaToolbarHelper::title(Text::_(strtoupper($option)) . ': ' . Text::_($subtitle_key), $componentName);
|
||
|
||
if (!$this->isDataView())
|
||
{
|
||
return;
|
||
}
|
||
|
||
// Set toolbar icons
|
||
JoomlaToolbarHelper::back();
|
||
}
|
||
|
||
/**
|
||
* Renders the toolbar for the component's Add pages
|
||
*
|
||
* @return void
|
||
*/
|
||
public function onAdd(): void
|
||
{
|
||
// On frontend, buttons must be added specifically
|
||
if (!$this->container->platform->isBackend() && !$this->renderFrontendButtons)
|
||
{
|
||
return;
|
||
}
|
||
|
||
$option = $this->container->componentName;
|
||
$componentName = str_replace('com_', '', $option);
|
||
$view = $this->container->input->getCmd('view', 'cpanel');
|
||
|
||
// Set toolbar title
|
||
$subtitle_key = strtoupper($option . '_TITLE_' . $this->container->inflector->pluralize($view)) . '_EDIT';
|
||
JoomlaToolbarHelper::title(Text::_(strtoupper($option)) . ': ' . Text::_($subtitle_key), $componentName);
|
||
|
||
if (!$this->isDataView())
|
||
{
|
||
return;
|
||
}
|
||
|
||
// Set toolbar icons
|
||
if ($this->perms->edit || $this->perms->editown)
|
||
{
|
||
// Show the apply button only if I can edit the record, otherwise I'll return to the edit form and get a
|
||
// 403 error since I can't do that
|
||
JoomlaToolbarHelper::apply();
|
||
}
|
||
|
||
JoomlaToolbarHelper::save();
|
||
|
||
if ($this->perms->create)
|
||
{
|
||
JoomlaToolbarHelper::custom('savenew', 'save-new.png', 'save-new_f2.png', 'JTOOLBAR_SAVE_AND_NEW', false);
|
||
}
|
||
|
||
JoomlaToolbarHelper::cancel();
|
||
}
|
||
|
||
/**
|
||
* Renders the toolbar for the component's Edit pages
|
||
*
|
||
* @return void
|
||
*/
|
||
public function onEdit(): void
|
||
{
|
||
// On frontend, buttons must be added specifically
|
||
if (!$this->container->platform->isBackend() && !$this->renderFrontendButtons)
|
||
{
|
||
return;
|
||
}
|
||
|
||
$this->onAdd();
|
||
}
|
||
|
||
/**
|
||
* Removes all links from the link bar
|
||
*
|
||
* @return void
|
||
*/
|
||
public function clearLinks(): void
|
||
{
|
||
$this->linkbar = [];
|
||
}
|
||
|
||
/**
|
||
* Get the link bar's link definitions
|
||
*
|
||
* @return array
|
||
*/
|
||
public function &getLinks(): array
|
||
{
|
||
return $this->linkbar;
|
||
}
|
||
|
||
/**
|
||
* Append a link to the link bar
|
||
*
|
||
* @param string $name The text of the link
|
||
* @param string|null $link The link to render; set to null to render a separator
|
||
* @param boolean $active True if it's an active link
|
||
* @param string|null $icon Icon class (used by some renderers, like the Bootstrap renderer)
|
||
* @param string|null $parent The parent element (referenced by name)) This will create a dropdown list
|
||
*
|
||
* @return void
|
||
*/
|
||
public function appendLink(string $name, ?string $link = null, bool $active = false, ?string $icon = null, ?string $parent = ''): void
|
||
{
|
||
$linkDefinition = [
|
||
'name' => $name,
|
||
'link' => $link,
|
||
'active' => $active,
|
||
'icon' => $icon,
|
||
];
|
||
|
||
if (empty($parent))
|
||
{
|
||
if (array_key_exists($name, $this->linkbar))
|
||
{
|
||
$this->linkbar[$name] = array_merge($this->linkbar[$name], $linkDefinition);
|
||
|
||
// If there already are some children, I have to put this view link in the "items" array in the first place
|
||
if (array_key_exists('items', $this->linkbar[$name]))
|
||
{
|
||
array_unshift($this->linkbar[$name]['items'], $linkDefinition);
|
||
}
|
||
}
|
||
else
|
||
{
|
||
$this->linkbar[$name] = $linkDefinition;
|
||
}
|
||
}
|
||
else
|
||
{
|
||
if (!array_key_exists($parent, $this->linkbar))
|
||
{
|
||
$parentElement = $linkDefinition;
|
||
$parentElement['name'] = $parent;
|
||
$parentElement['link'] = null;
|
||
$this->linkbar[$parent] = $parentElement;
|
||
$parentElement['items'] = [];
|
||
}
|
||
else
|
||
{
|
||
$parentElement = $this->linkbar[$parent];
|
||
|
||
if (!array_key_exists('dropdown', $parentElement) && !empty($parentElement['link']))
|
||
{
|
||
$newSubElement = $parentElement;
|
||
$parentElement['items'] = [$newSubElement];
|
||
}
|
||
}
|
||
|
||
$parentElement['items'][] = $linkDefinition;
|
||
$parentElement['dropdown'] = true;
|
||
|
||
if ($active)
|
||
{
|
||
$parentElement['active'] = true;
|
||
}
|
||
|
||
$this->linkbar[$parent] = $parentElement;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Prefixes (some people erroneously call this "prepend" – there is no such word) a link to the link bar
|
||
*
|
||
* @param string $name The text of the link
|
||
* @param string|null $link The link to render; set to null to render a separator
|
||
* @param boolean $active True if it's an active link
|
||
* @param string|null $icon Icon class (used by some renderers, like the Bootstrap renderer)
|
||
*
|
||
* @return void
|
||
*/
|
||
public function prefixLink(string $name, ?string $link = null, bool $active = false, ?string $icon = null): void
|
||
{
|
||
$linkDefinition = [
|
||
'name' => $name,
|
||
'link' => $link,
|
||
'active' => $active,
|
||
'icon' => $icon,
|
||
];
|
||
array_unshift($this->linkbar, $linkDefinition);
|
||
}
|
||
|
||
/**
|
||
* Renders the submenu (toolbar links) for all detected views of this component
|
||
*
|
||
* @return void
|
||
*/
|
||
public function renderSubmenu(): void
|
||
{
|
||
$views = $this->getMyViews();
|
||
|
||
if (empty($views))
|
||
{
|
||
return;
|
||
}
|
||
|
||
$activeView = $this->container->input->getCmd('view', 'cpanel');
|
||
|
||
foreach ($views as $view)
|
||
{
|
||
// Get the view name
|
||
$key = strtoupper($this->container->componentName) . '_TITLE_' . strtoupper($view);
|
||
|
||
//Do we have a translation for this key?
|
||
if (strtoupper(Text::_($key)) === $key)
|
||
{
|
||
$altview = $this->container->inflector->isPlural($view) ? $this->container->inflector->singularize($view) : $this->container->inflector->pluralize($view);
|
||
$key2 = strtoupper($this->container->componentName) . '_TITLE_' . strtoupper($altview);
|
||
|
||
$name = strtoupper(Text::_($key2)) === $key2 ? ucfirst($view) : Text::_($key2);
|
||
}
|
||
else
|
||
{
|
||
$name = Text::_($key);
|
||
}
|
||
|
||
$link = 'index.php?option=' . $this->container->componentName . '&view=' . $view;
|
||
|
||
$active = $view === $activeView;
|
||
|
||
$this->appendLink($name, $link, $active);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Return the front-end toolbar rendering flag
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function getRenderFrontendButtons(): bool
|
||
{
|
||
return $this->renderFrontendButtons;
|
||
}
|
||
|
||
/**
|
||
* @param boolean $renderFrontendButtons
|
||
*/
|
||
public function setRenderFrontendButtons(bool $renderFrontendButtons): void
|
||
{
|
||
$this->renderFrontendButtons = $renderFrontendButtons;
|
||
}
|
||
|
||
/**
|
||
* Return the front-end submenu rendering flag
|
||
*
|
||
* @return boolean
|
||
*/
|
||
public function getRenderFrontendSubmenu(): bool
|
||
{
|
||
return $this->renderFrontendSubmenu;
|
||
}
|
||
|
||
/**
|
||
* @param boolean $renderFrontendSubmenu
|
||
*/
|
||
public function setRenderFrontendSubmenu(bool $renderFrontendSubmenu): void
|
||
{
|
||
$this->renderFrontendSubmenu = $renderFrontendSubmenu;
|
||
}
|
||
|
||
/**
|
||
* Is the view we are rendering the toolbar for a data-aware view?
|
||
*
|
||
* @return bool
|
||
*/
|
||
public function isDataView(): bool
|
||
{
|
||
if (is_null($this->isDataView))
|
||
{
|
||
$this->isDataView = false;
|
||
$controller = $this->container->dispatcher->getController();
|
||
$view = null;
|
||
|
||
if (is_object($controller) && ($controller instanceof Controller))
|
||
{
|
||
$view = $controller->getView();
|
||
}
|
||
|
||
if (is_object($view) && ($view instanceof View))
|
||
{
|
||
$this->isDataView = $view instanceof DataViewInterface;
|
||
}
|
||
}
|
||
|
||
return $this->isDataView;
|
||
}
|
||
|
||
/**
|
||
* Automatically detects all views of the component
|
||
*
|
||
* @return string[] A list of all views, in the order to be displayed in the toolbar submenu
|
||
*/
|
||
protected function getMyViews(): array
|
||
{
|
||
$t_views = [];
|
||
$using_meta = false;
|
||
|
||
$componentPaths = $this->container->platform->getComponentBaseDirs($this->container->componentName);
|
||
$searchPath = $componentPaths['main'] . '/View';
|
||
$filesystem = $this->container->filesystem;
|
||
|
||
$allFolders = $filesystem->folderFolders($searchPath);
|
||
|
||
foreach ($allFolders as $folder)
|
||
{
|
||
$view = $folder;
|
||
|
||
// View already added
|
||
if (in_array($this->container->inflector->pluralize($view), $t_views))
|
||
{
|
||
continue;
|
||
}
|
||
|
||
// Do we have a 'skip.xml' file in there?
|
||
$files = $filesystem->folderFiles($searchPath . '/' . $view, '^skip\.xml$');
|
||
|
||
if (!empty($files))
|
||
{
|
||
continue;
|
||
}
|
||
|
||
// Do we have extra information about this view? (ie. ordering)
|
||
$meta = $filesystem->folderFiles($searchPath . '/' . $view, '^metadata\.xml$');
|
||
|
||
// Not found, do we have it inside the plural one?
|
||
if (!$meta)
|
||
{
|
||
$plural = $this->container->inflector->pluralize($view);
|
||
|
||
if (in_array($plural, $allFolders))
|
||
{
|
||
$view = $plural;
|
||
$meta = $filesystem->folderFiles($searchPath . '/' . $view, '^metadata\.xml$');
|
||
}
|
||
}
|
||
|
||
if (!empty($meta))
|
||
{
|
||
$using_meta = true;
|
||
$xml = simplexml_load_file($searchPath . '/' . $view . '/' . $meta[0]);
|
||
$order = (int) $xml->foflib->ordering;
|
||
}
|
||
else
|
||
{
|
||
// Next place. It's ok since the index are 0-based and count is 1-based
|
||
|
||
if (!isset($to_order))
|
||
{
|
||
$to_order = [];
|
||
}
|
||
|
||
$order = count($to_order);
|
||
}
|
||
|
||
$view = $this->container->inflector->pluralize($view);
|
||
|
||
$t_view = new \stdClass;
|
||
$t_view->ordering = $order;
|
||
$t_view->view = $view;
|
||
|
||
$to_order[] = $t_view;
|
||
$t_views[] = $view;
|
||
}
|
||
|
||
$views = [];
|
||
|
||
if (!empty($to_order))
|
||
{
|
||
if (class_exists('JArrayHelper'))
|
||
{
|
||
\JArrayHelper::sortObjects($to_order, 'ordering');
|
||
$views = \JArrayHelper::getColumn($to_order, 'view');
|
||
}
|
||
else
|
||
{
|
||
ArrayHelper::sortObjects($to_order, 'ordering');
|
||
$views = ArrayHelper::getColumn($to_order, 'view');
|
||
}
|
||
|
||
}
|
||
|
||
// If not using the metadata file, let's put the cpanel view on top
|
||
if (!$using_meta)
|
||
{
|
||
$cpanel = array_search('cpanels', $views);
|
||
|
||
if ($cpanel !== false)
|
||
{
|
||
unset($views[$cpanel]);
|
||
array_unshift($views, 'cpanels');
|
||
}
|
||
}
|
||
|
||
return $views;
|
||
}
|
||
|
||
/**
|
||
* Simplified default rendering without any attributes.
|
||
*
|
||
* @param array $tasks Array of tasks.
|
||
*
|
||
* @return void
|
||
*/
|
||
protected function renderToolbarElements(array $tasks): void
|
||
{
|
||
foreach ($tasks as $task)
|
||
{
|
||
$this->renderToolbarElement($task);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Checks if the current user has enough privileges for the requested ACL privilege of a custom toolbar button.
|
||
*
|
||
* @param string $area The ACL privilege as set up in the $this->perms object
|
||
*
|
||
* @return boolean True if the user has the ACL privilege specified
|
||
*/
|
||
protected function checkACL(string $area): bool
|
||
{
|
||
if (is_bool($area))
|
||
{
|
||
return $area;
|
||
}
|
||
|
||
if (in_array(strtolower($area), ['false', '0', 'no', '403']))
|
||
{
|
||
return false;
|
||
}
|
||
|
||
if (in_array(strtolower($area), ['true', '1', 'yes']))
|
||
{
|
||
return true;
|
||
}
|
||
|
||
if (strtolower($area) == 'guest')
|
||
{
|
||
return $this->container->platform->getUser()->guest;
|
||
}
|
||
|
||
if (strtolower($area) == 'user')
|
||
{
|
||
return !$this->container->platform->getUser()->guest;
|
||
}
|
||
|
||
if (empty($area))
|
||
{
|
||
return true;
|
||
}
|
||
|
||
if (isset($this->perms->$area))
|
||
{
|
||
return $this->perms->$area;
|
||
}
|
||
|
||
return false;
|
||
}
|
||
|
||
/**
|
||
* Render the toolbar from the configuration.
|
||
*
|
||
* @param array $toolbar The toolbar definition
|
||
*
|
||
* @return void
|
||
*/
|
||
private function renderFromConfig(array $toolbar): void
|
||
{
|
||
$isBackend = $this->container->platform->isBackend();
|
||
|
||
if ($isBackend || $this->renderFrontendSubmenu)
|
||
{
|
||
$this->renderSubmenu();
|
||
}
|
||
|
||
if (!$isBackend && !$this->renderFrontendButtons)
|
||
{
|
||
return;
|
||
}
|
||
|
||
if (!$this->isDataView())
|
||
{
|
||
return;
|
||
}
|
||
|
||
// Render each element
|
||
foreach ($toolbar as $elementType => $elementAttributes)
|
||
{
|
||
$value = isset($elementAttributes['value']) ? (string) ($elementAttributes['value']) : null;
|
||
$this->renderToolbarElement($elementType, $value, $elementAttributes);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* Render a toolbar element.
|
||
*
|
||
* @param string $type The element type.
|
||
* @param ?string $value The title translation string for a 'title' element.
|
||
* @param array $attributes The element attributes.
|
||
*
|
||
* @return void
|
||
*
|
||
* @codeCoverageIgnore
|
||
* @throws \InvalidArgumentException
|
||
*/
|
||
private function renderToolbarElement(string $type, $value = null, array $attributes = []): void
|
||
{
|
||
switch ($type)
|
||
{
|
||
case 'title':
|
||
$icon = $attributes['icon'] ?? 'generic.png';
|
||
if (isset($attributes['translate']))
|
||
{
|
||
$value = Text::_($value);
|
||
}
|
||
|
||
JoomlaToolbarHelper::title($value, $icon);
|
||
break;
|
||
|
||
case 'divider':
|
||
JoomlaToolbarHelper::divider();
|
||
break;
|
||
|
||
case 'custom':
|
||
$task = $attributes['task'] ?? '';
|
||
$icon = $attributes['icon'] ?? '';
|
||
$iconOver = $attributes['icon_over'] ?? '';
|
||
$alt = $attributes['alt'] ?? '';
|
||
$listSelect = isset($attributes['list_select']) ?
|
||
fofStringToBool($attributes['list_select']) : true;
|
||
|
||
JoomlaToolbarHelper::custom($task, $icon, $iconOver, $alt, $listSelect);
|
||
break;
|
||
|
||
case 'preview':
|
||
$url = $attributes['url'] ?? '';
|
||
$update_editors = fofStringToBool($attributes['update_editors'] ?? 'false');
|
||
|
||
JoomlaToolbarHelper::preview($url, $update_editors);
|
||
break;
|
||
|
||
case 'help':
|
||
if (!isset($attributes['help']))
|
||
{
|
||
throw new MissingAttribute('help', 'help');
|
||
}
|
||
|
||
$ref = $attributes['help'];
|
||
$com = fofStringToBool($attributes['com'] ?? 'false');
|
||
$override = $attributes['override'] ?? null;
|
||
$component = $attributes['component'] ?? null;
|
||
|
||
JoomlaToolbarHelper::help($ref, $com, $override, $component);
|
||
break;
|
||
|
||
case 'back':
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_BACK';
|
||
$href = $attributes['href'] ?? 'javascript:history.back();';
|
||
|
||
JoomlaToolbarHelper::back($alt, $href);
|
||
break;
|
||
|
||
case 'media_manager':
|
||
$directory = $attributes['directory'] ?? '';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_UPLOAD';
|
||
|
||
JoomlaToolbarHelper::media_manager($directory, $alt);
|
||
break;
|
||
|
||
case 'assign':
|
||
$task = $attributes['task'] ?? 'assign';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_ASSIGN';
|
||
|
||
JoomlaToolbarHelper::assign($task, $alt);
|
||
break;
|
||
|
||
case 'addNew':
|
||
case 'new':
|
||
$area = $attributes['acl'] ?? 'create';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'add';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_NEW';
|
||
$check = fofStringToBool($attributes['check'] ?? 'false');
|
||
|
||
JoomlaToolbarHelper::addNew($task, $alt, $check);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'copy':
|
||
$area = $attributes['acl'] ?? 'create';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'copy';
|
||
$alt = $attributes['alt'] ?? 'JLIB_HTML_BATCH_COPY';
|
||
$icon = $attributes['icon'] ?? 'copy.png';
|
||
$iconOver = $attributes['iconOver'] ?? 'copy_f2.png';
|
||
|
||
JoomlaToolbarHelper::custom($task, $icon, $iconOver, $alt, false);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'publish':
|
||
$area = $attributes['acl'] ?? 'editstate';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'publish';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_PUBLISH';
|
||
$check = fofStringToBool($attributes['check'] ?? 'false');
|
||
|
||
JoomlaToolbarHelper::publish($task, $alt, $check);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'publishList':
|
||
$area = $attributes['acl'] ?? 'editstate';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'publish';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_PUBLISH';
|
||
|
||
JoomlaToolbarHelper::publishList($task, $alt);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'unpublish':
|
||
$area = $attributes['acl'] ?? 'editstate';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'unpublish';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_UNPUBLISH';
|
||
$check = fofStringToBool($attributes['check'] ?? 'false');
|
||
|
||
JoomlaToolbarHelper::unpublish($task, $alt, $check);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'unpublishList':
|
||
$area = $attributes['acl'] ?? 'editstate';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'unpublish';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_UNPUBLISH';
|
||
|
||
JoomlaToolbarHelper::unpublishList($task, $alt);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'archiveList':
|
||
$area = $attributes['acl'] ?? 'editstate';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'archive';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_ARCHIVE';
|
||
|
||
JoomlaToolbarHelper::archiveList($task, $alt);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'unarchiveList':
|
||
$area = $attributes['acl'] ?? 'editstate';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'unarchive';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_UNARCHIVE';
|
||
|
||
JoomlaToolbarHelper::unarchiveList($task, $alt);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'edit':
|
||
case 'editList':
|
||
$area = $attributes['acl'] ?? 'edit';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'edit';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_EDIT';
|
||
|
||
JoomlaToolbarHelper::editList($task, $alt);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'editHtml':
|
||
$task = $attributes['task'] ?? 'edit_source';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_EDIT_HTML';
|
||
|
||
JoomlaToolbarHelper::editHtml($task, $alt);
|
||
break;
|
||
|
||
case 'editCss':
|
||
$task = $attributes['task'] ?? 'edit_css';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_EDIT_CSS';
|
||
|
||
JoomlaToolbarHelper::editCss($task, $alt);
|
||
break;
|
||
|
||
case 'deleteList':
|
||
case 'delete':
|
||
$area = $attributes['acl'] ?? 'delete';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$msg = $attributes['msg'] ?? '';
|
||
$task = $attributes['task'] ?? 'remove';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_DELETE';
|
||
|
||
JoomlaToolbarHelper::deleteList($msg, $task, $alt);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'trash':
|
||
$area = $attributes['acl'] ?? 'editstate';
|
||
|
||
if ($this->checkACL($area))
|
||
{
|
||
$task = $attributes['task'] ?? 'trash';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_TRASH';
|
||
$check = isset($attributes['check']) ?
|
||
fofStringToBool($attributes['check']) : true;
|
||
|
||
JoomlaToolbarHelper::trash($task, $alt, $check);
|
||
}
|
||
|
||
break;
|
||
|
||
case 'apply':
|
||
$task = $attributes['task'] ?? 'apply';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_APPLY';
|
||
|
||
JoomlaToolbarHelper::apply($task, $alt);
|
||
break;
|
||
|
||
case 'save':
|
||
$task = $attributes['task'] ?? 'save';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_SAVE';
|
||
|
||
JoomlaToolbarHelper::save($task, $alt);
|
||
break;
|
||
|
||
case 'savenew':
|
||
$task = $attributes['task'] ?? 'savenew';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_SAVE_AND_NEW';
|
||
$icon = $attributes['icon'] ?? 'save-new.png';
|
||
$iconOver = $attributes['iconOver'] ?? 'save-new_f2.png';
|
||
|
||
JoomlaToolbarHelper::custom($task, $icon, $iconOver, $alt, false);
|
||
break;
|
||
|
||
case 'save2new':
|
||
$task = $attributes['task'] ?? 'save2new';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_SAVE_AND_NEW';
|
||
|
||
JoomlaToolbarHelper::save2new($task, $alt);
|
||
break;
|
||
|
||
case 'save2copy':
|
||
$task = $attributes['task'] ?? 'save2copy';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_SAVE_AS_COPY';
|
||
JoomlaToolbarHelper::save2copy($task, $alt);
|
||
break;
|
||
|
||
case 'checkin':
|
||
$task = $attributes['task'] ?? 'checkin';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_CHECKIN';
|
||
$check = isset($attributes['check']) ?
|
||
fofStringToBool($attributes['check']) : true;
|
||
|
||
JoomlaToolbarHelper::checkin($task, $alt, $check);
|
||
break;
|
||
|
||
case 'cancel':
|
||
$task = $attributes['task'] ?? 'cancel';
|
||
$alt = $attributes['alt'] ?? 'JTOOLBAR_CANCEL';
|
||
|
||
JoomlaToolbarHelper::cancel($task, $alt);
|
||
break;
|
||
|
||
case 'preferences':
|
||
if (!isset($attributes['component']))
|
||
{
|
||
throw new MissingAttribute('component', 'preferences');
|
||
}
|
||
|
||
$component = $attributes['component'];
|
||
$height = $attributes['height'] ?? '550';
|
||
$width = $attributes['width'] ?? '875';
|
||
$alt = $attributes['alt'] ?? 'JToolbar_Options';
|
||
$path = $attributes['path'] ?? '';
|
||
|
||
JoomlaToolbarHelper::preferences($component, $height, $width, $alt, $path);
|
||
break;
|
||
|
||
default:
|
||
throw new UnknownButtonType($type);
|
||
}
|
||
}
|
||
}
|