Help:RotateLink
 | This is the documentation for RotateLink, a JavaScript gadget which can be enabled or disabled in your Preferences. The script itself is located at MediaWiki:Gadget-RotateLink.js. |
 | If you need more help, please ask at the discussion page or at Commons:Help desk. Documentation: |
Pop-up: the parameter setting window of the script after clicking the “request rotation” link.
The RotateLink is a gadget to add a link “request rotation” to file pages. It can be used to easily request rotation of an image which is in the wrong orientation (further info: Commons:Rotation). The link appears on the line just below the image, and looks like this: (
request rotation).
Most rotations will be done losslessly by Rotatebot within a couple of hours.
Details edit
Why a script/link? Most people and especially newcomers don't know that we have a bot for this. They often use lossy Windows JPEG rotation which results in wrong EXIF tags and a loss of quality. Note that even “lossless” jpegtran rotation can be slightly lossy (depends on the image's dimensions; at maximum 16 pixels are cropped at borders) but no new compression artifacts are created.
This gadget offers a simple interface for adding {{Rotate}} to the image description page. It doesn't slow down (notably) loading of file pages since the heavy code is loaded only on clicking the link.
The dialog pop-up window remembers the last used degree value (using a cookie, which expires after 14 days).
The pop-up will display a thumbnail which should be used to orient the image correctly. It is cared for that this thumbnail is a freshly produced one by automatically purging the file and by using an unusual image size. The purge may have the effect that (in case of wrong EXIF orientation) suddenly all thumbnail sizes will show up wrong if before only some were wrong.
Switching off and customization edit
The gadget is enabled by default for all logged-in users but can be easily disabled in the user's settings by one click (remove the checkmark ☑ in front of “RotateLink”) if someone does not like it.
To have this gadget on pages of a specific file type only use the option window.rotateFileTypes. Example to enable the gadget only on jpeg file pages:
window.rotateFileTypes = ['jpg', 'jpeg'];
Add this line to your common.js.
If you uploaded files recently and don't like to wait until the server is purged (is not needed for uploads after 5 October 2011), thus speeding up the dialog, add
window.rotateDontPurge = true;
to your common.js.
Code edit
- MediaWiki:Gadget-RotateLink.js – the link on file pages below the image
- MediaWiki:RotateRequest.js – the script itself / pop-up.
Attribution edit
Some pre-existing code/icons are used. We thank their authors for creating and sharing!
- MediaWiki:RotateRequest.js uses the jQuery Rotate plugin by Wilq32 which is MIT licensed.
- The user interface of this gadget uses some icons for easier accessibility:
- In MediaWiki:Gadget-RotateLink.js:
- In MediaWiki:RotateRequest.js:
- File:GeoGebra icon help.png: by Markus Hohenwarter, Michael Borcherds. CC-BY-SA-3.0
- File:Picframe ok.png: by AdmeLERT. LGPL; Is a derivative of File:Crystal Project success.png and File:Picframe.svg by Seahen
- File:Crystal error.png: by Everaldo Coelho (everaldo). LGPL
- File:Bert2 transp 5B5B5B cont 150ms.gif: by ajaxload.info (Code: Yannick Croissant, Design: Kath) and Saibo. PD-ineligible
Contact Persons edit
- For the request link and the user interface: Rillke
- For the rotation and template removal: Rotatebot (Steinsplitter, Luxo)