This function has been deprecated. Use get_bookmarks() instead.
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
-
(Optional) The category to use. If no category supplied uses all.<br> Default 0.
Default value: -1
- $before
-
(Optional) The HTML to output before the link.
Default value: ''
- $after
-
(Optional) The HTML to output after the link. Default
<br>.Default value: '<br>'
- $between
-
(Optional) The HTML to output between the link/image and its description.<br> Not used if no image or $show_images is true. Default ' '.
Default value: ' '
- $show_images
-
(Optional) Whether to show images (if defined).
Default value: true
- $orderby
-
(Optional) The order to output the links. E.g. 'id', 'name', 'url', 'description', 'rating', or 'owner'. Default 'name'.<br> If you start the name with an underscore, the order will be reversed.<br> Specifying 'rand' as the order will return links in a random order.
Default value: 'name'
- $show_description
-
(Optional) Whether to show the description if show_images=false/not defined.<br>
Default value: true
- $show_rating
-
(Optional) Show rating stars/chars.
Default value: false
- $limit
-
(Optional) Limit to X entries. If not specified, all entries are shown.<br>
Default value: -1
- $show_updated
-
(Optional) Whether to show last updated timestamp.
Default value: 1
- $display
-
(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, $echo = true) {
_deprecated_function( __FUNCTION__, 'WP-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') . ' ' . date(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 ( !$echo )
return $output;
echo $output;
}
Changelog
| Version | Description |
|---|---|
| 2.1.0 | Use get_bookmarks() |
| 0.71 | Introduced. This function has been deprecated. Use get_bookmarks() instead. |