* @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\Snippet; 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\User\User; 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\StringHelper; use Joomla\CMS\Application\CMSApplicationInterface; use Joomla\Input\Input; // No direct access to this file \defined('_JEXEC') or die; /** * Snippet Html View class * * @since 1.6 */ #[\AllowDynamicProperties] class HtmlView extends BaseHtmlView { /** * The item from the model * * @var mixed * @since 3.10.11 */ public mixed $item; /** * The app class * * @var CMSApplicationInterface * @since 5.2.1 */ public CMSApplicationInterface $app; /** * The input class * * @var Input * @since 5.2.1 */ public Input $input; /** * The state object * * @var mixed * @since 3.10.11 */ public mixed $state; /** * The form from the model * * @var mixed * @since 3.10.11 */ public mixed $form; /** * The toolbar object * * @var Toolbar * @since 3.10.11 */ public Toolbar $toolbar; /** * The styles url array * * @var array * @since 5.0.0 */ protected array $styles; /** * The scripts url array * * @var array * @since 5.0.0 */ protected array $scripts; /** * The actions object * * @var object * @since 3.10.11 */ public object $canDo; /** * The origin referral view name * * @var string * @since 3.10.11 */ public string $ref; /** * The origin referral item id * * @var int * @since 3.10.11 */ public int $refid; /** * The referral url suffix values * * @var string * @since 3.10.11 */ public string $referral; /** * The modal state * * @var bool * @since 5.2.1 */ public bool $isModal; /** * Snippet view display method * * @param string $tpl The name of the template file to parse; automatically searches through the template paths. * * @return void * @throws \Exception * @since 1.6 */ public function display($tpl = null): void { // set params $this->params = ComponentHelper::getParams('com_componentbuilder'); $this->useCoreUI = true; // Load module values $model = $this->getModel(); $this->form ??= $model->getForm(); $this->item = $model->getItem(); $this->styles = $model->getStyles(); $this->scripts = $model->getScripts(); $this->state = $model->getState(); // get action permissions $this->canDo = ComponentbuilderHelper::getActions('snippet', $this->item); // get application $this->app ??= Factory::getApplication(); // get input $this->input ??= method_exists($this->app, 'getInput') ? $this->app->getInput() : $this->app->input; $this->ref = $this->input->get('ref', 0, 'word'); $this->refid = $this->input->get('refid', 0, 'int'); $return = $this->input->get('return', null, 'base64'); // set the referral string $this->referral = ''; if ($this->refid && $this->ref) { // return to the item that referred to this item $this->referral = '&ref=' . (string) $this->ref . '&refid=' . (int) $this->refid; } elseif($this->ref) { // return to the list view that referred to this item $this->referral = '&ref=' . (string) $this->ref; } // check return value if (!is_null($return)) { // add the return value $this->referral .= '&return=' . (string) $return; } // Set the toolbar if ($this->getLayout() !== 'modal') { $this->isModal = false; $this->addToolbar(); } else { $this->isModal = true; $this->addModalToolbar(); } // 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 * @throws \Exception * @since 1.6 */ protected function addToolbar(): void { Factory::getApplication()->getInput()->set('hidemainmenu', true); $user = $this->getCurrentUser(); $userId = $user->id; $isNew = $this->item->id == 0; ToolbarHelper::title( Text::_($isNew ? 'COM_COMPONENTBUILDER_SNIPPET_NEW' : 'COM_COMPONENTBUILDER_SNIPPET_EDIT'), 'pencil-2 article-add'); // Built the actions for new and existing records. if (StringHelper::check($this->referral)) { if ($this->canDo->get('core.create') && $isNew) { // We can create the record. ToolbarHelper::save('snippet.save', 'JTOOLBAR_SAVE'); } elseif ($this->canDo->get('core.edit')) { // We can save the record. ToolbarHelper::save('snippet.save', 'JTOOLBAR_SAVE'); } if ($isNew) { // Do not creat but cancel. ToolbarHelper::cancel('snippet.cancel', 'JTOOLBAR_CANCEL'); } else { // We can close it. ToolbarHelper::cancel('snippet.cancel', 'JTOOLBAR_CLOSE'); } } else { if ($isNew) { // For new records, check the create permission. if ($this->canDo->get('core.create')) { ToolbarHelper::apply('snippet.apply', 'JTOOLBAR_APPLY'); ToolbarHelper::save('snippet.save', 'JTOOLBAR_SAVE'); ToolbarHelper::custom('snippet.save2new', 'save-new.png', 'save-new_f2.png', 'JTOOLBAR_SAVE_AND_NEW', false); }; ToolbarHelper::cancel('snippet.cancel', 'JTOOLBAR_CANCEL'); } else { if ($this->canDo->get('core.edit')) { // We can save the new record ToolbarHelper::apply('snippet.apply', 'JTOOLBAR_APPLY'); ToolbarHelper::save('snippet.save', 'JTOOLBAR_SAVE'); // We can save this record, but check the create permission to see // if we can return to make a new one. if ($this->canDo->get('core.create')) { ToolbarHelper::custom('snippet.save2new', 'save-new.png', 'save-new_f2.png', 'JTOOLBAR_SAVE_AND_NEW', false); } } $canVersion = ($this->canDo->get('core.version') && $this->canDo->get('snippet.version')); if ($this->state->params->get('save_history', 1) && $this->canDo->get('core.edit') && $canVersion) { ToolbarHelper::versions('com_componentbuilder.snippet', $this->item->id); } if ($this->canDo->get('core.create')) { ToolbarHelper::custom('snippet.save2copy', 'save-copy.png', 'save-copy_f2.png', 'JTOOLBAR_SAVE_AS_COPY', false); } if ($this->canDo->get('snippet.reset')) { // add Reset button. ToolbarHelper::custom('snippet.resetPowers', 'joomla custom-button-resetpowers', '', 'COM_COMPONENTBUILDER_RESET', false); } if ($this->canDo->get('snippet.push')) { // add Push button. ToolbarHelper::custom('snippet.pushPowers', 'share custom-button-pushpowers', '', 'COM_COMPONENTBUILDER_PUSH', false); } ToolbarHelper::cancel('snippet.cancel', 'JTOOLBAR_CLOSE'); } } ToolbarHelper::divider(); ToolbarHelper::inlinehelp(); // set help url for this view if found $this->help_url = ComponentbuilderHelper::getHelpUrl('snippet'); if (StringHelper::check($this->help_url)) { ToolbarHelper::help('COM_COMPONENTBUILDER_HELP_MANAGER', false, $this->help_url); } } /** * Add the modal toolbar. * * @return void * @throws \Exception * @since 5.0.0 */ protected function addModalToolbar() { Factory::getApplication()->getInput()->set('hidemainmenu', true); $user = $this->getCurrentUser(); $userId = $user->id; $isNew = $this->item->id == 0; ToolbarHelper::title( Text::_($isNew ? 'COM_COMPONENTBUILDER_SNIPPET_NEW' : 'COM_COMPONENTBUILDER_SNIPPET_EDIT'), 'pencil-2 article-add'); // Built the actions for new and existing records. if (StringHelper::check($this->referral)) { if ($this->canDo->get('core.create') && $isNew) { // We can create the record. ToolbarHelper::save('snippet.save', 'JTOOLBAR_SAVE'); } elseif ($this->canDo->get('core.edit')) { // We can save the record. ToolbarHelper::save('snippet.save', 'JTOOLBAR_SAVE'); } if ($isNew) { // Do not creat but cancel. ToolbarHelper::cancel('snippet.cancel', 'JTOOLBAR_CANCEL'); } else { // We can close it. ToolbarHelper::cancel('snippet.cancel', 'JTOOLBAR_CLOSE'); } } else { if ($isNew) { // For new records, check the create permission. if ($this->canDo->get('core.create')) { ToolbarHelper::apply('snippet.apply', 'JTOOLBAR_APPLY'); ToolbarHelper::save('snippet.save', 'JTOOLBAR_SAVE'); ToolbarHelper::custom('snippet.save2new', 'save-new.png', 'save-new_f2.png', 'JTOOLBAR_SAVE_AND_NEW', false); }; ToolbarHelper::cancel('snippet.cancel', 'JTOOLBAR_CANCEL'); } else { if ($this->canDo->get('core.edit')) { // We can save the new record ToolbarHelper::apply('snippet.apply', 'JTOOLBAR_APPLY'); ToolbarHelper::save('snippet.save', 'JTOOLBAR_SAVE'); } if ($this->canDo->get('snippet.reset')) { // add Reset button. ToolbarHelper::custom('snippet.resetPowers', 'joomla custom-button-resetpowers', '', 'COM_COMPONENTBUILDER_RESET', false); } if ($this->canDo->get('snippet.push')) { // add Push button. ToolbarHelper::custom('snippet.pushPowers', 'share custom-button-pushpowers', '', 'COM_COMPONENTBUILDER_PUSH', false); } ToolbarHelper::cancel('snippet.cancel', 'JTOOLBAR_CLOSE'); } } } /** * 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 = 30) { if (!is_string($var)) { return $var; } return StringHelper::html($var, $this->_charset ?? 'UTF-8', $shorten, $length); } /** * Prepare some document related stuff. * * @return void * @since 1.6 */ protected function _prepareDocument(): void { // Load jQuery Html::_('jquery.framework'); $isNew = ($this->item->id < 1); $this->getDocument()->setTitle(Text::_($isNew ? 'COM_COMPONENTBUILDER_SNIPPET_NEW' : 'COM_COMPONENTBUILDER_SNIPPET_EDIT')); // add styles foreach ($this->styles as $style) { Html::_('stylesheet', $style, ['version' => 'auto']); } // Add Ajax Token $this->getDocument()->addScriptDeclaration("var token = '" . Session::getFormToken() . "';"); // add scripts foreach ($this->scripts as $script) { Html::_('script', $script, ['version' => 'auto']); } } }