Warning: This function has been deprecated. Use get_bookmarks() instead.
get_links() WordPress Function
The get_links() function in WordPress is used to retrieve a list of links from the link database. This function can be used to display a list of links in your sidebar, or to get a list of links for use in your own custom functions.
get_links( int $category = -1, string $before = '', string $after = '<br />', string $between = ' ', bool $show_images = true, string $orderby = 'name', bool $show_description = true, bool $show_rating = false, int $limit = -1, int $show_updated = 1, bool $display = true ) #
Gets the links associated with category by ID.
Description
See also
Parameters
- $category
(int)(Optional) The category to use. If no category supplied uses all. Default 0.
Default value: -1
- $before
(string)(Optional) The HTML to output before the link.
Default value: ''
- $after
(string)(Optional) The HTML to output after the link. Default
<br />
.Default value: '<br />'
- $between
(string)(Optional) The HTML to output between the link/image and its description. Not used if no image or $show_images is true.
Default value: ' '
- $show_images
(bool)(Optional) Whether to show images (if defined).
Default value: true
- $orderby
(string)(Optional) The order to output the links. E.g. 'id', 'name', 'url', 'description', 'rating', or 'owner'. If you start the name with an underscore, the order will be reversed. Specifying 'rand' as the order will return links in a random order.
Default value: 'name'
- $show_description
(bool)(Optional) Whether to show the description if show_images=false/not defined.
Default value: true
- $show_rating
(bool)(Optional) Show rating stars/chars.
Default value: false
- $limit
(int)(Optional) Limit to X entries. If not specified, all entries are shown.
Default value: -1
- $show_updated
(int)(Optional) Whether to show last updated timestamp.
Default value: 1
- $display
(bool)(Optional)Whether to display the results, or return them instead.
Default value: true
Return
(null|string)
Source
File: wp-includes/deprecated.php
function get_links($category = -1, $before = '', $after = '<br />', $between = ' ', $show_images = true, $orderby = 'name', $show_description = true, $show_rating = false, $limit = -1, $show_updated = 1, $display = true) { _deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' ); $order = 'ASC'; if ( substr($orderby, 0, 1) == '_' ) { $order = 'DESC'; $orderby = substr($orderby, 1); } if ( $category == -1 ) // get_bookmarks() uses '' to signify all categories. $category = ''; $results = get_bookmarks(array('category' => $category, 'orderby' => $orderby, 'order' => $order, 'show_updated' => $show_updated, 'limit' => $limit)); if ( !$results ) return; $output = ''; foreach ( (array) $results as $row ) { if ( !isset($row->recently_updated) ) $row->recently_updated = false; $output .= $before; if ( $show_updated && $row->recently_updated ) $output .= get_option('links_recently_updated_prepend'); $the_link = '#'; if ( !empty($row->link_url) ) $the_link = esc_url($row->link_url); $rel = $row->link_rel; if ( '' != $rel ) $rel = ' rel="' . $rel . '"'; $desc = esc_attr(sanitize_bookmark_field('link_description', $row->link_description, $row->link_id, 'display')); $name = esc_attr(sanitize_bookmark_field('link_name', $row->link_name, $row->link_id, 'display')); $title = $desc; if ( $show_updated ) if (substr($row->link_updated_f, 0, 2) != '00') $title .= ' ('.__('Last updated') . ' ' . gmdate(get_option('links_updated_date_format'), $row->link_updated_f + (get_option('gmt_offset') * HOUR_IN_SECONDS)) . ')'; if ( '' != $title ) $title = ' title="' . $title . '"'; $alt = ' alt="' . $name . '"'; $target = $row->link_target; if ( '' != $target ) $target = ' target="' . $target . '"'; $output .= '<a href="' . $the_link . '"' . $rel . $title . $target. '>'; if ( $row->link_image != null && $show_images ) { if ( strpos($row->link_image, 'http') !== false ) $output .= "<img src=\"$row->link_image\" $alt $title />"; else // If it's a relative path. $output .= "<img src=\"" . get_option('siteurl') . "$row->link_image\" $alt $title />"; } else { $output .= $name; } $output .= '</a>'; if ( $show_updated && $row->recently_updated ) $output .= get_option('links_recently_updated_append'); if ( $show_description && '' != $desc ) $output .= $between . $desc; if ($show_rating) { $output .= $between . get_linkrating($row); } $output .= "$after\n"; } // End while. if ( !$display ) return $output; echo $output; }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
2.1.0 | Use get_bookmarks() |
0.71 | Introduced. |