wiki.techinc.nl/includes/logging/LogEntry.php
Gergő Tisza 0e3822a2f4 logging: Improve documentation of log parameter handling
Change-Id: Ib23a1afe2bc0b90fcf9291935b6ed019669494e8
2023-07-12 06:11:53 +00:00

107 lines
2.4 KiB
PHP

<?php
/**
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
use MediaWiki\Title\Title;
use MediaWiki\User\UserIdentity;
/**
* An individual log entry.
*
* This is the basis for methods that all log entries support.
*
* Must not be implemented directly by extensions, extend LogEntryBase instead.
*
* @stable to type
* @since 1.19
* @author Niklas Laxström
*/
interface LogEntry {
/**
* The main log type.
*
* @return string
*/
public function getType();
/**
* The log subtype.
*
* @return string
*/
public function getSubtype();
/**
* The full logtype in format maintype/subtype.
*
* @return string
*/
public function getFullType();
/**
* Get the extra parameters stored for this message.
* This will be in the same format as setParameters(), ie. the array keys
* might include message formatting prefixes.
*
* @return array
* @see ManualLogEntry::setParameters() for message formatting prefixes.
*/
public function getParameters();
/**
* @since 1.36
* @return UserIdentity
*/
public function getPerformerIdentity(): UserIdentity;
/**
* Get the target page of this action.
*
* @return Title
*/
public function getTarget();
/**
* Get the timestamp when the action was executed.
*
* @return string TS_MW timestamp, a string with 14 digits
*/
public function getTimestamp();
/**
* Get the user provided comment.
*
* @return string
*/
public function getComment();
/**
* Get the access restriction.
*
* @return int
*/
public function getDeleted();
/**
* @param int $field One of LogPage::DELETED_* bitfield constants
* @return bool
*/
public function isDeleted( $field );
}