get_bookmarks

BOOKMARK TAG

What It Does

Displays the bookmarks specified in the admin panel at Administration > Blogroll > Manage Blogroll.

Code

<?php get_bookmarks(‘parameters’); ?>

The available parameters are as follows:

orderby

Allows you to specify in which order the bookmarks will be displayed.

  • name (default value)
  • id
  • url
  • target
  • description
  • owner
  • rating
  • updated
  • rel
  • notes
  • rss
  • length
  • rand

order

Allows you to specify which order the bookmarks will be displayed as specified in the “orderby” parameter.

  • ASC – Ascending (default value)
  • DESC – Descending

limit

The maximum number of bookmarks to be displayed. -1 is used by default which is no limit (display all).

category

Allows you to specify which categories to be displayed by their numerical ID, seperated by commas. If no categories are specified, all the bookmarks are displayed.

category_name

Similar to “category”, only this allows you to specify a specific category to include by its name.

hide_invisible

Allows you to specify whether or not to display bookmarks whose visible setting is set to “No”.

  • 1 – True (default value)
  • 0 – False

show_updated

Allows you to specify whether or not to display the last updated timestamp.

  • 1 – True
  • 0 – False (default value)

include

Allows you to specify which bookmarks to include specified by their numerical ID seperated by a comma. “category”, “category_name” and “exclude” are all ignored if this parameter is used. By default, all bookmarks are included.

exclude

Allows you to specify which bookmarks to exclude specified by their numerical ID seperated by a comma.

Example

The following example will display a list of no more than 5 bookmarks in descending order.

<?php wp_list_bookmarks(‘order=desc&limit=5′); ?>