forked from joomla/Component-Builder
434 lines
14 KiB
PHP
434 lines
14 KiB
PHP
<?php
|
|
/**
|
|
* @package Joomla.Component.Builder
|
|
*
|
|
* @created 30th April, 2015
|
|
* @author Llewellyn van der Merwe <http://www.joomlacomponentbuilder.com>
|
|
* @github Joomla Component Builder <https://github.com/vdm-io/Joomla-Component-Builder>
|
|
* @copyright Copyright (C) 2015 - 2019 Vast Development Method. All rights reserved.
|
|
* @license GNU General Public License version 2 or later; see LICENSE.txt
|
|
*/
|
|
|
|
// No direct access to this file
|
|
defined('_JEXEC') or die('Restricted access');
|
|
|
|
/**
|
|
* Componentbuilder View class for the Help_documents
|
|
*/
|
|
class ComponentbuilderViewHelp_documents extends JViewLegacy
|
|
{
|
|
/**
|
|
* Help_documents view display method
|
|
* @return void
|
|
*/
|
|
function display($tpl = null)
|
|
{
|
|
if ($this->getLayout() !== 'modal')
|
|
{
|
|
// Include helper submenu
|
|
ComponentbuilderHelper::addSubmenu('help_documents');
|
|
}
|
|
|
|
// Assign data to the view
|
|
$this->items = $this->get('Items');
|
|
$this->pagination = $this->get('Pagination');
|
|
$this->state = $this->get('State');
|
|
$this->user = JFactory::getUser();
|
|
$this->listOrder = $this->escape($this->state->get('list.ordering'));
|
|
$this->listDirn = $this->escape($this->state->get('list.direction'));
|
|
$this->saveOrder = $this->listOrder == 'ordering';
|
|
// set the return here value
|
|
$this->return_here = urlencode(base64_encode((string) JUri::getInstance()));
|
|
// get global action permissions
|
|
$this->canDo = ComponentbuilderHelper::getActions('help_document');
|
|
$this->canEdit = $this->canDo->get('help_document.edit');
|
|
$this->canState = $this->canDo->get('help_document.edit.state');
|
|
$this->canCreate = $this->canDo->get('help_document.create');
|
|
$this->canDelete = $this->canDo->get('help_document.delete');
|
|
$this->canBatch = $this->canDo->get('core.batch');
|
|
|
|
// We don't need toolbar in the modal window.
|
|
if ($this->getLayout() !== 'modal')
|
|
{
|
|
$this->addToolbar();
|
|
$this->sidebar = JHtmlSidebar::render();
|
|
// load the batch html
|
|
if ($this->canCreate && $this->canEdit && $this->canState)
|
|
{
|
|
$this->batchDisplay = JHtmlBatch_::render();
|
|
}
|
|
}
|
|
|
|
// Check for errors.
|
|
if (count($errors = $this->get('Errors')))
|
|
{
|
|
throw new Exception(implode("\n", $errors), 500);
|
|
}
|
|
|
|
// Display the template
|
|
parent::display($tpl);
|
|
|
|
// Set the document
|
|
$this->setDocument();
|
|
}
|
|
|
|
/**
|
|
* Setting the toolbar
|
|
*/
|
|
protected function addToolBar()
|
|
{
|
|
JToolBarHelper::title(JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENTS'), 'support');
|
|
JHtmlSidebar::setAction('index.php?option=com_componentbuilder&view=help_documents');
|
|
JFormHelper::addFieldPath(JPATH_COMPONENT . '/models/fields');
|
|
|
|
if ($this->canCreate)
|
|
{
|
|
JToolBarHelper::addNew('help_document.add');
|
|
}
|
|
|
|
// Only load if there are items
|
|
if (ComponentbuilderHelper::checkArray($this->items))
|
|
{
|
|
if ($this->canEdit)
|
|
{
|
|
JToolBarHelper::editList('help_document.edit');
|
|
}
|
|
|
|
if ($this->canState)
|
|
{
|
|
JToolBarHelper::publishList('help_documents.publish');
|
|
JToolBarHelper::unpublishList('help_documents.unpublish');
|
|
JToolBarHelper::archiveList('help_documents.archive');
|
|
|
|
if ($this->canDo->get('core.admin'))
|
|
{
|
|
JToolBarHelper::checkin('help_documents.checkin');
|
|
}
|
|
}
|
|
|
|
// Add a batch button
|
|
if ($this->canBatch && $this->canCreate && $this->canEdit && $this->canState)
|
|
{
|
|
// Get the toolbar object instance
|
|
$bar = JToolBar::getInstance('toolbar');
|
|
// set the batch button name
|
|
$title = JText::_('JTOOLBAR_BATCH');
|
|
// Instantiate a new JLayoutFile instance and render the batch button
|
|
$layout = new JLayoutFile('joomla.toolbar.batch');
|
|
// add the button to the page
|
|
$dhtml = $layout->render(array('title' => $title));
|
|
$bar->appendButton('Custom', $dhtml, 'batch');
|
|
}
|
|
|
|
if ($this->state->get('filter.published') == -2 && ($this->canState && $this->canDelete))
|
|
{
|
|
JToolbarHelper::deleteList('', 'help_documents.delete', 'JTOOLBAR_EMPTY_TRASH');
|
|
}
|
|
elseif ($this->canState && $this->canDelete)
|
|
{
|
|
JToolbarHelper::trash('help_documents.trash');
|
|
}
|
|
|
|
if ($this->canDo->get('core.export') && $this->canDo->get('help_document.export'))
|
|
{
|
|
JToolBarHelper::custom('help_documents.exportData', 'download', '', 'COM_COMPONENTBUILDER_EXPORT_DATA', true);
|
|
}
|
|
}
|
|
|
|
if ($this->canDo->get('core.import') && $this->canDo->get('help_document.import'))
|
|
{
|
|
JToolBarHelper::custom('help_documents.importData', 'upload', '', 'COM_COMPONENTBUILDER_IMPORT_DATA', false);
|
|
}
|
|
|
|
// set help url for this view if found
|
|
$help_url = ComponentbuilderHelper::getHelpUrl('help_documents');
|
|
if (ComponentbuilderHelper::checkString($help_url))
|
|
{
|
|
JToolbarHelper::help('COM_COMPONENTBUILDER_HELP_MANAGER', false, $help_url);
|
|
}
|
|
|
|
// add the options comp button
|
|
if ($this->canDo->get('core.admin') || $this->canDo->get('core.options'))
|
|
{
|
|
JToolBarHelper::preferences('com_componentbuilder');
|
|
}
|
|
|
|
if ($this->canState)
|
|
{
|
|
JHtmlSidebar::addFilter(
|
|
JText::_('JOPTION_SELECT_PUBLISHED'),
|
|
'filter_published',
|
|
JHtml::_('select.options', JHtml::_('jgrid.publishedOptions'), 'value', 'text', $this->state->get('filter.published'), true)
|
|
);
|
|
// only load if batch allowed
|
|
if ($this->canBatch)
|
|
{
|
|
JHtmlBatch_::addListSelection(
|
|
JText::_('COM_COMPONENTBUILDER_KEEP_ORIGINAL_STATE'),
|
|
'batch[published]',
|
|
JHtml::_('select.options', JHtml::_('jgrid.publishedOptions', array('all' => false)), 'value', 'text', '', true)
|
|
);
|
|
}
|
|
}
|
|
|
|
JHtmlSidebar::addFilter(
|
|
JText::_('JOPTION_SELECT_ACCESS'),
|
|
'filter_access',
|
|
JHtml::_('select.options', JHtml::_('access.assetgroups'), 'value', 'text', $this->state->get('filter.access'))
|
|
);
|
|
|
|
if ($this->canBatch && $this->canCreate && $this->canEdit)
|
|
{
|
|
JHtmlBatch_::addListSelection(
|
|
JText::_('COM_COMPONENTBUILDER_KEEP_ORIGINAL_ACCESS'),
|
|
'batch[access]',
|
|
JHtml::_('select.options', JHtml::_('access.assetgroups'), 'value', 'text')
|
|
);
|
|
}
|
|
|
|
// Set Type Selection
|
|
$this->typeOptions = $this->getTheTypeSelections();
|
|
// We do some sanitation for Type filter
|
|
if (ComponentbuilderHelper::checkArray($this->typeOptions) &&
|
|
isset($this->typeOptions[0]->value) &&
|
|
!ComponentbuilderHelper::checkString($this->typeOptions[0]->value))
|
|
{
|
|
unset($this->typeOptions[0]);
|
|
}
|
|
// Only load Type filter if it has values
|
|
if (ComponentbuilderHelper::checkArray($this->typeOptions))
|
|
{
|
|
// Type Filter
|
|
JHtmlSidebar::addFilter(
|
|
'- Select '.JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_TYPE_LABEL').' -',
|
|
'filter_type',
|
|
JHtml::_('select.options', $this->typeOptions, 'value', 'text', $this->state->get('filter.type'))
|
|
);
|
|
|
|
if ($this->canBatch && $this->canCreate && $this->canEdit)
|
|
{
|
|
// Type Batch Selection
|
|
JHtmlBatch_::addListSelection(
|
|
'- Keep Original '.JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_TYPE_LABEL').' -',
|
|
'batch[type]',
|
|
JHtml::_('select.options', $this->typeOptions, 'value', 'text')
|
|
);
|
|
}
|
|
}
|
|
|
|
// Set Location Selection
|
|
$this->locationOptions = $this->getTheLocationSelections();
|
|
// We do some sanitation for Location filter
|
|
if (ComponentbuilderHelper::checkArray($this->locationOptions) &&
|
|
isset($this->locationOptions[0]->value) &&
|
|
!ComponentbuilderHelper::checkString($this->locationOptions[0]->value))
|
|
{
|
|
unset($this->locationOptions[0]);
|
|
}
|
|
// Only load Location filter if it has values
|
|
if (ComponentbuilderHelper::checkArray($this->locationOptions))
|
|
{
|
|
// Location Filter
|
|
JHtmlSidebar::addFilter(
|
|
'- Select '.JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_LOCATION_LABEL').' -',
|
|
'filter_location',
|
|
JHtml::_('select.options', $this->locationOptions, 'value', 'text', $this->state->get('filter.location'))
|
|
);
|
|
|
|
if ($this->canBatch && $this->canCreate && $this->canEdit)
|
|
{
|
|
// Location Batch Selection
|
|
JHtmlBatch_::addListSelection(
|
|
'- Keep Original '.JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_LOCATION_LABEL').' -',
|
|
'batch[location]',
|
|
JHtml::_('select.options', $this->locationOptions, 'value', 'text')
|
|
);
|
|
}
|
|
}
|
|
|
|
// Set Admin View Selection
|
|
$this->admin_viewOptions = JFormHelper::loadFieldType('Adminviewfolderlist')->options;
|
|
// We do some sanitation for Admin View filter
|
|
if (ComponentbuilderHelper::checkArray($this->admin_viewOptions) &&
|
|
isset($this->admin_viewOptions[0]->value) &&
|
|
!ComponentbuilderHelper::checkString($this->admin_viewOptions[0]->value))
|
|
{
|
|
unset($this->admin_viewOptions[0]);
|
|
}
|
|
// Only load Admin View filter if it has values
|
|
if (ComponentbuilderHelper::checkArray($this->admin_viewOptions))
|
|
{
|
|
// Admin View Filter
|
|
JHtmlSidebar::addFilter(
|
|
'- Select '.JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_ADMIN_VIEW_LABEL').' -',
|
|
'filter_admin_view',
|
|
JHtml::_('select.options', $this->admin_viewOptions, 'value', 'text', $this->state->get('filter.admin_view'))
|
|
);
|
|
|
|
if ($this->canBatch && $this->canCreate && $this->canEdit)
|
|
{
|
|
// Admin View Batch Selection
|
|
JHtmlBatch_::addListSelection(
|
|
'- Keep Original '.JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_ADMIN_VIEW_LABEL').' -',
|
|
'batch[admin_view]',
|
|
JHtml::_('select.options', $this->admin_viewOptions, 'value', 'text')
|
|
);
|
|
}
|
|
}
|
|
|
|
// Set Site View Selection
|
|
$this->site_viewOptions = JFormHelper::loadFieldType('Siteviewfolderlist')->options;
|
|
// We do some sanitation for Site View filter
|
|
if (ComponentbuilderHelper::checkArray($this->site_viewOptions) &&
|
|
isset($this->site_viewOptions[0]->value) &&
|
|
!ComponentbuilderHelper::checkString($this->site_viewOptions[0]->value))
|
|
{
|
|
unset($this->site_viewOptions[0]);
|
|
}
|
|
// Only load Site View filter if it has values
|
|
if (ComponentbuilderHelper::checkArray($this->site_viewOptions))
|
|
{
|
|
// Site View Filter
|
|
JHtmlSidebar::addFilter(
|
|
'- Select '.JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_SITE_VIEW_LABEL').' -',
|
|
'filter_site_view',
|
|
JHtml::_('select.options', $this->site_viewOptions, 'value', 'text', $this->state->get('filter.site_view'))
|
|
);
|
|
|
|
if ($this->canBatch && $this->canCreate && $this->canEdit)
|
|
{
|
|
// Site View Batch Selection
|
|
JHtmlBatch_::addListSelection(
|
|
'- Keep Original '.JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_SITE_VIEW_LABEL').' -',
|
|
'batch[site_view]',
|
|
JHtml::_('select.options', $this->site_viewOptions, 'value', 'text')
|
|
);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Method to set up the document properties
|
|
*
|
|
* @return void
|
|
*/
|
|
protected function setDocument()
|
|
{
|
|
if (!isset($this->document))
|
|
{
|
|
$this->document = JFactory::getDocument();
|
|
}
|
|
$this->document->setTitle(JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENTS'));
|
|
$this->document->addStyleSheet(JURI::root() . "administrator/components/com_componentbuilder/assets/css/help_documents.css", (ComponentbuilderHelper::jVersion()->isCompatible('3.8.0')) ? array('version' => 'auto') : 'text/css');
|
|
}
|
|
|
|
/**
|
|
* Escapes a value for output in a view script.
|
|
*
|
|
* @param mixed $var The output to escape.
|
|
*
|
|
* @return mixed The escaped value.
|
|
*/
|
|
public function escape($var)
|
|
{
|
|
if(strlen($var) > 50)
|
|
{
|
|
// use the helper htmlEscape method instead and shorten the string
|
|
return ComponentbuilderHelper::htmlEscape($var, $this->_charset, true);
|
|
}
|
|
// use the helper htmlEscape method instead.
|
|
return ComponentbuilderHelper::htmlEscape($var, $this->_charset);
|
|
}
|
|
|
|
/**
|
|
* Returns an array of fields the table can be sorted by
|
|
*
|
|
* @return array Array containing the field name to sort by as the key and display text as value
|
|
*/
|
|
protected function getSortFields()
|
|
{
|
|
return array(
|
|
'a.sorting' => JText::_('JGRID_HEADING_ORDERING'),
|
|
'a.published' => JText::_('JSTATUS'),
|
|
'a.title' => JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_TITLE_LABEL'),
|
|
'a.type' => JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_TYPE_LABEL'),
|
|
'a.location' => JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_LOCATION_LABEL'),
|
|
'g.' => JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_ADMIN_VIEW_LABEL'),
|
|
'h.' => JText::_('COM_COMPONENTBUILDER_HELP_DOCUMENT_SITE_VIEW_LABEL'),
|
|
'a.id' => JText::_('JGRID_HEADING_ID')
|
|
);
|
|
}
|
|
|
|
protected function getTheTypeSelections()
|
|
{
|
|
// Get a db connection.
|
|
$db = JFactory::getDbo();
|
|
|
|
// Create a new query object.
|
|
$query = $db->getQuery(true);
|
|
|
|
// Select the text.
|
|
$query->select($db->quoteName('type'));
|
|
$query->from($db->quoteName('#__componentbuilder_help_document'));
|
|
$query->order($db->quoteName('type') . ' ASC');
|
|
|
|
// Reset the query using our newly populated query object.
|
|
$db->setQuery($query);
|
|
|
|
$results = $db->loadColumn();
|
|
|
|
if ($results)
|
|
{
|
|
// get model
|
|
$model = $this->getModel();
|
|
$results = array_unique($results);
|
|
$_filter = array();
|
|
foreach ($results as $type)
|
|
{
|
|
// Translate the type selection
|
|
$text = $model->selectionTranslation($type,'type');
|
|
// Now add the type and its text to the options array
|
|
$_filter[] = JHtml::_('select.option', $type, JText::_($text));
|
|
}
|
|
return $_filter;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
protected function getTheLocationSelections()
|
|
{
|
|
// Get a db connection.
|
|
$db = JFactory::getDbo();
|
|
|
|
// Create a new query object.
|
|
$query = $db->getQuery(true);
|
|
|
|
// Select the text.
|
|
$query->select($db->quoteName('location'));
|
|
$query->from($db->quoteName('#__componentbuilder_help_document'));
|
|
$query->order($db->quoteName('location') . ' ASC');
|
|
|
|
// Reset the query using our newly populated query object.
|
|
$db->setQuery($query);
|
|
|
|
$results = $db->loadColumn();
|
|
|
|
if ($results)
|
|
{
|
|
// get model
|
|
$model = $this->getModel();
|
|
$results = array_unique($results);
|
|
$_filter = array();
|
|
foreach ($results as $location)
|
|
{
|
|
// Translate the location selection
|
|
$text = $model->selectionTranslation($location,'location');
|
|
// Now add the location and its text to the options array
|
|
$_filter[] = JHtml::_('select.option', $location, JText::_($text));
|
|
}
|
|
return $_filter;
|
|
}
|
|
return false;
|
|
}
|
|
}
|