функция
Устаревший since 0.71
get_linksbyname()
Устаревшее.
Помечено устаревшим с версии 2.1.0.
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
get_linksbyname( string $cat_name = "noname", string $before = '', string $after = '<br />', string $between = " ", bool $show_images = true, string $orderby = 'id', bool $show_description = true, bool $show_rating = false, 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/не задано.
$show_rating
bool
необязательный
= false
Показывать звёзды/символы рейтинга.
$limit
int
необязательный
= -1
Ограничить X записями. Если не указано, показываются все записи.
$show_updated
int
необязательный
Показывать ли метку времени последнего обновления. Значение по умолчанию — 0.
Исходный код
wp-includes/deprecated.php:404
function get_linksbyname($cat_name = "noname", $before = '', $after = '<br />', $between = " ", $show_images = true, $orderby = 'id',
$show_description = true, $show_rating = false,
$limit = -1, $show_updated = 0) {
_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;
get_links($cat_id, $before, $after, $between, $show_images, $orderby, $show_description, $show_rating, $limit, $show_updated);
}История изменений
| Версия | Описание |
|---|---|
| 2.1.0 | Deprecated. Use get_bookmarks() |
| 0.71 | Introduced. |
