# get_linksbyname_withrating()

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

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

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

## Сигнатура

```php
get_linksbyname_withrating( string $cat_name = "noname", string $before = '', string $after = '<br />', string $between = " ", bool $show_images = true, string $orderby = 'id', bool $show_description = true, int $limit = -1, int $show_updated )
```

## Описание

См. alsoget_bookmarks()

## Параметры

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

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

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

```php
function get_linksbyname_withrating($cat_name = "noname", $before = '', $after = '<br />', $between = " ",
									$show_images = true, $orderby = 'id', $show_description = true, $limit = -1, $show_updated = 0) {
	_deprecated_function( __FUNCTION__, '2.1.0', 'get_bookmarks()' );

	get_linksbyname($cat_name, $before, $after, $between, $show_images, $orderby, $show_description, true, $limit, $show_updated);
}
```

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

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

## Связанные

Использует: [`get_linksbyname`](https://chugunov.pro/api-wordpress/functions/get_linksbyname/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/).

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