附件模板文件 - 主题开发手册

附件是一种特殊的文章类型，它保存着通过WordPress媒体上传系统上传的文件信息，比如它的描述和名称，可以通过几个post type – attachment模板文件显示。

以图片为例，附件类型链接到元数据信息，关于图片的大小，生成的缩略图，图片文件的位置，HTML的alt文本，甚至从嵌入图片的EXIF数据中获得的信息。

利用附件模板获得额外的元数据信息进行上传，有助于SEO工作。

如模板层次结构所示，你能够通过几个模板文件按回退顺序显示你的附件。

MIME_type.php 和 subtype.php
它可以是任意MIME类型（例如：image.php, video.php, application.php）。对于text/plain，使用以下路径（按顺序）：
1. text_plain.php
2. plain.php
3. text.php
attachment.php
single-attachment.php
single.php
singular.php
index.php

MIME_type.php

附件是由模板文件根据它们的MIME类型提供的。例如，如果你的附件是一个图片，你可以通过创建image.php模板文件来定制它们的显示方式。所有post_mime_type为image/*的图片将通过image.php模板文件呈现。

附件也支持使用mime subtype.php文件。继续以图片为例，你可以进一步定制你的主题，不仅支持image.php文件，而且支持jpg.php子类型文件。

Attachment.php

附件页(attachment.php)是一个具有附件类型的单页，通过创建attachment.php来生成。就像一个单一的文章页面，专门用于你的文章，附件页在主题中提供一个专门的附件页面。

创建附件页就像创建一个 attachment.php 文件一样简单。attachment.php文件包含的代码与single.php文章页面类似。

<div class="entry-attachment">
       <?php $image_size = apply_filters( 'wporg_attachment_size', 'large' ); 
             echo wp_get_attachment_image( get_the_ID(), $image_size ); ?>
 
           <?php if ( has_excerpt() ) : ?>
       
           <div class="entry-caption">
                 <?php the_excerpt(); ?>
           </div><!-- .entry-caption -->
       <?php endif; ?>
</div><!-- .entry-attachment -->

函数参考

get_attachment_template() : 读取当前模板或父模板中的附件模板的路径。