Changeset 55262

Timestamp:

02/07/2023 02:33:44 PM (22 months ago)

Author:

audrasjb

Message:

Media: Introduce wp_get_attachment_link_attributes filter.

This changeset introduces the wp_get_attachment_link_attributes hook to allow developers to filter the link attributes when getting the attachment link.

Props NathanAtmoz, aaroncampbell, antpb, costdev.
Fixes #41574.

Location:

trunk

Files:

• src/wp-includes/post-template.php (modified) (1 diff)
• tests/phpunit/tests/post/wpGetAttachmentLink.php (added)

trunk/src/wp-includes/post-template.php

@@ -1667 +1667 @@
     }
 
-    $link_html = "<a href='" . esc_url( $url ) . "'>$link_text</a>";
+    /**
+     * Filters the list of attachment link attributes.
+     *
+     * @since 6.2.0
+     *
+     * @param array $attributes An array of attributes for the link markup,
+     *                          keyed on the attribute name.
+     * @param int   $id         Post ID.
+     */
+    $attributes = apply_filters( 'wp_get_attachment_link_attributes', array( 'href' => $url ), $_post->ID );
+
+    $link_attributes = '';
+    foreach ( $attributes as $name => $value ) {
+        $value            = 'href' === $name ? esc_url( $value ) : esc_attr( $value );
+        $link_attributes .= ' ' . esc_attr( $name ) . "='" . $value . "'";
+    }
+
+    $link_html = "<a$link_attributes>$link_text</a>";
 
     /**