Favicon List 1.1

Favicon List is an implementation of Khoi Vinh’s Favicon Link List concept on his blog, Subtraction. Supposedly, Khoi was planning on using the favicon concept for something at work that never materialised. A ton of people on his blog ended up liking the idea, so I spent my lunch hour developing the concept into a WordPress plugin.

Installing Favicon List

Favicon List is just like any other plugin — download the ZIP file and place faviconlist.php into wp-content/plugins/ for the proper WordPress directory. Once you’ve got it there, activate it from the Plugins menu in your WordPress installation. You’re not going to see any difference in your theme just by installing it, and it shouldn’t break anything during activation. (Well, hopefully it doesn’t break anything at all.)

Using Favicon List

Favicon List adds a template tag to the WordPress templating language (for more information on template tags, see the WordPress Codex.) Instead of calling a common function to display links such as get_links, you can now call get_faviconlist to retrieve a set of favicons from those on your link list. Syntax for get_faviconlist is as follows:

get_faviconlist( cat_id, imgclass, liclass, makeul, ulclass )

• cat_id is the Category ID of whatever category of links you want to display. Setting cat_id to -1 will display all links in your WordPress links database. (This defaults to -1.)
• imgclass is an optional parameter that allows you to set a CSS class attribute on the img tag used to display the favicon.
• liclass is an optional parameter that allows you to set a CSS class attribute on the li parent that encapsulates the list item data (favicon, link name).
• makeul is an optional boolean (true, false) value that allows the user to choose whether to wrap all li in an unordered list (ul) or not.
• liclass is an optional parameter that allows you to set a CSS class attribute on the ul that encapsulates the list. This only works if makeul is true.

Some examples are included in the packaged documentation. A copy of this documentation is available in the hyalineskies repository.