WordPress中调试缩略图的相关PHP函数使用解析
<p><strong>the_post_thumbnail</strong><br>
the_post_thumbnail 在 WordPress 中主要用来打印文章中设定的缩略图，而 get_the_post_thumbnail 函数可以将你需要的 HTML 代码以字符串的形式返回。</p>
<p>
the_post_thumbnail 函数的使用</p>
<div>
<div>
<div id="highlighter_168998">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code>the_post_thumbnail( </code><code>$size</code> <code>, </code><code>$attr</code><code>)</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
函数参数</p>
<ul>
<li>
$size 是指你想要的缩略图类型 默认是 ‘post-thumbnail' 也就是特色图像</li>
<li>
$attr 图像img标签中的属性设置。</li>
</ul>
<p>
the_post_thumbnail 函数声明</p>
<div>
<div>
<div id="highlighter_476318">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
<div>
4</div>
<div>
5</div>
<div>
6</div>
<div>
7</div>
<div>
8</div>
<div>
9</div>
<div>
10</div>
<div>
11</div>
<div>
12</div>
<div>
13</div>
<div>
14</div>
<div>
15</div>
<div>
16</div>
<div>
17</div>
<div>
18</div>
<div>
19</div>
<div>
20</div>
<div>
21</div>
<div>
22</div>
<div>
23</div>
<div>
24</div>
<div>
25</div>
<div>
26</div>
<div>
27</div>
<div>
28</div>
<div>
29</div>
<div>
30</div>
<div>
31</div>
<div>
32</div>
<div>
33</div>
<div>
34</div>
</td>
<td>
<div>
<div>
<code>/**</code>
</div>
<div>
<code> </code><code>* Display Post Thumbnail.</code>
</div>
<div>
<code> </code><code>*</code>
</div>
<div>
<code> </code><code>* @since 2.9.0</code>
</div>
<div>
<code> </code><code>*</code>
</div>
<div>
<code> </code><code>* @param int $size Optional. Image size. Defaults to 'post-thumbnail', which theme sets using set_post_thumbnail_size( $width, $height, $crop_flag );.</code>
</div>
<div>
<code> </code><code>* @param string|array $attr Optional. Query string or array of attributes.</code>
</div>
<div>
<code> </code><code>*/</code>
</div>
<div>
<code>function</code> <code>the_post_thumbnail( </code><code>$size</code> <code>= </code><code>'post-thumbnail'</code><code>, </code><code>$attr</code> <code>= </code><code>''</code> <code>) {</code>
</div>
<div>
<code> </code><code>echo</code> <code>get_the_post_thumbnail( null, </code><code>$size</code><code>, </code><code>$attr</code> <code>);</code>
</div>
<div>
<code>}</code>
</div>
<div>
<code>get_the_post_thumbnail 函数声明</code>
</div>
<div>
<code> </code><code>* Retrieve Post Thumbnail.</code>
</div>
<div>
<code> </code><code>*</code>
</div>
<div>
<code> </code><code>* @since 2.9.0</code>
</div>
<div>
<code> </code><code>*</code>
</div>
<div>
<code> </code><code>* @param int </code><code>$post_id</code> <code>Optional. Post ID.</code>
</div>
<div>
<code> </code><code>* @param string </code><code>$size</code> <code>Optional. Image size. Defaults to </code><code>'post-thumbnail'</code><code>.</code>
</div>
<div>
<code> </code><code>* @param string|</code><code>array</code> <code>$attr</code> <code>Optional. Query string </code><code>or</code> <code>array</code> <code>of attributes.</code>
</div>
<div>
<code> </code><code>*/</code>
</div>
<div>
<code>function</code> <code>get_the_post_thumbnail( </code><code>$post_id</code> <code>= null, </code><code>$size</code> <code>= </code><code>'post-thumbnail'</code><code>, </code><code>$attr</code> <code>= </code><code>''</code> <code>) {</code>
</div>
<div>
<code> </code><code>$post_id</code> <code>= ( null === </code><code>$post_id</code> <code>) ? get_the_ID() : </code><code>$post_id</code><code>;</code>
</div>
<div>
<code> </code><code>$post_thumbnail_id</code> <code>= get_post_thumbnail_id( </code><code>$post_id</code> <code>);</code>
</div>
<div>
<code> </code><code>$size</code> <code>= apply_filters( </code><code>'post_thumbnail_size'</code><code>, </code><code>$size</code> <code>);</code>
</div>
<div>
<code> </code><code>if</code> <code>( </code><code>$post_thumbnail_id</code> <code>) {</code>
</div>
<div>
<code> </code><code>do_action( </code><code>'begin_fetch_post_thumbnail_html'</code><code>, </code><code>$post_id</code><code>, </code><code>$post_thumbnail_id</code><code>, </code><code>$size</code> <code>); </code><code>// for "Just In Time" filtering of all of wp_get_attachment_image()'s filters</code>
</div>
<div>
<code> </code><code>if</code> <code>( in_the_loop() )</code>
</div>
<div>
<code> </code><code>update_post_thumbnail_cache();</code>
</div>
<div>
<code> </code><code>$html</code> <code>= wp_get_attachment_image( </code><code>$post_thumbnail_id</code><code>, </code><code>$size</code><code>, false, </code><code>$attr</code> <code>);</code>
</div>
<div>
<code> </code><code>do_action( </code><code>'end_fetch_post_thumbnail_html'</code><code>, </code><code>$post_id</code><code>, </code><code>$post_thumbnail_id</code><code>, </code><code>$size</code> <code>);</code>
</div>
<div>
<code> </code><code>} </code><code>else</code> <code>{</code>
</div>
<div>
<code> </code><code>$html</code> <code>= </code><code>''</code><code>;</code>
</div>
<div>
<code> </code><code>}</code>
</div>
<div>
<code> </code><code>return</code> <code>apply_filters( </code><code>'post_thumbnail_html'</code><code>, </code><code>$html</code><code>, </code><code>$post_id</code><code>, </code><code>$post_thumbnail_id</code><code>, </code><code>$size</code><code>, </code><code>$attr</code> <code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
<strong>set_post_thumbnail_size</strong><br>
set_post_thumbnail_size 函数是 WordPress 中设置特色图像大小的一个函数也是 add_image_size 函数的一个简单的应用。为了更好的突出特色图像的使用， WordPress 自 2.9.0 版开始，便有了本函数。</p>
<p>
set_post_thumbnail_size 函数的使用<br>
与 add_image_size 函数使用大概类似，只是该函数只针对特色图像进行设置。</p>
<div>
<div>
<div id="highlighter_399482">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code>set_post_thumbnail_size( </code><code>$width</code><code>, </code><code>$height</code><code>, </code><code>$crop</code><code>)</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
参数详解</p>
<ul>
<li>
$width 图像宽度</li>
<li>
$height 图像高度</li>
<li>
$crop 是否按照高宽剪裁图像</li>
</ul>
<p>
实例</p>
<div>
<div>
<div id="highlighter_247598">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
</td>
<td>
<div>
<div>
<code>set_post_thumbnail_size(100,0,true);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
<p>
注意：当高度和宽度任意一个为0时， WP 将自动适应另一个值进行缩略图生成工作。</p>
<p>
函数声明</p>
<div>
<div>
<div id="highlighter_770897">
<div>
<span>?</span>
</div>
<table border="0" cellpadding="0" cellspacing="0"><tbody><tr>
<td>
<div>
1</div>
<div>
2</div>
<div>
3</div>
<div>
4</div>
<div>
5</div>
<div>
6</div>
<div>
7</div>
</td>
<td>
<div>
<div>
<code>/**</code>
</div>
<div>
<code> </code><code>* Registers an image size for the post thumbnail</code>
</div>
<div>
<code> </code><code>*</code>
</div>
<div>
<code> </code><code>* @since 2.9.0</code>
</div>
<div>
<code> </code><code>*/</code>
</div>
<div>
<code>function</code> <code>set_post_thumbnail_size( </code><code>$width</code> <code>= 0, </code><code>$height</code> <code>= 0, </code><code>$crop</code> <code>= false ) {</code>
</div>
<div>
<code> </code><code>add_image_size( </code><code>'post-thumbnail'</code><code>, </code><code>$width</code><code>, </code><code>$height</code><code>, </code><code>$crop</code> <code>);</code>
</div>
</div>
</td>
</tr></tbody></table>
</div>
</div>
<div id="codetool">
<div>
<textarea></textarea>
</div>
</div>
</div>
頁:
[1]