wiki.techinc.nl/includes/api/ApiQueryAllmessages.php
Victor Vasiliev 4b9f91999e * Introduced list=allimages
* (bug 13371) Build page set from image hashes
* Mark non-existent messages in meta=allmessages as missing
2008-03-17 08:25:22 +00:00

133 lines
3.7 KiB
PHP

<?php
/*
* Created on Dec 1, 2007
*
* API for MediaWiki 1.8+
*
* Copyright (C) 2006 Yuri Astrakhan <Firstname><Lastname>@gmail.com
*
* 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.,
* 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
* http://www.gnu.org/copyleft/gpl.html
*/
if (!defined('MEDIAWIKI')) {
// Eclipse helper - will be ignored in production
require_once ('ApiQueryBase.php');
}
/**
* A query action to return messages from site message cache
*
* @addtogroup API
*/
class ApiQueryAllmessages extends ApiQueryBase {
public function __construct($query, $moduleName) {
parent :: __construct($query, $moduleName, 'am');
}
public function execute() {
global $wgMessageCache;
$params = $this->extractRequestParams();
if(!is_null($params['lang']))
{
global $wgLang;
$wgLang = Language::factory($params['lang']);
}
//Determine which messages should we print
$messages_target = array();
if( $params['messages'] == '*' ) {
$wgMessageCache->loadAllMessages();
$message_names = array_keys( array_merge( Language::getMessagesFor( 'en' ), $wgMessageCache->getExtensionMessagesFor( 'en' ) ) );
sort( $message_names );
$messages_target = $message_names;
} else {
$messages_target = explode( '|', $params['messages'] );
}
//Filter messages
if( isset( $params['filter'] ) ) {
$messages_filtered = array();
foreach( $messages_target as $message ) {
if( strpos( $message, $params['filter'] ) !== false ) { //!== is used because filter can be at the beginnig of the string
$messages_filtered[] = $message;
}
}
$messages_target = $messages_filtered;
}
$wgMessageCache->disableTransform();
//Get all requested messages
$messages = array();
foreach( $messages_target as $message ) {
$message = trim( $message ); //Message list can be formatted like "msg1 | msg2 | msg3", so let's trim() it
$messages[$message] = wfMsg( $message );
}
//Print the result
$result = $this->getResult();
$messages_out = array();
foreach( $messages as $name => $value ) {
$message = array();
$message['name'] = $name;
if( wfEmptyMsg( $name, $value ) ) {
$message['missing'] = '';
} else {
$result->setContent( $message, $value );
}
$messages_out[] = $message;
}
$result->setIndexedTagName( $messages_out, 'message' );
$result->addValue( 'query', $this->getModuleName(), $messages_out );
}
public function getAllowedParams() {
return array (
'messages' => array (
ApiBase :: PARAM_DFLT => '*',
),
'filter' => array(),
'lang' => null,
);
}
public function getParamDescription() {
return array (
'messages' => 'Which messages to output. "*" means all messages',
'filter' => 'Return only messages that contains specified string',
'lang' => 'Language code',
);
}
public function getDescription() {
return 'Return messages from this site.';
}
protected function getExamples() {
return array(
'api.php?action=query&meta=allmessages&amfilter=ipb-',
'api.php?action=query&meta=allmessages&ammessages=august|mainpage&amlang=de',
);
}
public function getVersion() {
return __CLASS__ . ': $Id$';
}
}