get_attachment_template() — описание функции WordPress на русском

Сигнатура

get_attachment_template(): string

Описание

Русский перевод этого описания пока проверяется. Показан оригинал.

The hierarchy for this template looks like:

{mime_type}-{sub_type}.php
{sub_type}.php
{mime_type}.php
attachment.php

An example of this is:

image-jpeg.php
jpeg.php
image.php
attachment.php

The template hierarchy and template path are filterable via the ‘$type_template_hierarchy’ and ‘$type_template’ dynamic hooks, where $type is ‘attachment’.

Возвращаемое значение

string

Исходный код

wp-includes/template.php:663

function get_attachment_template() {
	$attachment = get_queried_object();

	$templates = array();

	if ( $attachment ) {
		if ( str_contains( $attachment->post_mime_type, '/' ) ) {
			list( $type, $subtype ) = explode( '/', $attachment->post_mime_type );
		} else {
			list( $type, $subtype ) = array( $attachment->post_mime_type, '' );
		}

		if ( ! empty( $subtype ) ) {
			$templates[] = "{$type}-{$subtype}.php";
			$templates[] = "{$subtype}.php";
		}
		$templates[] = "{$type}.php";
	}
	$templates[] = 'attachment.php';

	return get_query_template( 'attachment', $templates );
}

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

Версия	Описание
4.3.0	The order of the mime type logic was reversed so the hierarchy is more logical.
2.0.0	Introduced.