春去花还在-CoLee★＂ » PHP http://colee.99n9.com CoLee的网页设计制作素材、html、javacript、ajax代码精心自编或修改收藏，欢迎大家共享与交流。 Tue, 04 Aug 2009 03:51:52 +0000 http://wordpress.org/?v=2.8 en hourly 1 WordPress主题标签(函数)参考手册 http://colee.99n9.com/wordpress%e4%b8%bb%e9%a2%98%e6%a0%87%e7%ad%be%e5%87%bd%e6%95%b0%e5%8f%82%e8%80%83%e6%89%8b%e5%86%8c/ http://colee.99n9.com/wordpress%e4%b8%bb%e9%a2%98%e6%a0%87%e7%ad%be%e5%87%bd%e6%95%b0%e5%8f%82%e8%80%83%e6%89%8b%e5%86%8c/#comments Fri, 17 Jul 2009 09:18:35 +0000 CoLee★＂ http://colee.99n9.com/?p=200 前段时间leesum用wordpress为客户设计制作的CMS企业网站主题（南京安富消防网）受到不少网友的青睐和垂询后在思考，是不是利用业务时间设计套通用的CMS主题或新闻、杂志型主题？想必大家都知道WordPress的主题的模板标签很多，即使一个WordPress主题制作高手，也很难记清楚每一个函数和相对应的参数。这时候，WordPress主题标签(函数)参考手册是相当受用且便捷的。

下面是leesum采集多篇网友日志整理汇总WordPress模板的基本资料和简单的函数说明，希望能给捣鼓wordpress主题和插件的朋友们有所帮助~~~

WordPress基本模板文件
一套完整的WordPress模板应至少具有如下文件：

* style.css : CSS(样式表)文件
* index.php : 主页模板[separator]
* archive.php : Archive/Category模板
* 404.php : Not Found 错误页模板
* comments.php : 留言/回复模板
* footer.php : Footer模板
* header.php : Header模板<!- -nextpage- ->
* sidebar.php : 侧栏模板
* page.php : 内容页(Page)模板
* single.php : 内容页(Post)模板
* searchform.php : 搜索表单模板
* search.php : 搜索结果模板

当然，具体到特定的某款模板，可能不止这些文件，但一般而言，这些文件是每套模板所必备的。

基本条件判断Tag

* is_home() : 是否为主页
* is_single() : 是否为内容页(Post)
* is_page() : 是否为内容页(Page)
* is_category() : 是否为Category/Archive页
* is_tag() : 是否为Tag存档页
* is_date() : 是否为指定日期存档页
* is_year() : 是否为指定年份存档页
* is_month() : 是否为指定月份存档页
* is_day() : 是否为指定日存档页
* is_time() : 是否为指定时间存档页
* is_archive() : 是否为存档页
* is_search() : 是否为搜索结果页
* is_404() : 是否为 “HTTP 404: Not Found” 错误页
* is_paged() : 主页/Category/Archive页是否以多页显示

Header部分常用到的PHP函数

* <?php bloginfo(’name’); ?> : 博客名称(Title)
* <?php bloginfo(’stylesheet_url’); ?> : CSS文件路径
* <?php bloginfo(’pingback_url’); ?> : PingBack Url
* <?php bloginfo(’template_url’); ?> : 模板文件路径
* <?php bloginfo(’version’); ?> : WordPress版本
* <?php bloginfo(’atom_url’); ?> : Atom Url
* <?php bloginfo(’rss2_url’); ?> : RSS 2.o Url
* <?php bloginfo(’url’); ?> : 博客 Url
* <?php bloginfo(’html_type’); ?> : 博客网页Html类型
* <?php bloginfo(’charset’); ?> : 博客网页编码
* <?php bloginfo(’description’); ?> : 博客描述
* <?php wp_title(); ?> : 特定内容页(Post/Page)的标题

模板常用的PHP函数及命令

* <?php get_header(); ?> : 调用Header模板
* <?php get_sidebar(); ?> : 调用Sidebar模板
* <?php get_footer(); ?> : 调用Footer模板
* <?php the_content(); ?> : 显示内容(Post/Page)
* <?php if(have_posts()) : ?> : 检查是否存在Post/Page
* <?php while(have_posts()) : the_post(); ?> : 如果存在Post/Page则予以显示
* <?php endwhile; ?> : While 结束
* <?php endif; ?> : If 结束
* <?php the_time(’字符串’) ?> : 显示时间，时间格式由“字符串”参数决定，具体参考PHP手册
* <?php comments_popup_link(); ?> : 正文中的留言链接。如果使用 comments_popup_script() ，则留言会在新窗口中打开，反之，则在当前窗口打开
* <?php the_title(); ?> : 内容页(Post/Page)标题
* <?php the_permalink() ?> : 内容页(Post/Page) Url
* <?php the_category(’, ‘) ?> : 特定内容页(Post/Page)所属Category
* <?php the_author(); ?> : 作者
* <?php the_ID(); ?> : 特定内容页(Post/Page) ID
* <?php edit_post_link(); ?> : 如果用户已登录并具有权限，显示编辑链接
* <?php get_links_list(); ?> : 显示Blogroll中的链接
* <?php comments_template(); ?> : 调用留言/回复模板
* <?php wp_list_pages(); ?> : 显示Page列表
* <?php wp_list_categories(); ?> : 显示Categories列表
* <?php next_post_link(’ %link ‘); ?> : 下一篇文章链接
* <?php previous_post_link(’%link’); ?> : 上一篇文章链接
* <?php get_calendar(); ?> : 日历
* <?php wp_get_archives() ?> : 显示内容存档
* <?php posts_nav_link(); ?> : 导航，显示上一篇/下一篇文章链接
* <?php include(TEMPLATEPATH . ‘/文件名’); ?> : 嵌入其他文件，可为定制的模板或其他类型文件

与主题模板相关的其他函数

* <?php _e(’Message’); ?> : 输出相应信息
* <?php wp_register(); ?> : 显示注册链接
* <?php wp_loginout(); ?> : 显示登录/注销链接
* <!–next page–> : 将当前内容分页
* <!–more–> : 将当前内容截断，以不在主页/目录页显示全部内容
* <?php timer_stop(1); ?> : 网页加载时间(秒)
* <?php echo get_num_queries(); ?> : 网页加载查询量

]]> http://colee.99n9.com/wordpress%e4%b8%bb%e9%a2%98%e6%a0%87%e7%ad%be%e5%87%bd%e6%95%b0%e5%8f%82%e8%80%83%e6%89%8b%e5%86%8c/feed/ 0 wp_list_bookmarks 函数全面分析 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/ 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 Fri, 17 Jul 2009 09:16:54 +0000 CoLee★＂ http://colee.99n9.com/?p=198 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' => '<h2>', 'title_after' => '</h2>',
  'category_orderby' => 'name', 'category_order' => 'ASC', 'class' => 'linkcat',
  'category_before' => '<li id="%id">', 'category_after' => '</li>');

相关参数：

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

  • category_after
    字符串型，位于链接分类之后的文字或代码。默认的设置是：其实这上面2个属性就是用来定义每个连接分类的样式，可以理解成下面这种形式：
  • 单个链接分类下的链接列表class
    字符串型，每一个链接的分类都会有一个 “class” 属性（从上面的代码就能看出），默认是：linkcat
    category_orderby
    字符串型，链接分类的排序方式，按照名词或者ID。
    ‘name‘ (默认)
    ‘id‘
    category_order
    字符串型，链接分类的升降序排列方式：
    ASC (默认)
    DESC
    title_li
    字符串型，链接标题的头文字或代码，默认是：Bookmarks，并且它控制连接是否按照列表的方式排列。
    title_before 和 title_after
    顾名思义，它们就是连接标题头前后的文字或代码，默认是 h2 标签
    上面这2组参数，实际定义的是 Blogroll 上面的头标题，即这个“ Blogroll 分类列表”上的类名。这些大的分类默认是被 li 标签套起来的，然后各个大分类下的链接列表则是套用在 ul 下的 li 进行排列。（是不是看不懂我在说什么？看不懂就跳过…）

    show_private
    布尔型，是否显示私有链接。
    1 (是)
    0 (不是 – 默认)
    include
    字符串型，输出指定 ID 的 Blogroll 的分类链接，各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。
    exclude
    字符串型，将指定 ID 的 Blogroll 分类链接从整个链接列表中排除，各个 ID 之间用半角的 “,” 分开。默认是什么都不排除。
    orderby
    字符串型，
    orderby
    字符串型，Blogroll 的排列方式（默认是根据名称排序，除非将这个值留空），即根据我们在 WP 后台链接设置界面下的那些参数来进行排序：
    ‘id’
    ‘url’
    ‘name’
    ‘target’
    ‘description’
    ‘owner’
    ‘rating’
    ‘updated’
    ‘rel’ – 按设定的关系排列
    ‘notes’
    ‘rss’
    ‘length’ – 连接名称的长度设定
    ‘rand’ – 随机排列显示
    order
    字符串型，设置升降序的排列方式
    ASC (默认)
    DESC
    limit
    整型，设置输出链接条数的最大值。默认值是“-1”，输出全部。
    before 和 after
    字符串型，Blogroll 里每一条连接前面和后面的文字或代码，默认是 li 标签。
    category_before 和 category_after
    字符串型，各个 Blogroll 分类前后的文字或代码，默认也是 li 标签。
    between
    字符串型，每个连接、图片和描述之间的文字或代码，默认是 “\n” 换行。
    show_images
    布尔型，是否允许显示 Blogroll 下链接的对应图片。
    1 (允许 – 默认)
    0 (不允许)
    show_description
    布尔型，是否允许显示每个链接的描述。
    1 (允许)
    0 (不允许 – 默认)
    show_rating
    布尔型，是否允许显示链接的等级。
    1 (允许)
    0 (不允许 – 默认)
    show_updated
    布尔型，是否允许显示最近更新后的时间戳。
    1 (允许)
    0 (不允许 – 默认)
    hide_invisible
    布尔型，是否显示所有的链接，甚至是被管理员设为不可见的链接，默认允许显示。
    1 (允许 – 默认)
    0 (不允许)
    echo
    布尔型，是否允许显示连接 or return them for use by PHP（怎么翻译？！） (FALSE)。默认允许。
    1 (允许 – 默认)
    0 (不允许)

    • ]]>     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/ 0     字符串替换函数str_replace使用帮助 http://colee.99n9.com/%e5%ad%97%e7%ac%a6%e4%b8%b2%e6%9b%bf%e6%8d%a2%e5%87%bd%e6%95%b0str_replace%e4%bd%bf%e7%94%a8%e5%b8%ae%e5%8a%a9/ http://colee.99n9.com/%e5%ad%97%e7%ac%a6%e4%b8%b2%e6%9b%bf%e6%8d%a2%e5%87%bd%e6%95%b0str_replace%e4%bd%bf%e7%94%a8%e5%b8%ae%e5%8a%a9/#comments Fri, 03 Jul 2009 02:19:11 +0000 CoLee★＂ http://colee.99n9.com/?p=61 str_replace函数

    功能: 字符串替换

    语法: string str_replace(string needle, string str, string haystack);

    返回值: 字符串

    函数种类: 字符串处理

    本函数将字符串 str 代入 haystack 字符串中，将所有的 needle 置换成 str。mlevine@adtraq.com (11-Apr-1999) 指出在 PHP 3.0.7 版，本函数有些 bug，而 nadeem@bleh.org (05-Jun-1999) 补充在 PHP 3.0.8 版本函数就回复正常了。

    使用范例

    下例将 %body% 以 black 取代

    < php

    $bodytag = str_replace(”%body%”, “black”, “<body text=%body%>”);

    echo $bodytag;

    >

    格式：

    [@str_replace("要替换的旧内容", "要取代原内容的新字符", $被替换内容的变量名)]

    [@str_replace(array('旧1','旧2','旧3'), array('新1','新2','新3'), $被替换内容的变量名)]

    [@str_replace(array('旧1','旧2','旧3'), '新内容', $被替换内容的变量名)]

    实例：

    多对一替换：想把内容字段里所有的<p></p>标签清除掉,替换成空

    [@str_replace(array('<p>','</p>'), '', $Content)]

    一对一替换：想把内容字段里所有的<br>标签换成<p>

    [@str_replace('<br>', '<p>', $Content)]

    多对多替换：想把内容字段里的<br>换成<br />, 同时<p>换<hr>，把</p>全清除

    [@str_replace(array('<br>', '<p>','</p>'), array('<br />','<hr>',''), $Content)]

    ]]>     http://colee.99n9.com/%e5%ad%97%e7%ac%a6%e4%b8%b2%e6%9b%bf%e6%8d%a2%e5%87%bd%e6%95%b0str_replace%e4%bd%bf%e7%94%a8%e5%b8%ae%e5%8a%a9/feed/ 0     wordpress架构结构图 http://colee.99n9.com/wordpress%e6%9e%b6%e6%9e%84%e7%bb%93%e6%9e%84%e5%9b%be/ http://colee.99n9.com/wordpress%e6%9e%b6%e6%9e%84%e7%bb%93%e6%9e%84%e5%9b%be/#comments Wed, 01 Jul 2009 07:48:06 +0000 CoLee★＂ http://colee.99n9.com/?p=49 这张wordpress架构结构图，能在你写主题提供很清晰的思路。

    wordpress主题模板结构图

    wordpress主题模板结构图

    ]]>     http://colee.99n9.com/wordpress%e6%9e%b6%e6%9e%84%e7%bb%93%e6%9e%84%e5%9b%be/feed/ 0     WordPress主题标签(函数)参考 http://colee.99n9.com/wordpress%e4%b8%bb%e9%a2%98%e6%a0%87%e7%ad%be%e5%87%bd%e6%95%b0%e5%8f%82%e8%80%83/ http://colee.99n9.com/wordpress%e4%b8%bb%e9%a2%98%e6%a0%87%e7%ad%be%e5%87%bd%e6%95%b0%e5%8f%82%e8%80%83/#comments Wed, 01 Jul 2009 07:07:28 +0000 CoLee★＂ http://colee.99n9.com/?p=45 WordPress基本模板文件一套完整的WordPress模板应至少具有如下文件： * style.css : CSS(样式表)文件 * index.php : 主页模板[separator] * archive.php : Archive/Category模板 * 404.php : Not Found 错误页模板 * comments.php : 留言/回复模板 * footer.php : Footer模板 * header.php : Header模板

    * sidebar.php : 侧栏模板 * page.php : 内容页(Page)模板 * single.php : 内容页(Post)模板 * searchform.php : 搜索表单模板 * search.php : 搜索结果模板 当然，具体到特定的某款模板，可能不止这些文件，但一般而言，这些文件是每套模板所必备的。 基本条件判断Tag * is_home() : 是否为主页 * is_single() : 是否为内容页(Post) * is_page() : 是否为内容页(Page) * is_category() : 是否为Category/Archive页 * is_tag() : 是否为Tag存档页 * is_date() : 是否为指定日期存档页 * is_year() : 是否为指定年份存档页 * is_month() : 是否为指定月份存档页 * is_day() : 是否为指定日存档页 * is_time() : 是否为指定时间存档页 * is_archive() : 是否为存档页 * is_search() : 是否为搜索结果页 * is_404() : 是否为 “HTTP 404: Not Found” 错误页 * is_paged() : 主页/Category/Archive页是否以多页显示 Header部分常用到的PHP函数 *

    : 博客名称(Title) *

    : CSS文件路径 *

    : PingBack Url *

    : 模板文件路径 *

    : WordPress版本 *

    : Atom Url *

    : RSS 2.o Url *

    : 博客 Url *

    : 博客网页Html类型 *

    : 博客网页编码 *

    : 博客描述 *

    : 特定内容页(Post/Page)的标题 模板常用的PHP函数及命令 *

    : 调用Header模板 *

    : 调用Sidebar模板 *

    : 调用Footer模板 *

    : 显示内容(Post/Page) *

    : 检查是否存在Post/Page *

    : 如果存在Post/Page则予以显示 *

    : While 结束 *

    : If 结束 *

    : 显示时间，时间格式由“字符串”参数决定，具体参考PHP手册 *

    : 正文中的留言链接。如果使用 comments_popup_script() ，则留言会在新窗口中打开，反之，则在当前窗口打开 *

    : 内容页(Post/Page)标题 *

    : 内容页(Post/Page) Url *

    : 特定内容页(Post/Page)所属Category *

    : 作者 *

    : 特定内容页(Post/Page) ID *

    : 如果用户已登录并具有权限，显示编辑链接 *

    : 显示Blogroll中的链接 *

    : 调用留言/回复模板 *

    : 显示Page列表 *

    : 显示Categories列表 *

    : 下一篇文章链接 *

    : 上一篇文章链接 *

    : 日历 *

    : 显示内容存档 *

    : 导航，显示上一篇/下一篇文章链接 *

    : 嵌入其他文件，可为定制的模板或其他类型文件 与主题模板相关的其他函数 *

    : 输出相应信息 *

    : 显示注册链接 *

    : 显示登录/注销链接 *

    : 将当前内容分页 *

    : 将当前内容截断，以不在主页/目录页显示全部内容 *

    : 网页加载时间(秒) *

    : 网页加载查询量

    ]]>     http://colee.99n9.com/wordpress%e4%b8%bb%e9%a2%98%e6%a0%87%e7%ad%be%e5%87%bd%e6%95%b0%e5%8f%82%e8%80%83/feed/ 0     WordPress之友情链接wp_list_bookmarks函数详解 http://colee.99n9.com/wordpress%e4%b9%8bwp_list_bookmarks%e5%87%bd%e6%95%b0%e8%af%a6%e8%a7%a3/ http://colee.99n9.com/wordpress%e4%b9%8bwp_list_bookmarks%e5%87%bd%e6%95%b0%e8%af%a6%e8%a7%a3/#comments Tue, 30 Jun 2009 08:15:15 +0000 CoLee★＂ http://colee.99n9.com/?p=8 wp_list_bookmarks 这个函数也是为Blogroll服务的，比以前的函数 get_links_list() 和 get_links() 更加强大，它有很多参数，参数和参数之前用”&”分隔。详见全文。

     

    wp_list_bookmarks 函数的默认参数是：

    ‘orderby’ => ‘name’

    ‘order’ => ‘ASC’

    ‘limit’ => -1

    ‘category’ => ”

    ‘category_name’ => ”

    ‘hide_invisible’ => 1

    ’show_updated’ => 0

    ‘echo’ => 1

    ‘categorize’ => 1

    ‘title_li’ => __(’Bookmarks’)

    ‘title_before’ => ‘<h2>’

    ‘title_after’ => ‘</h2>’

    ‘category_orderby’ => ‘name’

    ‘category_order’ => ‘ASC’

    ‘class’ => ‘linkcat’

    ‘category_before’ => ‘<li id=”%id” class=”%class”>’

    ‘category_after’ => ‘</li>’

    下面我来一一介绍每个参数的用途：

    categorize

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

    1 （默认，根据链接的分类显示）

    0 （不按照分类，显示全部）

    category

    字符串型，后面就直接 “=链接分类ID号”，那么就显示这个分类下的链接。如果没有指定的话就显示所有的链接。

    category_name

    字符串型，如果后面 “=某个链接分类的名称” 那么就会在该链接分类前显示分类的名称，如果这里留空的话则会显示所有链接分类的分类名称(即默认的形式)。

    category_before

    字符串型，位于链接分类之前的文字或代码。默认的设置是：<li id=”[category id]” class=”linkcat”>

    category_after

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

    class

    字符串型，每一个链接的分类都会有一个 “class” 属性（从上面的代码就能看出），默认是：linkcat

    category_orderby

    字符串型，链接分类的排序方式，按照名词或者ID。

    ‘name’ (默认)

    ‘id’

    category_order

    字符串型，链接分类的升降序排列方式：

    ASC (默认)

    DESC

    title_li

    字符串型，链接标题的头文字或代码，默认是：Bookmarks，并且它控制连接是否按照列表的方式排列。

    title_before 和 title_after

    顾名思义，它们就是连接标题头前后的文字或代码，默认是 h2 标签

    show_private

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

    1 (是)

    0 (不是 – 默认)

    include

    字符串型，输出指定 ID 的 Blogroll 的分类链接，各个 ID 之间用半角的 “,” 分开。默认显示所有的 Blogroll 分类。

    exclude

    字符串型，将指定 ID 的 Blogroll 分类链接从整个链接列表中排除，各个 ID 之间用半角的 “,” 分开。默认是什么都不排除。

    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

    字符串型，设置升降序的排列方式

    ASC (默认)

    DESC

    limit

    整型，设置输出链接条数的最大值。默认值是”-1″，输出全部。

    between

    字符串型，每个连接、图片和描述之间的文字或代码，默认是 “n” 换行。

    show_images

    布尔型，是否允许显示 Blogroll 下链接的对应图片。

    1 (允许 – 默认)

    0 (不允许)

    show_description

    布尔型，是否允许显示每个链接的描述。

    1 (允许)

    0 (不允许 – 默认)

    show_rating

    布尔型，是否允许显示链接的等级。

    1 (允许)

    0 (不允许 – 默认)

    show_updated

    布尔型，是否允许显示最近更新后的时间戳。

    1 (允许)

    0 (不允许 – 默认)

    hide_invisible

    布尔型，是否显示所有的链接，甚至是被管理员设为不可见的链接，默认允许显示。

    1 (允许 – 默认)

    0 (不允许)

    例如：

    随机显示10条链接：

    <?php wp_list_bookmarks(’orderby=rand&limit=10′); ?>

    随机显示分类ID为1的链接：

    <?php wp_list_bookmarks(’orderby=rand&category=1′); ?>

    剩下的大家可以自己发挥了，呵呵。

    ]]>     http://colee.99n9.com/wordpress%e4%b9%8bwp_list_bookmarks%e5%87%bd%e6%95%b0%e8%af%a6%e8%a7%a3/feed/ 0