<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>春去花还在-CoLee★＂ &#187; wp_list_bookmarks</title>
	<atom:link href="http://colee.99n9.com/tag/wp_list_bookmarks/feed/" rel="self" type="application/rss+xml" />
	<link>http://colee.99n9.com</link>
	<description>CoLee的网页设计制作素材、html、javacript、ajax代码精心自编或修改收藏，欢迎大家共享与交流。</description>
	<lastBuildDate>Tue, 04 Aug 2009 03:51:52 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.8</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>wp_list_bookmarks 函数全面分析</title>
		<link>http://colee.99n9.com/wp_list_bookmarks-%e5%87%bd%e6%95%b0%e5%85%a8%e9%9d%a2%e5%88%86%e6%9e%90/</link>
		<comments>http://colee.99n9.com/wp_list_bookmarks-%e5%87%bd%e6%95%b0%e5%85%a8%e9%9d%a2%e5%88%86%e6%9e%90/#comments</comments>
		<pubDate>Fri, 17 Jul 2009 09:16:54 +0000</pubDate>
		<dc:creator>CoLee★＂</dc:creator>
				<category><![CDATA[PHP]]></category>
		<category><![CDATA[wp_list_bookmarks]]></category>

		<guid isPermaLink="false">http://colee.99n9.com/?p=198</guid>
		<description><![CDATA[2.1 版本启用了一个新函数来代替以前常用的 Blogroll 的两个函数 get_links_list() 和 get_links() ，这2个函数可能会在以后的版本中被弃用，所以以后在调用 Blogroll 的时候最好用：
其实这个函数的用法和 wp_list_categories 基本相同，自定义的参数全部都写在了 “(’ ‘)” 里面，并且参数之间用 “&#38;” 连接。
下面是这个函数的默认参数：


$defaults = array('orderby' =&#62; 'name', 'order' =&#62; 'ASC', 'limit' =&#62; -1, 'category' =&#62; '',
  'category_name' =&#62; '', 'hide_invisible' =&#62; 1, 'show_updated' =&#62; 0, 'echo' =&#62; 1,
  'categorize' =&#62; 1, 'title_li' =&#62; __('Bookmarks'), 'title_before' =&#62; '&#60;h2&#62;', 'title_after' =&#62; [...]]]></description>
			<content:encoded><![CDATA[<p>2.1 版本启用了一个新函数来代替以前常用的 Blogroll 的两个函数 get_links_list() 和 get_links() ，这2个函数可能会在以后的版本中被弃用，所以以后在调用 Blogroll 的时候最好用：<br />
其实这个函数的用法和 wp_list_categories 基本相同，自定义的参数全部都写在了 “(’ ‘)” 里面，并且参数之间用 “&amp;” 连接。</p>
<p>下面是这个函数的默认参数：</p>
<div>
<div>
<pre>$defaults = array('orderby' =&gt; 'name', 'order' =&gt; 'ASC', 'limit' =&gt; -1, 'category' =&gt; '',
  'category_name' =&gt; '', 'hide_invisible' =&gt; 1, 'show_updated' =&gt; 0, 'echo' =&gt; 1,
  'categorize' =&gt; 1, 'title_li' =&gt; __('Bookmarks'), 'title_before' =&gt; '&lt;h2&gt;', 'title_after' =&gt; '&lt;/h2&gt;',
  'category_orderby' =&gt; 'name', 'category_order' =&gt; 'ASC', 'class' =&gt; 'linkcat',
  'category_before' =&gt; '&lt;li id="%id"&gt;', 'category_after' =&gt; '&lt;/li&gt;');</pre>
</div>
</div>
<p>相关参数：</p>
<p>categorize<br />
布尔型，用于设置连接是否按照各自的分类显示：<br />
1 （默认，根据链接的分类显示）<br />
0 （不按照分类，显示全部）<br />
categorize<br />
字符串型，后面就直接 “=链接的分类ID号” ，那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。<br />
category_name<br />
字符串型，如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称，如果这里留空的话则会显示所有链接分类的分类名称（即默认的形式）。（个人觉得这个参数不常用，一般不用管它）<br />
category_before<br />
字符串型，位于链接分类之前的文字或代码。默认的设置是：</p>
<li id="[category id]">category_after<br />
字符串型，位于链接分类之后的文字或代码。默认的设置是：其实这上面2个属性就是用来定义每个连接分类的样式，可以理解成下面这种形式：</li>
<li id="[category id]">单个链接分类下的链接列表class<br />
字符串型，每一个链接的分类都会有一个 “class” 属性（从上面的代码就能看出），默认是：linkcat<br />
category_orderby<br />
字符串型，链接分类的排序方式，按照名词或者ID。<br />
‘name‘ (默认)<br />
‘id‘<br />
category_order<br />
字符串型，链接分类的升降序排列方式：<br />
ASC (默认)<br />
DESC<br />
title_li<br />
字符串型，链接标题的头文字或代码，默认是：Bookmarks，并且它控制连接是否按照列表的方式排列。<br />
title_before 和 title_after<br />
顾名思义，它们就是连接标题头前后的文字或代码，默认是 h2 标签<br />
上面这2组参数，实际定义的是 Blogroll 上面的头标题，即这个“ Blogroll 分类列表”上的类名。这些大的分类默认是被 li 标签套起来的，然后各个大分类下的链接列表则是套用在 ul 下的 li 进行排列。（是不是看不懂我在说什么？看不懂就跳过…）</p>
<p>show_private<br />
布尔型，是否显示私有链接。<br />
1 (是)<br />
0 (不是 – 默认)<br />
include<br />
字符串型，输出指定 ID 的 Blogroll 的分类链接，各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。<br />
exclude<br />
字符串型，将指定 ID 的 Blogroll 分类链接从整个链接列表中排除，各个 ID 之间用半角的 “,” 分开。默认是什么都不排除。<br />
orderby<br />
字符串型，<br />
orderby<br />
字符串型，Blogroll 的排列方式（默认是根据名称排序，除非将这个值留空），即根据我们在 WP 后台链接设置界面下的那些参数来进行排序：<br />
‘id’<br />
‘url’<br />
‘name’<br />
‘target’<br />
‘description’<br />
‘owner’<br />
‘rating’<br />
‘updated’<br />
‘rel’ – 按设定的关系排列<br />
‘notes’<br />
‘rss’<br />
‘length’ – 连接名称的长度设定<br />
‘rand’ – 随机排列显示<br />
order<br />
字符串型，设置升降序的排列方式<br />
ASC (默认)<br />
DESC<br />
limit<br />
整型，设置输出链接条数的最大值。默认值是“-1”，输出全部。<br />
before 和 after<br />
字符串型，Blogroll 里每一条连接前面和后面的文字或代码，默认是 li 标签。<br />
category_before 和 category_after<br />
字符串型，各个 Blogroll 分类前后的文字或代码，默认也是 li 标签。<br />
between<br />
字符串型，每个连接、图片和描述之间的文字或代码，默认是 “\n” 换行。<br />
show_images<br />
布尔型，是否允许显示 Blogroll 下链接的对应图片。<br />
1 (允许 – 默认)<br />
0 (不允许)<br />
show_description<br />
布尔型，是否允许显示每个链接的描述。<br />
1 (允许)<br />
0 (不允许 – 默认)<br />
show_rating<br />
布尔型，是否允许显示链接的等级。<br />
1 (允许)<br />
0 (不允许 – 默认)<br />
show_updated<br />
布尔型，是否允许显示最近更新后的时间戳。<br />
1 (允许)<br />
0 (不允许 – 默认)<br />
hide_invisible<br />
布尔型，是否显示所有的链接，甚至是被管理员设为不可见的链接，默认允许显示。<br />
1 (允许 – 默认)<br />
0 (不允许)<br />
echo<br />
布尔型，是否允许显示连接 or return them for use by PHP（怎么翻译？！） (FALSE)。默认允许。<br />
1 (允许 – 默认)<br />
0 (不允许)</li>
]]></content:encoded>
			<wfw:commentRss>http://colee.99n9.com/wp_list_bookmarks-%e5%87%bd%e6%95%b0%e5%85%a8%e9%9d%a2%e5%88%86%e6%9e%90/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>WordPress之友情链接wp_list_bookmarks函数详解</title>
		<link>http://colee.99n9.com/wordpress%e4%b9%8bwp_list_bookmarks%e5%87%bd%e6%95%b0%e8%af%a6%e8%a7%a3/</link>
		<comments>http://colee.99n9.com/wordpress%e4%b9%8bwp_list_bookmarks%e5%87%bd%e6%95%b0%e8%af%a6%e8%a7%a3/#comments</comments>
		<pubDate>Tue, 30 Jun 2009 08:15:15 +0000</pubDate>
		<dc:creator>CoLee★＂</dc:creator>
				<category><![CDATA[PHP]]></category>
		<category><![CDATA[WordPress]]></category>
		<category><![CDATA[wp_list_bookmarks]]></category>

		<guid isPermaLink="false">http://colee.99n9.com/?p=8</guid>
		<description><![CDATA[WordPress的友情链接应用]]></description>
			<content:encoded><![CDATA[<p>wp_list_bookmarks 这个函数也是为Blogroll服务的，比以前的函数 get_links_list() 和 get_links() 更加强大，它有很多参数，参数和参数之前用&#8221;&amp;&#8221;分隔。详见全文。</p>
<p><span id="more-300"> </span></p>
<p>wp_list_bookmarks 函数的默认参数是：</p>
<p>&#8216;orderby&#8217; =&gt; &#8216;name&#8217;</p>
<p>&#8216;order&#8217; =&gt; &#8216;ASC&#8217;</p>
<p>&#8216;limit&#8217; =&gt; -1</p>
<p>&#8216;category&#8217; =&gt; &#8221;</p>
<p>&#8216;category_name&#8217; =&gt; &#8221;</p>
<p>&#8216;hide_invisible&#8217; =&gt; 1</p>
<p>&#8217;show_updated&#8217; =&gt; 0</p>
<p>&#8216;echo&#8217; =&gt; 1</p>
<p>&#8216;categorize&#8217; =&gt; 1</p>
<p>&#8216;title_li&#8217; =&gt; __(&#8217;Bookmarks&#8217;)</p>
<p>&#8216;title_before&#8217; =&gt; &#8216;&lt;h2&gt;&#8217;</p>
<p>&#8216;title_after&#8217; =&gt; &#8216;&lt;/h2&gt;&#8217;</p>
<p>&#8216;category_orderby&#8217; =&gt; &#8216;name&#8217;</p>
<p>&#8216;category_order&#8217; =&gt; &#8216;ASC&#8217;</p>
<p>&#8216;class&#8217; =&gt; &#8216;linkcat&#8217;</p>
<p>&#8216;category_before&#8217; =&gt; &#8216;&lt;li id=&#8221;%id&#8221; class=&#8221;%class&#8221;&gt;&#8217;</p>
<p>&#8216;category_after&#8217; =&gt; &#8216;&lt;/li&gt;&#8217;</p>
<p>下面我来一一介绍每个参数的用途：</p>
<p>categorize</p>
<p>布尔型，用于设置连接是否按照各自的分类显示：</p>
<p>1 （默认，根据链接的分类显示）</p>
<p>0 （不按照分类，显示全部）</p>
<p>category</p>
<p>字符串型，后面就直接 &#8220;=链接分类ID号&#8221;，那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。</p>
<p>category_name</p>
<p>字符串型，如果后面 &#8220;=某个链接分类的名称&#8221; 那么就会在该链接分类前显示分类的名称，如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。</p>
<p>category_before</p>
<p>字符串型，位于链接分类之前的文字或代码。默认的设置是：&lt;li id=&#8221;[category id]&#8221; class=&#8221;linkcat&#8221;&gt;</p>
<p>category_after</p>
<p>字符串型，位于链接分类之后的文字或代码。默认的设置是：&lt;/li&gt;</p>
<p>class</p>
<p>字符串型，每一个链接的分类都会有一个 &#8220;class&#8221; 属性（从上面的代码就能看出），默认是：linkcat</p>
<p>category_orderby</p>
<p>字符串型，链接分类的排序方式，按照名词或者ID。</p>
<p>&#8216;name&#8217; (默认)</p>
<p>&#8216;id&#8217;</p>
<p>category_order</p>
<p>字符串型，链接分类的升降序排列方式：</p>
<p>ASC (默认)</p>
<p>DESC</p>
<p>title_li</p>
<p>字符串型，链接标题的头文字或代码，默认是：Bookmarks，并且它控制连接是否按照列表的方式排列。</p>
<p>title_before 和 title_after</p>
<p>顾名思义，它们就是连接标题头前后的文字或代码，默认是 h2 标签</p>
<p>show_private</p>
<p>布尔型，是否显示私有链接。</p>
<p>1 (是)</p>
<p>0 (不是 &#8211; 默认)</p>
<p>include</p>
<p>字符串型，输出指定 ID 的 Blogroll 的分类链接，各个 ID 之间用半角的 &#8220;,&#8221; 分开。默认显示所有的 Blogroll 分类。</p>
<p>exclude</p>
<p>字符串型，将指定 ID 的 Blogroll 分类链接从整个链接列表中排除，各个 ID 之间用半角的 &#8220;,&#8221; 分开。默认是什么都不排除。</p>
<p>orderby</p>
<p>字符串型，Blogroll 的排列方式（默认是根据名称排序，除非将这个值留空），即根据我们在 WP 后台链接设置界面下的那些参数来进行排序：</p>
<p>1.&#8217;id’</p>
<p>2. &#8216;url’</p>
<p>3. &#8216;name’</p>
<p>4. &#8216;target’</p>
<p>5. &#8216;description’</p>
<p>6. &#8216;owner’</p>
<p>7. &#8216;rating’</p>
<p>8. &#8216;updated’</p>
<p>9. &#8216;rel’ &#8211; 按设定的关系排列</p>
<p>10. &#8216;notes’</p>
<p>11. &#8216;rss’</p>
<p>12. &#8216;length’ &#8211; 连接名称的长度设定</p>
<p>13. &#8216;rand’ &#8211; 随机排列显示</p>
<p>order</p>
<p>字符串型，设置升降序的排列方式</p>
<p>ASC (默认)</p>
<p>DESC</p>
<p>limit</p>
<p>整型，设置输出链接条数的最大值。默认值是&#8221;-1&#8243;，输出全部。</p>
<p>between</p>
<p>字符串型，每个连接、图片和描述之间的文字或代码，默认是 &#8220;n&#8221; 换行。</p>
<p>show_images</p>
<p>布尔型，是否允许显示 Blogroll 下链接的对应图片。</p>
<p>1 (允许 &#8211; 默认)</p>
<p>0 (不允许)</p>
<p>show_description</p>
<p>布尔型，是否允许显示每个链接的描述。</p>
<p>1 (允许)</p>
<p>0 (不允许 &#8211; 默认)</p>
<p>show_rating</p>
<p>布尔型，是否允许显示链接的等级。</p>
<p>1 (允许)</p>
<p>0 (不允许 &#8211; 默认)</p>
<p>show_updated</p>
<p>布尔型，是否允许显示最近更新后的时间戳。</p>
<p>1 (允许)</p>
<p>0 (不允许 &#8211; 默认)</p>
<p>hide_invisible</p>
<p>布尔型，是否显示所有的链接，甚至是被管理员设为不可见的链接，默认允许显示。</p>
<p>1 (允许 &#8211; 默认)</p>
<p>0 (不允许)</p>
<p>例如：</p>
<p>随机显示10条链接：</p>
<p>&lt;?php wp_list_bookmarks(&#8217;orderby=rand&amp;limit=10&#8242;); ?&gt;</p>
<p>随机显示分类ID为1的链接：</p>
<p>&lt;?php wp_list_bookmarks(&#8217;orderby=rand&amp;category=1&#8242;); ?&gt;</p>
<p>剩下的大家可以自己发挥了，呵呵。</p>
]]></content:encoded>
			<wfw:commentRss>http://colee.99n9.com/wordpress%e4%b9%8bwp_list_bookmarks%e5%87%bd%e6%95%b0%e8%af%a6%e8%a7%a3/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>

