24 private const RIGHT =
'translate-manage';
26 public function __construct( ApiQuery $query,
string $moduleName ) {
27 parent::__construct( $query, $moduleName,
'mmg' );
30 public function execute() {
31 $params = $this->extractRequestParams();
32 $groupId = $params[
'groupId'];
33 $msgKey = $params[
'messageKey'];
34 $name = $params[
'changesetName'] ?? MessageChangeStorage::DEFAULT_NAME;
36 $user = $this->getUser();
37 $allowed = $user->isAllowed( self::RIGHT );
40 $this->dieWithError(
'apierror-permissiondenied-generic',
'permissiondenied' );
43 $group = MessageGroups::getGroup( $groupId );
45 $this->dieWithError(
'apierror-translate-invalidgroup',
'invalidgroup' );
48 if ( !MessageChangeStorage::isValidCdbName( $name ) ) {
50 [
'apierror-translate-invalid-changeset-name', wfEscapeWikiText( $name ) ],
54 $cdbPath = MessageChangeStorage::getCdbPath( $name );
56 $sourceChanges = MessageChangeStorage::getGroupChanges( $cdbPath, $groupId );
58 if ( $sourceChanges->getAllModifications() === [] ) {
59 $this->dieWithError( [
'apierror-translate-smg-nochanges' ] );
63 $sourceChanges, $group->getNamespace(), $msgKey, $group->getSourceLanguage()
66 $result = $this->getResult();
67 $result->addValue( [
'query', $this->getModuleName() ],
null, $messages );
77 $deletions = $sourceChanges->getDeletions( $languageCode );
79 $languageCode, $msgKey, [ MessageSourceChange::ADDITION, MessageSourceChange::RENAME ]
85 foreach ( $deletions as $deletion ) {
86 if ( $deletion[
'content'] ===
null ) {
90 $similarity = $stringComparator->getSimilarity(
96 $title = Title::makeTitle(
98 TranslateUtils::title( $deletion[
'key'], $languageCode, $groupNamespace )
102 'key' => $deletion[
'key'],
103 'content' => $deletion[
'content'],
104 'similarity' => $similarity,
105 'link' => $title->getFullURL(),
106 'title' => $title->getPrefixedText()
111 usort( $renameList,
static function ( $a, $b ) {
112 return -( $a[
'similarity'] <=> $b[
'similarity'] );
118 protected function getAllowedParams(): array {
119 $params = parent::getAllowedParams();
120 $params[
'groupId'] = [
121 ParamValidator::PARAM_TYPE =>
'string',
122 ParamValidator::PARAM_REQUIRED =>
true,
125 $params[
'messageKey'] = [
126 ParamValidator::PARAM_TYPE =>
'string',
127 ParamValidator::PARAM_REQUIRED =>
true,
130 $params[
'changesetName'] = [
131 ParamValidator::PARAM_TYPE =>
'string',
132 ParamValidator::PARAM_DEFAULT => MessageChangeStorage::DEFAULT_NAME
138 protected function getExamplesMessages(): array {
140 'action=query&meta=managemessagegroup&mmggroupId=hello
141 &mmgchangesetName=default&mmgmessageKey=world' =>
'apihelp-query+managemessagegroups-example-1',
return[ 'Translate:ConfigHelper'=> static function():ConfigHelper { return new ConfigHelper();}, 'Translate:CsvTranslationImporter'=> static function(MediaWikiServices $services):CsvTranslationImporter { return new CsvTranslationImporter( $services->getWikiPageFactory());}, 'Translate:EntitySearch'=> static function(MediaWikiServices $services):EntitySearch { return new EntitySearch($services->getMainWANObjectCache(), $services->getCollationFactory() ->makeCollation( 'uca-default-u-kn'), MessageGroups::singleton(), $services->getNamespaceInfo(), $services->get( 'Translate:MessageIndex'), $services->getTitleParser(), $services->getTitleFormatter());}, 'Translate:ExternalMessageSourceStateImporter'=> static function(MediaWikiServices $services):ExternalMessageSourceStateImporter { return new ExternalMessageSourceStateImporter($services->getMainConfig(), $services->get( 'Translate:GroupSynchronizationCache'), $services->getJobQueueGroup(), LoggerFactory::getInstance( 'Translate.GroupSynchronization'), MessageIndex::singleton());}, 'Translate:GroupSynchronizationCache'=> static function(MediaWikiServices $services):GroupSynchronizationCache { return new GroupSynchronizationCache( $services->get( 'Translate:PersistentCache'));}, 'Translate:MessageBundleStore'=> static function(MediaWikiServices $services):MessageBundleStore { return new MessageBundleStore(new RevTagStore(), $services->getJobQueueGroup(), $services->getLanguageNameUtils(), $services->get( 'Translate:MessageIndex'));}, 'Translate:MessageGroupReview'=> static function(MediaWikiServices $services):MessageGroupReview { return new MessageGroupReview($services->getDBLoadBalancer(), $services->getHookContainer());}, 'Translate:MessageIndex'=> static function(MediaWikiServices $services):MessageIndex { $params=$services->getMainConfig() ->get( 'TranslateMessageIndex');if(is_string( $params)) { $params=(array) $params;} $class=array_shift( $params);return new $class( $params);}, 'Translate:ParsingPlaceholderFactory'=> static function():ParsingPlaceholderFactory { return new ParsingPlaceholderFactory();}, 'Translate:PersistentCache'=> static function(MediaWikiServices $services):PersistentCache { return new PersistentDatabaseCache($services->getDBLoadBalancer(), $services->getJsonCodec());}, 'Translate:ProgressStatsTableFactory'=> static function(MediaWikiServices $services):ProgressStatsTableFactory { return new ProgressStatsTableFactory($services->getLinkRenderer(), $services->get( 'Translate:ConfigHelper'));}, 'Translate:SubpageListBuilder'=> static function(MediaWikiServices $services):SubpageListBuilder { return new SubpageListBuilder($services->get( 'Translate:TranslatableBundleFactory'), $services->getLinkBatchFactory());}, 'Translate:TranslatableBundleFactory'=> static function(MediaWikiServices $services):TranslatableBundleFactory { return new TranslatableBundleFactory($services->get( 'Translate:TranslatablePageStore'), $services->get( 'Translate:MessageBundleStore'));}, 'Translate:TranslatableBundleMover'=> static function(MediaWikiServices $services):TranslatableBundleMover { return new TranslatableBundleMover($services->getMovePageFactory(), $services->getJobQueueGroup(), $services->getLinkBatchFactory(), $services->get( 'Translate:TranslatableBundleFactory'), $services->get( 'Translate:SubpageListBuilder'), $services->getMainConfig() ->get( 'TranslatePageMoveLimit'));}, 'Translate:TranslatablePageParser'=> static function(MediaWikiServices $services):TranslatablePageParser { return new TranslatablePageParser($services->get( 'Translate:ParsingPlaceholderFactory'));}, 'Translate:TranslatablePageStore'=> static function(MediaWikiServices $services):TranslatablePageStore { return new TranslatablePageStore($services->get( 'Translate:MessageIndex'), $services->getJobQueueGroup(), new RevTagStore(), $services->getDBLoadBalancer());}, 'Translate:TranslationStashReader'=> static function(MediaWikiServices $services):TranslationStashReader { $db=$services->getDBLoadBalancer() ->getConnectionRef(DB_REPLICA);return new TranslationStashStorage( $db);}, 'Translate:TranslationStatsDataProvider'=> static function(MediaWikiServices $services):TranslationStatsDataProvider { return new TranslationStatsDataProvider(new ServiceOptions(TranslationStatsDataProvider::CONSTRUCTOR_OPTIONS, $services->getMainConfig()), $services->getObjectFactory());}, 'Translate:TranslationUnitStoreFactory'=> static function(MediaWikiServices $services):TranslationUnitStoreFactory { return new TranslationUnitStoreFactory( $services->getDBLoadBalancer());}, 'Translate:TranslatorActivity'=> static function(MediaWikiServices $services):TranslatorActivity { $query=new TranslatorActivityQuery($services->getMainConfig(), $services->getDBLoadBalancer());return new TranslatorActivity($services->getMainObjectStash(), $query, $services->getJobQueueGroup());}, 'Translate:TtmServerFactory'=> static function(MediaWikiServices $services):TtmServerFactory { $config=$services->getMainConfig();$default=$config->get( 'TranslateTranslationDefaultService');if( $default===false) { $default=null;} return new TtmServerFactory( $config->get( 'TranslateTranslationServices'), $default);}]
@phpcs-require-sorted-array