attachment_link
Позволяет изменить ссылку на вложение (файл из медиабиблиотеки).
Используется в функции get_attachment_link().
Использование
add_filter( 'attachment_link', 'wp_kama_attachment_link_filter', 10, 2 ); /** * Function for `attachment_link` filter-hook. * * @param string $link The attachment's permalink. * @param int $post_id Attachment ID. * * @return string */ function wp_kama_attachment_link_filter( $link, $post_id ){ // filter... return $link; }
- $link(строка)
- Ссылка на страницу вложения.
- $post_id(число)
- ID вложения.
Примеры
#1 Замена ссылки на страницу медиафайла ссылкой на сам медиафайл
add_filter( 'attachment_link', 'change_attachment_link', 10, 2 ); function change_attachment_link( $link, $post_id ) { return wp_get_attachment_url( $post_id ); }
Список изменений
С версии 2.0.0 | Введена. |
С версии 5.6.0 | Providing an empty string will now disable the view attachment page link on the media modal. |
Где вызывается хук
attachment_link
wp-includes/link-template.php 534
return apply_filters( 'attachment_link', $link, $post->ID );