Joomla-Sermon-Distributor-Fork/admin/models/help_documents.php

585 lines
17 KiB
PHP
Raw Normal View History

2015-11-30 21:30:54 +00:00
<?php
/*-------------------------------------------------------------------------------------------------------------| www.vdm.io |------/
____ ____ __ __ __
/\ _`\ /\ _`\ __ /\ \__ __/\ \ /\ \__
\ \,\L\_\ __ _ __ ___ ___ ___ ___ \ \ \/\ \/\_\ ____\ \ ,_\ _ __ /\_\ \ \____ __ __\ \ ,_\ ___ _ __
\/_\__ \ /'__`\/\`'__\/' __` __`\ / __`\ /' _ `\ \ \ \ \ \/\ \ /',__\\ \ \/ /\`'__\/\ \ \ '__`\/\ \/\ \\ \ \/ / __`\/\`'__\
/\ \L\ \/\ __/\ \ \/ /\ \/\ \/\ \/\ \L\ \/\ \/\ \ \ \ \_\ \ \ \/\__, `\\ \ \_\ \ \/ \ \ \ \ \L\ \ \ \_\ \\ \ \_/\ \L\ \ \ \/
\ `\____\ \____\\ \_\ \ \_\ \_\ \_\ \____/\ \_\ \_\ \ \____/\ \_\/\____/ \ \__\\ \_\ \ \_\ \_,__/\ \____/ \ \__\ \____/\ \_\
\/_____/\/____/ \/_/ \/_/\/_/\/_/\/___/ \/_/\/_/ \/___/ \/_/\/___/ \/__/ \/_/ \/_/\/___/ \/___/ \/__/\/___/ \/_/
/------------------------------------------------------------------------------------------------------------------------------------/
2015-11-30 21:30:54 +00:00
@version 2.0.x
@created 22nd October, 2015
2015-11-30 21:30:54 +00:00
@package Sermon Distributor
@subpackage help_documents.php
@author Llewellyn van der Merwe <https://www.vdm.io/>
@copyright Copyright (C) 2015. All Rights Reserved
@license GNU/GPL Version 2 or later - http://www.gnu.org/licenses/gpl-2.0.html
A sermon distributor that links to Dropbox.
/----------------------------------------------------------------------------------------------------------------------------------*/
2015-11-30 21:30:54 +00:00
// No direct access to this file
defined('_JEXEC') or die('Restricted access');
2020-05-30 21:39:43 +00:00
use Joomla\Utilities\ArrayHelper;
2015-11-30 21:30:54 +00:00
/**
* Help_documents Model
*/
class SermondistributorModelHelp_documents extends JModelList
{
public function __construct($config = array())
{
if (empty($config['filter_fields']))
{
$config['filter_fields'] = array(
'a.id','id',
'a.published','published',
'a.access','access',
2015-11-30 21:30:54 +00:00
'a.ordering','ordering',
'a.created_by','created_by',
'a.modified_by','modified_by',
'a.type','type',
'a.location','location',
'a.admin_view','admin_view',
'a.site_view','site_view',
'a.title','title'
2015-11-30 21:30:54 +00:00
);
}
parent::__construct($config);
}
2015-11-30 21:30:54 +00:00
/**
* Method to auto-populate the model state.
*
* Note. Calling getState in this method will result in recursion.
*
* @param string $ordering An optional ordering field.
* @param string $direction An optional direction (asc|desc).
*
2015-11-30 21:30:54 +00:00
* @return void
*
2015-11-30 21:30:54 +00:00
*/
protected function populateState($ordering = null, $direction = null)
{
$app = JFactory::getApplication();
// Adjust the context to support modal layouts.
if ($layout = $app->input->get('layout'))
{
$this->context .= '.' . $layout;
}
$access = $this->getUserStateFromRequest($this->context . '.filter.access', 'filter_access', 0, 'int');
$this->setState('filter.access', $access);
$published = $this->getUserStateFromRequest($this->context . '.filter.published', 'filter_published', '');
$this->setState('filter.published', $published);
$created_by = $this->getUserStateFromRequest($this->context . '.filter.created_by', 'filter_created_by', '');
$this->setState('filter.created_by', $created_by);
$created = $this->getUserStateFromRequest($this->context . '.filter.created', 'filter_created');
$this->setState('filter.created', $created);
$sorting = $this->getUserStateFromRequest($this->context . '.filter.sorting', 'filter_sorting', 0, 'int');
$this->setState('filter.sorting', $sorting);
$search = $this->getUserStateFromRequest($this->context . '.filter.search', 'filter_search');
$this->setState('filter.search', $search);
// Check if the form was submitted
$formSubmited = $app->input->post->get('form_submited');
2015-11-30 21:30:54 +00:00
$type = $this->getUserStateFromRequest($this->context . '.filter.type', 'filter_type');
if ($formSubmited)
{
$type = $app->input->post->get('type');
$this->setState('filter.type', $type);
}
2015-11-30 21:30:54 +00:00
$location = $this->getUserStateFromRequest($this->context . '.filter.location', 'filter_location');
if ($formSubmited)
{
$location = $app->input->post->get('location');
$this->setState('filter.location', $location);
}
2015-11-30 21:30:54 +00:00
$admin_view = $this->getUserStateFromRequest($this->context . '.filter.admin_view', 'filter_admin_view');
if ($formSubmited)
{
$admin_view = $app->input->post->get('admin_view');
$this->setState('filter.admin_view', $admin_view);
}
2015-11-30 21:30:54 +00:00
$site_view = $this->getUserStateFromRequest($this->context . '.filter.site_view', 'filter_site_view');
if ($formSubmited)
{
$site_view = $app->input->post->get('site_view');
$this->setState('filter.site_view', $site_view);
}
$title = $this->getUserStateFromRequest($this->context . '.filter.title', 'filter_title');
if ($formSubmited)
{
$title = $app->input->post->get('title');
$this->setState('filter.title', $title);
}
2015-11-30 21:30:54 +00:00
// List state information.
parent::populateState($ordering, $direction);
}
/**
* Method to get an array of data items.
*
* @return mixed An array of data items on success, false on failure.
*/
public function getItems()
2019-04-04 11:52:38 +00:00
{
// check in items
2015-11-30 21:30:54 +00:00
$this->checkInNow();
// load parent items
$items = parent::getItems();
2020-01-05 22:53:13 +00:00
// Set values to display correctly.
2015-11-30 21:30:54 +00:00
if (SermondistributorHelper::checkArray($items))
{
2020-01-05 22:53:13 +00:00
// Get the user object if not set.
if (!isset($user) || !SermondistributorHelper::checkObject($user))
{
$user = JFactory::getUser();
}
2015-11-30 21:30:54 +00:00
foreach ($items as $nr => &$item)
{
2020-01-05 22:53:13 +00:00
// Remove items the user can't access.
$access = ($user->authorise('help_document.access', 'com_sermondistributor.help_document.' . (int) $item->id) && $user->authorise('help_document.access', 'com_sermondistributor'));
2015-11-30 21:30:54 +00:00
if (!$access)
{
unset($items[$nr]);
continue;
}
// decode groups
2015-11-30 21:30:54 +00:00
$groupsArray = json_decode($item->groups, true);
if (SermondistributorHelper::checkArray($groupsArray))
{
2020-01-05 22:53:13 +00:00
$groupsNames = array();
2015-11-30 21:30:54 +00:00
foreach ($groupsArray as $groups)
{
2020-01-05 22:53:13 +00:00
$groupsNames[] = SermondistributorHelper::getGroupName($groups);
2015-11-30 21:30:54 +00:00
}
2020-01-05 22:53:13 +00:00
$item->groups = implode(', ', $groupsNames);
2015-11-30 21:30:54 +00:00
}
}
2019-04-04 11:52:38 +00:00
}
2015-11-30 21:30:54 +00:00
// set selection value to a translatable value
2015-11-30 21:30:54 +00:00
if (SermondistributorHelper::checkArray($items))
{
foreach ($items as $nr => &$item)
{
// convert type
2015-11-30 21:30:54 +00:00
$item->type = $this->selectionTranslation($item->type, 'type');
// convert location
2015-11-30 21:30:54 +00:00
$item->location = $this->selectionTranslation($item->location, 'location');
}
}
2019-04-04 11:52:38 +00:00
2015-11-30 21:30:54 +00:00
// return items
return $items;
}
/**
* Method to convert selection values to translatable string.
*
* @return translatable string
*/
public function selectionTranslation($value,$name)
2015-11-30 21:30:54 +00:00
{
// Array of type language strings
2017-02-17 20:21:37 +00:00
if ($name === 'type')
2015-11-30 21:30:54 +00:00
{
$typeArray = array(
0 => 'COM_SERMONDISTRIBUTOR_HELP_DOCUMENT_SELECT_AN_OPTION',
1 => 'COM_SERMONDISTRIBUTOR_HELP_DOCUMENT_JOOMLA_ARTICLE',
2 => 'COM_SERMONDISTRIBUTOR_HELP_DOCUMENT_TEXT',
3 => 'COM_SERMONDISTRIBUTOR_HELP_DOCUMENT_URL'
);
// Now check if value is found in this array
2015-11-30 21:30:54 +00:00
if (isset($typeArray[$value]) && SermondistributorHelper::checkString($typeArray[$value]))
{
return $typeArray[$value];
}
}
// Array of location language strings
2017-02-17 20:21:37 +00:00
if ($name === 'location')
2015-11-30 21:30:54 +00:00
{
$locationArray = array(
1 => 'COM_SERMONDISTRIBUTOR_HELP_DOCUMENT_ADMIN',
2 => 'COM_SERMONDISTRIBUTOR_HELP_DOCUMENT_SITE'
);
// Now check if value is found in this array
2015-11-30 21:30:54 +00:00
if (isset($locationArray[$value]) && SermondistributorHelper::checkString($locationArray[$value]))
{
return $locationArray[$value];
}
}
return $value;
}
/**
* Method to build an SQL query to load the list data.
*
* @return string An SQL query
*/
protected function getListQuery()
{
// Get the user object.
2015-11-30 21:30:54 +00:00
$user = JFactory::getUser();
// Create a new query object.
2015-11-30 21:30:54 +00:00
$db = JFactory::getDBO();
$query = $db->getQuery(true);
// Select some fields
2015-11-30 21:30:54 +00:00
$query->select('a.*');
// From the sermondistributor_item table
2015-11-30 21:30:54 +00:00
$query->from($db->quoteName('#__sermondistributor_help_document', 'a'));
// Filter by published state
2015-11-30 21:30:54 +00:00
$published = $this->getState('filter.published');
if (is_numeric($published))
{
$query->where('a.published = ' . (int) $published);
}
elseif ($published === '')
{
$query->where('(a.published = 0 OR a.published = 1)');
}
// Join over the asset groups.
2015-11-30 21:30:54 +00:00
$query->select('ag.title AS access_level');
$query->join('LEFT', '#__viewlevels AS ag ON ag.id = a.access');
// Filter by access level.
$_access = $this->getState('filter.access');
if ($_access && is_numeric($_access))
2015-11-30 21:30:54 +00:00
{
$query->where('a.access = ' . (int) $_access);
}
elseif (SermondistributorHelper::checkArray($_access))
{
// Secure the array for the query
$_access = ArrayHelper::toInteger($_access);
// Filter by the Access Array.
$query->where('a.access IN (' . implode(',', $_access) . ')');
2015-11-30 21:30:54 +00:00
}
// Implement View Level Access
2015-11-30 21:30:54 +00:00
if (!$user->authorise('core.options', 'com_sermondistributor'))
{
$groups = implode(',', $user->getAuthorisedViewLevels());
$query->where('a.access IN (' . $groups . ')');
}
// Filter by search.
2015-11-30 21:30:54 +00:00
$search = $this->getState('filter.search');
if (!empty($search))
{
if (stripos($search, 'id:') === 0)
{
$query->where('a.id = ' . (int) substr($search, 3));
}
else
{
$search = $db->quote('%' . $db->escape($search) . '%');
$query->where('(a.title LIKE '.$search.' OR a.type LIKE '.$search.' OR a.location LIKE '.$search.' OR a.admin_view LIKE '.$search.' OR g. LIKE '.$search.' OR a.site_view LIKE '.$search.' OR h. LIKE '.$search.')');
2015-11-30 21:30:54 +00:00
}
}
// Filter by Type.
$_type = $this->getState('filter.type');
if (is_numeric($_type))
2015-11-30 21:30:54 +00:00
{
if (is_float($_type))
{
$query->where('a.type = ' . (float) $_type);
}
else
{
$query->where('a.type = ' . (int) $_type);
}
}
elseif (SermondistributorHelper::checkString($_type))
{
$query->where('a.type = ' . $db->quote($db->escape($_type)));
2015-11-30 21:30:54 +00:00
}
// Filter by Location.
$_location = $this->getState('filter.location');
if (is_numeric($_location))
2015-11-30 21:30:54 +00:00
{
if (is_float($_location))
{
$query->where('a.location = ' . (float) $_location);
}
else
{
$query->where('a.location = ' . (int) $_location);
}
2015-11-30 21:30:54 +00:00
}
elseif (SermondistributorHelper::checkString($_location))
2015-11-30 21:30:54 +00:00
{
$query->where('a.location = ' . $db->quote($db->escape($_location)));
2015-11-30 21:30:54 +00:00
}
// Filter by Admin_view.
$_admin_view = $this->getState('filter.admin_view');
if (is_numeric($_admin_view))
2015-11-30 21:30:54 +00:00
{
if (is_float($_admin_view))
{
$query->where('a.admin_view = ' . (float) $_admin_view);
}
else
{
$query->where('a.admin_view = ' . (int) $_admin_view);
}
}
elseif (SermondistributorHelper::checkString($_admin_view))
{
$query->where('a.admin_view = ' . $db->quote($db->escape($_admin_view)));
}
// Filter by Site_view.
$_site_view = $this->getState('filter.site_view');
if (is_numeric($_site_view))
{
if (is_float($_site_view))
{
$query->where('a.site_view = ' . (float) $_site_view);
}
else
{
$query->where('a.site_view = ' . (int) $_site_view);
}
}
elseif (SermondistributorHelper::checkString($_site_view))
{
$query->where('a.site_view = ' . $db->quote($db->escape($_site_view)));
2015-11-30 21:30:54 +00:00
}
// Add the list ordering clause.
2015-11-30 21:30:54 +00:00
$orderCol = $this->state->get('list.ordering', 'a.id');
$orderDirn = $this->state->get('list.direction', 'desc');
2015-11-30 21:30:54 +00:00
if ($orderCol != '')
{
$query->order($db->escape($orderCol . ' ' . $orderDirn));
}
return $query;
}
/**
* Method to get list export data.
*
2020-01-05 22:53:13 +00:00
* @param array $pks The ids of the items to get
* @param JUser $user The user making the request
*
* @return mixed An array of data items on success, false on failure.
*/
2020-01-05 22:53:13 +00:00
public function getExportData($pks, $user = null)
2015-11-30 21:30:54 +00:00
{
// setup the query
if (($pks_size = SermondistributorHelper::checkArray($pks)) !== false || 'bulk' === $pks)
2015-11-30 21:30:54 +00:00
{
2020-01-05 22:53:13 +00:00
// Set a value to know this is export method. (USE IN CUSTOM CODE TO ALTER OUTCOME)
$_export = true;
2020-01-05 22:53:13 +00:00
// Get the user object if not set.
if (!isset($user) || !SermondistributorHelper::checkObject($user))
{
$user = JFactory::getUser();
}
// Create a new query object.
2015-11-30 21:30:54 +00:00
$db = JFactory::getDBO();
$query = $db->getQuery(true);
// Select some fields
2015-11-30 21:30:54 +00:00
$query->select('a.*');
// From the sermondistributor_help_document table
2015-11-30 21:30:54 +00:00
$query->from($db->quoteName('#__sermondistributor_help_document', 'a'));
// The bulk export path
if ('bulk' === $pks)
{
$query->where('a.id > 0');
}
// A large array of ID's will not work out well
elseif ($pks_size > 500)
{
// Use lowest ID
$query->where('a.id >= ' . (int) min($pks));
// Use highest ID
$query->where('a.id <= ' . (int) max($pks));
}
// The normal default path
else
{
$query->where('a.id IN (' . implode(',',$pks) . ')');
}
// Implement View Level Access
2015-11-30 21:30:54 +00:00
if (!$user->authorise('core.options', 'com_sermondistributor'))
{
$groups = implode(',', $user->getAuthorisedViewLevels());
$query->where('a.access IN (' . $groups . ')');
}
// Order the results by ordering
2015-11-30 21:30:54 +00:00
$query->order('a.ordering ASC');
// Load the items
2015-11-30 21:30:54 +00:00
$db->setQuery($query);
$db->execute();
if ($db->getNumRows())
{
$items = $db->loadObjectList();
2020-01-05 22:53:13 +00:00
// Set values to display correctly.
2015-11-30 21:30:54 +00:00
if (SermondistributorHelper::checkArray($items))
{
foreach ($items as $nr => &$item)
{
2020-01-05 22:53:13 +00:00
// Remove items the user can't access.
$access = ($user->authorise('help_document.access', 'com_sermondistributor.help_document.' . (int) $item->id) && $user->authorise('help_document.access', 'com_sermondistributor'));
2015-11-30 21:30:54 +00:00
if (!$access)
{
unset($items[$nr]);
continue;
}
// unset the values we don't want exported.
2015-11-30 21:30:54 +00:00
unset($item->asset_id);
unset($item->checked_out);
unset($item->checked_out_time);
}
}
// Add headers to items array.
2015-11-30 21:30:54 +00:00
$headers = $this->getExImPortHeaders();
if (SermondistributorHelper::checkObject($headers))
{
array_unshift($items,$headers);
}
return $items;
}
}
return false;
}
/**
* Method to get header.
*
* @return mixed An array of data items on success, false on failure.
*/
public function getExImPortHeaders()
{
// Get a db connection.
2015-11-30 21:30:54 +00:00
$db = JFactory::getDbo();
// get the columns
2015-11-30 21:30:54 +00:00
$columns = $db->getTableColumns("#__sermondistributor_help_document");
if (SermondistributorHelper::checkArray($columns))
{
// remove the headers you don't import/export.
2015-11-30 21:30:54 +00:00
unset($columns['asset_id']);
unset($columns['checked_out']);
unset($columns['checked_out_time']);
$headers = new stdClass();
foreach ($columns as $column => $type)
{
$headers->{$column} = $column;
}
return $headers;
}
return false;
2019-04-04 11:52:38 +00:00
}
2015-11-30 21:30:54 +00:00
/**
* Method to get a store id based on model configuration state.
*
* @return string A store id.
*
*/
protected function getStoreId($id = '')
{
// Compile the store id.
2015-11-30 21:30:54 +00:00
$id .= ':' . $this->getState('filter.id');
$id .= ':' . $this->getState('filter.search');
$id .= ':' . $this->getState('filter.published');
$id .= ':' . $this->getState('filter.access');
2015-11-30 21:30:54 +00:00
$id .= ':' . $this->getState('filter.ordering');
$id .= ':' . $this->getState('filter.created_by');
$id .= ':' . $this->getState('filter.modified_by');
$id .= ':' . $this->getState('filter.type');
$id .= ':' . $this->getState('filter.location');
$id .= ':' . $this->getState('filter.admin_view');
$id .= ':' . $this->getState('filter.site_view');
$id .= ':' . $this->getState('filter.title');
2015-11-30 21:30:54 +00:00
return parent::getStoreId($id);
}
/**
* Build an SQL query to checkin all items left checked out longer then a set time.
*
* @return a bool
*
*/
protected function checkInNow()
2015-11-30 21:30:54 +00:00
{
// Get set check in time
2015-11-30 21:30:54 +00:00
$time = JComponentHelper::getParams('com_sermondistributor')->get('check_in');
2015-11-30 21:30:54 +00:00
if ($time)
{
// Get a db connection.
2015-11-30 21:30:54 +00:00
$db = JFactory::getDbo();
// reset query
2015-11-30 21:30:54 +00:00
$query = $db->getQuery(true);
$query->select('*');
$query->from($db->quoteName('#__sermondistributor_help_document'));
$db->setQuery($query);
$db->execute();
if ($db->getNumRows())
{
// Get Yesterdays date
2015-11-30 21:30:54 +00:00
$date = JFactory::getDate()->modify($time)->toSql();
// reset query
2015-11-30 21:30:54 +00:00
$query = $db->getQuery(true);
// Fields to update.
2015-11-30 21:30:54 +00:00
$fields = array(
$db->quoteName('checked_out_time') . '=\'0000-00-00 00:00:00\'',
$db->quoteName('checked_out') . '=0'
);
// Conditions for which records should be updated.
2015-11-30 21:30:54 +00:00
$conditions = array(
$db->quoteName('checked_out') . '!=0',
$db->quoteName('checked_out_time') . '<\''.$date.'\''
);
// Check table
2015-11-30 21:30:54 +00:00
$query->update($db->quoteName('#__sermondistributor_help_document'))->set($fields)->where($conditions);
$db->setQuery($query);
$db->execute();
}
}
return false;
}
}