WordPress函数

如果你是一名WordPress开发者，你可能知道WordPress函数 the_content() 可以直接输出文章内容，而 get_the_content() 则需要在前面添加 echo 才可以输出文章内容。 <?php the_content(); echo get_the_content(); ?> 这是WordPress内置函数的一个很重要的标志，the_ 开头的函数直接输出，…

count_user_posts 是一个用来获取用户文章数量的WordPress函数，该函数位于 wp-includes/user.php 文件，具体代码如下：function count_user_posts( $userid, $post_type = 'post' ) { global $wpdb; $where = get_posts_by_author_sql( $p…

在 WordPress 开发的过程中，我们需要使用到各种 WordPress 函数，今天介绍一个非常简单实用的选择函数 selected() ，它可以简化我们制作一个多项选择列表的代码量。 按照常规方法，要制作一个下拉选择列表，我们通常要使用 if() 函数进行判断：<!-- Testing the values with if() --> <select name="…

描述 add_meta_box() 函数是在 WordPress 2.5 添加的，用来给插件开发者添加 Meta模块 到管理界面。 用法 <?php add_meta_box( $id, $title, $callback, $post_type, $context,$priority, $callback_args ); ?> 参数 $id （字符串）（必需）Meta模块的 HTML…

WordPress附件可以是图片、视频、文本文件等类型，但大部分附件函数都是针对图片的，本文总结了常用的附件函数使用方法。 wp_get_attachment_image_src() <?php wp_get_attachment_image_src( $attachment_id, $size, $icon ); ?> 用于图片类附件时，根据附件id和指定的尺寸（$size,默认是t…

说明 将已添加的脚本进行本地化（翻译）。当然也可用来在一个页面中包含任意的Javascript数据。 用法 <?php wp_localize_script( $handle, $object_name, $l10n ); ?> 参数 $handle （字符串）（必填） 你所要附加数据的处理脚本 默认值：无 $object_name （字符串）（必填） 将包含数据的脚本对象名称（也就是…

说明 将函数连接到指定action（动作）。 在Plugin API/Action Reference 上查看动作hook列表。wordpress核心调用do_action() 时触发动作。 用法 <?php add_action( $tag, $function_to_add, $priority, $accepted_args ); ?> 参数 $tag （字符串）（必填）$fun…

说明 该标签显示带有链接的WordPress页面列表，并且可以选择将 Home（主页）自动显示为列表中的一员。该标签是自定义侧边栏和标题栏的好帮手，同时还可以用在其它模板中。 用法 <?php wp_page_menu( $args ); ?> 默认用法 <?php $args = array( 'depth' => 0, 'sort_colu…

说明 the_widget() 是一个模板标签，用来显示任何一个小工具。它可以在模板的任何地方使用。 用法 <?php the_widget($widget, $instance, $args); ?> 参数 widget （字符串）小工具的 PHP 类名 WP_Widget_Archives —— Archives WP_Widget_Calendar  —— Calend…

说明 is_active_widget() 是一个条件标签，用来检查是否小工具已经在前端显示（已使用）。只有在小工具初始化后，该函数才会生效。 用法 <?php is_active_widget( $callback, $widget_id, $id_base, $skip_inactive ); ?> 参数 $callback （字符串）（可选）小工具回调检查。 默认值：False …

介绍 用来注销小工具（通常是用来注销WordPress内置的小工具） 用法 <?php unregister_widget( $widget_class ) ?> 参数 $widget_class （对象）WP_Widget 扩展的 类名 WP_Widget_Pages = 页面 WP_Widget_Calendar = 日历 WP_Widget_Archives = 存档 WP_Wi…

介绍 注册一个单独的侧边栏区域和返回ID，供 "widgets_init" 钩子调用。 用法 <?php register_sidebar( $args ); ?> 默认用法 <?php $args = array( 'name' => __( 'Sidebar name', 'theme_text_do…

说明 wp_tag_cloud() 函数的作用是用来标签云的，可以根据每个标签所关联的文章次数来定义字体大小、标签排序等属性。从 2.8 版本开始，添加了 分类法（taxonomy）参数，这就意味着，除了 标签（tags）以外，还可以将 分类（Categories） 或其他 自定义分类法（Custom Taxonomies）作为“云”显示。 用法 <?php wp_tag_cloud( $a…

描述 将分类以列表的形式显示为链接。点击分类的链接，就可以访问该分类下的所有文章的存档页面。 注意： wp_list_categories() 和 list_cats() 以及 wp_list_cats() 的使用类似，但是后面 2 个已经弃用。 如果你希望不格式化输出分类，请使用 get_categories() 用法 <?php wp_list_categories( $args ); …

描述 用来显示网站的作者（用户）列表，如果用户发布有文章，就会将作者名字链接到他们的文章。还可以显示每个作者的文章数和RSS订阅链接。 用法 <?php wp_list_authors( $args ); ?> 默认用法 <?php $args = array( 'orderby' => 'name', 'order…

描述 加载翻译后的插件字符串。 如果未给出路径，默认路径为插件根目录。.mo文件路径基于带有破折号的域名命名，域名后应跟有一个破折号，破折号后为本地语言简码。 这里的本地语言简码是指你在wp-config.php中填写的 WPLANG 的值，比如你填写的是 zh_CN ，那么就该使用 zh_CN，如果你的插件的 text domain 为 “my-plugin”，那么语言包的名字应该为 “my-p…

描述 加载翻译后的主题字符串。 如果本地主题根目录下有一个.mo文件，该文件会被包括在$domain的被翻译字符串中。 .mo文件必须根据本地设置命名。 用法 <?php load_theme_textdomain( $domain, $path ) ?> 参数 $domain（字符串）（必需）用以检索被翻译字符串的唯一标识符默认值： None$path（未知）（可选）语言包 .mo …

描述 query_posts() 可以用来控制在循环（Loop）中显示哪些文章。它可以替换主查询，而使用一个新的查询来获取文章。要清除 query_posts() 的新查询，可以使用 wp_reset_query() 来重置查询。 我们强烈建议您使用 pre_get_posts 来替代 query_posts() ，同时使用 is_main_query 来检查主查询。 举个例子，在首页（homep…

描述 返回你博客的信息，这些信息可以用在任何地方的 PHP 代码中。这个函数，和 bloginfo() 一样，可以用来在模板文件的任何地方显示你博客的信息。 用法 <?php $bloginfo = get_bloginfo( $show, $filter ); ?> 参数 $show(字符串 string) (可选) 关键字命名你想要的信息。默认: name 'name&#…

描述 显示你博客的相关信息，大部分都是管理后台生成于“用户 > 你的个人资料”和“设置 > 常规”中设置的信息。此功能与 bloginfo() 相同，除非它输出用于订阅的RSS标记。 用法 <?php bloginfo_rss('show'); ?> 例子 显示博客标题和链接 显示带链接和RSS feed标识的博客名称。 <title><…

描述 显示你的博客信息，大部分都是显示WordPress管理界面的 用户资料 和 常规设置 中的信息。它可以在模板文件的任何地方使用。一般 bloginfo() 都是用来直接在浏览器中输出内容的。如果你需要在PHP中返回值的话，那么请用 get_bloginfo()。 用法 <?php bloginfo( $show ); ?> 参数 $show (字符串string) (可选)你需要…

描述 加载评论模板。只能用于单篇 文章 或 页面 来显示评论，如果不是这些页面，将没办法显示。 用法 <?php comments_template( $file, $separate_comments ); ?> 参数 $file(字符串string) (可选) 要加载的文件 默认: /comments.php$separate_comments(布尔值boolean) (可选) 是…

描述 引入 searchform.php 文件来显示搜索表单。 用法 <?php get_search_form( $echo ); ?> 参数 $echo : (布尔值) (可选) 如果是 true 则输出表单； false 则返回表单的字符串。默认: true 返回值 (字符串string)，如果参数 $echo 设置为 false，就返回表单的HTML代码。 例子 如果你的主题没…

描述 引入当前主题的页脚文件 footer.php，如果使用特定的名字，那么就会调用这个特定名字的页脚文件 footer-{name}.php 。 如果主题没有 footer.php 就会引入默认的 wp-includes/theme-compat/footer.php 。 用法 <?php get_footer( $name ); ?> 参数 $name(string) (可选) 调…