/**
 * Gets an array of link objects associated with category $cat_name.
 *
 * <code>
 *	$links = get_linkobjectsbyname('fred');
 *	foreach ($links as $link) {
 * 		echo '<li>'.$link->link_name.'</li>';
 *	}
 * </code>
 *
 * @since 1.0.1
 * @deprecated 2.1
 * @deprecated Use get_bookmarks()
 * @see get_bookmarks()
 *
 * @param string $cat_name The category name to use. If no match is found uses all.
 * @param string $orderby The order to output the links. E.g. 'id', 'name', 'url', 'description', or 'rating'.
 *		Or maybe owner. If you start the name with an underscore the order will be reversed. You can also
 *		specify 'rand' as the order which will return links in a random order.
 * @param int $limit Limit to X entries. If not specified, all entries are shown.
 * @return unknown
 */
function get_linkobjectsbyname($cat_name = "noname", $orderby = 'name', $limit = -1)
{
    _deprecated_function(__FUNCTION__, '2.1', 'get_bookmarks()');
    $cat_id = -1;
    $cat = get_term_by('name', $cat_name, 'link_category');
    if ($cat) {
        $cat_id = $cat->term_id;
    }
    return get_linkobjects($cat_id, $orderby, $limit);
}

/** function get_linkobjectsbyname()
 ** Gets an array of link objects associated with category 'cat_name'.
 ** Parameters:
 **   cat_name (default 'noname')  - The category name to use. If no
 **     match is found uses all
 **   orderby (default 'id') - the order to output the links. E.g. 'id', 'name',
 **     'url', 'description', or 'rating'. Or maybe owner. If you start the
 **     name with an underscore the order will be reversed.
 **     You can also specify 'rand' as the order which will return links in a
 **     random order.
 **   limit (default -1) - Limit to X entries. If not specified, all entries
 **     are shown.
 **
 ** Use this like:
 ** $links = get_linkobjectsbyname('fred');
 ** foreach ($links as $link) {
 **   echo '<li>'.$link->link_name.'</li>';
 ** }
 **/
function get_linkobjectsbyname($cat_name = "noname", $orderby = 'name', $limit = -1)
{
    global $wpdb;
    $cat_id = -1;
    $results = $wpdb->get_results("SELECT cat_id FROM {$wpdb->linkcategories} WHERE cat_name='{$cat_name}'");
    if ($results) {
        foreach ($results as $result) {
            $cat_id = $result->cat_id;
        }
    }
    return get_linkobjects($cat_id, $orderby, $limit);
}

 /** function get_linkobjectsbyname()
  ** Gets an array of link objects associated with category 'cat_name'.
  ** Parameters:
  **   cat_name (default 'noname')  - The category name to use. If no
  **     match is found uses all
  **   orderby (default 'id') - the order to output the links. E.g. 'id', 'name',
  **     'url', 'description', or 'rating'. Or maybe owner. If you start the
  **     name with an underscore the order will be reversed.
  **     You can also specify 'rand' as the order which will return links in a
  **     random order.
  **   limit (default -1) - Limit to X entries. If not specified, all entries
  **     are shown.
  **
  ** Use this like:
  ** $links = get_linkobjectsbyname('fred');
  ** foreach ($links as $link) {
  **   echo '<li>'.stripslashes($link->link_name).'</li>';
  ** }
  **/
 function get_linkobjectsbyname($cat_name = "noname", $orderby = 'name', $limit = -1)
 {
     $cat_id = -1;
     $results = $GLOBALS['wpdb']->get_results("SELECT cat_id FROM " . wp_table('linkcategories') . " WHERE cat_name='{$cat_name}'");
     if ($results) {
         foreach ($results as $result) {
             $cat_id = $result->cat_id;
         }
     }
     return get_linkobjects($cat_id, $orderby, $limit);
 }

/** function get_linkobjectsbyname()
 ** Gets an array of link objects associated with category 'cat_name'.
 ** Parameters:
 **   cat_name (default 'noname')  - The category name to use. If no
 **     match is found uses all
 **   orderby (default 'id') - the order to output the links. E.g. 'id', 'name',
 **     'url', 'description', or 'rating'. Or maybe owner. If you start the
 **     name with an underscore the order will be reversed.
 **     You can also specify 'rand' as the order which will return links in a
 **     random order.
 **   limit (default -1) - Limit to X entries. If not specified, all entries
 **     are shown.
 **
 ** Use this like:
 ** $links = get_linkobjectsbyname('fred');
 ** foreach ($links as $link) {
 **   echo '<li>'.$link->link_name.'</li>';
 ** }
 **/
function get_linkobjectsbyname($cat_name = "noname", $orderby = 'name', $limit = -1)
{
    global $wpdb;
    $cat_id = -1;
    $cat = get_term_by('name', $cat_name, 'link_category');
    if ($cat) {
        $cat_id = $cat->term_id;
    }
    return get_linkobjects($cat_id, $orderby, $limit);
}

 function syndicated_links()
 {
     $contributors = FeedWordPress::link_category_id();
     if (function_exists('get_bookmarks')) {
         $links = get_bookmarks(array("category" => $contributors));
     } else {
         $links = get_linkobjects($contributors);
         // deprecated as of WP 2.1
     }
     return $links;
 }