Thijs/wiki.techinc.nl
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
wiki.techinc.nl/docs/extension.schema.v1.json

721 lines
18 KiB
JSON
Raw Normal View History

registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
{
"$schema": "http://json-schema.org/schema#",
"description": "MediaWiki extension.json schema",
"type": "object",
"properties": {
"manifest_version": {
"type": "integer",
"description": "Version of the extension.json schema the extension.json file is in.",
"required": true
},
"name": {
"type": "string",
"description": "The extension's canonical name.",
"required": true
},
"namemsg": {
"type": "string",
"description": "i18n message key of the extension's name."
},
"type": {
"type": "string",
"description": "The extension's type, as an index to $wgExtensionCredits.",
"default": "other"
},
"author": {
"type": [
"string",
"array"
],
"description": "Extension's authors.",
"items": {
"type": "string"
}
},
"version": {
"type": "string",
"description": "The version of this release of the extension."
},
"url": {
"type": "string",
"description": "URL to the homepage for the extension.",
registration: Allow protocol-relative links in "url" field Bug: T93010 Change-Id: I626fb5528b41910d859d8596a8ad350f94c1082e
2017-07-17 17:13:49 +00:00
"format": "uri-reference"
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
},
"description": {
"type": "string",
"description": "Raw description of the extension."
},
"descriptionmsg": {
"type": "string",
"description": "Message key for a i18n message describing the extension."
},
"license-name": {
"type": "string",
registration: Improve license-name validation Our hardcoded enum list in the extension.json schema for license-name values was incomplete and did not cover the full SPDX license identifier specification, which includes things like "AND" for specifying multiple licenses. Composer already has solid code in a library to do this validation, so let's use it! This updates both the validateRegistrationFile.php and ExtensionJsonValidationTest.php to use the composer/spdx-licenses library (a new development dependency) to ensure the license-name field is a valid SPDX identifier. Also fix a silly typo in the validateRegistrationFile script which prevented it from running, and use ::class so it will be easier to detect typos like that in the future. Bug: T146862 Change-Id: Ibb8973ed7950ae81c90558f9630f73746b2aff2c
2016-09-28 02:56:07 +00:00
"description": "SPDX identifier for the license under which the extension is released."
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
},
"requires": {
"type": "object",
registration: Allow properties in "requires" from v2 v2 of the schema allows extensions and skins to be definied under "requires". This is also used by some extensions in extension.json for v1. It works, so allow the same properties in v1 as in v2. Change-Id: I9b5f1986cadbd714d6f3460ac3e1db3bf7aae65d
2017-01-30 17:51:16 +00:00
"description": "Indicates what versions of MediaWiki core or extensions are required. This syntax may be extended in the future, for example to check dependencies between other services.",
"additionalProperties": false,
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
"properties": {
"MediaWiki": {
"type": "string",
"description": "Version constraint string against MediaWiki core."
registration: Allow properties in "requires" from v2 v2 of the schema allows extensions and skins to be definied under "requires". This is also used by some extensions in extension.json for v1. It works, so allow the same properties in v1 as in v2. Change-Id: I9b5f1986cadbd714d6f3460ac3e1db3bf7aae65d
2017-01-30 17:51:16 +00:00
},
"extensions": {
"type": "object",
"description": "Set of version constraint strings against specific extensions."
},
"skins": {
"type": "object",
"description": "Set of version constraint strings against specific skins."
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
}
}
},
"ResourceFileModulePaths": {
"type": "object",
"description": "Default paths to use for all ResourceLoader file modules",
"additionalProperties": false,
"properties": {
"localBasePath": {
"type": "string",
"description": "Base path to prepend to all local paths, relative to current directory"
},
"remoteExtPath": {
"type": "string",
"description": "Base path to prepend to all remote paths, relative to $wgExtensionAssetsPath"
},
"remoteSkinPath": {
"type": "string",
"description": "Base path to prepend to all remote paths, relative to $wgStylePath"
}
}
},
"ResourceModules": {
"type": "object",
"description": "ResourceLoader modules to register",
"patternProperties": {
"^[a-zA-Z0-9-\\.]+$": {
"type": "object",
"anyOf": [
{
"description": "A ResourceLoaderFileModule definition",
"additionalProperties": false,
"properties": {
"localBasePath": {
"type": "string",
"description": "Base path to prepend to all local paths in $options. Defaults to $IP"
},
"remoteBasePath": {
"type": "string",
"description": "Base path to prepend to all remote paths in $options. Defaults to $wgScriptPath"
},
"remoteExtPath": {
"type": "string",
"description": "Equivalent of remoteBasePath, but relative to $wgExtensionAssetsPath"
},
"skipFunction": {
"type": "string",
"description": "Path to a file containing a JavaScript \"skip function\", if desired."
},
"scripts": {
"type": ["string", "array"],
"description": "Scripts to always include (array of file paths)",
"items": {
"type": "string"
}
},
"languageScripts": {
"type": "object",
"description": "Scripts to include in specific language contexts (mapping of language code to file path(s))",
"patternProperties": {
"^[a-zA-Z0-9-]{2,}$": {
"type": [
"string",
"array"
],
"items": {
"type": "string"
}
}
}
},
"skinScripts": {
"type": "object",
"description": "Scripts to include in specific skin contexts (mapping of skin name to script(s)",
"patternProperties": {
".+": {
"type": [
"string",
"array"
],
"items": {
"type": "string"
}
}
}
},
"debugScripts": {
"type": ["string", "array"],
"description": "Scripts to include in debug contexts",
"items": {
"type": "string"
}
},
"loaderScripts": {
"type": ["string", "array"],
"description": "Scripts to include in the startup module",
"items": {
"type": "string"
}
},
"dependencies": {
"type": ["string", "array"],
"description": "Modules which must be loaded before this module",
"items": {
"type": "string"
}
},
"styles": {
"type": ["string", "array", "object"],
"description": "Styles to always load",
"items": {
"type": "string"
}
},
"skinStyles": {
"type": "object",
"description": "Styles to include in specific skin contexts (mapping of skin name to style(s))",
"patternProperties": {
".+": {
"type": [
"string",
"array"
],
"items": {
"type": "string"
}
}
}
},
"messages": {
"type": ["string", "array"],
"description": "Messages to always load",
"items": {
"type": "string"
}
},
"group": {
"type": "string",
"description": "Group which this module should be loaded together with"
},
resourceloader: Implement 'deprecated' option for FileModule ResourceLoader modules can now carry a 'deprecated' option which can be a boolean or an object with message key. This message or a default deprecation message will be show whenever that module is used in production. Note: This will not work in debug mode for ResourceLoaderFile modules and this is deemed acceptable for the time being. We can revisit later. Bug: T137772 Change-Id: Ib9ebd2d39a59fd41d8537e06884699f77b03580c
2016-07-14 22:09:06 +00:00
"deprecated": {
Follow-up 8a7fb8577: For deprecated RL modules, allow strings So that more than just PHP code and MediaWiki core can use it, but also JSON-based static extension registrations. :-) Change-Id: If22fccbb43c5b05db2a666d61ae8864ee9815e7d
2018-01-09 00:05:05 +00:00
"type": ["object", "string", "boolean"],
"description": "Whether the module is deprecated and usage is discouraged. Either a boolean, or a string or an object with key message can be used to customise deprecation message."
resourceloader: Implement 'deprecated' option for FileModule ResourceLoader modules can now carry a 'deprecated' option which can be a boolean or an object with message key. This message or a default deprecation message will be show whenever that module is used in production. Note: This will not work in debug mode for ResourceLoaderFile modules and this is deemed acceptable for the time being. We can revisit later. Bug: T137772 Change-Id: Ib9ebd2d39a59fd41d8537e06884699f77b03580c
2016-07-14 22:09:06 +00:00
},
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
"position": {
"type": "string",
"description": "Position on the page to load this module at",
"enum": [
"bottom",
"top"
]
},
"templates": {
"type": ["object", "array"],
"description": "Templates to be loaded for client-side usage"
},
"targets": {
"type": ["string", "array"],
"description": "ResourceLoader target the module can run on",
"items": {
"type": "string"
}
Add 'noflip' option on RL modules to disable CSSJanus Should be useful for cases where we pull in an external library that already manages RTL flipping in its styles, and CSSJanus does the wrong thing without extra markup. Example: 'ext.tmh.video-js' => $baseExtensionResource + [ 'scripts' => 'resources/videojs/video.js', 'styles' => 'resources/videojs/video-js.css', 'noflip' => true, ... ], Bug: T148572 Bug: T148565 Change-Id: Icbad20d8a6e9a0d354ad159f5816f4fb67cc2775
2016-10-18 19:04:40 +00:00
},
"noflip": {
"type": "boolean",
"description": "Whether to skip CSSJanus LTR-to-RTL flipping for this module. Recommended for styles imported from libraries that already properly handle their RTL styles. Default is false, meaning CSSJanus will be applied on RTL-mode output."
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
}
}
},
{
"description": "A ResourceLoaderWikiModule definition",
"additionalProperties": false,
"properties": {
"class": {
"enum": ["ResourceLoaderWikiModule"]
},
"group": {
"type": "string",
"description": "Group which this module should be loaded together with"
},
"position": {
"type": "string",
"description": "Position on the page to load this module at",
"enum": [
"bottom",
"top"
]
},
"targets": {
"type": ["string", "array"],
"description": "ResourceLoader target the module can run on",
"items": {
"type": "string"
}
},
"scripts": {
"type": "array",
"items": {
"type": "string"
}
},
"styles": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
{
"description": "A ResourceLoaderImageModule definition",
"additionalProperties": false,
"properties": {
"class": {
"enum": ["ResourceLoaderImageModule"]
},
ResourceLoaderImage module definitions can define a defaultColor Bug: T197909 Change-Id: I0745e112d11026ed59d8daca990b313305cd094a
2018-06-25 22:55:19 +00:00
"defaultColor": {
"type": "string"
},
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
"data": {
"type": "string"
},
"prefix": {
"type": "string"
},
"selector": {
"type": "string"
},
"selectorWithoutVariant": {
"type": "string"
},
"selectorWithVariant": {
"type": "string"
},
"variants": {
"type": "object"
},
"images": {
"type": "object"
},
"position": {
"enum": [
"top",
"bottom"
]
}
}
},
{
"description": "An arbitrary ResourceLoaderModule definition",
"properties": {
"class": {
"type": "string",
"pattern": "^((?!ResourceLoader(File|Image)Module).)*$"
}
},
"required": ["class"]
}
]
}
}
},
"ResourceModuleSkinStyles": {
"type": "object",
"description": "ResourceLoader modules for custom skin styles"
},
"ResourceLoaderSources": {
"type": "object",
"description": "ResourceLoader sources to register"
},
"ResourceLoaderLESSVars": {
"type": "object",
"description": "ResourceLoader LESS variables"
},
"ConfigRegistry": {
"type": "object",
"description": "Registry of factory functions to create Config objects"
},
"SessionProviders": {
"type": "object",
"description": "Session providers"
},
"AuthManagerAutoConfig": {
"type": "object",
"description": "AuthManager auto-configuration",
"additionalProperties": false,
"properties": {
"preauth": {
"type": "object",
"description": "Pre-authentication providers"
},
"primaryauth": {
"type": "object",
"description": "Primary authentication providers"
},
"secondaryauth": {
"type": "object",
"description": "Secondary authentication providers"
}
}
},
"CentralIdLookupProviders": {
"type": "object",
"description": "Central ID lookup providers"
},
"namespaces": {
"type": "array",
"description": "Method to add extra namespaces",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"constant": {
"type": "string"
},
"name": {
"type": "string"
},
"gender": {
"type": "object",
"properties": {
"male": {
"type": "string"
},
"female": {
"type": "string"
}
}
},
"subpages": {
"type": "boolean",
"default": false
},
"content": {
"type": "boolean",
"default": false
},
"defaultcontentmodel": {
"type": "string"
},
"protection": {
"type": ["string", "array"],
"description": "Userright(s) required to edit in this namespace"
},
"capitallinkoverride": {
"type": "boolean",
"description": "Set $wgCapitalLinks on a per-namespace basis"
registration: Support conditionally registered namespaces Some extensions (e.g. EventLogging) conditionally register a namespace depending upon the wiki's configuration using the CanonicalNamespaces hook. Since the "namespaces" key automatically registers the namespace, we need an option to not register it and let the extension take care of that manually using the hook. All of the other namespace related settings are safe to unconditionally set since they won't do anything if the namespace doesn't actually exist. Bug: T141604 Change-Id: Ie8c217fdc8bd783b30f98210309ea56fef39c0da
2016-07-29 08:09:24 +00:00
},
"conditional": {
"type": "boolean",
"description": "Whether the namespace is conditional upon configuration and should not be registered (requires separate registration via a hook)",
"default": false
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
}
},
"required": ["id", "constant", "name"]
}
},
"TrackingCategories": {
"type": "array",
"description": "Tracking category message keys",
"items": {
"type": "string"
}
},
"DefaultUserOptions": {
"type": "object",
"description": "Default values of user options"
},
"HiddenPrefs": {
"type": "array",
"description": "Preferences users cannot set",
"items": {
"type": "string"
}
},
"GroupPermissions": {
"type": "object",
"description": "Default permissions to give to user groups",
"patternProperties": {
"^[a-z]+$": {
"type": "object",
"patternProperties": {
"^[a-z]+$": {
"type": "boolean"
}
}
}
}
},
"RevokePermissions": {
"type": "object",
"description": "Default permissions to revoke from user groups",
"patternProperties": {
"^[a-z]+$": {
"type": "object",
"patternProperties": {
"^[a-z]+$": {
"type": "boolean"
}
}
}
}
},
"GrantPermissions": {
"type": "object",
"description": "Map of permissions granted to authorized consumers to their bundles, called 'grants'",
"patternProperties": {
"^[a-z]+$": {
"type": "object",
"patternProperties": {
"^[a-z]+$": {
"type": "boolean"
}
}
}
}
},
"GrantPermissionGroups": {
"type": "object",
"description": "Map of grants to their UI grouping",
"patternProperties": {
"^[a-z]+$": {
"type": "string"
}
}
},
"ImplicitGroups": {
"type": "array",
"description": "Implicit groups"
},
"GroupsAddToSelf": {
"type": "object",
"description": "Groups a user can add to themselves"
},
"GroupsRemoveFromSelf": {
"type": "object",
"description": "Groups a user can remove from themselves"
},
"AddGroups": {
"type": "object",
"description": "Groups a user can add to users"
},
"RemoveGroups": {
"type": "object",
"description": "Groups a user can remove from users"
},
"AvailableRights": {
"type": "array",
"description": "User rights added by the extension",
"items": {
"type": "string"
}
},
"ContentHandlers": {
"type": "object",
"description": "Mapping of model ID to class name",
"patternProperties": {
"^[A-Za-z]+$": {
"type": "string"
}
}
},
"RateLimits": {
"type": "object",
"description": "Rate limits"
},
"RecentChangesFlags": {
"type": "object",
"description": "Flags (letter symbols) shown on RecentChanges pages"
},
"MediaHandlers": {
"type": "object",
"description": "Plugins for media file type handling. Each entry in the array maps a MIME type to a PHP class name."
},
"ExtensionFunctions": {
"type": [
"array",
"string"
],
"description": "Function to call after setup has finished",
"items": {
"type": "string"
}
},
"ExtensionMessagesFiles": {
"type": "object",
"description": "File paths containing PHP internationalization data"
},
"MessagesDirs": {
"type": "object",
"description": "Directory paths containing JSON internationalization data"
},
"ExtensionEntryPointListFiles": {
"type": "object"
},
"SpecialPages": {
"type": "object",
"description": "SpecialPages implemented in this extension (mapping of page name to class name)"
},
Enable using PSR-4 autoloader for MediaWiki core and extensions This adds support for a PSR-4 (<http://www.php-fig.org/psr/psr-4/>) autoloader, so instead of needing to manually list each class, just the namespace prefix is needed. Extensions can set a "AutoloadNamespaces" property in extension.json to register PSR-4 compatible namespaces to be autoloaded. The implementation is based off of the example implementation (<http://www.php-fig.org/psr/psr-4/examples/>) with some modifications for performance, notably cutting down on function calls, and only trying to look up classes that are namespaced. The generateLocalAutoload.php script will ignore any directory that is registered as a PSR-4 namespace. Bug: T99865 Bug: T173799 Change-Id: Id095dde37cbb40aa424fb628bd3c94e684ca2f65
2017-08-24 18:05:26 +00:00
"AutoloadNamespaces": {
"type": "object",
registration: Validate AutoloadNamespaces keys have trailing \ The PSR-4 autoloader requires "AutoloadNamespaces" keys to have a trailing \ (\\ in JSON), so add a validation check for that. Unfortunately the validation error isn't great, since it checks to see if the property matches patternProperties, and when it doesn't, it claims the property isn't defined since additionalProperties is false. But it's still better than not failing when they are missing. Bug: T189136 Change-Id: If01bd06cdd767fb704a8ff85cdf1c143e53fa4ca
2018-05-20 19:13:05 +00:00
"description": "Mapping of PSR-4 compliant namespace to directory for autoloading",
"patternProperties": {
"^[A-Za-z0-9\\\\]+\\\\$": {
"type": "string"
}
},
"additionalProperties": false
Enable using PSR-4 autoloader for MediaWiki core and extensions This adds support for a PSR-4 (<http://www.php-fig.org/psr/psr-4/>) autoloader, so instead of needing to manually list each class, just the namespace prefix is needed. Extensions can set a "AutoloadNamespaces" property in extension.json to register PSR-4 compatible namespaces to be autoloaded. The implementation is based off of the example implementation (<http://www.php-fig.org/psr/psr-4/examples/>) with some modifications for performance, notably cutting down on function calls, and only trying to look up classes that are namespaced. The generateLocalAutoload.php script will ignore any directory that is registered as a PSR-4 namespace. Bug: T99865 Bug: T173799 Change-Id: Id095dde37cbb40aa424fb628bd3c94e684ca2f65
2017-08-24 18:05:26 +00:00
},
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
"AutoloadClasses": {
"type": "object"
},
"Hooks": {
"type": [ "string", "object" ],
"description": "Hooks this extension uses (mapping of hook name to callback)"
},
"JobClasses": {
"type": "object",
Allow callback functions for creating jobs $wgJobClasses can now specify a factory function for creating a job, instead of a class to be instantiated directly. This makes it possible to inject services in a job constructor, and register a factory function that calls the constructor with default services. This follows Ieb85493a7765 and Ia2107dc5af78, which introduced factory functions for API modules and special pages. Change-Id: I0461e59da2a8fa6681e3b1fcdfc38bfed7f3ac32
2017-05-04 16:00:28 +00:00
"description": "Job types this extension implements (mapping of job type to class name or factory function)"
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
},
"LogTypes": {
"type": "array",
"description": "List of new log types this extension uses"
},
"LogRestrictions": {
"type": "object"
},
"FilterLogTypes": {
"type": "object"
},
"ActionFilteredLogs": {
"type": "object",
"description": "List of log types which can be filtered by log actions",
"patternProperties": {
"^[a-z-]+$": {
"type": "object",
"patternProperties": {
"^[a-z-]+$": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
},
"LogNames": {
"type": "object"
},
"LogHeaders": {
"type": "object"
},
"LogActions": {
"type": "object"
},
"LogActionsHandlers": {
"type": "object"
},
"Actions": {
"type": "object"
},
"APIModules": {
"type": "object"
},
"APIFormatModules": {
"type": "object"
},
"APIMetaModules": {
"type": "object"
},
"APIPropModules": {
"type": "object"
},
"APIListModules": {
"type": "object"
},
"ValidSkinNames": {
"type": "object"
},
"FeedClasses": {
"type": "object",
"description": "Available feeds objects"
},
"SkinOOUIThemes": {
"type": "object"
},
registration: Support setting $wgPasswordPolicy in extension.json Bug: T149597 Change-Id: I56c0b8932fcd42ec9b748529daa32a998fb19bf8
2016-10-31 17:12:56 +00:00
"PasswordPolicy": {
"type": "object",
"description": "Password policies"
},
registration: Set "FileExtensions" to $GLOBALS Change-Id: Ie52004d25ebc06c81cd7d8d7de60479ff365ccea
2016-11-17 22:36:09 +00:00
"FileExtensions": {
registration: FileExtensions should be an array, not an object Change-Id: Iff44a4c241ab953906a7b0611f09e66856b1f7dc
2016-11-21 02:43:50 +00:00
"type": "array",
"description": "Preferred file extensions for uploading",
"items": {
"type": "string"
}
registration: Set "FileExtensions" to $GLOBALS Change-Id: Ie52004d25ebc06c81cd7d8d7de60479ff365ccea
2016-11-17 22:36:09 +00:00
},
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
"callback": {
"type": [
"array",
"string"
],
"description": "A function to be called right after MediaWiki processes this file"
},
"config": {
"type": "object",
"description": "Configuration options for this extension",
"properties": {
"_prefix": {
"type": "string",
"default": "wg",
"description": "Prefix to put in front of configuration settings when exporting them to $GLOBALS"
}
},
"patternProperties": {
"^[a-zA-Z_\u007f-\u00ff][a-zA-Z0-9_\u007f-\u00ff]*$": {
"properties": {
"_merge_strategy": {
"type": "string",
"enum": [
"array_merge_recursive",
Added array_replace_recursive merge strategy For extension registry, add array_replace_recursive merge strategy, as some extensions/configuration may prefer that to array_merge_recursive. In some cases, configuration is merged from multiple extensions, such as JsonConfig's $wgJsonConfigs configuration: ZeroBanner defines "JsonZeroConfig": { "namespace": 480, "nsName": "Zero", "isLocal": false, "cacheKey": "1" } and mobile.php overrides it with $wgJsonConfigs['JsonZeroConfig']['isLocal'] = false; $wgJsonConfigs['JsonZeroConfig']['remote'] = [ 'url' => 'https://zero.wikimedia.org/w/api.php', 'username' => $wmgZeroPortalApiUserName, 'password' => $wmgZeroPortalApiPassword, ]; Having identical value 'isLocal' would be converted into an array if array_merge_recursive is used, but the replace strategy fixes it. Change-Id: Ica6ddd0ae76f23e60de9b6235c6e2a3f2754a95d
2016-10-18 05:23:56 +00:00
"array_replace_recursive",
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
"array_plus_2d",
"array_plus",
"array_merge"
],
"default": "array_merge"
}
}
}
}
},
"ParserTestFiles": {
"type": "array",
"description": "Parser test suite files to be run by parserTests.php when no specific filename is passed to it"
},
registration: Support 'ServiceWiringFiles' in extension.json Change-Id: Ib413a14cb8e21207264fa1c45d84550b3eab7a4e
2016-08-26 06:00:28 +00:00
"ServiceWiringFiles": {
"type": "array",
"description": "List of service wiring files to be loaded by the default instance of MediaWikiServices"
},
registration: Convert "config" into an object with metadata To add extra metadata for "config" options without constantly adding hacky underscore prefixed keys, convert "config" items into an object, where the value is under a "value" key. "_merge_strategy" is now just "merge_strategy", but still has the underscore prefix for the cache structure, to avoid changing it. Since this is a fully breaking change, it only applies to files with manifest_version: 2 set. A conversion script has been added to assist with automated conversion. Bug: T133626 Change-Id: Id1071fc0647892438e5cd0e3ee621fbdaaa64014
2016-06-22 22:33:35 +00:00
"load_composer_autoloader": {
"type": "boolean",
"description": "Load the composer autoloader for this extension, if one is present"
}
}
}
Reference in a new issue Copy permalink