wikimedia/mediawiki-extensions-Gadgets
1
0
Fork 0
mirror of https://gerrit.wikimedia.org/r/mediawiki/extensions/Gadgets synced 2024-11-14 19:14:45 +00:00
Code Issues Packages Projects Releases Wiki Activity
mediawiki-extensions-Gadgets/includes/Content/schema.json

92 lines
2.2 KiB
JSON
Raw Normal View History

Implement Gadgets definition namespace repo Implements: * Gadget definition content and content handler * Basic validation for gadget definition content * GadgetDefinitionNamespace implementation of GadgetRepo * DataUpdates upon editing/deletion of Gadget definition pages * EditFilterMerged hook for improved error messages * 'GadgetsRepoClass' option to switch GadgetRepo implementation used * Lazy-load the GadgetResourceLoaderModule class so we don't need to load each individual gadget object unless its needed Note that Special:Gadgets's export feature intentionally doesn't work yet, and will be fixed in a follow up patch. Bug: T106177 Change-Id: Ib11db5fb0f7b46793bfa956cf1367f1dc1059b1c
2015-08-03 06:37:32 +00:00
{
"$schema": "http://json-schema.org/schema#",
"description": "Gadget definition schema",
"type": "object",
"additionalProperties": false,
"properties": {
"settings": {
"type": "object",
"additionalProperties": false,
"properties": {
"rights": {
"description": "The rights required to be able to enable/load this gadget",
"type": "array",
"items": {
"type": "string"
}
},
"default": {
"description": "Whether this gadget is enabled by default",
"type": "boolean",
"default": false
},
Support JSON files in gadgets The parsed content of JSON files in the gadget is made available from the gadget's JS files via require(). That is, MediaWiki:Gadget-data.json (or Gadget:data.json) is available as `require('./data.json')`. This is supported for both MediaWikiGadgetsDefinitionRepo and GadgetDefinitionNamespaceRepo. The JSON parsing is done server-side. JSON can only be used in "package" gadgets - in which the JS files can also be invoked via require(). Also added a test for GadgetResourceLoaderModule. Bug: T198758 Depends-On: Ib4556d09c4d393269e32771aab00f59a5f630e1b Depends-On: Id4589a597ccfc4266b3e63d10f75b146aa7a287a Change-Id: I21acb46cdd244a39b5cc6963aa763f0113bd1e38
2021-10-17 13:05:15 +00:00
"package": {
"description": "Whether this is gadget a packaged ResourceLoader module",
"type": "boolean",
"default": false
},
Implement Gadgets definition namespace repo Implements: * Gadget definition content and content handler * Basic validation for gadget definition content * GadgetDefinitionNamespace implementation of GadgetRepo * DataUpdates upon editing/deletion of Gadget definition pages * EditFilterMerged hook for improved error messages * 'GadgetsRepoClass' option to switch GadgetRepo implementation used * Lazy-load the GadgetResourceLoaderModule class so we don't need to load each individual gadget object unless its needed Note that Special:Gadgets's export feature intentionally doesn't work yet, and will be fixed in a follow up patch. Bug: T106177 Change-Id: Ib11db5fb0f7b46793bfa956cf1367f1dc1059b1c
2015-08-03 06:37:32 +00:00
"hidden": {
"description": "Whether this gadget is hidden from preferences",
"type": "boolean",
"default": false
},
"skins": {
"description": "Skins supported by this gadget; empty or true if all skins are supported",
"type": [ "array", "boolean" ],
"items": {
"type": "string"
}
},
Allow specifying page actions in definitions Allow specifying page actions ('view', 'edit', 'history', etc) in gadget definitions. If specified, the gadget is run only on the given page action(s). This is especially useful for default gadgets like RefToolbar[1] and TextReactions[2] that only need to be loaded while editing. [1]: https://en.wikipedia.org/wiki/WP:RefToolbar [2]: https://en.wikipedia.org/wiki/WP:Text_reactions Bug: T204201 Bug: T63007 Change-Id: Idde71b3f1f6c36cd21539a2312be8f12217a9acc
2021-12-14 13:10:22 +00:00
"actions": {
"description": "Page actions on which the gadget is supported",
"type": "array",
"items": {
"type": "string"
}
},
Implement Gadgets definition namespace repo Implements: * Gadget definition content and content handler * Basic validation for gadget definition content * GadgetDefinitionNamespace implementation of GadgetRepo * DataUpdates upon editing/deletion of Gadget definition pages * EditFilterMerged hook for improved error messages * 'GadgetsRepoClass' option to switch GadgetRepo implementation used * Lazy-load the GadgetResourceLoaderModule class so we don't need to load each individual gadget object unless its needed Note that Special:Gadgets's export feature intentionally doesn't work yet, and will be fixed in a follow up patch. Bug: T106177 Change-Id: Ib11db5fb0f7b46793bfa956cf1367f1dc1059b1c
2015-08-03 06:37:32 +00:00
"category": {
"description": "Key of the category this gadget belongs to",
"type": "string",
"default": ""
Restrict ?withgadget query parameter to opt-in gadgets. ?withgadget query parameters allows for ad-hoc loading of gadgets (after passing all other basic checks). This was recently added in I5b30d4e. In T29766#7611796 Gergo raised concerns about how this can be potentially abused. This patch aims to restrict the feature by giving gadgets latitude to either use it or not depending on the nature of the gadget. The patch does so by adding `supportsUrlLoad` option that gadgets (maybe those deemed safe) can use it to opt-in to the parameter. By default gadgets don't support it, so it can be enabled for each on a case-by-case basis. Bug: T29766 Change-Id: Ie64174085e650579d76cc862774a4fe1b3d08396
2022-01-11 09:03:44 +00:00
},
"supportsdirectload": {
"description": "Whether this gadget supports ?withgadget query parameter",
"type": "boolean",
"default": false
Add support for ES6 gadgets, but with validation disabled Gadgets can mark themselves as ES6-only by specifying the requiresES6 boolean attribute. Syntax validation is disabled for them (as the validator doesn't support ES6 yet), and they are loaded together in a separate request. The minifier doesn't reject syntax errors, and thus these would be passed through to web clients. Hence, communities using this feature are encouraged to use ESLint or another linter to make sure only valid ES <= 6 code is being used. Because of the above, this feature is only made available for non-default gadgets. Bug: T75714 Change-Id: Ib98ac0700471554d5721d7ab858d4660e1e0e980
2022-01-30 13:15:25 +00:00
},
"requiresES6": {
"description": "Whether this gadget requires ES6",
"type": "boolean",
"default": false
Implement Gadgets definition namespace repo Implements: * Gadget definition content and content handler * Basic validation for gadget definition content * GadgetDefinitionNamespace implementation of GadgetRepo * DataUpdates upon editing/deletion of Gadget definition pages * EditFilterMerged hook for improved error messages * 'GadgetsRepoClass' option to switch GadgetRepo implementation used * Lazy-load the GadgetResourceLoaderModule class so we don't need to load each individual gadget object unless its needed Note that Special:Gadgets's export feature intentionally doesn't work yet, and will be fixed in a follow up patch. Bug: T106177 Change-Id: Ib11db5fb0f7b46793bfa956cf1367f1dc1059b1c
2015-08-03 06:37:32 +00:00
}
}
},
"module": {
"type": "object",
"additionalProperties": false,
"properties": {
"scripts": {
"type": "array",
"description": "List of JavaScript pages included in this gadget"
},
"styles": {
"type": "array",
"description": "List of CSS pages included in this gadget"
},
Support JSON files in gadgets The parsed content of JSON files in the gadget is made available from the gadget's JS files via require(). That is, MediaWiki:Gadget-data.json (or Gadget:data.json) is available as `require('./data.json')`. This is supported for both MediaWikiGadgetsDefinitionRepo and GadgetDefinitionNamespaceRepo. The JSON parsing is done server-side. JSON can only be used in "package" gadgets - in which the JS files can also be invoked via require(). Also added a test for GadgetResourceLoaderModule. Bug: T198758 Depends-On: Ib4556d09c4d393269e32771aab00f59a5f630e1b Depends-On: Id4589a597ccfc4266b3e63d10f75b146aa7a287a Change-Id: I21acb46cdd244a39b5cc6963aa763f0113bd1e38
2021-10-17 13:05:15 +00:00
"datas": {
"type": "array",
"description": "List of JSON pages included in this gadget"
},
Implement Gadgets definition namespace repo Implements: * Gadget definition content and content handler * Basic validation for gadget definition content * GadgetDefinitionNamespace implementation of GadgetRepo * DataUpdates upon editing/deletion of Gadget definition pages * EditFilterMerged hook for improved error messages * 'GadgetsRepoClass' option to switch GadgetRepo implementation used * Lazy-load the GadgetResourceLoaderModule class so we don't need to load each individual gadget object unless its needed Note that Special:Gadgets's export feature intentionally doesn't work yet, and will be fixed in a follow up patch. Bug: T106177 Change-Id: Ib11db5fb0f7b46793bfa956cf1367f1dc1059b1c
2015-08-03 06:37:32 +00:00
"dependencies": {
"type": "array",
"description": "ResourceLoader modules this gadget depends upon"
},
"messages": {
"type": "array",
"description": "Messages this gadget depends upon"
}
}
}
}
}
Reference in a new issue Copy permalink