Функция GET_BOOKMARK() │ WP 2.1.0

Функция GET_BOOKMARK() в WordPress используется для получения данных закладки (ссылки).

Возврат

Функция возвращает данные в виде массива, объекта или null. Тип возвращаемого значения зависит от параметра $output.

Применение

Функция вызывается следующим образом:

get_bookmark( $bookmark, $output, $filter );

• $bookmark (int|stdClass) (обязательный) — ID или объект закладки, которую нужно получить.

• $output (string) — необходимый тип возврата. Может быть:

  • OBJECT — стандартный объект (stdClass).
  • ARRAY_A — ассоциативный массив.
  • ARRAY_N — числовой массив.

  По умолчанию: OBJECT.

• $filter (string) — как обрабатывать поля закладки.
  По умолчанию: 'raw'.

Примеры использования

Пример 1: Получение данных закладки

Давайте получим данные закладки с ID 13 и выведем её URL:

$link = get_bookmark( 13, ARRAY_N );

echo $link[0]; // Выведет URL закладки

В этом примере переменная $link будет содержать следующий объект:

stdClass Object
(
    [link_id] => 13
    [link_url] => http://www.gogetlinks.net/?inv=n98gxr
    [link_name] => gogetlinks.net
    [link_image] => http://wp-kama.com/wp-includes/images/crystal/archive.png
    [link_target] => 
    [link_description] => Покупка/продажа качественных ссылок
    [link_visible] => Y
    [link_owner] => 1
    [link_rating] => 0
    [link_updated] => 0000-00-00 00:00:00
    [link_rel] => 
    [link_notes] => 
    [link_rss] => 
    [link_category] => Array()
)

Пример 2: Вывод названия закладки

Чтобы вывести название закладки (например, с ID 5), можно воспользоваться следующим кодом:

$bookmark = get_bookmark(5);
echo $bookmark->link_name; 

Или в сокращенной форме:

echo get_bookmark(5)->link_name;

Пример 3: Вывод закладки как ссылки

Если вы хотите вывести закладку как гиперссылку, используйте следующий код:

$bookmark = get_bookmark( 5 );
echo ''. $bookmark->link_name .'';

Заметки

• Глобальная переменная: $link — текущий объект закладки.
• Глобальная переменная: $wpdb — объект абстракции базы данных WordPress.

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

• С версии 2.1.0 — функция была добавлена.

Эта статья поможет вам понять, как использовать функцию GET_BOOKMARK() для работы с закладками в WordPress. Если у вас есть свои примеры использования или вы хотите подробнее изучить другие функции, такие как EDIT_BOOKMARK_LINK, GET_BOOKMARKS или WP_LIST_BOOKMARKS, вы можете продолжить изучение на соответ��твующих ресурсах WordPress.