image_add_caption( string $html, int $id, string $caption, string $title, string $align, string $url, string $size, string $alt = '' ): string

188function image_add_caption( $html, $id, $caption, $title, $align, $url, $size, $alt = '' ) {189 190	/**191	 * Filters the caption text.192	 *193	 * Note: If the caption text is empty, the caption shortcode will not be appended194	 * to the image HTML when inserted into the editor.195	 *196	 * Passing an empty value also prevents the {@see 'image_add_caption_shortcode'}197	 * Filters from being evaluated at the end of image_add_caption().198	 *199	 * @since 4.1.0200	 *201	 * @param string $caption The original caption text.202	 * @param int    $id      The attachment ID.203	 */204	$caption = apply_filters( 'image_add_caption_text', $caption, $id );205 206	/**207	 * Filters whether to disable captions.208	 *209	 * Prevents image captions from being appended to image HTML when inserted into the editor.210	 *211	 * @since 2.6.0212	 *213	 * @param bool $bool Whether to disable appending captions. Returning true from the filter214	 *                   will disable captions. Default empty string.215	 */216	if ( empty( $caption ) || apply_filters( 'disable_captions', '' ) ) {217		return $html;218	}219 220	$id = ( 0 < (int) $id ) ? 'attachment_' . $id : '';221 222	if ( ! preg_match( '/width=["\']([0-9]+)/', $html, $matches ) ) {223		return $html;224	}225 226	$width = $matches[1];227 228	$caption = str_replace( array( "\r\n", "\r" ), "\n", $caption );229	$caption = preg_replace_callback( '/<[a-zA-Z0-9]+(?: [^<>]+>)*/', '_cleanup_image_add_caption', $caption );230 231	// Convert any remaining line breaks to <br />.232	$caption = preg_replace( '/[ \n\t]*\n[ \t]*/', '<br />', $caption );233 234	$html = preg_replace( '/(class=["\'][^\'"]*)align(none|left|right|center)\s?/', '$1', $html );235	if ( empty( $align ) ) {236		$align = 'none';237	}238 239	$shcode = '[caption id="' . $id . '" align="align' . $align . '" width="' . $width . '"]' . $html . ' ' . $caption . '[/caption]';240 241	/**242	 * Filters the image HTML markup including the caption shortcode.243	 *244	 * @since 2.6.0245	 *246	 * @param string $shcode The image HTML markup with caption shortcode.247	 * @param string $html   The image HTML markup.248	 */249	return apply_filters( 'image_add_caption_shortcode', $shcode, $html );250}