Template:Wikipedia ads/doc
 | This is a documentation subpage for Template:Wikipedia ads. It may contain usage information, categories and other content that is not part of the original template page. |
 | This template is used on approximately 3,700 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
 | This template uses Lua: |
This template displays web banner-style advertisements, almost all of which are animated, for various Wikipedia maintenance collaborations, WikiProjects, policies, guidelines, processes and practices, such as barnstars, featured articles and edit summaries. The ads rotate at random each time the page is changed, and can be cycled manually by clicking the "show another" button in the bottom-right corner of the box. Clicking on the ad will take you to a relevant page; to view the image description page, click the "file info" link.
To include the ad box on your userpage or talk page, simply edit your page and add {{Wikipedia ads}} in the appropriate place. This will produce something like the following:
 | |
| Wikipedia ads | file info – #174 |
Parameters
[edit]By default, the template will show ads taken at random from the entire collection. The following parameters are supported:
| Parameter and Value | Description |
|---|---|
1=ad number, 2=ad number...
|
Rotate at random through only the ads specified. E.g. if you want to rotate ads 1, 2, 10 and 50, use the code {{Wikipedia ads|1|2|10|50}}. |
ad=ad number
|
Display only the specified ad. |
linkcolor=color
|
Change the color of the links. |
color=color
|
Change the color of the text. |
background=color
|
Change the background color; by default the template has a transparent background. |
float=position
|
Float the ads alongside any text that follows, e.g. float=right. |
margin=CSS value
|
A custom CSS margin. Defaults to "0 auto" if the float parameter is not set. |
showpurge=yes
|
Show the purge link (the link with the display text "show another") even if only one ad will be output. This is normally not necessary, but can be useful for hacks using the |ad= parameter.
|
nolinks=yes
|
Hide the links at the bottom of the template. Please try to avoid this, as the "file info" link is the only way to see the licensing and authorship information for the image (normally, this can be done simply by clicking the image). |
width=width
|
Changes the width of the ads. Please keep in mind that significant changes from the default will result in either unreadable ads, or poor quality images since the images will be rescaled by the browser. |
Hiding the ads
[edit]If you do not wish to see these ads, you may hide them by adding the following code to your common.css file:
.qxz-ads { display: none !important; }
Current ads
[edit]This template was conceived and implemented by Gurch and later rewritten by Svick. The images were created by many different users, as detailed below. (Individual images may have been edited by more than one user.)
If you would like an ad to be created for a particular page or project, one of the users listed below may wish to create it for you.
Bear in mind that there are already dozens of ads in use; if the project you wish to promote already has one, feel free to suggest improvements or make your own replacement, but try to stick to one ad per project.
Click the [show] button in the box below to expand the list of all ads.
Creating ads
[edit]If you wish to create ads yourself, you are welcome to do so. Several guides such as User:Cheong Kok Chun/How to create ads for Mac OS X users, User:Miranda/96:FEW#How do you make those ads.3F for Windows, and User:Urban Versis 32/Hot Tips#Wikipedia Ads on Linux (And Windows) for any system that supports GIMP have been made to assist creators. To ensure that the template works properly and all ads are uniform, however, please set the dimensions of the said image to be 468 pixels wide by 60 high.
Additionally, the following requirements must be met to ensure copyright and Wikipedia's image use policy are not violated:
- If the image includes other images (a derivative work), it must only include images under a free license or in the public domain.
- The image itself must be released under a free license or into the public domain.
- Some free licenses specify that derivative works must also use that license (for example, Creative Commons Attribution Share-Alike 2.0). If an ad contains images under such a license, the ad itself must also be released under that license.
- Non-free images cannot be used.
The image may be uploaded locally or to Commons, but in either case the local image description page should exist and contain {{Wikipedia-adnavbox}}.
Bear in mind when creating animations that they can have large file sizes, and many contributors do not access Wikipedia through a high-speed connection. Try to keep each image to no more than a few hundred kilobytes in size.
Adding and removing ads
[edit]To add and remove ads, please see the instructions at Module:Wikipedia ads/list.
Errors
[edit]Errors are tracked using the Category:Wikipedia ads templates with errors category.
ID '123' does not exist
[edit]- Wikipedia ads error: ID '123' does not exist (help).
There are two likely causes for this error. The first is a misspelling of the ad ID. Check the list of current ads to see if you have typed in the ad ID correctly. The second is that the ID is for a previously existing banner that has been removed from Module:Wikipedia ads/list. Ads are sometimes removed for projects that have become defunct or are otherwise no longer relevant. Check the ad list history to see if this is the case. Usually in this case it is best to remove the ad ID from your Wikipedia ads template, but if you think the ad was removed from the ad list in error you can start a discussion about it at Template talk:Wikipedia ads.
TemplateData
[edit]TemplateData for Wikipedia ads
Advertisements for all sorts of Wikipedia collaborations and policies.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| 1 | 1 | Number of a rotated ad. | Number | optional |
| 2 | 2 | Number of a rotated ad. | Number | optional |
| 3 | 3 | Number of a rotated ad. | Number | optional |
| 4 | 4 | Number of a rotated ad. | Number | optional |
| 5 | 5 | Number of a rotated ad. Subsequent ads can be added with parameters 6, 7, 8, etc. | Number | optional |
| ad | ad | Display the specified ad only.
| Number | optional |
| Link color | linkcolor | Color of the links.
| String | optional |
| color | color | Color of the text.
| String | optional |
| background | background | Background color. | String | optional |
| float | float | Position of the template. Can be "left", "right" or "both". | String | optional |
| margin | margin | A custom CSS margin for the template. Default to "0 auto" if the float parameter is not set.
| String | optional |
| No links | nolinks | Hide all links. Not recommended due to licensing issues. | String | optional |
| Show purge link | showpurge | Display a "show another" link even if only one ad can be shown. | String | optional |
See also
[edit]- {{Wikipedia ads/gallery}}
- {{Promotional}} – article cleanup message for promotional tone in content articles
- Template:Wikipedia ads generic – collects the generic ads like Be Bold (i.e. excluding the many regional and specialist WikiProject ads) for use as a parameter for {{Wikipedia ads}}
- Wikipedia:Banners and buttons