* @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\Help_document; 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\StringHelper; // No direct access to this file \defined('_JEXEC') or die; /** * Help_document Html View class * * @since 1.6 */ class HtmlView extends BaseHtmlView { /** * Help_document 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) { // set params $this->params = ComponentHelper::getParams('com_componentbuilder'); $this->useCoreUI = true; // Assign the variables $this->form = $this->get('Form'); $this->item = $this->get('Item'); $this->styles = $this->get('Styles'); $this->scripts = $this->get('Scripts'); $this->state = $this->get('State'); // get action permissions $this->canDo = ComponentbuilderHelper::getActions('help_document', $this->item); // get input $jinput = Factory::getApplication()->input; $this->ref = $jinput->get('ref', 0, 'word'); $this->refid = $jinput->get('refid', 0, 'int'); $return = $jinput->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 $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 { Factory::getApplication()->input->set('hidemainmenu', true); $user = Factory::getApplication()->getIdentity(); $userId = $user->id; $isNew = $this->item->id == 0; ToolbarHelper::title( Text::_($isNew ? 'COM_COMPONENTBUILDER_HELP_DOCUMENT_NEW' : 'COM_COMPONENTBUILDER_HELP_DOCUMENT_EDIT'), 'pencil-2 article-add'); // Built the actions for new and existing records. if (StringHelper::check($this->referral)) { if ($this->canDo->get('help_document.create') && $isNew) { // We can create the record. ToolbarHelper::save('help_document.save', 'JTOOLBAR_SAVE'); } elseif ($this->canDo->get('help_document.edit')) { // We can save the record. ToolbarHelper::save('help_document.save', 'JTOOLBAR_SAVE'); } if ($isNew) { // Do not creat but cancel. ToolbarHelper::cancel('help_document.cancel', 'JTOOLBAR_CANCEL'); } else { // We can close it. ToolbarHelper::cancel('help_document.cancel', 'JTOOLBAR_CLOSE'); } } else { if ($isNew) { // For new records, check the create permission. if ($this->canDo->get('help_document.create')) { ToolbarHelper::apply('help_document.apply', 'JTOOLBAR_APPLY'); ToolbarHelper::save('help_document.save', 'JTOOLBAR_SAVE'); ToolbarHelper::custom('help_document.save2new', 'save-new.png', 'save-new_f2.png', 'JTOOLBAR_SAVE_AND_NEW', false); }; ToolbarHelper::cancel('help_document.cancel', 'JTOOLBAR_CANCEL'); } else { if ($this->canDo->get('help_document.edit')) { // We can save the new record ToolbarHelper::apply('help_document.apply', 'JTOOLBAR_APPLY'); ToolbarHelper::save('help_document.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('help_document.create')) { ToolbarHelper::custom('help_document.save2new', 'save-new.png', 'save-new_f2.png', 'JTOOLBAR_SAVE_AND_NEW', false); } } $canVersion = ($this->canDo->get('core.version') && $this->canDo->get('help_document.version')); if ($this->state->params->get('save_history', 1) && $this->canDo->get('help_document.edit') && $canVersion) { ToolbarHelper::versions('com_componentbuilder.help_document', $this->item->id); } if ($this->canDo->get('help_document.create')) { ToolbarHelper::custom('help_document.save2copy', 'save-copy.png', 'save-copy_f2.png', 'JTOOLBAR_SAVE_AS_COPY', false); } ToolbarHelper::cancel('help_document.cancel', 'JTOOLBAR_CLOSE'); } } ToolbarHelper::divider(); ToolbarHelper::inlinehelp(); // set help url for this view if found $this->help_url = ComponentbuilderHelper::getHelpUrl('help_document'); if (StringHelper::check($this->help_url)) { ToolbarHelper::help('COM_COMPONENTBUILDER_HELP_MANAGER', false, $this->help_url); } } /** * 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_HELP_DOCUMENT_NEW' : 'COM_COMPONENTBUILDER_HELP_DOCUMENT_EDIT')); // add styles foreach ($this->styles as $style) { Html::_('stylesheet', $style, ['version' => 'auto']); } // add scripts foreach ($this->scripts as $script) { Html::_('script', $script, ['version' => 'auto']); } } }