Eine auf WordPress spezialiserte Suchmaschine für Entwickler und Theme-Autoren



get_attachment_taxonomies ›

Seit2.5.0
Veraltetn/v
get_attachment_taxonomies ( $attachment, $output = 'names' )
Parameter: (2)
  • (int|array|object) $attachment Attachment ID, data array, or data object.
    Erforderlich: Ja
  • (string) $output Output type. 'names' to return an array of taxonomy names, or 'objects' to return an array of taxonomy objects. Default is 'names'.
    Erforderlich: Nein
    Standard: 'names'
Gibt zurück:
  • (array) Empty array on failure. List of taxonomies on success.
Definiert in:
Codex:
Changelog:
  • 4.7.0

Retrieves taxonomies attached to given the attachment.



Quellcode

function get_attachment_taxonomies( $attachment, $output = 'names' ) {
	if ( is_int( $attachment ) ) {
		$attachment = get_post( $attachment );
	} elseif ( is_array( $attachment ) ) {
		$attachment = (object) $attachment;
	}
	if ( ! is_object( $attachment ) ) {
		return array();
	}

	$file     = get_attached_file( $attachment->ID );
	$filename = basename( $file );

	$objects = array( 'attachment' );

	if ( false !== strpos( $filename, '.' ) ) {
		$objects[] = 'attachment:' . substr( $filename, strrpos( $filename, '.' ) + 1 );
	}
	if ( ! empty( $attachment->post_mime_type ) ) {
		$objects[] = 'attachment:' . $attachment->post_mime_type;
		if ( false !== strpos( $attachment->post_mime_type, '/' ) ) {
			foreach ( explode( '/', $attachment->post_mime_type ) as $token ) {
				if ( ! empty( $token ) ) {
					$objects[] = "attachment:$token";
				}
			}
		}
	}

	$taxonomies = array();
	foreach ( $objects as $object ) {
		if ( $taxes = get_object_taxonomies( $object, $output ) ) {
			$taxonomies = array_merge( $taxonomies, $taxes );
		}
	}

	if ( 'names' === $output ) {
		$taxonomies = array_unique( $taxonomies );
	}

	return $taxonomies;
}