Merge "Move around "ا" to after "آ" and not before"

[lhc/web/wiklou.git] / includes / api / ApiHelp.php

diff --git a/includes/api/ApiHelp.php b/includes/api/ApiHelp.php
index 192c039..318555a 100644 (file)
--- a/includes/api/ApiHelp.php
+++ b/includes/api/ApiHelp.php
@@ -4,7 +4,7 @@
  *
  * Created on Aug 29, 2014
  *
- * Copyright © 2014 Brad Jorsch <bjorsch@wikimedia.org>
+ * Copyright © 2014 Wikimedia Foundation and contributors
  *
  * 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
@@ -485,7 +485,9 @@ class ApiHelp extends ApiBase {
                                                $type = $settings[ApiBase::PARAM_TYPE];
                                                $multi = !empty( $settings[ApiBase::PARAM_ISMULTI] );
                                                $hintPipeSeparated = true;
-                                               $count = ApiBase::LIMIT_SML2 + 1;
+                                               $count = !empty( $settings[ApiBase::PARAM_ISMULTI_LIMIT2] )
+                                                       ? $settings[ApiBase::PARAM_ISMULTI_LIMIT2] + 1
+                                                       : ApiBase::LIMIT_SML2 + 1;
 
                                                if ( is_array( $type ) ) {
                                                        $count = count( $type );
@@ -529,23 +531,42 @@ class ApiHelp extends ApiBase {
                                                        switch ( $type ) {
                                                                case 'submodule':
                                                                        $groups[] = $name;
+
                                                                        if ( isset( $settings[ApiBase::PARAM_SUBMODULE_MAP] ) ) {
                                                                                $map = $settings[ApiBase::PARAM_SUBMODULE_MAP];
-                                                                               ksort( $map );
-                                                                               $submodules = [];
-                                                                               foreach ( $map as $v => $m ) {
-                                                                                       $submodules[] = "[[Special:ApiHelp/{$m}|{$v}]]";
-                                                                               }
+                                                                               $defaultAttrs = [];
                                                                        } else {
-                                                                               $submodules = $module->getModuleManager()->getNames( $name );
-                                                                               sort( $submodules );
-                                                                               $prefix = $module->isMain()
-                                                                                       ? '' : ( $module->getModulePath() . '+' );
-                                                                               $submodules = array_map( function ( $name ) use ( $prefix ) {
-                                                                                       $text = Html::element( 'span', [ 'dir' => 'ltr', 'lang' => 'en' ], $name );
-                                                                                       return "[[Special:ApiHelp/{$prefix}{$name}|{$text}]]";
-                                                                               }, $submodules );
+                                                                               $prefix = $module->isMain() ? '' : ( $module->getModulePath() . '+' );
+                                                                               $map = [];
+                                                                               foreach ( $module->getModuleManager()->getNames( $name ) as $submoduleName ) {
+                                                                                       $map[$submoduleName] = $prefix . $submoduleName;
+                                                                               }
+                                                                               $defaultAttrs = [ 'dir' => 'ltr', 'lang' => 'en' ];
+                                                                       }
+                                                                       ksort( $map );
+
+                                                                       $submodules = [];
+                                                                       $deprecatedSubmodules = [];
+                                                                       foreach ( $map as $v => $m ) {
+                                                                               $attrs = $defaultAttrs;
+                                                                               $arr = &$submodules;
+                                                                               try {
+                                                                                       $submod = $module->getModuleFromPath( $m );
+                                                                                       if ( $submod ) {
+                                                                                               if ( $submod->isDeprecated() ) {
+                                                                                                       $arr = &$deprecatedSubmodules;
+                                                                                                       $attrs['class'] = 'apihelp-deprecated-value';
+                                                                                               }
+                                                                                       }
+                                                                               } catch ( ApiUsageException $ex ) {
+                                                                                       // Ignore
+                                                                               }
+                                                                               if ( $attrs ) {
+                                                                                       $v = Html::element( 'span', $attrs, $v );
+                                                                               }
+                                                                               $arr[] = "[[Special:ApiHelp/{$m}|{$v}]]";
                                                                        }
+                                                                       $submodules = array_merge( $submodules, $deprecatedSubmodules );
                                                                        $count = count( $submodules );
                                                                        $info[] = $context->msg( 'api-help-param-list' )
                                                                                ->params( $multi ? 2 : 1 )
@@ -650,13 +671,25 @@ class ApiHelp extends ApiBase {
 
                                                if ( $multi ) {
                                                        $extra = [];
+                                                       $lowcount = !empty( $settings[ApiBase::PARAM_ISMULTI_LIMIT1] )
+                                                               ? $settings[ApiBase::PARAM_ISMULTI_LIMIT1]
+                                                               : ApiBase::LIMIT_SML1;
+                                                       $highcount = !empty( $settings[ApiBase::PARAM_ISMULTI_LIMIT2] )
+                                                               ? $settings[ApiBase::PARAM_ISMULTI_LIMIT2]
+                                                               : ApiBase::LIMIT_SML2;
+
                                                        if ( $hintPipeSeparated ) {
                                                                $extra[] = $context->msg( 'api-help-param-multi-separate' )->parse();
                                                        }
-                                                       if ( $count > ApiBase::LIMIT_SML1 ) {
-                                                               $extra[] = $context->msg( 'api-help-param-multi-max' )
-                                                                       ->numParams( ApiBase::LIMIT_SML1, ApiBase::LIMIT_SML2 )
-                                                                       ->parse();
+                                                       if ( $count > $lowcount ) {
+                                                               if ( $lowcount === $highcount ) {
+                                                                       $msg = $context->msg( 'api-help-param-multi-max-simple' )
+                                                                               ->numParams( $lowcount );
+                                                               } else {
+                                                                       $msg = $context->msg( 'api-help-param-multi-max' )
+                                                                               ->numParams( $lowcount, $highcount );
+                                                               }
+                                                               $extra[] = $msg->parse();
                                                        }
                                                        if ( $extra ) {
                                                                $info[] = implode( ' ', $extra );