404 lines
12 KiB
PHP
404 lines
12 KiB
PHP
<?php
|
|
/*-------------------------------------------------------------------------------------------------------------| www.vdm.io |------/
|
|
____ ____ __ __ __
|
|
/\ _`\ /\ _`\ __ /\ \__ __/\ \ /\ \__
|
|
\ \,\L\_\ __ _ __ ___ ___ ___ ___ \ \ \/\ \/\_\ ____\ \ ,_\ _ __ /\_\ \ \____ __ __\ \ ,_\ ___ _ __
|
|
\/_\__ \ /'__`\/\`'__\/' __` __`\ / __`\ /' _ `\ \ \ \ \ \/\ \ /',__\\ \ \/ /\`'__\/\ \ \ '__`\/\ \/\ \\ \ \/ / __`\/\`'__\
|
|
/\ \L\ \/\ __/\ \ \/ /\ \/\ \/\ \/\ \L\ \/\ \/\ \ \ \ \_\ \ \ \/\__, `\\ \ \_\ \ \/ \ \ \ \ \L\ \ \ \_\ \\ \ \_/\ \L\ \ \ \/
|
|
\ `\____\ \____\\ \_\ \ \_\ \_\ \_\ \____/\ \_\ \_\ \ \____/\ \_\/\____/ \ \__\\ \_\ \ \_\ \_,__/\ \____/ \ \__\ \____/\ \_\
|
|
\/_____/\/____/ \/_/ \/_/\/_/\/_/\/___/ \/_/\/_/ \/___/ \/_/\/___/ \/__/ \/_/ \/_/\/___/ \/___/ \/__/\/___/ \/_/
|
|
|
|
/------------------------------------------------------------------------------------------------------------------------------------/
|
|
|
|
@version 4.0.x
|
|
@created 22nd October, 2015
|
|
@package Sermon Distributor
|
|
@subpackage Help_documentTable.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.
|
|
|
|
/----------------------------------------------------------------------------------------------------------------------------------*/
|
|
namespace TrueChristianChurch\Component\Sermondistributor\Administrator\Table;
|
|
|
|
use Joomla\CMS\Factory;
|
|
use Joomla\CMS\Table\Table;
|
|
use Joomla\CMS\Language\Text;
|
|
use Joomla\CMS\String\PunycodeHelper;
|
|
use Joomla\CMS\Access\Access as AccessRules;
|
|
use Joomla\CMS\Access\Rules;
|
|
use Joomla\CMS\Tag\TaggableTableInterface;
|
|
use Joomla\CMS\Tag\TaggableTableTrait;
|
|
use Joomla\CMS\User\CurrentUserInterface;
|
|
use Joomla\CMS\User\CurrentUserTrait;
|
|
use Joomla\CMS\Versioning\VersionableTableInterface;
|
|
use Joomla\CMS\Application\ApplicationHelper;
|
|
use Joomla\Database\DatabaseInterface;
|
|
use Joomla\Registry\Registry;
|
|
use Joomla\Database\DatabaseDriver;
|
|
use Joomla\Event\DispatcherInterface;
|
|
use Joomla\String\StringHelper;
|
|
use Joomla\Utilities\ArrayHelper;
|
|
use TrueChristianChurch\Component\Sermondistributor\Administrator\Helper\SermondistributorHelper;
|
|
|
|
// No direct access to this file
|
|
\defined('_JEXEC') or die;
|
|
|
|
/**
|
|
* Help_documents Table class
|
|
*
|
|
* @since 1.6
|
|
*/
|
|
class Help_documentTable extends Table implements VersionableTableInterface, TaggableTableInterface, CurrentUserInterface
|
|
{
|
|
use TaggableTableTrait;
|
|
use CurrentUserTrait;
|
|
|
|
/**
|
|
* Constructor
|
|
*
|
|
* @param DatabaseDriver $db Database connector object
|
|
* @param ?DispatcherInterface $dispatcher Event dispatcher for this table
|
|
*
|
|
* @param object Database connector object
|
|
* @since 4.0
|
|
*/
|
|
function __construct(DatabaseDriver $db, ?DispatcherInterface $dispatcher = null)
|
|
{
|
|
// The type alias generally is the internal component name with the
|
|
// content type. Ex.: com_content.article
|
|
$this->typeAlias = 'com_sermondistributor.help_document';
|
|
|
|
// Ensure the params and metadata in json encoded in the bind method
|
|
$this->_jsonEncode = ['params', 'metadata'];
|
|
|
|
// Indicates that columns fully support the NULL value in the database
|
|
// $this->_supportNullValue = true; // hmmm will keep an eye on this ;)
|
|
|
|
parent::__construct('#__sermondistributor_help_document', 'id', $db, $dispatcher);
|
|
}
|
|
|
|
/**
|
|
* Method to bind an associative array or object to the Table instance.This
|
|
* method only binds properties that are publicly accessible and optionally
|
|
* takes an array of properties to ignore when binding.
|
|
*
|
|
* @param array|object $src An associative array or object to bind to the Table instance.
|
|
* @param array|string $ignore An optional array or space separated list of properties to ignore while binding.
|
|
*
|
|
* @return boolean True on success.
|
|
*
|
|
* @since 1.7.0
|
|
* @throws \InvalidArgumentException
|
|
*/
|
|
public function bind($array, $ignore = '')
|
|
{
|
|
// Bind the rules.
|
|
if (isset($array['rules']) && is_array($array['rules']))
|
|
{
|
|
$rules = new AccessRules($array['rules']);
|
|
$this->setRules($rules);
|
|
}
|
|
|
|
return parent::bind($array, $ignore);
|
|
}
|
|
|
|
/**
|
|
* Overload the store method for the Help_document table.
|
|
*
|
|
* @param boolean Toggle whether null values should be updated.
|
|
*
|
|
* @return boolean True on success, false on failure.
|
|
* @since 1.6
|
|
*/
|
|
public function store($updateNulls = false)
|
|
{
|
|
$date = Factory::getDate()->toSql();
|
|
$userId = $this->getCurrentUser()->id;
|
|
|
|
if ($this->id)
|
|
{
|
|
// Existing item
|
|
$this->modified = $date;
|
|
$this->modified_by = $userId;
|
|
}
|
|
else
|
|
{
|
|
// New help_document. A help_document created and created_by field can be set by the user,
|
|
// so we don't touch either of these if they are set.
|
|
if (!(int) $this->created)
|
|
{
|
|
$this->created = $date;
|
|
}
|
|
if (empty($this->created_by))
|
|
{
|
|
$this->created_by = $userId;
|
|
}
|
|
}
|
|
|
|
if (isset($this->alias))
|
|
{
|
|
// Verify that the alias is unique
|
|
$table = new self($this->getDbo(), $this->getDispatcher());
|
|
|
|
if ($table->load(['alias' => $this->alias]) && ($table->id != $this->id || $this->id == 0))
|
|
{
|
|
$this->setError(Text::_('COM_SERMONDISTRIBUTOR_HELP_DOCUMENT_ERROR_UNIQUE_ALIAS'));
|
|
|
|
if ($table->published === -2)
|
|
{
|
|
$this->setError(Text::_('COM_SERMONDISTRIBUTOR_HELP_DOCUMENT_ERROR_UNIQUE_ALIAS_TRASHED'));
|
|
}
|
|
|
|
return false;
|
|
}
|
|
}
|
|
|
|
if (isset($this->url))
|
|
{
|
|
// Convert IDN urls to punycode
|
|
$this->url = PunycodeHelper::urlToPunycode($this->url);
|
|
}
|
|
|
|
if (isset($this->website))
|
|
{
|
|
// Convert IDN urls to punycode
|
|
$this->website = PunycodeHelper::urlToPunycode($this->website);
|
|
}
|
|
|
|
return parent::store($updateNulls);
|
|
}
|
|
|
|
/**
|
|
* Overloaded check method to ensure data integrity.
|
|
*
|
|
* @return boolean True on success.
|
|
*
|
|
* @see \Joomla\CMS\Table\Table::check
|
|
* @since 1.5
|
|
*/
|
|
public function check()
|
|
{
|
|
try {
|
|
parent::check();
|
|
} catch (\Exception $e) {
|
|
$this->setError($e->getMessage());
|
|
return false;
|
|
}
|
|
|
|
if (isset($this->alias))
|
|
{
|
|
// Generate a valid alias
|
|
$this->generateAlias();
|
|
|
|
$table = new self($this->getDbo(), $this->getDispatcher());
|
|
|
|
while ($table->load(['alias' => $this->alias]) && ($table->id != $this->id || $this->id == 0))
|
|
{
|
|
$this->alias = StringHelper::increment($this->alias, 'dash');
|
|
}
|
|
}
|
|
|
|
/*
|
|
* Clean up keywords -- eliminate extra spaces between phrases
|
|
* and cr (\r) and lf (\n) characters from string.
|
|
* Only process if not empty.
|
|
*/
|
|
if (!empty($this->metakey))
|
|
{
|
|
// Array of characters to remove.
|
|
$bad_characters = array("\n", "\r", "\"", "<", ">");
|
|
|
|
// Remove bad characters.
|
|
$after_clean = StringHelper::str_ireplace($bad_characters, "", $this->metakey);
|
|
|
|
// Create array using commas as delimiter.
|
|
$keys = explode(',', $after_clean);
|
|
$clean_keys = [];
|
|
|
|
foreach ($keys as $key)
|
|
{
|
|
// Ignore blank keywords.
|
|
if (trim($key))
|
|
{
|
|
$clean_keys[] = trim($key);
|
|
}
|
|
}
|
|
|
|
// Put array back together delimited by ", "
|
|
$this->metakey = implode(", ", $clean_keys);
|
|
}
|
|
|
|
// Clean up description -- eliminate quotes and <> brackets
|
|
if (!empty($this->metadesc))
|
|
{
|
|
// Only process if not empty
|
|
$bad_characters = array("\"", "<", ">");
|
|
$this->metadesc = StringHelper::str_ireplace($bad_characters, "", $this->metadesc);
|
|
}
|
|
|
|
// If we don't have any access rules set at this point just use an empty AccessRules class
|
|
if (!$this->getRules())
|
|
{
|
|
$rules = $this->getDefaultAssetValues('com_sermondistributor.help_document.'.$this->id);
|
|
$this->setRules($rules);
|
|
}
|
|
|
|
// Set ordering
|
|
if ($this->published < 0)
|
|
{
|
|
// Set ordering to 0 if state is archived or trashed
|
|
$this->ordering = 0;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Gets the default asset values for a component.
|
|
*
|
|
* @param $string $component The component asset name to search for
|
|
*
|
|
* @return AccessRules The AccessRules object for the asset
|
|
*/
|
|
protected function getDefaultAssetValues($component, $try = true)
|
|
{
|
|
// Need to find the asset id by the name of the component.
|
|
$db = Factory::getContainer()->get(DatabaseInterface::class);
|
|
$query = $db->getQuery(true)
|
|
->select($db->quoteName('id'))
|
|
->from($db->quoteName('#__assets'))
|
|
->where($db->quoteName('name') . ' = ' . $db->quote($component));
|
|
$db->setQuery($query);
|
|
$db->execute();
|
|
if ($db->loadRowList())
|
|
{
|
|
// asset already set so use saved rules
|
|
$assetId = (int) $db->loadResult();
|
|
return AccessRules::getAssetRules($assetId); // (TODO) instead of keeping inherited Allowed it becomes Allowed.
|
|
}
|
|
// try again
|
|
elseif ($try)
|
|
{
|
|
$try = explode('.',$component);
|
|
$result = $this->getDefaultAssetValues($try[0], false);
|
|
if ($result instanceof AccessRules)
|
|
{
|
|
if (isset($try[1]))
|
|
{
|
|
$_result = (string) $result;
|
|
$_result = json_decode($_result);
|
|
foreach ($_result as $name => &$rule)
|
|
{
|
|
$v = explode('.', $name);
|
|
if ($try[1] !== $v[0])
|
|
{
|
|
// remove since it is not part of this view
|
|
unset($_result->$name);
|
|
}
|
|
else
|
|
{
|
|
// clear the value since we inherit
|
|
$rule = [];
|
|
}
|
|
}
|
|
// check if there are any view values remaining
|
|
if (count( (array) $_result))
|
|
{
|
|
$_result = json_encode($_result);
|
|
$_result = array($_result);
|
|
// Instantiate and return the AccessRules object for the asset rules.
|
|
$rules = new AccessRules;
|
|
$rules->mergeCollection($_result);
|
|
|
|
return $rules;
|
|
}
|
|
}
|
|
return $result;
|
|
}
|
|
}
|
|
return AccessRules::getAssetRules(0);
|
|
}
|
|
|
|
/**
|
|
* Get the type alias for the history table
|
|
*
|
|
* The type alias generally is the internal component name with the
|
|
* content type. Ex.: com_content.article
|
|
*
|
|
* @return string The alias as described above
|
|
*
|
|
* @since 3.10.0
|
|
*/
|
|
public function getTypeAlias()
|
|
{
|
|
return $this->typeAlias;
|
|
}
|
|
|
|
/**
|
|
* Method to compute the default name of the asset.
|
|
* The default name is in the form table_name.id
|
|
* where id is the value of the primary key of the table.
|
|
*
|
|
* @return string
|
|
*
|
|
* @since 1.7.0
|
|
*/
|
|
protected function _getAssetName()
|
|
{
|
|
$k = $this->_tbl_key;
|
|
|
|
return $this->getTypeAlias() . '.' . (int) $this->$k;
|
|
}
|
|
|
|
/**
|
|
* Method to get the parent asset under which to register this one.
|
|
*
|
|
* By default, all assets are registered to the ROOT node with ID, which will default to 1 if none exists.
|
|
* An extended class can define a table and ID to lookup. If the asset does not exist it will be created.
|
|
*
|
|
* @param Table $table A Table object for the asset parent.
|
|
* @param integer $id Id to look up
|
|
*
|
|
* @return integer
|
|
*
|
|
* @since 1.7.0
|
|
*/
|
|
protected function _getAssetParentId(Table $table = null, $id = null)
|
|
{
|
|
/** @var Asset $assets */
|
|
$assets = self::getInstance('Asset', 'JTable', ['dbo' => $this->getDbo()]);
|
|
$rootId = $assets->getRootId();
|
|
|
|
// load the sermondistributor asset
|
|
$assets->loadByName('com_sermondistributor');
|
|
|
|
return $assets->id ?? $rootId ?? 1;
|
|
}
|
|
|
|
/**
|
|
* Generate a valid alias from title / date.
|
|
* Remains public to be able to check for duplicated alias before saving
|
|
*
|
|
* @return string
|
|
*/
|
|
public function generateAlias()
|
|
{
|
|
if (empty($this->alias))
|
|
{
|
|
$this->alias = $this->title;
|
|
}
|
|
|
|
$this->alias = ApplicationHelper::stringURLSafe($this->alias);
|
|
|
|
if (trim(str_replace('-', '', $this->alias)) == '')
|
|
{
|
|
$this->alias = Factory::getDate()->format('Y-m-d-H-i-s');
|
|
}
|
|
|
|
return $this->alias;
|
|
}
|
|
}
|