Diep.io Wiki
Register
Advertisement
Diep.io Wiki

Request or submit gadgets here! This page offers an explanation on Gadgets, and how our Wiki uses them.

What gadgets are
Gadgets are custom-built extensions that, when enabled, change the way the Wiki works or looks in some fashion.
How gadgets work
After gadgets have been enabled on a Wiki, scripts and/or stylesheets can be drafted by Local Administrators which serve a certain function or purpose. These scripts and stylesheets, collectively dependencies, along with a MediaWiki-stored description, make up a given gadget. The dependencies are what the gadget needs to work, to change the way this Wikia functions or looks in some fashion, while the description, naturally, describes what a specific gadget is meant to do.
How to use gadgets
Once created, a gadget can be enabled or disabled via Special:Preferences, under the Gadgets Tab. The interface includes a brief explanation and warning about gadgets, then there is a list of gadgets on this Wikia that can be enabled, ordered into sections depending on what it is that a given gadget affects. The Aesthetic Gadgets section for example, lists gadgets that primarily change the way this Wikia looks in some fashion, and usually has gadgets that rely solely upon stylesheet dependencies to function.

How you can help[]

Only Administrators have access to MediaWiki, so while only Admins can make the improvements or corrections, normal users can recommend gadgets, write code, suggest improvements to existing gadgets, and much more all from the associated talk pages of each gadget. Bug reports are especially helpful, even if you have no knowledge of CSS or JS yourself.

Improving dependency files
Dependency files are either JS scripts or CSS stylesheets, so a knowledge of either would be necessary to help in this area. Using <syntaxhighlight> to submit code snippets on associated talk pages is always appreciated, and it shows great potential as a future Administrator. Dependency files may be located via Special:Gadgets, and their talk pages can be located via Category:Gadget-Dependency-Talk.
Improving gadget descriptions
Gadget descriptions are short summaries of what a gadget does specifically. If you would like to suggest changes to a given description, you can find the description’s talk page via the description itself or via Category:Gadget-Description-Talk where the suggestion may be posted.
Improving gadget messages

Several MediaWiki messages have been customized to provide warnings and general information about gadgets in areas where they would be used, namely in Special:Preferences and Special:Gadgets. If anyone has any suggestions to improve these messages, using the talk pages of a given message to make suggestions is strongly encouraged.

List of MessagesList of Message Talk Pages

Dependency files
Dependency files always end in either .css or .js. The dependency for a specific gadget can be located via Special:Gadgets. The associated talk pages are also categorized in Category:Gadget-Dependency-Talk, and can be located that way too.
Description pages
The description for a specific gadget can be located via Special:Gadgets and Special:Preferences, as the very first link in the description. Descriptions are also categorized in Category:Gadget Descriptions.
Default gadget messages
All messages associated with gadgets can be located at Special:AllMessages by querying for the Gadgets- prefix, which includes links to message talk pages to suggest improvements.

Requesting new gadgets

If you don’t know CSS or JS, no need to fear! If you have a really cool idea for a gadget that you’d like to have, you can use this talk page to make your request. When you do, be sure to do the following things:

  1. Title your request with a header.
  2. List whether your gadget would require CSS, JS, or both.
  3. List what skins it should work on (Monobook, Oasis, or both).
  4. List what user rights, if any, should be required to use this gadget.
  5. List whether this gadget should be enabled by default for all users or not.
  6. Describe in great detail exactly what you want it to do.
  7. Sign your post with four tildes (~~~~).

An example request should look like this:

Old Diep Theme Gadget Request

  • Requires CSS only.
  • Works on the Oasis (default) skin only.
  • No user rights should be required.
  • Should not be enabled by default.
  • I want this gadget to be able to recreate what the Diep.io Wiki used to look like in 2016, the dark blue and grey color with the old wordmark too.
 Ursuul  Talk  Wall  Date  9:26 AM Friday, August 18, 2017 (UTC) 
Submitting new gadgets

Think you’ve got the technical skill necessary to make gadgets? Here’s how you submit yours to be created sitewide:

  1. Title your submission with a header.
  2. List what skins it should work on (Monobook, Oasis, or both).
  3. List what user rights, if any, should be required to use this gadget.
  4. List whether this gadget should be enabled by default for all users or not.
  5. Describe what your gadget is intended to do.
  6. Post the CSS and/or JS under an <h3>, wrapped in <syntaxhighlight> or <pre> Tags.
  7. Sign your post with four tildes (~~~~).

An example submission should look like this:

Emberfall Gadget Submission

  • Requires JavaScript only.
  • Works on the Oasis (default) skin only.
  • No user rights should be required.
  • Should not be enabled by default.
  • I made this gadget to recreate the “Emberfall” effect on the old Diep.io Conception Wikia, which looked like falling embers.

JS

window.snowColor = '#F05E1B';
window.flakesMax = 40;
window.flakesMaxActive = 20;
window.animationInterval = 60;
window.className = 'emberfall';
window.followMouse = false;
window.snowStick = false;
window.useTwinkleEffect = true;
window.freezeOnBlur = false;
window.flakeLeftOffset = 0;
window.flakeWidth = 6;
window.flakeHeight = 6;
window.vMaxX = 1;
window.vMaxY = 1;

importArticles({
    type: 'script',
    articles: [
        'u:dev:SnowStorm.js'
    ]
});
 Ursuul  Talk  Wall  Date  9:26 AM Friday, August 18, 2017 (UTC) 

Gadget Sections
  • Aesthetic Gadgets — Changes the way the Wiki appears.
  • Restricted Gadgets — Only usable by users with certain User-Rights.
Enabled by default vs disabled by default
Most, if not all gadgets will be set to disabled by default. Partly because these are designed to be optional extensions, and partly because we can already use existing infrastructure to serve code to all users. The only time a gadget would be enabled by default, was if it was stable enough and useful enough to merit sitewide use, while also unimportant enough to allow users to opt-out of the gadget. Such events will be quite rare.
Skin-specific gadgets
Some gadgets only work on certain skins, namely the Monobook skin or the default Oasis skin. Most CSS-based gadgets will only work on Oasis, while most JavaScript gadgets will work on all skins. Very few gadgets will ever be Monobook-exclusive due to low amount of traffic it receives.
User-Group-specific gadgets
Some gadgets are made primarily with the Diep.io Wiki Staff in mind, and so normal users will not be able to enable it. This is often done due to the perceived power a certain gadget could have, and thus necessitates restricting it.

See also[]

Advertisement