FANDOM


CategoryIcon adds icons to links on category page, where image name = link target. Added images has class "cicon-image" by default.

Settings

Available through window.fng.cicon:

option - defaults - acceptable values
description
debug - false - true/false
some info spammed to console
restrict - true - true/false
run the script only in category: namespace
ext - .png - string
image format (extension)
cls - cicon-image - string
image class, for styling purposes
scale - /scale-to-width-down/50 - string
add scaling request to image path (reduces bandwith usage); last part (50) - size in pixels; use scale="" to disable
iprepend - "" - string
prepend text to image name; result: string+name+ext
iappend - "" - string
append text to image name; result: name+string+ext
tprepend - "" - string
prepend text (span with class "cicon-prepend") to image tag; result: string<img ...>
tappend - "" - string
append text (span with class "cicon-append") to image tag; result: <img ...>string

Example

//create settings object
window.fng = $.extend(window.fng, {cicon:{}});
//set file extension to .svg
window.fng.cicon.ext = '.svg';
//append 'Map ' to all filenames ('Map Earth' etc)
window.fng.cicon.iprepend = 'Map ';
//request downscaling to 50px
window.fng.cicon.scale = '/scale-to-width-down/50';

With settings above the script searches files named "Map link.svg", where "link" is link text, then adds them to links.

Notes

  • Double redirects will not resolved.
  • Image and text are not styled by default. Use classes above to add styling.
  • Settings supposed to be somewhere in common/wikia.js. Script itself - in ImportJS.

Installation

Add this on your wiki:

Global Site-wide
w:Special:Mypage/global.js MediaWiki:Common.js
importArticles({
    type: "script",
    articles: [
        "u:dev:CategoryIcon/code.js"
    ]
});

Add this to Mediawiki:ImportJS:

  dev:CategoryIcon/code.js
importArticles — Best Practices for installing JavaScript on FANDOM
The importArticles statement is designed to combine multiple HTTP requests into a single data transfer, allowing multiple scripts to load and execute faster. If you've been installing several different scripts, your JavaScript file has probably accumulated unnecessary import statements. Click "Expand" to learn how to efficiently batch import scripts to speed up performance and make your code look cleaner. One other approach is by using the MediaWiki:ImportJS.
If your JavaScript file has several lines of code that say importScript, importScriptPage, or importArticles, you may be able to combine them! By batch importing a collection of scripts with a single import, your JavaScript code will load faster and look cleaner. Consider the example below. On the left is an example of what your JavaScript file might currently look like. On the right is how you could improve that code.
Multiple imports — messy and slow One import — clean and efficient
importScriptPage('AjaxRC/code.js','dev');
 
importScript('MediaWiki:localScript.js');
 
importArticle({
  type: 'script',
  article: 'u:dev:FloatingToc/code.js'
});
 
importScriptPage('page1.js', 'wikiname');
 
importScriptPage('page2.js', 'wikiname');
importArticles({
    type: 'script',
    articles: [
        'u:dev:AjaxRC/code.js',
        'MediaWiki:localScript.js',
        'u:dev:FloatingToc/code.js',
        'u:wikiname:page1.js',
        'u:wikiname:page2.js'
    ]
});
Note: In this example, pay close attention to the placement of commas and other punctuation. For people who aren't familiar with programming (and even those who are!), a common mistake when writing code is to accidentally delete, forget, or misplace critical symbols like commas or quotation marks. This can cause a syntax error that breaks the code. Carefully follow the convention shown here when using importArticles.
But there's much more to importArticles than just this! For more examples and advanced usage, see the help page at Help:Including additional JavaScript and CSS.


Ad blocker interference detected!


Wikia is a free-to-use site that makes money from advertising. We have a modified experience for viewers using ad blockers

Wikia is not accessible if you’ve made further modifications. Remove the custom ad blocker rule(s) and the page will load as expected.