附件是一种特殊的文章类型,包含了通过WordPress媒体上传系统上传的文件的信息,例如其描述和名称,该信息可以通过几种文章类型(附件模板文件)显示。
例如,对于图像、附件文章类型链接到元数据信息,有关图像的大小,生成的缩略图,图像文件的位置,HTML替代文本,甚至是从嵌入在图像中的EXIF数据获得的信息。
利用附件模板获取附件的其他元数据信息,有助于SEO。
如模板层次结构所示,您可以按回退的顺序通过多个模板文件显示附件:
- MIME_type.php 和 a subtype.php 它可以是任何MIME类型(例如:image.php,video.php,application.php)。 对于text/plain,可以使用以下顺序:
- text_plain.php
- plain.php
- 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():检索当前模板或父模板中的附件模板的路径。