2008-12-24
Wordpress首页显示日志缩略图插件IFH的典型调用
标签:Image For Homepage, PHP, seo, wordpress最近，本站发布了实现Wordpress首页文章缩略图Image For Homepage（简称IFH）的插件，详见《仲子说隆重发布Wordpress首页文章缩略图显示插件Image For Homepage 1.0版》。为了方便大家的使用，本文将要介绍IFH的一些典型使用方法。
1、首先安装好插件
最最简单的安装方法就是将插件解压后上传到plugins目录下，然后再后台激活即可。
2、典型的调用方式。
在你所使用的Wordpress模板的首页index.php中，找到the_excerpt()或者the_content()，注意，括号中可能带有参数，如'more...'。如果是使用the_content()调用的话，那么应该说明你的首页是将文章内容全部显示出来。这样做其实是不太有利于搜索引擎优化的，而且也将导致整个首页非常的长。因此建议在index.php中，将所有the_content()的调用都改为the_excerpt()调用。
那么接下来，就是在the_excerpt()这句话的上一行，加入对于IFH这个插件函数的调用。最典型的调用方式为：
if (function_exists("image_for_homepage")){image_for_homepage(true, 1, 200, 0, 'right', 'IFHL', '<div>', '</div>');}
加入if (function_exists("image_for_homepage"))的判断，主要是为了避免未来如果您禁用了这个插件，而忘记删除以上调用，所导致的首页打不开的现象。因此只是为了保险起见而已，您如果觉得太罗嗦，也可以不加入这个判断。以下就介绍这个主要的函数调用体image_for_homepage(true, 1, 200, 0, 'right', 'IFHL', '<div>', '</div>')的含义以及更加丰富的调用（您需要注意的是，如果是直接从网页上copy的调用代码，单引号可能会变成中文的引号，请你手动在index.php中修改成英文的单引号）。
(1) image_for_homepage(true, 1, 200, 0, 'right', 'IFHL', '<div>', '</div>')
这个或许是最经常使用的调用。
- true表示生成缓冲缩略图，也就是缩略图会实际产生，并存储在服务器上。这样生成的缩略图质量较好，首页打开速度也会提高。如果改为false，则只是在<img>调用的时候，重新设定了宽度和高度。（需要注意的是，如果这个图片不是在你网站上实际存在的，而是别的网站的图片，那么也不会实际生成缩略图）。
- 1表示生成缩略图的类型为“保持原图不失真，并在必要时进行裁剪”。如果改为0，则表示不管原图的比例如何，强制生成指定的比例（不推荐）。
- 接下来的两项200和0表示缩略图的宽度和高度：200表示宽度，0表示在宽度为200的情况下保持原图的比例，这样的缩略图绝对不会失真，但是不同文章的缩略图高度就有可能不同。反之也可以，也就是0和200的话，就表示保持缩略图的高度为200，宽度等比例缩小。但是，或许会有朋友不喜欢这样调用，那么也可以完全指定缩略图的宽和高，这样，在前面缩略图类型调用为1的前提下，会根据原图比例进行一些裁剪，裁剪是从两端向中央裁剪。
- right表示生成的缩略图的位置为居右，改为left则居左，center表示居中。
- IFHL表示给生成的缩略图自动加上文章的链接（注意保持大小写），这样用户在点击这个图片的时候，就会在本页打开文章。如果是打算在新窗口中打开的话，将这个参数改为IFHL_blank（注意保持大小写）。
- <div>和</div>表示缩略图的前后缀，一般不需要修改。但是如果您对HTML很熟悉，可以根据自己的情况定制。
(2) image_for_homepage(true, 1, 200, 0, 'right', ", '<div>', '</div>')
这个调用，表示为首页生成缩略图，缩略图的宽为200，高为保持比例输出，并且缩略图居右显示。缩略图上没有带链接。
(3) image_for_homepage(true, 1, 200, 0, 'center', ", '<div>', '</div>')
这个调用，表示为首页生成缩略图，缩略图的宽为200，高为保持比例输出，并且缩略图居中显示，这样摘要的内容就会在图的下面。缩略图上没有带链接。
(4) image_for_homepage(true, 1, 200, 0, 'left', ", '<div>', '</div>')
这个调用，表示为首页生成缩略图，缩略图的宽为200，高为保持比例输出，并且缩略图居左显示。缩略图上没有带链接。
(5) image_for_homepage(true, 1, 200, 200, 'right', ", '<div>', '</div>')
这个调用，表示为首页生成200×200的缩略图，并且缩略图居右显示。如果原图不符合这个比例，会进行相应的裁剪。缩略图上没有带链接。
(6) image_for_homepage(true, 1, 200, 0, 'right', 'IFHL_blank', '<div>', '</div>')
这个调用，表示为首页生成缩略图，缩略图的宽为200，高为保持比例输出，并且缩略图居右显示。缩略图上带文章链接，并且是在新窗口中打开。本站使用的就是这个调用。
(7) image_for_homepage(true, 1, 200, 100, 'right', 'IFHL_blank', '<div>', '</div>')
这个调用，表示为首页生成缩略图，缩略图的宽为200，高为100，并且缩略图居右显示。缩略图上带文章链接，并且是在新窗口中打开。
(8) image_for_homepage(true, 1, 200, 200, 'left', ", '<div>', '</div>')
这个调用，表示为首页生成200×200的缩略图，并且缩略图居左显示。缩略图上没有带链接。
(9) image_for_homepage(true, 1, 200, 200, 'left', 'IFHL', '<div>', '</div>')
这个调用，表示为首页生成200×200的缩略图，并且缩略图居左显示。缩略图上带文章链接，在同一页面中打开。
基本上上面所介绍的调用能够满足大家的大部分需求，如果还有别的需求，可以根据自己的需要调整参数。
需要注意的是，本插件在WordPress2.1版、2.6.5版、2.7版上都经过测试。能够正常使用。因此，IFH插件应该在WordPress2.1～2.7版上都能够使用。如果无法使用的朋友，可以给我留言。
还有，本插件需要的使用的环境为Apahce+PHP+Wordpress，不能保证所有的IIS用户都能够使用（和服务商的环境设置有些关系）。如果是在IIS上无法正常使用的朋友，也可以给我留言。如果需求比较多，可以考虑开发一个IIS版的插件。
本文可以自由转载，转载时请保留全文并注明出处：
转载自仲子说 [ http://www.wangzhongyuan.com/ ]
原文链接：http://www.wangzhongyuan.com/archives/556.html
仲子说隆重发布Wordpress首页文章缩略图显示插件Image For Homepage 1.0版 仲子说 Image For Homepage, PHP wordpress said,
2008年12月24日 at 16:06
[...] 更多的调用函数可以参见：《Wordpress首页显示日志缩略图插件IFH的典型调用》 插件使用效果图： [...]
Spirit said,
2008年12月25日 at 14:37
如果能做成一个有GUI的东西是不是更好用？～
啦啦啦 said,
2008年12月31日 at 22:04
hi,, 有个建议, 如果是100*100的原图, 如果用IFHP调用默认为200宽度的话, 图片就会被撑大,,不好看..
有没有这种可能性就是: 调用200宽度,,如果图片宽度小于200,则使用原图尺寸,,不用缩略图了, 如果原图>200宽度,, 调用缩略图模式?
不知道修改起来难不难?
仲远 said,
2009年1月1日 at 0:51
to 啦啦啦:
谢谢您的关注，我已经往您评论时所留下的邮箱里发了一封邮件，请您查收。
啦啦啦 said,
2009年1月1日 at 1:21
好像收不到诶,, 难道live邮箱支持不好?
要不要试试看ilalala@qq.com?
仲远 said,
2009年1月1日 at 1:57
好的，已发送
tomchen1989 said,
2009年1月12日 at 7:05
仲远兄的这个插件很方便很好，小弟非常喜欢且非常感谢！
但是有些点不厚道的就是仲远兄echo了一段自己网站的链接，display:none的css是写在js里的，想必是为了做自己的这个blog的seo。这段连同float:right的css的echo还用base32加了密。这可以理解，对大家也没有坏处，但小弟认为还是不太好，应该让大家知道才好。
仲远兄完全可以不必base32，并声明一下加了自己的链接。或者干脆不要加自己的链接，声明一下：“请每位使用本插件的同学在友情链接中添加wangzhongyuan.com”
还有你的footer上的Powered by Wang Zhongyuan，这是仲远兄的blog，想怎么改怎么改，但是建议还是写Powered by Wordpress。虽然改动很多，但毕竟还是用的wp，或者写个modified by Wang也好。
呵呵仅仅是多管闲事的小弟的一点儿愚见而已，还望仲远兄包涵则个。
仲远 said,
2009年1月12日 at 15:20
to tomchen1989：
谢谢你诚恳的建议。但是你的前一段话和后一段话其实是矛盾的。
一方面，你建议不该在插件中加入版权信息；另一方面，你又建议在Wordpress中保留Wordpress的版权信息。
其实插件和模板开发一样，都是作者辛辛苦苦花时间写出来的。也许使用的人觉得很方便，很快就能够安装使用，达到自己想要的效果。却有多少人想过，作者也许为了开发这个插件，连续多日熬夜到凌晨四、五点！因此，就像模板一样，插件中也是有版权信息的。并且，我在下载页面中，也说明了“免责声明：作者对这个插件保留一切权利，您仅在个人使用时可以免费下载并使用这个插件”。
但是，如果你是个人使用，并且根据自己的需要，修改插件，也是可以的（但是不能够将其再分发传播），因为最后插件的代码是在你的手上的。这就像使用我现在使用的模板一样，我其实对其进行很多的修改，所以才将我的网站的底部改为Powered by Wang Zhongyuan，主要目的是在Wang Zhongyuan上加上我的邮箱的链接，方便大家的联系。但是我没有再将我修改过的这个WordPress模板进行分发传播。
因此，还是这句话：谢谢您对这个插件的关注和使用，但是我保留对这个插件的一切权利。并且，如果您觉得在使用这个插件时，其中的版权信息困扰着你（实际上对网站是没有任何影响的），可以通过插件中readme.txt中的邮箱和我联系。我可以教你如何去除。
阿呆马的博客 » 在WordPress首页显示图片摘要 said,
2009年1月13日 at 21:05
[...] left，right，或者center自选 更加具体的参数的意思，可以看原作者的网站http://www.wangzhongyuan.com/archives/556.html [...]
mybaby said,
2009年1月19日 at 16:36
这个插件在调用远程图片时是不是不能裁剪？？
仲远 said,
2009年1月19日 at 19:35
to mybaby:
是的，不能够裁剪。因为这个照片不在你的服务器上。
Setting.sun said,
2009年1月30日 at 11:53
仲兄，我发现一个问题
图片的缓存，并不是保存在wp-content/uploads/ZhongziImageCache/
而是保存到了
wp-content/uploads/下面的时间文件夹
不理解中！
希望得到答复
最好直接email我
hewaner said,
2009年3月5日 at 14:01
刚刚对照着看了我的模板，在index.php中没有找到the_exerpt或者the_content，怎我看看，怎么回事啊！！
网站地址：http://www.hewaner.cn/myblog/
对月而歌 said,
2009年3月6日 at 11:44
找啊.找找啊找了好几天就弄这个首页摘要插图,找到一个有后发现只能本站内部的可以用，找到您这个,哎 我弄上去上面一片乱码伤心死了,后来才看到你这个现在不支持IIS上面的,我哭啊,有啥解决办法么,真的是愁死个人儿啊.
岛上猫 said,
2009年3月23日 at 10:35
仲兄 你好
我想问问 如果 我想把图片放置在别的地方 是不是只要修改CSS代码就可以了？
很感谢你制作这个插件哦！
岛上猫 said,
2009年3月23日 at 10:40
补充
因为我使用的主题 它在左边放置了时间啊期啊一类的 右边是正文
所以看着左边有点空 我想把文章内的缩略图 放置到左边去 这样看着会比较舒服点
不知道要实现这样的效果 仲兄有什么解决的办法！
如果能抽点时间到我的博客进行技术指导 实在不胜感激！
仲远 said,
2009年3月23日 at 15:07
to 岛上猫：
你在模板中的index.php文件中，将
<div class="post-meta left-col">
<h3 class="wrap"><span class="month"><?php the_time('M'); ?><span class="year"><?php the_time('o'); ?></span></span><span class="day"><?php the_time('d'); ?></span></h3>
<h4 class="author"><?php the_author_posts_link(); ?></h4>
<h4 class="comments"><a href="<?php comments_link(); ?>"><?php comments_number('0','1','%'); ?></a></h4>
</div>
改为：
<div class="post-meta left-col">
<h3 class="wrap"><span class="month"><?php the_time('M'); ?><span class="year"><?php the_time('o'); ?></span></span><span class="day"><?php the_time('d'); ?></span></h3>
<?php if (function_exists("image_for_homepage")){image_for_homepage(true, 1, 80, 0, 'left', 'IFHL', '<div>', '</div>');} ?>
<h4 class="author"><?php the_author_posts_link(); ?></h4>
<h4 class="comments"><a href="<?php comments_link(); ?>"><?php comments_number('0','1','%'); ?></a></h4>
</div>
其中，函数调用中的80表示缩略图宽度为80，你可以根据自己的需要修改。还需要注意一点，如果你直接从网页上拷贝以上代码，如果报错，可能需要注意单引号以及双引号是否为英文格式的。
岛上猫 said,
2009年3月23日 at 16:24
谢谢仲兄～～已经成功了～～只有表示感谢了 呵呵
happyftp said,
2009年3月26日 at 20:54
用了一下，很好，谢谢拉。
小恒 said,
2009年4月8日 at 2:33
很喜欢的插件，但是能不能同时显示多张图片的？感谢感谢
仲远 said,
2009年4月8日 at 9:32
很遗憾，目前暂时没有显示多张图片的功能~
以后有时间，我会考虑开发这个功能的：）
布谷鸟 said,
2009年5月5日 at 12:52
建议增加一种显示方式：如设定数值a,b,则当宽度>高度时，按宽度a,高度保持比例显示; 当高度>宽度时，按高度b,宽度保持比例显示。
这样比较美观，像豆瓣九点：http://9.douban.com/subject/9277319/
onecm said,
2009年5月6日 at 1:21
问个问题，
假如有一篇文章没有图片，是否能调用一张默认图片呢？如何调用。
仲远 said,
2009年5月6日 at 20:50
to onecm：
对不起，目前没有此功能。没有图片的页面，首页上页不会显示缩略图。
不过今后可以考虑增加此功能，谢谢。
拉家具 said,
2009年5月25日 at 11:47
看我的模板，在index.php中没有找到the_exerpt或者the_content，怎么回事啊！！
网站地址：www.lajiaju.cn
拉家具 said,
2009年5月25日 at 11:50
这是index.php的内容
GeniusAlchemist said,
2009年5月25日 at 20:58
话说我的WP模板的index.php里没有the_excerpt或者the_content的说，只有发现在wp-atom.php里有几个get_the_excerpt和get_the_content的说= =为什么啊……我的index.php很简单，就几行，一个行貌似主题一行貌似调用wp-blog-header.php的说，没了……对了，WORDPRESS版本是2.7.1的。是不是新版修改过结构啊= =
仲远 said,
2009年5月25日 at 21:16
to GeniusAlchemist：
你的模板是什么？
如果你的模板是librio的话，在index.php中应该是有the_content()这行代码的。
eyesangel said,
2009年5月27日 at 19:33
仲远兄，在网上搜到你这个插件，非常好用。
不知道有没有考虑添加一个附属功能，目前这个插件已经很好的提供了缩略图的功能，可不可以稍稍修改一下，能够在正文里面直接把图片缩小成指定的大小或比例呢？
我试过将此插件在正文里面调用，但结果是出来一张缩略图的同时原图也显示出来了。不知道是我没有正确调用还是没有此功能
简单点说，就是让这个插件同时也解决掉正文里面图片过大会撑破页面的问题
例如加上一个参数
if (function_exists("image_for_homepage")){image_for_homepage(true, 1, 200, 0, 'right', 'IFHL', 'content"', ");}
有了content即表示此时调整正文显示的图片大小。不知道可不可以实现，谢谢
仲远 said,
2009年5月28日 at 16:04
to eyesangel：
谢谢你的关注。不过目前的插件没有这个功能。主要考虑是因为在正文中，你可以很方便地使用后台的编辑器调整图片的大小。所以就没有支持这个功能了。
sasa said,
2009年6月12日 at 9:30
这个插件实在太好用了，已经用上了！
有个问题？在the_content()加了上述的代码，假如在文章的第一张图片之后才加上read more，这样就会在首页产生两张图片，一张是缩略图，另外一张是read more之前的图片，这个问题能不能解决？
另外一个问题就是，能不能在后台或者代码里面控制首页输出多少张缩略图，例如文章有很多图片，想在首页输出几张缩略图这样的形式！期待下一个更新的版本！
cuiqingyao said,
2009年6月23日 at 16:22
请问下能不能在分类目录或是标签页用呢？
不是在首页，我不希望在首页用？
仲远 said,
2009年6月24日 at 20:53
to cuiqingyao:
可以的~
roc said,
2009年7月1日 at 14:30
今天安装ifh出现问题，一启用就把代码显示在页面上了，每个页面都有这些代码，是哪里出问题始终没有找到，请协助
本人php盲啊~~~加qq：53002102
我爱伪摇滚 said,
2009年7月12日 at 16:30
我来回答sasa的第一个问题吧，这个问题问过作者，把the_content()改为the_excerpt()调用就行了
tea said,
2009年7月22日 at 23:46
the_content()改为the_excerpt()之后，超链接或视频什么的就无效了，我希望能保持原来的内容不变。有没有什么办法把默认的图片隐藏，只显示缩略图。然后不影响其它内容
tea said,
2009年7月22日 at 23:47
补充一下我的网站，看了就知道我想要的效果了。
http://0898q.com/wp/
duola said,
2009年8月13日 at 20:31
博主你好，非常喜欢你的这个插件。我想问一下，我的博客调用你的插件之后首页缩略图变成这样了http://pic.yupoo.com/duolab/803807e77c7e/v63zqd0t.jpg，还有就是这个可不可以去掉，我不是想去掉你的插件版权，我会声明的，这个层我影响我windows live write的预览功能。希望博主能够理解。
jackpei said,
2009年9月21日 at 11:47
这个插件可否这样使用，首页图片控制统一大小，然后点击进入单篇文章链接后图片大小正常显示为上传的大小？谢谢！
仲远 said,
2009年9月21日 at 12:46
to jackpei:
现在难道不是这样吗？
如果你那边的效果不是这样的话，可能是你的调用有问题。你只需要在Homepage中进行调用。
如果你的网页的Homepage和SinglePage都是在index.php中的话，你可以通过is_home()来进行区别
urethritis said,
2009年10月7日 at 12:38
我的成功了，感谢兄弟阿，作出这么强大的东西，之前找了好几个方法，都没有成功，Thank you very much ！
我的博客：http://www.uuvidio.com
有这个插件，漂亮多了！
underone said,
2009年11月6日 at 11:55
这个插件还会更新不：）·
WordPress首页显示日志缩略图插件IFH典型调用 - ┊腾祖℡ 软件站 said,
2010年3月11日 at 12:34
[...] 本文可以自由转载，转载时请保留全文并注明出处： 转载自仲子说 [ http://www.wangzhongyuan.com/ ] 原文链接：http://www.wangzhongyuan.com/archives/556.html [...]
airyland said,
2010年3月29日 at 19:03
很感谢开发了这个插件。这也许是我发现的最方便最适合我想法的插件了。真的非常感谢。
skying said,
2010年4月14日 at 14:00
我找了很久，再没发现比这个更适合我想要的了，请问这个插件会更新吗？
中红网 said,
2010年5月28日 at 17:30
谢谢了，，，这个插件不错。。。。。。。。。
lemons said,
2010年7月7日 at 16:44
我在代码前加入了你说的调用
image_for_homepage(true, 1, 200, 0, 'right', 'IFHL', ", "
结果在首页没有实现缩略图的功能啊，就出现一列代码。
test3 | 芦志龙的博客 said,
2010年7月29日 at 13:50
[...] 更多的调用函数可以参见：《Wordpress首页显示日志缩略图插件IFH的典型调用》 插件使用效果图： [...]
千千伴奏网 said,
2010年8月4日 at 16:45
不错