1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
<?php
/**
* API module for TTMServer
*
* @file
* @author Niklas Laxström
* @copyright Copyright © 2012-2013, Niklas Laxström
* @license GPL-2.0+
*/
/**
* API module for TTMServer
*
* @ingroup API TranslateAPI TTMServer
* @since 2012-01-26
*/
class ApiTTMServer extends ApiBase {
public function execute() {
global $wgTranslateTranslationServices;
$params = $this->extractRequestParams();
$config = $wgTranslateTranslationServices[$params['service']];
$server = TTMServer::factory( $config );
$suggestions = $server->query(
$params['sourcelanguage'],
$params['targetlanguage'],
$params['text']
);
$result = $this->getResult();
foreach ( $suggestions as $sug ) {
$sug['location'] = $server->expandLocation( $sug );
unset( $sug['wiki'] );
$result->addValue( $this->getModuleName(), null, $sug );
}
$result->setIndexedTagName_internal( $this->getModuleName(), 'suggestion' );
}
protected function getAvailableTranslationServices() {
global $wgTranslateTranslationServices;
$good = array();
foreach ( $wgTranslateTranslationServices as $id => $config ) {
if ( isset( $config['public'] ) && $config['public'] === true ) {
$good[] = $id;
}
}
return $good;
}
public function getAllowedParams() {
$available = $this->getAvailableTranslationServices();
return array(
'service' => array(
ApiBase::PARAM_TYPE => $available,
ApiBase::PARAM_DFLT => 'TTMServer',
),
'sourcelanguage' => array(
ApiBase::PARAM_TYPE => 'string',
ApiBase::PARAM_REQUIRED => true,
),
'targetlanguage' => array(
ApiBase::PARAM_TYPE => 'string',
ApiBase::PARAM_REQUIRED => true,
),
'text' => array(
ApiBase::PARAM_TYPE => 'string',
ApiBase::PARAM_REQUIRED => true,
),
);
}
/**
* @deprecated since MediaWiki core 1.25
*/
public function getParamDescription() {
return array(
'service' => 'Which of the available translation services to use.',
'sourcelanguage' => 'A language code of the source text',
'targetlanguage' => 'A language code of the suggestion',
'text' => 'The text to find suggestions for',
);
}
/**
* @deprecated since MediaWiki core 1.25
*/
public function getDescription() {
return 'Query suggestions from translation memories';
}
/**
* @deprecated since MediaWiki core 1.25
*/
public function getExamples() {
return array(
'api.php?action=ttmserver&sourcelanguage=en&targetlanguage=fi&text=Help',
);
}
/**
* @see ApiBase::getExamplesMessages()
*/
protected function getExamplesMessages() {
return array(
'action=ttmserver&sourcelanguage=en&targetlanguage=fi&text=Help'
=> 'apihelp-ttmserver-example-1',
);
}
}
|