# get_links()

URL: https://chugunov.pro/api-wordpress/functions/get_links/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 0.71.

> Устаревший элемент. Помечен устаревшим с версии 2.1.0.

## Сигнатура

```php
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 ): null|string
```

## Описание

См. alsoget_bookmarks()

## Параметры

- `$category` `int` — необязательный, по умолчанию `-1`. Категория, которую нужно использовать. Если категория не указана, используются все.
  
  Значение по умолчанию: 0.
- `$before` `string` — необязательный, по умолчанию `''`. HTML для вывода перед ссылкой.
- `$after` `string` — необязательный, по умолчанию `'<br />'`. HTML для вывода после ссылки. Значение по умолчанию —
  .
- `$between` `string` — необязательный, по умолчанию `' '`. HTML для вывода между ссылкой/изображением и её описанием.
  
  Не используется, если изображения нет или $show_images равно true. Значение по умолчанию — ‘ ‘.
- `$show_images` `bool` — необязательный, по умолчанию `true`. Показывать ли изображения (если заданы).
- `$orderby` `string` — необязательный, по умолчанию `'name'`. Порядок вывода ссылок. Например, 'id', 'name', 'url', 'description', 'rating' или 'owner'. Значение по умолчанию — 'name'.
  
  Если начать имя с подчёркивания, порядок будет обратным.
  
  Если указать порядок 'rand', ссылки будут возвращены в случайном порядке.
- `$show_description` `bool` — необязательный, по умолчанию `true`. Показывать ли описание, если show_images=false/не задано.
- `$show_rating` `bool` — необязательный, по умолчанию `false`. Показывать звёзды/символы рейтинга.
- `$limit` `int` — необязательный, по умолчанию `-1`. Ограничить X записями. Если не указано, показываются все записи.
- `$show_updated` `int` — необязательный, по умолчанию `1`. Показывать ли метку времени последнего обновления.
- `$display` `bool` — необязательный, по умолчанию `true`. Выводить результаты или возвращать их вместо вывода.

## Возвращаемое значение

`null|string`

## Исходный код

Файл: `wp-includes/deprecated.php:949`

```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 ( str_starts_with($orderby, '_') ) {
		$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 ( !str_starts_with($row->link_updated_f, '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 && $show_images ) {
			if ( str_contains( $row->link_image, 'http' ) )
				$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;
}
```

## История изменений

- 2.1.0 — Deprecated. Use get_bookmarks()
- 0.71 — Introduced.

## Связанные

Использует: [`get_linkrating`](https://chugunov.pro/api-wordpress/functions/get_linkrating/), [`sanitize_bookmark_field`](https://chugunov.pro/api-wordpress/functions/sanitize_bookmark_field/), [`get_bookmarks`](https://chugunov.pro/api-wordpress/functions/get_bookmarks/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`esc_url`](https://chugunov.pro/api-wordpress/functions/esc_url/), [`esc_attr`](https://chugunov.pro/api-wordpress/functions/esc_attr/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/), [`get_option`](https://chugunov.pro/api-wordpress/functions/get_option/).
Используется в: [`get_links_list`](https://chugunov.pro/api-wordpress/functions/get_links_list/), [`get_linksbyname`](https://chugunov.pro/api-wordpress/functions/get_linksbyname/), [`get_links_withrating`](https://chugunov.pro/api-wordpress/functions/get_links_withrating/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_links/