Collapsing Links
This is a very simple plugin that uses Javascript to form a collapsable set of links in the sidebar for the links (blogroll). Every link corresponding to a given link category will be expanded.
You can use multiple instances of the widget, each with its own set of options. In this way you could have one set of links for certain categories one place on your page, and another widget with a different set of links somewhere else.
It is based off of the Collapsing Categories and Collapsing Pages plugins.
What’s new?
-
0.4 (2015.08.12)
- Compatible with WP 4.3
-
0.3.5 (2010.06.23)
- Fixed javascript path error
-
0.3.4 (2010.06.18)
- Fixed html validation when target is blank (thanks http://dropdeaddick.com)
-
0.3.3 (2010.01.28)
- Switched from scriptaculous to jquery. No longer conflicts with plugins which use mootools (e.g. featured content gallery)
- Restricted settings page to authorized users
Options
Style options can be set via the settings panel. All other options can be set
from the widget panel. If you wish to insert the code into your theme manually
instead of using a widget, you can use the following options. These options
can be given to the collapsLink() function either as an array or in query
style, in the same manner as the wp_list_links function.
$defaults=array(
'showLinkCount'=> true ,
'catSort'=> 'linkName' ,
'catSortOrder'=> 'ASC' ,
'linkSort'=> 'linkName' ,
'linkSortOrder'=> 'ASC' ,
'inExclude'=> 'exclude' ,
'inExcludeCats'=> '' ,
'expand'=> 0 ,
'customExpand' => '',
'customCollapse' => '',
'defaultExpand'=> '',
'animate' => 0,
'nofollow' => true,
'debug' => false
);
- showLinkCount
- When true, the number of links in the category will be shown in parentheses following the name of the link category
- catSort
- The order in which link categories should be sorted. Possible values:
- ‚catName‘ the name of the link category (default)
- ‚catId‘ the id of the link category
- ‚catSlug‘ the slug of the link category
- ‚catOrder‘ custom order specified in the links options
- ‚catCount‘ the number of links in each category
- The order in which link categories should be sorted. Possible values:
- linkSort
- The order in which link linkegories should be sorted. Possible values:
- ‚linkName‘ the name of the link (default)
- ‚linkId‘ the id of the link
- ‚linkUrl‘ the url of the link
- ‚linkRating‘ the rating assigned to the link
- The order in which link linkegories should be sorted. Possible values:
- catSortOrder
- Whether categories should be sorted in normal or reverse order. Possible
values:
- ‚ASC‘ normal order (a-z, 0-9) (default)
- ‚DESC‘ reverse order (z-a, 9-0)
- Whether categories should be sorted in normal or reverse order. Possible
values:
- linkSortOrder
- Whether link should be sorted in normal or reverse order. Possible values:
- ‚ASC‘ normal order (a-z, 0-9) (default)
- ‚DESC‘ reverse order (z-a, 9-0)
- Whether link should be sorted in normal or reverse order. Possible values:
- inExclude
- Whether to include or exclude certain categories
- ‚exclude‘ (default)
- ‚include‘
- Whether to include or exclude certain categories
- inExcludeCats
- The link categories which should be included or excluded
- expand
- The symbols to be used to mark expanding and collapsing. Possible values:
- ‚0‘ Triangles (default)
- ‚1‘ + –
- ‚2‘ [+] [-]
- ‚3‘ images (you can upload your own if you wish)
- ‚4‘ custom symbols
- The symbols to be used to mark expanding and collapsing. Possible values:
- customExpand
- If you have selected ‚4‘ for the expand option, this character will be used to mark expandable link categories
-
customCollapse
- If you have selected ‚4‘ for the expand option, this character will be used to mark collapsible link categories
-
defaultExpand
- A comma separated list of link category IDs or Slugs which should be expanded by default
- animate
- When set to true, collapsing and expanding will be animated
- nofollow
- When set to true (default), rel=’nofollow‘ tags will be added to links
- debug
- When set to true, extra debugging information will be displayed in the underlying code of your page (but not visible from the browser). Use this option if you are having problems
Examples
collapsLink('animate=true&nofollow=false&expand=3,inExcludeCats=blogroll,lousy-friends')
This will produce a list with: * animation on * no nofollow tags * using images to mark collapsing and expanding * exclude links in the categories blogroll and lousy-friends
Demo
You can see this on my test blog at http://robfelty.com/test
CAVEAT
Currently this plugin relies on Javascript to expand and collapse the links. If a user’s browser doesn’t support javascript they won’t see the links to the posts, but the links to the links will still work (which is the default behavior in wordpress anyways)
The option to show the number of links currently uses the number stored in the database, which includes both visible and invisible links. If you have invisible links, this number will be wrong.