網生@誌 | zEUS.'Blog » wp_list_bookmarks http://zeuscn.net Not Only Wordpress Template, But Also My Life... Tue, 23 Feb 2010 11:20:15 +0000 http://wordpress.org/?v=2.8.4 en hourly 1 简单定制 Wordpress 友情链接页面 http://zeuscn.net/archives/2008/03/28/easily-create-a-link-page.html http://zeuscn.net/archives/2008/03/28/easily-create-a-link-page.html#comments Fri, 28 Mar 2008 13:29:31 +0000 zEUS. http://zeuscn.net/archives/2008/03/28/easily-create-a-link-page/ wordpress曾经我很傻很天真的做了一个“友情链接”的页面，每次和朋友交换友链除了在 WP 后台的链接页面添加外，还要手动编辑“友情链接”页面里的链接… 非常繁琐… 不过当我知道了 WP 有一个控制 Blogroll 的 wp_list_bookmarks 函数后，发现原来一切都是那么简单… 好了，废话少说，来看怎么制作这个页面。

先在 WP 后台 链接 的 分类 标签下设置好你所需的分类：

wordpress
记住每个分类对应的 ID 号。
再回到管理链接的页面下，给友情链接添加描述并将其放到相应的分类下：
wordpress

友情链接编辑完成后，就开始建立一个“页面模板”。打开所使用的主题包中的 page.php 文件，在文件最前面加上下面的“声明代码”：

/*
Template Name: Links Page Template PAGE
*/
?>

再找到如下代码：



修改中间的 the_content() 函数：

&after=

&show_images=0&show_description=1&orderby=name&title_before=

&title_after=

‘); ?>



将上面的 XX YY ZZ 修改成第一步中记下的 Blogroll 分类的 ID 号，ID 号之间用半角的 “,” 分开。
看过《wp_list_bookmarks 函数详解 》的朋友估计看得懂上面的这个 () 函数：

  1. categorize=1 — 显示所有 Blogroll 的分类；
  2. category=XX,YY,ZZ — 指定显示 ID 为 XX YY ZZ 的 Blogroll 分类，如果您的 Blogroll 没有一个总的大分类话，这个参数可以去掉，因为上一个参数已经指定了显示所有分类；
  3. category_orderby=id — 分类按照 ID 号进行排列，假如 XX>ZZ>YY 那么最终显示的顺序就是：XX 分类下的链接、ZZ 分类下的链接、YY 分类下的链接；
  4. before 和 after — 每个连接前后都用 li 标签套起来；
  5. show_images=0 — 不显示链接的图片；
  6. show_description=1 — 显示连接的描述；
  7. orderby=name — Blogroll 的链接根据其名称排序；
  8. title_before 和 title_after — 分类标题前后用 h3 标签套起来（主要是为了加入 h3 的样式）。

接下来只需要将这个文件另存为一个 php 文件就行了，比如：link_temp.php ，将其上传到到主题文件夹的目录下。

最后撰写一个新页面，并在右侧的页面模块选择刚刚上传的 “Links Page Template PAGE”
wordpress
写上标题 “友情链接” 和缩略名 “links” ，保存… 转到前台查看这个页面，是不是效果已经出来了呢？
以后凡是在 WP 后台链接里添加完链接之后，这个页面也会自动更新。无需再进行其它操作了。

上述是建立友情链接页面最基础的方法，也许会因为样式的原因不是特别美观，那么就需要您自己给这个页面写上相应的样式。
以我现在使用的 Ipple Ultra 为例，点击 这里 下载我已经预写好的 link_temp.php 文件，修改其中对应的 Blogroll 分类的 ID 号之后上传到主题文件中，最后把下面这段 CSS 代码直接添加到 style.css 文件的末尾即可：

.link-entry {
float:left;
margin:0px auto 10px;
padding-bottom:5px;
width:609px;
list-style:none;
}
.link-entry ul li{
background:transparent url(images/rnd-li.gif) no-repeat scroll left 2px;
padding:1px 16px;
list-style:none;
}

最终效果，可以直接参考我的 友情链接 页面 :smile:

日志评论

本文地址：http://zeuscn.net/archives/2008/03/28/easily-create-a-link-page.html，转载原创文章请注明 zEUScn.NET ‖ 您可以直接 发布评论

Copyright©zEUScn.NET.Some rights reserved.

(Digital Fingerprint:
05538bd2e0492fe803256b5788cfa6fd)

相关文章

]]> http://zeuscn.net/archives/2008/03/28/easily-create-a-link-page.html/feed 46 wp_list_bookmarks 函数详解 http://zeuscn.net/archives/2008/03/28/wp_list_bookmarks.html http://zeuscn.net/archives/2008/03/28/wp_list_bookmarks.html#comments Fri, 28 Mar 2008 06:33:32 +0000 zEUS. http://zeuscn.net/archives/2008/03/28/wp_list_bookmarks/ ‘name’, ‘order’ => ‘ASC’, ‘limit’ => -1, ‘category’ => ”, ‘category_name’ => ”, ‘hide_invisible’ => 1, ’show_updated’ => 0, ‘echo’ => 1, ‘categorize’ => 1, ‘title_li’ => __(’Bookmarks’), ‘title_before’ => ‘ ‘, ‘title_after’ [...]]]> wordpress 2.1 版本启用了一个新函数来代替以前常用的 Blogroll 的两个函数 get_links_list() 和 get_links() ，这2个函数可能会在以后的版本中被弃用，所以以后在调用 Blogroll 的时候最好用：



其实这个函数的用法和 wp_list_categories 基本相同，自定义的参数全部都写在了 “(’ ‘)” 里面，并且参数之间用 “&” 连接。

下面是这个函数的默认参数：

$defaults = array(’orderby’ => ‘name’, ‘order’ => ‘ASC’, ‘limit’ => -1, ‘category’ => ”,
‘category_name’ => ”, ‘hide_invisible’ => 1, ’show_updated’ => 0, ‘echo’ => 1,
‘categorize’ => 1, ‘title_li’ => __(’Bookmarks’), ‘title_before’ => ‘

‘, ‘title_after’ => ‘

‘,
‘category_orderby’ => ‘name’, ‘category_order’ => ‘ASC’, ‘class’ => ‘linkcat’,
‘category_before’ => ‘

  • ‘, ‘category_after’ => ‘

    • ‘);

    相关参数：

      categorize
      布尔型，用于设置连接是否按照各自的分类显示：

    1. 1 （默认，根据链接的分类显示）
    2. 0 （不按照分类，显示全部）
      categorize
      字符串型，后面就直接 “=链接的分类ID号” ，那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。
      category_name
      字符串型，如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称，如果这里留空的话则会显示所有链接分类的分类名称（即默认的形式）。（个人觉得这个参数不常用，一般不用管它）
      category_before
      字符串型，位于链接分类之前的文字或代码。默认的设置是：

      category_after
      字符串型，位于链接分类之后的文字或代码。默认的设置是：

    其实这上面2个属性就是用来定义每个连接分类的样式，可以理解成下面这种形式：

  • 单个链接分类下的链接列表

      • class
      字符串型，每一个链接的分类都会有一个 “class” 属性（从上面的代码就能看出），默认是：linkcat
      category_orderby
      字符串型，链接分类的排序方式，按照名词或者ID。

    1. ‘name‘ (默认)
    2. ‘id‘
      category_order
      字符串型，链接分类的升降序排列方式：

    1. ASC (默认)
    2. DESC
      title_li
      字符串型，链接标题的头文字或代码，默认是：Bookmarks，并且它控制连接是否按照列表的方式排列。
      title_before 和 title_after
      顾名思义，它们就是连接标题头前后的文字或代码，默认是 h2 标签

    上面这2组参数，实际定义的是 Blogroll 上面的头标题，即这个“ Blogroll 分类列表”上的类名。这些大的分类默认是被 li 标签套起来的，然后各个大分类下的链接列表则是套用在 ul 下的 li 进行排列。（是不是看不懂我在说什么？看不懂就跳过…）

      show_private
      布尔型，是否显示私有链接。

    1. 1 (是)
    2. 0 (不是 – 默认)
      include
      字符串型，输出指定 ID 的 Blogroll 的分类链接，各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。
      exclude
      字符串型，将指定 ID 的 Blogroll 分类链接从整个链接列表中排除，各个 ID 之间用半角的 “,” 分开。默认是什么都不排除。
      orderby
      字符串型，
      orderby
      字符串型，Blogroll 的排列方式（默认是根据名称排序，除非将这个值留空），即根据我们在 WP 后台链接设置界面下的那些参数来进行排序：

    1. ‘id’
    2. ‘url’
    3. ‘name’
    4. ‘target’
    5. ‘description’
    6. ‘owner’
    7. ‘rating’
    8. ‘updated’
    9. ‘rel’ – 按设定的关系排列
    10. ‘notes’
    11. ‘rss’
    12. ‘length’ – 连接名称的长度设定
    13. ‘rand’ – 随机排列显示
      order
      字符串型，设置升降序的排列方式

    1. ASC (默认)
    2. DESC
      limit
      整型，设置输出链接条数的最大值。默认值是“-1”，输出全部。
      before 和 after
      字符串型，Blogroll 里每一条连接前面和后面的文字或代码，默认是 li 标签。
      category_before 和 category_after
      字符串型，各个 Blogroll 分类前后的文字或代码，默认也是 li 标签。
      between
      字符串型，每个连接、图片和描述之间的文字或代码，默认是 “\n” 换行。
      show_images
      布尔型，是否允许显示 Blogroll 下链接的对应图片。

    1. 1 (允许 – 默认)
    2. 0 (不允许)
      show_description
      布尔型，是否允许显示每个链接的描述。

    1. 1 (允许)
    2. 0 (不允许 – 默认)
      show_rating
      布尔型，是否允许显示链接的等级。

    1. 1 (允许)
    2. 0 (不允许 – 默认)
      show_updated
      布尔型，是否允许显示最近更新后的时间戳。

    1. 1 (允许)
    2. 0 (不允许 – 默认)
      hide_invisible
      布尔型，是否显示所有的链接，甚至是被管理员设为不可见的链接，默认允许显示。

    1. 1 (允许 – 默认)
    2. 0 (不允许)
      echo
      布尔型，是否允许显示连接 or return them for use by PHP（怎么翻译？！） (FALSE)。默认允许。

    1. 1 (允许 – 默认)
    2. 0 (不允许)

    下面是几个例子：
    最简单的 Blogroll 列表：
    显示所有链接，Blogroll 的标题为 h2 标签下的 “Bookmarks”，链接套在 li 标签内




    显示根据 URL 排序的，指定分类的链接：
    显示链接分类为2的 Blogroll ，并给每个连接一个 span 的属性，显示连接图片，不显示描述，根据 url 进行排序。

    &after=&show_images=1&show_description=0&orderby=url’); ?>


    显示分级和时间戳：
    显示所有链接，描述另起一行，不显示图片，根据链接的 ID 排序，并显示链接分级和最近更新的时间戳。

      &show_images=0&orderby=id&show_rating=1&show_updated=1′); ?>

    在了解了 函数后，会不会觉得新建一个丰富的“友情链接”的页面也是一件很容易的事情了呢？

    zEUS.

    日志评论

    本文地址：http://zeuscn.net/archives/2008/03/28/wp_list_bookmarks.html，转载原创文章请注明 zEUScn.NET ‖ 您可以直接 发布评论

    Copyright©zEUScn.NET.Some rights reserved.

    (Digital Fingerprint:
    05538bd2e0492fe803256b5788cfa6fd)

    相关文章

    ]]>     http://zeuscn.net/archives/2008/03/28/wp_list_bookmarks.html/feed 31