# get_linkobjectsbyname()

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

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

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

## Сигнатура

```php
get_linkobjectsbyname( string $cat_name = "noname", string $orderby = 'name', int $limit = -1 ): array
```

## Описание

$links = get_linkobjectsbyname( ‘fred’ ); foreach ( $links as $link ) { echo ‘
‘ . $link->link_name . ‘
‘; }
См. alsoget_bookmarks()

## Параметры

- `$cat_name` `string` — необязательный, по умолчанию `"noname"`. Имя используемой рубрики. Если совпадений не найдено, используются все.
  
  Значение по умолчанию — 'noname'.
- `$orderby` `string` — необязательный, по умолчанию `'name'`. Порядок вывода ссылок. Например, 'id', 'name', 'url', 'description', 'rating' или 'owner'. Значение по умолчанию — 'name'.
  
  Если начать имя с подчёркивания, порядок будет обратным.
  
  Если указать порядок 'rand', ссылки будут возвращены в случайном порядке.
- `$limit` `int` — необязательный, по умолчанию `-1`. Ограничить X записями. Если не указано, показываются все записи.

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

`array`

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

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

```php
function get_linkobjectsbyname($cat_name = "noname" , $orderby = 'name', $limit = -1) {
	_deprecated_function( __FUNCTION__, '2.1.0', '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);
}
```

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

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

## Связанные

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

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