- md5
- bada4d1b1661757def8d65bcaa1dbf8d
- sha1
- ff0985b63b633471550a70a548f096d2561a9e7b
- sha256
- 6144fe42b93786af9a101c4ed1da87143384d6afb8c200e201d4a1ec571cd3f1
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
<?php
/**
* Joomla! Content Management System
*
* @copyright Copyright (C) 2005 - 2020 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\Versioning;
defined('JPATH_PLATFORM') or die;
use Joomla\CMS\Component\ComponentHelper;
use Joomla\Database\ParameterType;
use Joomla\CMS\Factory;
use Joomla\CMS\Table\Table;
/**
* Handle the versioning of content items
*
* @since 4.0.0
*/
class Versioning
{
/**
* Method to get a list of available versions of this item.
*
* @param string $typeAlias Typealias of the component
* @param integer $id ID of the content item to get
*
* @return object[] A list of history items
*
* @since 4.0.0
*/
public static function get($typeAlias, $id)
{
$db = Factory::getDbo();
$itemid = $typeAlias . '.' . $id;
$query = $db->getQuery(true);
$query->select($db->quoteName('h.version_note') . ',' . $db->quoteName('h.save_date') . ',' . $db->quoteName('u.name'))
->from($db->quoteName('#__history', 'h'))
->leftJoin($db->quoteName('#__users', 'u'), $db->quoteName('u.id') . ' = ' . $db->quoteName('h.editor_user_id'))
->where($db->quoteName('item_id') . ' = :item_id')
->bind(':item_id', $itemid, ParameterType::STRING)
->order($db->quoteName('save_date') . ' DESC ');
$db->setQuery($query);
return $db->loadObjectList();
}
/**
* Method to delete the history for an item.
*
* @param string $typeAlias Typealias of the component
* @param integer $id ID of the content item to delete
*
* @return boolean true on success, otherwise false.
*
* @since 4.0.0
*/
public static function delete($typeAlias, $id)
{
$db = Factory::getDbo();
$itemid = $typeAlias . '.' . $id;
$query = $db->getQuery(true);
$query->delete($db->quoteName('#__history'))
->where($db->quoteName('item_id') . ' = :item_id')
->bind(':item_id', $itemid, ParameterType::STRING);
$db->setQuery($query);
return $db->execute();
}
/**
* Method to save a version snapshot to the content history table.
*
* @param string $typeAlias Typealias of the content type
* @param integer $id ID of the content item
* @param mixed $data Array or object of data that can be
* en- and decoded into JSON
* @param string $note Note for the version to store
*
* @return boolean True on success, otherwise false.
*
* @since 4.0.0
*/
public static function store($typeAlias, $id, $data, $note = '')
{
$typeTable = Table::getInstance('Contenttype', 'JTable');
$typeTable->load(array('type_alias' => $typeAlias));
$historyTable = Table::getInstance('Contenthistory', 'JTable');
$historyTable->item_id = $typeAlias . '.' . $id;
// Don't store unless we have a non-zero item id
if (!$historyTable->item_id)
{
return true;
}
$historyTable->version_data = json_encode($data);
$historyTable->version_note = $note;
// Don't save if hash already exists and same version note
$historyTable->sha1_hash = $historyTable->getSha1($data, $typeTable);
if ($historyRow = $historyTable->getHashMatch())
{
if (!$note || ($historyRow->version_note === $note))
{
return true;
}
else
{
// Update existing row to set version note
$historyTable->version_id = $historyRow->version_id;
}
}
$result = $historyTable->store();
// Load history_limit config from extension.
$aliasParts = explode('.', $typeAlias);
$context = $aliasParts[1] ?? '';
$maxVersionsContext = ComponentHelper::getParams($aliasParts[0])->get('history_limit_' . $context, 0);
if ($maxVersionsContext)
{
$historyTable->deleteOldVersions($maxVersionsContext);
}
elseif ($maxVersions = ComponentHelper::getParams($aliasParts[0])->get('history_limit', 0))
{
$historyTable->deleteOldVersions($maxVersions);
}
return $result;
}
}
No other release has this exact content. See every version of this file.