详解WordPress模板标签Template_Tags

本文说明

一些你渲染文章时会用到的函数
玲曦在官方基础上整理，言简意赅如有不理解看官方具体详细解释就行啦！

官方定义

模板标签（Template tags）在博客的 模板
文件中使用，用来动态的显示内容或自定义网站。下面介绍的是一些在WordPress中常用的标签，根据功能排序。

包含模板文件的标签（Include tags）

• get_header 页头
• get_sidebar 侧栏
• get_search_form 搜索表单
• comments_template 评论模板。
• get_footer 页脚

博客信息标签（博客信息标签）

• bloginfo 显示有关当前站点的信息
• bloginfo_rss 显示有关博客的信息，同bloginfo，仅去除html标记用于RSS源
• get_bloginfo 返回有关当前站点的信息。
• get_bloginfo_rss 站点rss容器（玲曦表示官方描述很模糊，这个函数不常用吧）

列表及下拉列表的标签（Lists & Dropdown tags）

• p_list_authors
  显示站点作者（用户）的列表，如果用户已经创作了任何帖子，则作者名称将显示为指向其帖子的链接。（可选）此标记显示每个作者的帖子数和RSS feed链接。
• wp_list_categories 显示或检索类别的HTML列表。
• wp_list_pages 以列表（li）格式检索或显示页面列表（或分层帖子类型的项目）。
• wp_list_bookmarks
  显示在“ 管理” >“ 链接”面板中找到的书签。该模板标签允许用户控制书签的排序和显示方式。
  注意：wp_list_bookmarks（）替换了不推荐使用的模板标签get_links_list（）和get_links（）。
• wp_list_comments 根据各种参数（包括在管理区域中设置的参数）显示帖子或页面的所有评论。
• wp_get_archives 档案获取
• wp_page_menu
  将WordPress 页面列表显示为链接，并提供将Home自动添加到显示的页面列表中的机会。此标签对于自定义边栏或标题很有用，但也可以在其他模板中使用。
• wp_dropdown_pages 在没有提交按钮的选择（即下拉）框中显示页面列表。
• wp_dropdown_categories 显示或检索类别的HTML下拉列表。
• wp_dropdown_users 创建用户的下拉HTML内容。

登录/登出标签（Login/Logout tags）

• is_user_logged_in 判断当前访问者是否是登录用户。
• wp_login_url 此模板标记返回允许用户登录到站点的URL。
• wp_logout_url 注销登陆
• wp_lostpassword_url 此模板标记返回允许用户检索丢失的密码的URL。(找回密码)
• wp_registration_url 此模板标记返回允许用户注册该站点的URL
• wp_loginout
  显示登录链接，或者如果用户已登录，则显示注销链接。可选的redirect参数可用于在登录或注销时重定向用户。
• wp_register
  如果用户已登录，此标签将显示“ Site Admin”链接，如果用户未登录，则此标签显示“注册”链接。
• wp_signon 使用记住密码的选项对用户进行身份验证。替换不推荐使用的函数wp_login。

文章信息标签（Post tags）

• the_ID 当前文章id
• the_title
  当前文章标题(显示或返回当前帖子的未转义标题。该标记只能在The Loop中使用，要在循环之外获取帖子的标题，请使用get_the_title。如果帖子是受保护的或不公开的，将在标题前加上“受保护：”或“私人：”字样。)
• the_title_rss 显示当前帖子的标题，格式为RSS。此标记必须在The Loop中。
• the_title_attribute
  显示或返回当前帖子的标题。它在某种程度上重复了the_title（）的功能，但通过使用strip_tags（）剥离HTML标签并将某些字符（包括引号）转换为与esc_attr（）等价的字符实体，提供了HTML属性中标题的“纯净”版本。） ; 它还使用 查询字符串样式参数。此标记必须在The Loop中。
• single_post_title
  在单个帖子页面（永久链接页面）上显示或返回帖子标题。此标记对于在The Loop外显示帖子标题很有用
• the_content 文章内容（全部）。
• the_content_rss显示格式化为RSS的当前帖子的内容。该标签必须在The_Loop中。(官方不推荐或弃用)
• the_excerpt 显示帖子摘录。
• the_excerpt_rss
  显示当前已格式化为RSS的帖子的摘录。如果未为帖子提供显式摘录（在帖子编辑器的可选摘录字段中），则使用帖子内容的前55个字。该标签必须在The_Loop中。
• wp_link_pages
  显示分页文章的页面链接（即一次或多次包含 Quicktag）。这与link_pages（）（不建议使用）的工作方式几乎相同，不同之处在于参数以查询字符串格式给出。该标签必须在The_Loop中。
• posts_nav_link 显示下一页和上一页的链接。对于提供索引，类别和存档页面的“分页”导航很有用。
• next_post_link 下一篇文章链接
• next_posts_link 打印指向当前查询中下一组帖子的链接。
• previous_post_link
  在单个帖子永久链接页面上使用时，此模板标记显示到前一个帖子的链接，该链接按时间顺序从当前帖子开始存在。
• previous_posts_link 打印指向当前查询中的上一组帖子的链接。
• next_image_link
  这将创建指向当前帖子所附的下一张图片的链接。只要将一系列图像链接到附件页面，当在附件页面中查看图像时，它将在图像上放置一个“下一个图像链接”。
• previous_image_link
  这将创建指向附加到当前帖子的上一张图像的链接。只要将一系列图像链接到附件页面，当在附件页面中查看图像时，它将在图像上放置一个“上一个图像链接”。
• sticky_class 此功能已被弃用。请改用post_class（）。
• post_class是上面sticky_class的新函数,显示帖子容器元素的类。
• the_category 当前文章分类
• the_category_rss 以RSS格式显示帖子所属的一个或多个类别的名称。此标记必须在The Loop中使用。
• the_tags
  此模板标签显示指向该标签或文章所属标签的链接。如果没有标签与当前条目关联，则不显示任何内容。此标记应在The Loop中使用。
• the_meta
  这是一个简单的内置函数，用于显示当前帖子的自定义字段，称为“ post-meta”（存储在wp_postmeta表中）。它将数据格式化为无序列表（请参见下面的输出）。

评论标签（Comment tags）

• wp_list_comments 根据各种参数（包括在管理区域中设置的参数）显示帖子或页面的所有评论。
• comments_number 评论编号ID
• comments_link
  该comments_link模板标签显示的URL为当前这篇文章的评论。此标记必须位于The Loop或为评论设置的循环中。
• comments_rss_link 打印RSS评论提要链接。(此函数已废弃!)
  comments_rss_link 上面comments_rss_link新函数显示帖子的评论供稿链接。
• comments_popup_script
  输出注释弹出窗口的JavaScript代码。该标记与comments_popup_link（）一起用于单个文件中，尽管通常位于页面的部分中，但该标记可在模板中的任何位置使用。
• comments_popup_link
  如果使用comments_popup_script（），则显示指向注释弹出窗口的链接，否则显示指向注释的普通链接。该标签必须在The Loop或comment循环内。
• comment_ID 评论id
• comment_id_fields
  为注释表单生成两个隐藏的输入，以标识comment_post_ID和comment_parent线程注释。此标记必须在的>部分内comments.php。
• comment_author 显示评论作者姓名；也就是评论者提供的那个。如果未提供名称（“ 讨论选项 ”下未启用“用户必须填写名称和电子邮件” ），则WordPress将分配“匿名”作为评论作者。
• comment_author_link 评论作者连接
• comment_author_email 评论作者的电子邮件
• comment_author_email_link
  显示评论作者的电子邮件地址，未链接。如果在“ 讨论选项 ”下启用了“用户必须填写姓名和电子邮件”，则必须提供电子邮件地址。
• comment_author_url 评论作者URL地址
• comment_author_url_link 显示评论作者的URL（通常是其网站），如果提供了URL，则已链接。此标记必须在The Loop或注释循环中。
• comment_author_IP 评论者IP
• comment_type 显示评论条目的评论类型（常规评论，引用或Pingback）。此标记必须在The Loop或注释循环中。
• comment_text 显示评论文本。使用get_comment_text（）返回一个值而不是显示它。
• comment_excerpt 显示评论文本的摘录（最多20个单词）。
• comment_date 显示发表评论的日期。
• comment_time 显示发表评论的时间。此标记必须在The Loop或注释循环中。(时间戳)
• comment_form_title
  根据评论回复状态显示文本。这只会影响禁用Javascript的用户或未comment-reply.js加载JavaScript的页面。此标记通常直接
  在注释表单的下方和之前使用。
• comment_author_rss 显示格式为RSS的评论作者的姓名。通常在RSS评论提要模板中使用。此标记必须在The Loop或注释循环中。
• comment_text_rss 显示格式为RSS的注释文本。通常在RSS评论提要模板中使用。此标记必须在The Loop或注释循环中。
• comment_link_rss 显示格式为RSS的条目注释的URL。通常在RSS评论提要模板中使用。此标记必须在The Loop或注释循环中。(不推荐，将来可能正式废弃的)
• permalink_comments_rss 从1.5版开始，此功能已从WordPress核心中删除。这意味着它已被新功能替代或不再需要。如果存在，使用此功能的所有代码都必须转换为使用其替换代码。 请改用任何这些功能。(废弃!)
• comment_reply_link 显示用于回复评论链接的HTML内容。
• cancel_comment_reply_link 显示一个链接，该链接取消对上一个评论（嵌套评论）的答复，并将评论表单重新设置为默认状态。
• previous_comments_link 这将创建一个指向包含较旧评论的先前评论页面的链接。
• next_comments_link 这将创建一个指向包含新评论的下一个评论页面的链接
• paginate_comments_links 生成一种新方法以在评论模板中列出分页的评论。它不使用上一个或下一个注释链接，而是使用数字索引显示注释页面的完整列表。

时间及日期标签（Date and Time tags）

• the_time 显示当前帖子的时间。要返回发布时间，请使用get_the_time（）。此标记必须在The Loop中使用。
• the_date 当前日期
• the_date_xml 返回日期xml
• the_modified_time 此标记显示帖子上次修改的时间（和日期），类似于the_time（）的功能，该功能显示帖子创建的时间（和日期）。此标记必须在The Loop中使用。如果未指定格式参数，则将“ 管理” > “设置” >“ 常规”中的“ 默认日期格式”（请注意说“日期格式”）设置用作显示格式。
• the_modified_date 该标签显示帖子上次修改的日期（和时间）。该标签的工作方式与the_modified_time（）相同，该标签还显示了上次修改帖子的时间/日期。此标记必须在The Loop中使用。如果未指定格式参数，则将“ 管理” > “设置” >“ 常规”中的“ 默认日期格式”（请注意说“日期格式”）设置用作显示格式。
• the_modified_author 使用此模板标签可以显示上次修改帖子的作者。此标记必须在The Loop中使用。注意：the_modified_author在2.8版中首次可用。
• single_month_title 显示或返回当前页面的月份和年份标题。仅当mWordPress 将or存档月份参数传递给当前页面时，此标记才起作用（在查看每月存档页面时发生）。
• get_the_time 返回当前在PHP中使用的帖子的时间。它不显示时间。要显示发布时间，请使用the_time（）。此标记必须在The Loop中使用。
• get_day_link 将每日存档URL返回到特定的年，月和日，以供PHP使用。它不显示URL。如果年，月和日参数设置为’’，则标记将返回当前日期存档的URL。
• get_month_link 返回每月的存档URL到特定的年份和月份，以在PHP中使用。它不显示URL。如果year和month参数设置为’’，则标记将返回当前月份存档的URL。
• get_year_link 将年度存档URL返回到特定年份以在PHP中使用。它不显示URL。如果year设置为’’，则标记会返回当前年份存档的URL。
• get_calendar 获取日历

分类标签（Category tags）

• is_category 如果指定了$category参数，则此函数还将检查查询是否针对指定的类别之一。
• the_category 当前分类
• the_category_rss 以RSS格式显示帖子所属的一个或多个类别的名称。此标记必须在The Loop中使用。
• single_cat_title 显示或检索类别存档的页面标题。
• category_description 返回在类别设置屏幕中为当前类别（帖子>类别）定义的类别的描述。
  如果在archive.php模板中使用，请将此函数放在is_category（）条件语句中。否则，此功能将停止处理每月和其他存档页面的页面。
• wp_dropdown_categories 显示或检索类别的HTML下拉列表。
• wp_list_categories 显示或检索类别的HTML列表。
• get_category_parents 获取当前父级分类
• get_the_category 检索帖子类别。(此函数仅返回默认“类别”分类法的结果。对于自定义分类法，请使用get_the_terms()。)
• get_category_link 当前分类连接(返回给定类别ID的正确网址。)
• in_category 检查当前帖子是否在给定类别中。

作者信息标签（Author tags）

• the_author 当前作者
• the_author_link
  该标签显示帖子作者的网站链接。该网站字段在用户的配置文件（设置管理 > 档案 > 个人信息）。链接的文本是作者的个人资料显示名称，公开为字段。此标记必须在The Loop中使用。
• the_author_posts
  显示作者发表的帖子总数。草稿和私人帖子不计算在内。此标记必须在The Loop中使用。
• the_author_posts_link
  显示作者所有帖子的链接。链接文本是用户的“公开显示名称”字段。单击呈现的链接的结果将由“ 作者模板”的“ 模板层次结构 ” 控制。此标记必须在The Loop中使用。
• the_author_meta 所述the_author_meta模板标签为使用者显示所希望的元数据字段。一次仅返回一个字段，您需要指定所需的字段。如果在The Loop中使用此标记，则无需指定用户ID值，并且显示的数据是当前帖子作者的数据。如果在The Loop之外使用此标记，则可以指定用户ID 。
  如果meta字段不存在，则不打印任何内容。
• wp_list_authors 显示站点作者（用户）的列表，如果用户已经创作了任何帖子，则作者名称将显示为指向其帖子的链接。（可选）此标记显示每个作者的帖子数和RSS feed链接。
• wp_dropdown_users 创建用户的下拉HTML内容。

文章 Tag 标签（Tag tags）

• is_tag 此条件标签检查是否正在显示标签归档页面。这是一个布尔函数，表示它返回TRUE或FALSE。
• the_tags 此模板标签显示指向该标签或文章所属标签的链接。如果没有标签与当前条目关联，则不显示任何内容。此标记应在The Loop中使用。
• tag_description 首次在WordPress 版本2.8中可用，此模板标记返回标记的描述。可以将标签ID作为参数传递，但是如果未传递标签ID，则将返回描述当前查询的标签。
• single_tag_title 显示或返回当前存档页面的标签标题。
• wp_tag_cloud 该wp_tag_cloud（）功能显示标签所谓的“标签云”，其中每个标签的大小是由多少次特定的标签已被分配到职位确定的名单。
• wp_generate_tag_cloud WP生成标签云
• get_the_tags 返回一个对象数组，每个对象分配给帖子一个标签。如果在The Loop中使用此函数，则无需传递任何ID。
• get_the_tag_list
  生成与当前帖子关联的标签的HTML字符串。每个标签的名称将链接到相关的“标签”页面。您可以告诉函数在所有标签之前和之后以及每个标签之间放置一个字符串。与get_the_category_list此不同，此标记必须在The Loop中使用。
• get_tag_link 获取标签链接

编辑链接标签（Edit Link tags）

• edit_post_link
  如果用户已登录并被允许编辑帖子，则显示编辑当前帖子的链接。可以在The Loop内部或外部使用。如果在循环之外，则需要传递帖子ID。可以与页面，帖子，附件和修订版一起使用。
• edit_comment_link 如果用户已登录并被允许编辑评论，则显示编辑当前评论的链接。它必须在The Loop内以及注释循环内。
• edit_tag_link 如果用户已登录并被允许编辑标签，则显示编辑当前标签的链接。它必须在The Loop中。
• edit_bookmark_link 如果用户已登录并被允许编辑书签，则显示编辑当前书签的链接。它必须在The Loop中。使用get_edit_bookmark_link检索网址。

固定链接标签（Permalink tags）

• permalink_anchor
  输出固定链接用于后锚标识符或ID（<一个ID =” …）。这是用于链接到特定的柱的网页上显示的几个职位，如存档页面是有用的。该标签必须在该循环。
• get_permalink 检索当前帖子或帖子ID的完整永久链接。
• the_permalink
  显示到The Loop中当前正在处理的帖子的永久链接的URL。此标记必须在The Loop中，并且通常用于在显示帖子时显示每个帖子的固定链接。由于此模板标记仅限于显示正在处理的帖子的永久链接，因此您不能使用它来显示指向Weblog上任意帖子的永久链接。如果要获取帖子的永久链接，请参考get_permalink（），因为它具有唯一的帖子ID。
• permalink_single_rss 将永久链接打印到RSS feed。（已废弃!）
• the_permalink_rss 上面的新函数,显示该帖子的永久链接以供供稿使用。

链接管理标签（Links Manager tags）

• wp_list_bookmarks 显示在“ 管理” >“ 链接”面板中找到的书签。该模板标签允许用户控制书签的排序和显示方式。
• get_bookmarks 此函数返回在“ 管理” >“ 链接” >“ 编辑”面板中找到的一组书签。该模板标签允许用户直接检索书签信息。
• get_bookmark 根据书签链接ID检索书签数据。
• get_bookmark_field 获取书签字段

引用标签（Trackback tags）

• trackback_url 引用URL
• trackback_rdf
  输出帖子的引用 RDF信息。此标记必须在The Loop中。
  此信息不会显示在浏览器中。它的使用部分用于自动检测帖子的引用URI，某些博客和RDF工具可以对其进行“引用”。如果要启用帖子的引用URI的自动发现，请在模板中包括此标记。如果没有它，希望向您的帖子之一发送引用引用的人将不得不手动搜索引用引用URI。

一般标签（General tags）

• wp_title 显示或检索博客所有区域的页面标题。
• get_posts

get_posts的最合适用法是根据一组参数创建一个帖子数组。它检索最近的帖子列表或符合此条件的帖子。get_posts也可以用于创建多个循环，尽管在这种情况下，最好使用新的WP_Query直接引用WP_Query。
get_posts的参数与get_pages的参数相似，但实现方式完全不同，应在适当的情况下使用。get_posts使用WP_Query，而get_pages更直接地查询数据库。每个参数都有反映这种实现差异的参数。
query_posts也使用 WP_Query，但不建议这样做，因为它通过更改全局变量 $ wp_query的变量直接更改了主循环。另一方面， get_posts仅引用新的 WP_Query对象，因此不会影响或更改主循环。
如果您想在执行之前更改主查询，则可以使用pre_get_posts挂接到它。如果您只想基于页面中的一组简单参数来调用帖子数组，那么get_posts是您的最佳选择。

• query_posts

注意：此函数将完全覆盖主查询，并且不适合插件或主题使用。它用于修改主查询的过于简单的方法可能会出现问题，应尽可能避免使用。在大多数情况下，还有更好的，调整主查询，如通过更好的性能选项“pre_get_posts”内采取行动WP_Query。不得在WordPress循环中使用此功能。

• the_search_query

如果进行了搜索，则显示当前请求的搜索查询。
可以在HTML属性中安全地使用此函数（如下面的“搜索框”示例中所示）。
使用get_search_query检索值。

地理标签（Geo tags）

自从 WordPress 1.5 以后地理功能已经从主程序中移除，成为一个插件功能，下列标签会出现在插件版本中。

此处玲曦不做描述！请自行查找相关资料

• print_Lat (the_Lat)
• print_Lon (the_Lon)
• print_UrlPopNav (the_UrlPopNav)
• print_AcmeMap_Url (the_AcmeMap_Url)
• print_GeoURL_Url (the_GeoURL_Url)
• print_GeoCache_Url (the_GeoCache_Url)
• print_MapQuest_Url (the_MapQuest_Url)
• print_SideBit_Url (the_SideBit_Url)
• print_DegreeConfluence_Url (the_DegreeConfluence_Url)
• print_TopoZone_Url (the_TopoZone_Url)
• print_FindU_Url (the_FindU_Url)
• print_MapTech_Url (the_MapTech_Url)