mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/PageImages
synced 2024-11-15 20:09:54 +00:00
a8c7cbc870
It's useful for API consumers to have the dimensions of the original image so that they know the bounds within which they can safely rewrite the thumb URL (bearing in mind the prerendered widths[1], in the case of WMF wiki consumers). This change adds an 'original' property to the page object, containing the original image source URL along with its width and height, when original image info is requested. A warning is added when original image info is requested, noting the format change and warning the consumer that the original image URL will no longer be provided within the 'thumbnail' property in a future release. [1] https://github.com/wikimedia/operations-mediawiki-config/blob/master/wmf-config/InitialiseSettings.php#L17535 Bug: T152163 Change-Id: I9d937f73a974dfb099b93552405531464b8ad3ae
18 lines
1.3 KiB
JSON
18 lines
1.3 KiB
JSON
{
|
|
"@metadata": {
|
|
"authors": []
|
|
},
|
|
"pageimages-desc": "Collects information about images used on page",
|
|
"pageimages-blacklist": "",
|
|
"pageimages-info-label": "Page image",
|
|
"apihelp-query+pageimages-description": "Returns information about images on the page, such as thumbnail and presence of photos.",
|
|
"apihelp-query+pageimages-example-1": "Get name and <kbd>100</kbd>-pixel thumbnail of an image on the <kbd>Albert Einstein</kbd> page.",
|
|
"apihelp-query+pageimages-param-prop": "Which information to return:\n;thumbnail:URL and dimensions of thumbnail image associated with page, if any.\n;original:URL and original dimensions of image associated with page, if any.\n;name:Image title.",
|
|
"apihelp-query+pageimages-param-thumbsize": "Maximum thumbnail dimension.",
|
|
"apihelp-query+pageimages-param-limit": "Properties of how many pages to return.",
|
|
"apihelp-query+pageimages-param-license": "Limit page images to a certain license type",
|
|
"apihelp-query+pageimages-paramvalue-license-free": "only free images",
|
|
"apihelp-query+pageimages-paramvalue-license-any": "best image, whether free or non-free.",
|
|
"apiwarn-query+pageimages-original-in-thumbnail-deprecated": "The original image's source URL is now provided with its dimensions in its own property for the page object. It will be removed from the 'thumbnail' property in a future release."
|
|
}
|