docs/extension.schema.json

   1 {
   2         "$schema": "http://json-schema.org/schema#",
   3         "description": "MediaWiki extension.json schema",
   4         "type": "object",
   5         "properties": {
   6                 "manifest_version": {
   7                         "type": "integer",
   8                         "description": "Version of the extension.json schema the extension.json file is in.",
   9                         "required": true
  10                 },
  11                 "name": {
  12                         "type": "string",
  13                         "description": "The extension's canonical name.",
  14                         "required": true
  15                 },
  16                 "namemsg": {
  17                         "type": "string",
  18                         "description": "i18n message key of the extension's name."
  19                 },
  20                 "type": {
  21                         "type": "string",
  22                         "description": "The extension's type, as an index to $wgExtensionCredits.",
  23                         "default": "other"
  24                 },
  25                 "author": {
  26                         "type": [
  27                                 "string",
  28                                 "array"
  29                         ],
  30                         "description": "Extension's authors.",
  31                         "items": {
  32                                 "type": "string"
  33                         }
  34                 },
  35                 "version": {
  36                         "type": "string",
  37                         "description": "The version of this release of the extension."
  38                 },
  39                 "url": {
  40                         "type": "string",
  41                         "description": "URL to the homepage for the extension.",
  42                         "format": "uri"
  43                 },
  44                 "description": {
  45                         "type": "string",
  46                         "description": "Raw description of the extension."
  47                 },
  48                 "descriptionmsg": {
  49                         "type": "string",
  50                         "description": "Message key for a i18n message describing the extension."
  51                 },
  52                 "license-name": {
  53                         "type": "string",
  54                         "description": "Short identifier for the license under which the extension is released.",
  55                         "enum": [
  56                                 "AFL-1.1",
  57                                 "AFL-1.2",
  58                                 "AFL-2.0",
  59                                 "AFL-2.1",
  60                                 "AFL-3.0",
  61                                 "APL-1.0",
  62                                 "Aladdin",
  63                                 "ANTLR-PD",
  64                                 "Apache-1.0",
  65                                 "Apache-1.1",
  66                                 "Apache-2.0",
  67                                 "APSL-1.0",
  68                                 "APSL-1.1",
  69                                 "APSL-1.2",
  70                                 "APSL-2.0",
  71                                 "Artistic-1.0",
  72                                 "Artistic-1.0-cl8",
  73                                 "Artistic-1.0-Perl",
  74                                 "Artistic-2.0",
  75                                 "AAL",
  76                                 "BitTorrent-1.0",
  77                                 "BitTorrent-1.1",
  78                                 "BSL-1.0",
  79                                 "BSD-2-Clause",
  80                                 "BSD-2-Clause-FreeBSD",
  81                                 "BSD-2-Clause-NetBSD",
  82                                 "BSD-3-Clause",
  83                                 "BSD-3-Clause-Clear",
  84                                 "BSD-4-Clause",
  85                                 "BSD-4-Clause-UC",
  86                                 "CECILL-1.0",
  87                                 "CECILL-1.1",
  88                                 "CECILL-2.0",
  89                                 "CECILL-B",
  90                                 "CECILL-C",
  91                                 "ClArtistic",
  92                                 "CNRI-Python",
  93                                 "CNRI-Python-GPL-Compatible",
  94                                 "CPOL-1.02",
  95                                 "CDDL-1.0",
  96                                 "CDDL-1.1",
  97                                 "CPAL-1.0",
  98                                 "CPL-1.0",
  99                                 "CATOSL-1.1",
 100                                 "Condor-1.1",
 101                                 "CC-BY-1.0",
 102                                 "CC-BY-2.0",
 103                                 "CC-BY-2.5",
 104                                 "CC-BY-3.0",
 105                                 "CC-BY-ND-1.0",
 106                                 "CC-BY-ND-2.0",
 107                                 "CC-BY-ND-2.5",
 108                                 "CC-BY-ND-3.0",
 109                                 "CC-BY-NC-1.0",
 110                                 "CC-BY-NC-2.0",
 111                                 "CC-BY-NC-2.5",
 112                                 "CC-BY-NC-3.0",
 113                                 "CC-BY-NC-ND-1.0",
 114                                 "CC-BY-NC-ND-2.0",
 115                                 "CC-BY-NC-ND-2.5",
 116                                 "CC-BY-NC-ND-3.0",
 117                                 "CC-BY-NC-SA-1.0",
 118                                 "CC-BY-NC-SA-2.0",
 119                                 "CC-BY-NC-SA-2.5",
 120                                 "CC-BY-NC-SA-3.0",
 121                                 "CC-BY-SA-1.0",
 122                                 "CC-BY-SA-2.0",
 123                                 "CC-BY-SA-2.5",
 124                                 "CC-BY-SA-3.0",
 125                                 "CC0-1.0",
 126                                 "CUA-OPL-1.0",
 127                                 "D-FSL-1.0",
 128                                 "WTFPL",
 129                                 "EPL-1.0",
 130                                 "eCos-2.0",
 131                                 "ECL-1.0",
 132                                 "ECL-2.0",
 133                                 "EFL-1.0",
 134                                 "EFL-2.0",
 135                                 "Entessa",
 136                                 "ErlPL-1.1",
 137                                 "EUDatagrid",
 138                                 "EUPL-1.0",
 139                                 "EUPL-1.1",
 140                                 "Fair",
 141                                 "Frameworx-1.0",
 142                                 "FTL",
 143                                 "AGPL-1.0",
 144                                 "AGPL-3.0",
 145                                 "GFDL-1.1",
 146                                 "GFDL-1.2",
 147                                 "GFDL-1.3",
 148                                 "GPL-1.0",
 149                                 "GPL-1.0+",
 150                                 "GPL-2.0",
 151                                 "GPL-2.0+",
 152                                 "GPL-2.0-with-autoconf-exception",
 153                                 "GPL-2.0-with-bison-exception",
 154                                 "GPL-2.0-with-classpath-exception",
 155                                 "GPL-2.0-with-font-exception",
 156                                 "GPL-2.0-with-GCC-exception",
 157                                 "GPL-3.0",
 158                                 "GPL-3.0+",
 159                                 "GPL-3.0-with-autoconf-exception",
 160                                 "GPL-3.0-with-GCC-exception",
 161                                 "LGPL-2.1",
 162                                 "LGPL-2.1+",
 163                                 "LGPL-3.0",
 164                                 "LGPL-3.0+",
 165                                 "LGPL-2.0",
 166                                 "LGPL-2.0+",
 167                                 "gSOAP-1.3b",
 168                                 "HPND",
 169                                 "IBM-pibs",
 170                                 "IPL-1.0",
 171                                 "Imlib2",
 172                                 "IJG",
 173                                 "Intel",
 174                                 "IPA",
 175                                 "ISC",
 176                                 "JSON",
 177                                 "LPPL-1.3a",
 178                                 "LPPL-1.0",
 179                                 "LPPL-1.1",
 180                                 "LPPL-1.2",
 181                                 "LPPL-1.3c",
 182                                 "Libpng",
 183                                 "LPL-1.02",
 184                                 "LPL-1.0",
 185                                 "MS-PL",
 186                                 "MS-RL",
 187                                 "MirOS",
 188                                 "MIT",
 189                                 "Motosoto",
 190                                 "MPL-1.0",
 191                                 "MPL-1.1",
 192                                 "MPL-2.0",
 193                                 "MPL-2.0-no-copyleft-exception",
 194                                 "Multics",
 195                                 "NASA-1.3",
 196                                 "Naumen",
 197                                 "NBPL-1.0",
 198                                 "NGPL",
 199                                 "NOSL",
 200                                 "NPL-1.0",
 201                                 "NPL-1.1",
 202                                 "Nokia",
 203                                 "NPOSL-3.0",
 204                                 "NTP",
 205                                 "OCLC-2.0",
 206                                 "ODbL-1.0",
 207                                 "PDDL-1.0",
 208                                 "OGTSL",
 209                                 "OLDAP-2.2.2",
 210                                 "OLDAP-1.1",
 211                                 "OLDAP-1.2",
 212                                 "OLDAP-1.3",
 213                                 "OLDAP-1.4",
 214                                 "OLDAP-2.0",
 215                                 "OLDAP-2.0.1",
 216                                 "OLDAP-2.1",
 217                                 "OLDAP-2.2",
 218                                 "OLDAP-2.2.1",
 219                                 "OLDAP-2.3",
 220                                 "OLDAP-2.4",
 221                                 "OLDAP-2.5",
 222                                 "OLDAP-2.6",
 223                                 "OLDAP-2.7",
 224                                 "OPL-1.0",
 225                                 "OSL-1.0",
 226                                 "OSL-2.0",
 227                                 "OSL-2.1",
 228                                 "OSL-3.0",
 229                                 "OLDAP-2.8",
 230                                 "OpenSSL",
 231                                 "PHP-3.0",
 232                                 "PHP-3.01",
 233                                 "PostgreSQL",
 234                                 "Python-2.0",
 235                                 "QPL-1.0",
 236                                 "RPSL-1.0",
 237                                 "RPL-1.1",
 238                                 "RPL-1.5",
 239                                 "RHeCos-1.1",
 240                                 "RSCPL",
 241                                 "Ruby",
 242                                 "SAX-PD",
 243                                 "SGI-B-1.0",
 244                                 "SGI-B-1.1",
 245                                 "SGI-B-2.0",
 246                                 "OFL-1.0",
 247                                 "OFL-1.1",
 248                                 "SimPL-2.0",
 249                                 "Sleepycat",
 250                                 "SMLNJ",
 251                                 "SugarCRM-1.1.3",
 252                                 "SISSL",
 253                                 "SISSL-1.2",
 254                                 "SPL-1.0",
 255                                 "Watcom-1.0",
 256                                 "NCSA",
 257                                 "VSL-1.0",
 258                                 "W3C",
 259                                 "WXwindows",
 260                                 "Xnet",
 261                                 "X11",
 262                                 "XFree86-1.1",
 263                                 "YPL-1.0",
 264                                 "YPL-1.1",
 265                                 "Zimbra-1.3",
 266                                 "Zlib",
 267                                 "ZPL-1.1",
 268                                 "ZPL-2.0",
 269                                 "ZPL-2.1",
 270                                 "Unlicense"
 271                         ]
 272                 },
 273                 "requires": {
 274                         "type": "object",
 275                         "description": "Indicates what versions of MediaWiki core are required. This syntax may be extended in the future, for example to check dependencies between other extensions.",
 276                         "properties": {
 277                                 "MediaWiki": {
 278                                         "type": "string",
 279                                         "description": "Version constraint string against MediaWiki core."
 280                                 }
 281                         }
 282                 },
 283                 "ResourceFileModulePaths": {
 284                         "type": "object",
 285                         "description": "Default paths to use for all ResourceLoader file modules",
 286                         "additionalProperties": false,
 287                         "properties": {
 288                                 "localBasePath": {
 289                                         "type": "string",
 290                                         "description": "Base path to prepend to all local paths, relative to current directory"
 291                                 },
 292                                 "remoteExtPath": {
 293                                         "type": "string",
 294                                         "description": "Base path to prepend to all remote paths, relative to $wgExtensionAssetsPath"
 295                                 },
 296                                 "remoteSkinPath": {
 297                                         "type": "string",
 298                                         "description": "Base path to prepend to all remote paths, relative to $wgStylePath"
 299                                 }
 300                         }
 301                 },
 302                 "ResourceModules": {
 303                         "type": "object",
 304                         "description": "ResourceLoader modules to register",
 305                         "patternProperties": {
 306                                 "^[a-zA-Z0-9-\\.]+$": {
 307                                         "type": "object",
 308                                         "anyOf": [
 309                                                 {
 310                                                         "description": "A ResourceLoaderFileModule definition",
 311                                                         "additionalProperties": false,
 312                                                         "properties": {
 313                                                                 "localBasePath": {
 314                                                                         "type": "string",
 315                                                                         "description": "Base path to prepend to all local paths in $options. Defaults to $IP"
 316                                                                 },
 317                                                                 "remoteBasePath": {
 318                                                                         "type": "string",
 319                                                                         "description": "Base path to prepend to all remote paths in $options. Defaults to $wgScriptPath"
 320                                                                 },
 321                                                                 "remoteExtPath": {
 322                                                                         "type": "string",
 323                                                                         "description": "Equivalent of remoteBasePath, but relative to $wgExtensionAssetsPath"
 324                                                                 },
 325                                                                 "skipFunction": {
 326                                                                         "type": "string",
 327                                                                         "description": "Path to a file containing a JavaScript \"skip function\", if desired."
 328                                                                 },
 329                                                                 "scripts": {
 330                                                                         "type": ["string", "array"],
 331                                                                         "description": "Scripts to always include (array of file paths)",
 332                                                                         "items": {
 333                                                                                 "type": "string"
 334                                                                         }
 335                                                                 },
 336                                                                 "languageScripts": {
 337                                                                         "type": "object",
 338                                                                         "description": "Scripts to include in specific language contexts (mapping of language code to file path(s))",
 339                                                                         "patternProperties": {
 340                                                                                 "^[a-zA-Z0-9-]{2,}$": {
 341                                                                                         "type": [
 342                                                                                                 "string",
 343                                                                                                 "array"
 344                                                                                         ],
 345                                                                                         "items": {
 346                                                                                                 "type": "string"
 347                                                                                         }
 348                                                                                 }
 349                                                                         }
 350                                                                 },
 351                                                                 "skinScripts": {
 352                                                                         "type": "object",
 353                                                                         "description": "Scripts to include in specific skin contexts (mapping of skin name to script(s)",
 354                                                                         "patternProperties": {
 355                                                                                 ".+": {
 356                                                                                         "type": [
 357                                                                                                 "string",
 358                                                                                                 "array"
 359                                                                                         ],
 360                                                                                         "items": {
 361                                                                                                 "type": "string"
 362                                                                                         }
 363                                                                                 }
 364                                                                         }
 365                                                                 },
 366                                                                 "debugScripts": {
 367                                                                         "type": ["string", "array"],
 368                                                                         "description": "Scripts to include in debug contexts",
 369                                                                         "items": {
 370                                                                                 "type": "string"
 371                                                                         }
 372                                                                 },
 373                                                                 "loaderScripts": {
 374                                                                         "type": ["string", "array"],
 375                                                                         "description": "Scripts to include in the startup module",
 376                                                                         "items": {
 377                                                                                 "type": "string"
 378                                                                         }
 379                                                                 },
 380                                                                 "dependencies": {
 381                                                                         "type": ["string", "array"],
 382                                                                         "description": "Modules which must be loaded before this module",
 383                                                                         "items": {
 384                                                                                 "type": "string"
 385                                                                         }
 386                                                                 },
 387                                                                 "styles": {
 388                                                                         "type": ["string", "array", "object"],
 389                                                                         "description": "Styles to always load",
 390                                                                         "items": {
 391                                                                                 "type": "string"
 392                                                                         }
 393                                                                 },
 394                                                                 "skinStyles": {
 395                                                                         "type": "object",
 396                                                                         "description": "Styles to include in specific skin contexts (mapping of skin name to style(s))",
 397                                                                         "patternProperties": {
 398                                                                                 ".+": {
 399                                                                                         "type": [
 400                                                                                                 "string",
 401                                                                                                 "array"
 402                                                                                         ],
 403                                                                                         "items": {
 404                                                                                                 "type": "string"
 405                                                                                         }
 406                                                                                 }
 407                                                                         }
 408                                                                 },
 409                                                                 "messages": {
 410                                                                         "type": ["string", "array"],
 411                                                                         "description": "Messages to always load",
 412                                                                         "items": {
 413                                                                                 "type": "string"
 414                                                                         }
 415                                                                 },
 416                                                                 "group": {
 417                                                                         "type": "string",
 418                                                                         "description": "Group with which this module should be loaded"
 419                                                                 },
 420                                                                 "deprecated": {
 421                                                                         "type": ["object", "boolean"],
 422                                                                         "description": "Whether the module is deprecated and usage is discouraged. Either a boolean or an object with key message can be used to customise deprecation message."
 423                                                                 },
 424                                                                 "position": {
 425                                                                         "type": "string",
 426                                                                         "description": "Position on the page to load this module at",
 427                                                                         "enum": [
 428                                                                                 "bottom",
 429                                                                                 "top"
 430                                                                         ]
 431                                                                 },
 432                                                                 "templates": {
 433                                                                         "type": ["object", "array"],
 434                                                                         "description": "Templates to be loaded for client-side usage"
 435                                                                 },
 436                                                                 "targets": {
 437                                                                         "type": ["string", "array"],
 438                                                                         "description": "ResourceLoader target the module can run on",
 439                                                                         "items": {
 440                                                                                 "type": "string"
 441                                                                         }
 442                                                                 }
 443                                                         }
 444                                                 },
 445                                                 {
 446                                                         "description": "A ResourceLoaderWikiModule definition",
 447                                                         "additionalProperties": false,
 448                                                         "properties": {
 449                                                                 "class": {
 450                                                                         "enum": ["ResourceLoaderWikiModule"]
 451                                                                 },
 452                                                                 "group": {
 453                                                                         "type": "string",
 454                                                                         "description": "Group with which this module should be loaded"
 455                                                                 },
 456                                                                 "position": {
 457                                                                         "type": "string",
 458                                                                         "description": "Position on the page to load this module at",
 459                                                                         "enum": [
 460                                                                                 "bottom",
 461                                                                                 "top"
 462                                                                         ]
 463                                                                 },
 464                                                                 "targets": {
 465                                                                         "type": ["string", "array"],
 466                                                                         "description": "ResourceLoader target the module can run on",
 467                                                                         "items": {
 468                                                                                 "type": "string"
 469                                                                         }
 470                                                                 },
 471                                                                 "scripts": {
 472                                                                         "type": "array",
 473                                                                         "description": "A list of on-wiki pages containing JavaScript that should be loaded",
 474                                                                         "items": {
 475                                                                                 "type": "string"
 476                                                                         }
 477                                                                 },
 478                                                                 "styles": {
 479                                                                         "type": "array",
 480                                                                         "description": "A list of on-wiki pages containing CSS that should be loaded",
 481                                                                         "items": {
 482                                                                                 "type": "string"
 483                                                                         }
 484                                                                 }
 485                                                         }
 486                                                 },
 487                                                 {
 488                                                         "description": "A ResourceLoaderImageModule definition",
 489                                                         "additionalProperties": false,
 490                                                         "properties": {
 491                                                                 "class": {
 492                                                                         "enum": ["ResourceLoaderImageModule"]
 493                                                                 },
 494                                                                 "data": {
 495                                                                         "type": "string"
 496                                                                 },
 497                                                                 "prefix": {
 498                                                                         "type": "string"
 499                                                                 },
 500                                                                 "selector": {
 501                                                                         "type": "string"
 502                                                                 },
 503                                                                 "selectorWithoutVariant": {
 504                                                                         "type": "string"
 505                                                                 },
 506                                                                 "selectorWithVariant": {
 507                                                                         "type": "string"
 508                                                                 },
 509                                                                 "variants": {
 510                                                                         "type": "object"
 511                                                                 },
 512                                                                 "images": {
 513                                                                         "type": "object"
 514                                                                 },
 515                                                                 "position": {
 516                                                                         "enum": [
 517                                                                                 "top",
 518                                                                                 "bottom"
 519                                                                         ]
 520                                                                 }
 521                                                         }
 522                                                 },
 523                                                 {
 524                                                         "description": "An arbitrary ResourceLoaderModule definition",
 525                                                         "properties": {
 526                                                                 "class": {
 527                                                                         "type": "string",
 528                                                                         "pattern": "^((?!ResourceLoader(File|Image)Module).)*$"
 529                                                                 }
 530                                                         },
 531                                                         "required": ["class"]
 532                                                 }
 533                                         ]
 534                                 }
 535                         }
 536                 },
 537                 "ResourceModuleSkinStyles": {
 538                         "type": "object",
 539                         "description": "ResourceLoader modules for custom skin styles"
 540                 },
 541                 "ResourceLoaderSources": {
 542                         "type": "object",
 543                         "description": "ResourceLoader sources to register"
 544                 },
 545                 "ResourceLoaderLESSVars": {
 546                         "type": "object",
 547                         "description": "ResourceLoader LESS variables"
 548                 },
 549                 "ConfigRegistry": {
 550                         "type": "object",
 551                         "description": "Registry of factory functions to create Config objects"
 552                 },
 553                 "SessionProviders": {
 554                         "type": "object",
 555                         "description": "Session providers"
 556                 },
 557                 "AuthManagerAutoConfig": {
 558                         "type": "object",
 559                         "description": "AuthManager auto-configuration",
 560                         "additionalProperties": false,
 561                         "properties": {
 562                                 "preauth": {
 563                                         "type": "object",
 564                                         "description": "Pre-authentication providers"
 565                                 },
 566                                 "primaryauth": {
 567                                         "type": "object",
 568                                         "description": "Primary authentication providers"
 569                                 },
 570                                 "secondaryauth": {
 571                                         "type": "object",
 572                                         "description": "Secondary authentication providers"
 573                                 }
 574                         }
 575                 },
 576                 "CentralIdLookupProviders": {
 577                         "type": "object",
 578                         "description": "Central ID lookup providers"
 579                 },
 580                 "ChangeCredentialsBlacklist": {
 581                         "type": "object",
 582                         "description": "AuthenticationRequest classes which can only be used internally for credentials change"
 583                 },
 584                 "RemoveCredentialsBlacklist": {
 585                         "type": "object",
 586                         "description": "AuthenticationRequest classes which can only be used internally for credentials removal"
 587                 },
 588                 "namespaces": {
 589                         "type": "array",
 590                         "description": "Method to add extra namespaces",
 591                         "items": {
 592                                 "type": "object",
 593                                 "properties": {
 594                                         "id": {
 595                                                 "type": "integer"
 596                                         },
 597                                         "constant": {
 598                                                 "type": "string"
 599                                         },
 600                                         "name": {
 601                                                 "type": "string"
 602                                         },
 603                                         "gender": {
 604                                                 "type": "object",
 605                                                 "properties": {
 606                                                         "male": {
 607                                                                 "type": "string"
 608                                                         },
 609                                                         "female": {
 610                                                                 "type": "string"
 611                                                         }
 612                                                 }
 613                                         },
 614                                         "subpages": {
 615                                                 "type": "boolean",
 616                                                 "default": false
 617                                         },
 618                                         "content": {
 619                                                 "type": "boolean",
 620                                                 "default": false
 621                                         },
 622                                         "defaultcontentmodel": {
 623                                                 "type": "string"
 624                                         },
 625                                         "protection": {
 626                                                 "type": ["string", "array"],
 627                                                 "description": "Userright(s) required to edit in this namespace"
 628                                         },
 629                                         "capitallinkoverride": {
 630                                                 "type": "boolean",
 631                                                 "description": "Set $wgCapitalLinks on a per-namespace basis"
 632                                         },
 633                                         "conditional": {
 634                                                 "type": "boolean",
 635                                                 "description": "Whether the namespace is conditional upon configuration and should not be registered (requires separate registration via a hook)",
 636                                                 "default": false
 637                                         }
 638                                 },
 639                                 "required": ["id", "constant", "name"]
 640                         }
 641                 },
 642                 "TrackingCategories": {
 643                         "type": "array",
 644                         "description": "Tracking category message keys",
 645                         "items": {
 646                                 "type": "string"
 647                         }
 648                 },
 649                 "DefaultUserOptions": {
 650                         "type": "object",
 651                         "description": "Default values of user options"
 652                 },
 653                 "HiddenPrefs": {
 654                         "type": "array",
 655                         "description": "Preferences users cannot set",
 656                         "items": {
 657                                 "type": "string"
 658                         }
 659                 },
 660                 "GroupPermissions": {
 661                         "type": "object",
 662                         "description": "Default permissions to give to user groups",
 663                         "patternProperties": {
 664                                 "^[a-z]+$": {
 665                                         "type": "object",
 666                                         "patternProperties": {
 667                                                 "^[a-z]+$": {
 668                                                         "type": "boolean"
 669                                                 }
 670                                         }
 671                                 }
 672                         }
 673                 },
 674                 "RevokePermissions": {
 675                         "type": "object",
 676                         "description": "Default permissions to revoke from user groups",
 677                         "patternProperties": {
 678                                 "^[a-z]+$": {
 679                                         "type": "object",
 680                                         "patternProperties": {
 681                                                 "^[a-z]+$": {
 682                                                         "type": "boolean"
 683                                                 }
 684                                         }
 685                                 }
 686                         }
 687                 },
 688                 "GrantPermissions": {
 689                         "type": "object",
 690                         "description": "Map of permissions granted to authorized consumers to their bundles, called 'grants'",
 691                         "patternProperties": {
 692                                 "^[a-z]+$": {
 693                                         "type": "object",
 694                                         "patternProperties": {
 695                                                 "^[a-z]+$": {
 696                                                         "type": "boolean"
 697                                                 }
 698                                         }
 699                                 }
 700                         }
 701                 },
 702                 "GrantPermissionGroups": {
 703                         "type": "object",
 704                         "description": "Map of grants to their UI grouping",
 705                         "patternProperties": {
 706                                 "^[a-z]+$": {
 707                                         "type": "string"
 708                                 }
 709                         }
 710                 },
 711                 "ImplicitGroups": {
 712                         "type": "array",
 713                         "description": "Implicit groups"
 714                 },
 715                 "GroupsAddToSelf": {
 716                         "type": "object",
 717                         "description": "Groups a user can add to themselves"
 718                 },
 719                 "GroupsRemoveFromSelf": {
 720                         "type": "object",
 721                         "description": "Groups a user can remove from themselves"
 722                 },
 723                 "AddGroups": {
 724                         "type": "object",
 725                         "description": "Groups a user can add to users"
 726                 },
 727                 "RemoveGroups": {
 728                         "type": "object",
 729                         "description": "Groups a user can remove from users"
 730                 },
 731                 "AvailableRights": {
 732                         "type": "array",
 733                         "description": "User rights added by the extension",
 734                         "items": {
 735                                 "type": "string"
 736                         }
 737                 },
 738                 "ContentHandlers": {
 739                         "type": "object",
 740                         "description": "Mapping of model ID to class name",
 741                         "patternProperties": {
 742                                 "^[A-Za-z]+$": {
 743                                         "type": "string"
 744                                 }
 745                         }
 746                 },
 747                 "RateLimits": {
 748                         "type": "object",
 749                         "description": "Rate limits"
 750                 },
 751                 "RecentChangesFlags": {
 752                         "type": "object",
 753                         "description": "Flags (letter symbols) shown on RecentChanges pages"
 754                 },
 755                 "MediaHandlers": {
 756                         "type": "object",
 757                         "description": "Plugins for media file type handling. Each entry in the array maps a MIME type to a PHP class name."
 758                 },
 759                 "ExtensionFunctions": {
 760                         "type": [
 761                                 "array",
 762                                 "string"
 763                         ],
 764                         "description": "Function to call after setup has finished",
 765                         "items": {
 766                                 "type": "string"
 767                         }
 768                 },
 769                 "ExtensionMessagesFiles": {
 770                         "type": "object",
 771                         "description": "File paths containing PHP internationalization data"
 772                 },
 773                 "MessagesDirs": {
 774                         "type": "object",
 775                         "description": "Directory paths containing JSON internationalization data"
 776                 },
 777                 "ExtensionEntryPointListFiles": {
 778                         "type": "object"
 779                 },
 780                 "SpecialPages": {
 781                         "type": "object",
 782                         "description": "SpecialPages implemented in this extension (mapping of page name to class name)"
 783                 },
 784                 "AutoloadClasses": {
 785                         "type": "object"
 786                 },
 787                 "Hooks": {
 788                         "type": [ "string", "object" ],
 789                         "description": "Hooks this extension uses (mapping of hook name to callback)"
 790                 },
 791                 "JobClasses": {
 792                         "type": "object",
 793                         "description": "Job types this extension implements (mapping of job type to class name)"
 794                 },
 795                 "LogTypes": {
 796                         "type": "array",
 797                         "description": "List of new log types this extension uses"
 798                 },
 799                 "LogRestrictions": {
 800                         "type": "object"
 801                 },
 802                 "FilterLogTypes": {
 803                         "type": "object"
 804                 },
 805                 "ActionFilteredLogs": {
 806                         "type": "object",
 807                         "description": "List of log types which can be filtered by log actions",
 808                         "patternProperties": {
 809                                 "^[a-z-]+$": {
 810                                         "type": "object",
 811                                         "patternProperties": {
 812                                                 "^[a-z-]+$": {
 813                                                         "type": "array",
 814                                                         "items": {
 815                                                                 "type": "string"
 816                                                         }
 817                                                 }
 818                                         }
 819                                 }
 820                         }
 821                 },
 822                 "LogNames": {
 823                         "type": "object"
 824                 },
 825                 "LogHeaders": {
 826                         "type": "object"
 827                 },
 828                 "LogActions": {
 829                         "type": "object"
 830                 },
 831                 "LogActionsHandlers": {
 832                         "type": "object"
 833                 },
 834                 "Actions": {
 835                         "type": "object"
 836                 },
 837                 "APIModules": {
 838                         "type": "object"
 839                 },
 840                 "APIFormatModules": {
 841                         "type": "object"
 842                 },
 843                 "APIMetaModules": {
 844                         "type": "object"
 845                 },
 846                 "APIPropModules": {
 847                         "type": "object"
 848                 },
 849                 "APIListModules": {
 850                         "type": "object"
 851                 },
 852                 "ValidSkinNames": {
 853                         "type": "object"
 854                 },
 855                 "FeedClasses": {
 856                         "type": "object",
 857                         "description": "Available feeds objects"
 858                 },
 859                 "SkinOOUIThemes": {
 860                         "type": "object"
 861                 },
 862                 "callback": {
 863                         "type": [
 864                                 "array",
 865                                 "string"
 866                         ],
 867                         "description": "A function to be called right after MediaWiki processes this file"
 868                 },
 869                 "config_prefix": {
 870                         "type": "string",
 871                         "default": "wg",
 872                         "description": "Prefix to put in front of configuration settings when exporting them to $GLOBALS"
 873                 },
 874                 "config": {
 875                         "type": "object",
 876                         "description": "Configuration options for this extension",
 877                         "patternProperties": {
 878                                 "^[a-zA-Z_\u007f-\u00ff][a-zA-Z0-9_\u007f-\u00ff]*$": {
 879                                         "type": "object",
 880                                         "properties": {
 881                                                 "value": {
 882                                                         "required": true
 883                                                 },
 884                                                 "merge_strategy": {
 885                                                         "type": "string",
 886                                                         "enum": [
 887                                                                 "array_merge_recursive",
 888                                                                 "array_plus_2d",
 889                                                                 "array_plus",
 890                                                                 "array_merge"
 891                                                         ],
 892                                                         "default": "array_merge"
 893                                                 },
 894                                                 "path": {
 895                                                         "description": "Whether this should be interpreted as a filesystem path, relative to extension directory root",
 896                                                         "type": "boolean",
 897                                                         "default": false
 898                                                 },
 899                                                 "description": {
 900                                                         "type": ["string", "array"],
 901                                                         "description": "A description of the config setting, mostly for documentation/developers"
 902                                                 }
 903                                         }
 904                                 }
 905                         }
 906                 },
 907                 "ParserTestFiles": {
 908                         "type": "array",
 909                         "description": "Parser test suite files to be run by parserTests.php when no specific filename is passed to it"
 910                 },
 911                 "load_composer_autoloader": {
 912                         "type": "boolean",
 913                         "description": "Load the composer autoloader for this extension, if one is present"
 914                 }
 915         }
 916 }