WordPress.org网站
获取WordPress
WordPress.org网站

WordPress开发人员资源

获取permalink（）

获取永久链接(int | WP_发布 $帖子,布尔 $leavename（名字） = 假 ):字符串|假

在本文中

返回页首

检索当前帖子或帖子ID的完整永久链接。

参数

$帖子整数|WP_支柱可选择的
发布ID或发布对象。默认为全局$帖子.
$leavename（名字）布尔可选择的
是否保留帖子名称或页面名称。

违约：假

返回

字符串|假永久链接URL。如果帖子不存在，则为False。

更多信息

在插件或主题中，它最早可以在设置主题（_theme）行动。任何早期使用，包括加载的插件，生成致命错误。

请注意，当在没有ID参数的帖子页面（索引、存档等）的The Loop外部使用时，它将返回The Loop中最后一篇帖子的URL，不当前页面的永久链接。

来源

函数get_permalink（$post=0，$leavename=false）{$rewritecode=数组(“%year%”，“%monthnum%”，“%day%”，“%hour%”，“%分钟%”，“%second%”，$leavename？“”：“%postname%'，“%post_id%”，“%category%”，“%author%”，$leavename？“”：“%页面名称%'，);if（isobject（$post）&&isset（$post->filter）&&'sample'===$post->filter{$sample=真；}其他{$post=获取post（$post）；$sample=假；}if（空（$post->ID））{返回false；}if（“页面”===$post->post_type）{return get_page_link（$post，$leavename，$sample）；}elseif（“附件”===$post->post_type）{return get_attachment_link（$post，$leavename）；}elseif（in_array（$post->post_type，get_post_types（数组（'_builtin'=>false）），true））{返回get_post_permink（$post，$lavename，$sample）；}$permalink=获取选项（'permalink_structure'）；/***在替换令牌之前，过滤帖子的永久链接结构。**仅适用于post_type为“post”的帖子。**@自3.0.0起**@param string$permalink站点的permalink-结构。*@param WP_Post$Post有问题的帖子。*@param bool$lavename是否保留帖子名称。*/$permalink=应用过滤器（'pre_post_link'，$permallink，$post，$leavename）；如果($永久链接&&! wp_force_plain_post_permalink（$post）) {$category=“”；if（str_contains（$permalink，“%category%”）{$cats=get_the_category（$post->ID）；if（$cats）{$cats=wp_list_sort($只猫，阵列('term_id'=>'ASC'，));/***筛选在%category%永久链接标记中使用的类别。**@自3.5.0起**@param WP_Term$cat要在永久链接中使用的类别。*@param array$cats与帖子关联的所有类别（WP_Term对象）的数组。*@param WP_Post$Post有问题的帖子。*/$category_object=应用过滤器（'post_link_category'，$cats[0]，$cats，$post）；$category_object=get_term（$categori_object，'类别'）；$category=$categary_object->slug；if（$category_object->parent）{$类别=get_category_parents（$category_object->parent，false，'/'，true）$类别；}}/**在永久链接中显示默认类别，*无需显式赋值。*/if（空（$category））{$default_category=get_term（get_option（'default_catagory'），'category'）；if（$default_category&&！is_wp_error（$default _category））{$category=$default_category->slug；}}}$author=''；if（str_contains（$permalink，“%author%”）{$authordata=get_userdata（$post->post_author）；$author=$authordata->user_nicename；}/**这不是API调用，因为永久链接基于存储的post_date值，*它应该被解析为本地时间，而不管默认的PHP时区是什么。*/$date=爆炸（“”，str_replace（数组（“-”，“：”），“”，$post->post_date））；$rewritereplace=数组($日期[0]，$date[1]，$日期[2]，$日期[3]，$日期[4]，$日期[5]，$post->post_name，$post->ID，$类别，$作者，$post->post_name，);$permalink=home_url（str_replace（$rewritecode，$rewrite replace，$permalindk））；$permalink=user_trailingslashit（$permalink，'single'）；}else{//如果他们没有使用奇特的永久链接选项。$permalink=home_url（'？p='.$post->ID）；}/***过滤帖子的永久链接。**仅适用于post_type为“post”的帖子。**@自1.5.0起**@param string$permalink帖子的永久链接。*@param WP_Post$Post有问题的帖子。*@param bool$leavename是否保留帖子名称。*/return apply_filters（'post_link'，$permalink，$post，$leavename）；}

查看所有引用 在Trac上查看 在GitHub上查看

挂钩

应用筛选器（“post_link”，一串 $永久链接,WP_支柱 $帖子,布尔 $leavename（名字） )

过滤帖子的永久链接。

应用筛选器（'帖子链接类别'，WP_术语 $猫,阵列 $只猫,工作包支柱 $帖子 )

筛选在%category%永久链接标记中使用的类别。

应用筛选器（“pre_post_link”，一串 $永久链接,WP_支柱 $帖子,布尔 $发酵剂 )

在替换令牌之前，过滤帖子的永久链接结构。

使用描述
wp_force_plain_post_permalink（）wp-includes/link-template.php

确定帖子是否应始终使用普通的永久链接结构。

wp_list_sort（）wp-includes/functions.php

基于一个或多个orderby参数对对象数组或数组进行排序。

获取类别（）wp-includes/category-模板.php

检索帖子类别。

获取类别家长（）wp-includes/category-模板.php

使用分隔符检索类别父项。

获取页面链接（）wp-includes/link-template.php

检索当前页面或页面ID的永久链接。

获取附件链接（）wp-includes/link-template.php

检索附件的永久链接。

获取post_permalink（）wp-includes/link-template.php

检索自定义帖子类型的帖子的永久链接。

user_trailingslashit（）wp-includes/link-template.php

如果站点设置为添加尾随斜杠，则检索尾随斜线字符串。

获取用户数据（）wp-includes/可插拔.php

按用户ID检索用户信息。

获取term（）wp-includes/分类.php

按术语ID从数据库中获取所有术语数据。

主页url（）wp-includes/link-template.php

检索前端可访问的当前站点的URL。

应用过滤器（）wp-includes/plugin.php

调用已添加到过滤器挂钩的回调函数。

获取选项（_O）wp-includes/选项.php

基于选项名称检索选项值。

获取post（）wp-includes/post.php

检索给定帖子ID或帖子对象的帖子数据。

获取发布类型（）wp包含/post.php

获取所有已注册的post类型对象的列表。

is_wp_error（）wp-includes/load.php

检查给定变量是否为WordPress错误。

再显示11个显示更少
使用人描述
WP_Sitemaps_Posts:：get_url_list（）wp-includes/sitemaps/providers/class-wp-sitemaps-posts.php

获取帖子类型网站地图的URL列表。

WP_REST_Post_Search_Handler:：prepare_item（）wp-includes/rest-api/search/class-wp-rest-post-search-handler.php

准备给定帖子ID的搜索结果。

获取隐私策略url（）wp-includes/link-template.php

检索隐私策略页面的URL。

WP_REST_Posts_Controller:：prepare_item_for_response（）wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

为响应准备一个post输出。

WP_REST_Posts_Controller:：get_item（）wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

检索单个帖子。

WP_自定义_导航_菜单：：ajax_insert_auto_draft_post（）wp-includes/class-wp-customize-nav-menus.php

用于添加新自动草稿帖子的Ajax处理程序。

wp_get_cononical_url（）wp-includes/link-template.php

返回帖子的规范URL。

wp_embed_extract_more（）wp-includes/embedd.php

过滤修剪后的摘录后显示的“more”链接中的字符串。

wp_oembed_add_discovery_links（）wp-includes/embedd.php

在网站的head元素中添加oEmbed发现链接。

获取post_embed_url（）wp-includes/embedd.php

检索URL以在iframe中嵌入特定帖子。

获取post_embed_html（）wp-includes/embedd.php

检索特定帖子的嵌入代码。

get_preview_post_link（）wp-includes/link-template.php

检索用于文章预览的URL。

WP_自定义_可用_菜单项_设置：：value_as_WP_post_Nav_菜单项（）wp-includes/customize/class-wp-customize-nav-menu-item-setting.php

将值模拟到WP_支柱并设置为导航菜单项。

WP_Customize_Nav_Menus:：search_available_items_query（）wp-includes/class-wp-customize-nav-menus.php

执行可用项目搜索的后期查询。

WP_Customize_Nav_Menus:：load_available_items_query（）wp-includes/class-wp-customize-nav-menus.php

执行post_type和分类查询以加载可用菜单项。

WP_Posts_List_Table:：handle_row_actions（）wp-admin/includes/class-wp-posts-list-table.php

生成并显示行操作链接。

wp安装可能启用重试链接（）wp-admin/included/upgrade.php

可能会在安装时启用相当长的永久链接。

wp_dashboard_recent_posts（）wp-admin/includes/dashboard.php

生成“即将发布”和“最近发布”部分。

获取媒体项（）wp-admin/includes/media.php

检索用于修改图像附件的HTML表单。

获取示例permalink_html（）wp-admin/includes/post.php

返回示例永久链接slug编辑器的HTML。

获取示例permalink（）wp-admin/includes/post.php

基于帖子名称返回示例永久链接。

WP_Media_List_Table:：_get_row_actions（）wp-admin/includes/class-wp-media-list-table.php
WP_Comments_List_Table:：column_response（）wp-admin/includes/class-wp-comments-list-table.php
wp_list_categories（）wp-includes/category-模板.php

显示或检索类别的HTML列表。

wp_notify_postauthor（）wp-includes/可插拔.php

通知作者（和/或其他人）帖子上的评论/trackback/pingback。

wp_notify_moderator（）wp-includes/可插拔.php

将等待批准的新评论通知网站版主。

wp_get_archives（）wp-includes/general-template.php

根据类型和格式显示存档链接。

获取边界_post_rel_link（）wp-includes/deprecated.php

获取边界后关系链接。

获取父级post_rel_link（）wp-includes/deprecated.php

获取父级后关系链接。

上一个post（）wp-includes/deprecated.php

打印上一篇文章的链接。

next_post（）wp-includes/deprecated.php

打印下一篇文章的链接。

wp_old_slug_redirect（）wp-includes/query.php

将旧段塞重定向到正确的永久链接。

获取注释_生成链接（）wp-includes/link-template.php

检索评论页码链接。

paginate_comments_links（）wp-includes/link-template.php

显示或检索当前帖子上评论的分页链接。

获取相邻位置post_link（）wp-includes/link-template.php

检索相邻的帖子链接。

获取相邻位置post_rel_link（）wp-includes/link-template.php

检索相邻的后关系链接。

获取post_type_archive_link（）wp-includes/link-template.php

检索后期类型存档的永久链接。

获取post_comments_feed_link（）wp-includes/link-template.php

检索帖子评论提要的永久链接。

获取永久链接（）wp-includes/link-template.php

检索当前帖子或帖子ID的完整永久链接。

获取附件链接（）wp-includes/link-template.php

检索附件的永久链接。

post_permalink（）wp-includes/deprecated.php

从帖子ID检索永久链接。

permalink（）wp-includes/link-template.php

显示当前帖子的永久链接。

wp_admin_bar_edit_menu（）wp-includes/admin-bar.php

提供帖子和术语的编辑链接。

permalink_rss（）wp-includes/feed-php

显示帖子的永久链接，以便在订阅源中使用。

Walker_Page:：start_el（）wp-includes/class-walker-page.php

输出树中当前元素的开头。

_wp_link_page（）wp包含/post-template.php

的助手函数wp_link_pages（）.

获取内容（）wp-includes/post-template.php

检索帖子内容。

_转换post_status（）wp包含/post.php

用于管理将来发布的后期转换的挂钩。

wp_insert_post（）wp-includes/post.php

插入或更新帖子。

重定向_guess_404_permalink（）wp-includes/canonical.php

尝试根据查询变量猜测404请求的正确URL。

重定向匿名（）wp-includes/canonical.php

根据站点URL将传入链接重定向到正确的URL。

获取日志链接（）wp-includes/ms-functions.php

获取另一个博客上帖子的永久链接。

wp_setup_nav_menu_item（）wp-includes/nav-menu.php

使用共享导航菜单项属性装饰菜单项对象。

wp_xmlrpc_server:：mw_getPost（）wp包含/class-wp-xmlrpc-server.php

检索帖子。

wp_xmlrpc_server:：mw_getRecentPosts（）wp包含/class-wp-xmlrpc-server.php

检索最近发布的列表。

wp_xmlrpc_server:：_prepare_page（）wp包含/class-wp-xmlrpc-server.php

准备页面数据以在XML-RPC对象中返回。

wp_xmlrpc_server:：_prepare_post（）wp包含/class-wp-xmlrpc-server.php

准备在XML-RPC对象中返回的post数据。

获取post_reply_link（）wp-includes/注释模板.php

检索回复帖子链接的HTML内容。

注释_格式（）wp-includes/注释模板.php

输出一个完整的注释表单，以便在模板中使用。

获取跟踪回url（）wp-includes/注释模板.php

检索当前帖子的trackback URL。

注释_popup_link（）wp-includes/注释模板.php

显示当前帖子ID的评论链接。

获取注释_reply_link（）wp-includes/注释模板.php

检索回复评论链接的HTML内容。

获取注释链接（）wp-includes/注释模板.php

检索给定注释的链接。

获取评论链接（）wp-includes/注释模板.php

检索到当前帖子评论的链接。

trackback（）wp包含/comment.php

发送回溯。

pingback（）wp包含/comment.php

Ping回帖子中的链接。

_WP_编辑器：：WP_link_query（）wp-includes/class-wp-editor.php

执行内部链接的后期查询。

再显示62个显示更少

变更日志

版本描述
1.0.0介绍。

用户贡献的笔记

  1. 跳到备注13内容
    stratboy公司
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：6你必须登录才能对这个便条的帮助进行投票

    通过slug获取帖子或页面（或其他）永久链接：

    函数get_link_by_slug（$slug，$type='post'）{$post=get_page_by_path（$slug、OBJECT、$type）；return get_permalink（$post->ID）；}

    如果你正在使用polylang（就像我通常做的那样），你可以从任何一个语言段开始获取permalink（我通常从我的语言开始，通常是网站的默认语言）：

    函数get_link_by_slug（$slug，$lang_slug=null，$type='post'）{$post=get_page_by_path（$slug、OBJECT、$type）；$id=（$lang_slug）？pll_get_post（$post->ID，$lang_slug）：$post->ID；返回get_permalink（$id）；}
  3. 跳到备注15内容
    食品法典委员会
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：5你必须登录才能对这个便条的帮助进行投票

    传入post对象而不是ID
    这显示了如何使用页面标题而不是ID获取永久链接。

    <a href=“<？php echo esc_url（get_permalink（get_page_by_title（'每月事件'））；？>”><？php esc_html_e（“每月事件”，“textdomain”）；？></a>
  4. 跳到注释16内容
    食品法典委员会
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：2你必须登录才能对这个便条的帮助进行投票

    链接到特定帖子
    返回两个特定帖子（帖子ID 1和10）的永久链接，作为信息列表中的超文本链接。

    <ul><li><？php esc_html_e（'我的博客信息：'，'文本域'）；？><ul><li><a href=“<？php echo esc_url（get_permalink（1））；？>”><？php esc_html_e（“关于MyBlog”，“textdomain”）；？></a></li><li><a href=“<？php echo esc_url（get_permalink（10））；？>”><？php esc_html_e（“关于所有者”，“textdomain”）；？></a></li></ul></li></ul>
  9. 跳到注释21内容
    洪托德09
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：0你必须登录才能对这个便条的帮助进行投票

    从当前子页面获取页面父级的永久链接（在循环中使用）：

    while（have_posts（））：post（）；获取永久链接（wp_get_post_parent_id（get_the_id（）））；结束时；

    获取ID：获取当前页面的id。
    wp_get_post_parent_id：获取当前页面的父页面id。

  10. 跳到注释22内容
    托尔科德罗
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：0你必须登录才能对这个便条的帮助进行投票

    通过其模板slug获取页面永久链接：

    函数wpdocs_wp_get_page_url_by_template_slug（$template_slug）{$url=空；$template=“页面-”$template_slug.'。php'；$pages=get_posts（数组('post_type'=>'page'，“meta_query”=>数组(阵列(“key”=>“_wp_page_template”，“value”=>$template，“比较”=>“=”，))) );if（isset（$pages[0]））{$url=获取永久链接（$pages[0]->ID）；}返回$url；}

    您可以在主题中的任意位置调用该函数，如下所示：

    //输出类似于“http://（www.）（subdomain.）domain.com/shopping-cart-page-name__depends-on-permalink-settings/”的urlecho wpdocs_wp_get_page_url_by_template_slug（'shopping_cart'）；

    注：该函数仅检索使用给定模板的第一个页面。我写它是为了获取我的购物车的url，诸如此类，显然这些只使用了一次。我已经修改了我的模板下拉列表，以便在其他帖子中使用某些模板时，它不会显示这些模板。如果要获取使用给定模板的所有帖子，请按如下方式修改函数：

    函数wpdocs_wp_get_page_url_by_template_slug（$template_slug）{$urls=数组（）；$template=“页面-”$template_slug.'。php'；$pages=get_posts（数组(“post_type”=>“页面”，“meta_query”=>数组(阵列(“key”=>“_wp_page_template”，“value”=>$template，“比较”=>“=”，))) );foreach（$pages作为$page）{$urls[]=获取永久链接（$page->ID）；}返回！空（$urls）$urls:false；}
  12. 跳到注释24内容
    jvanstone公司
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：-2你必须登录才能对这个便条的帮助进行投票

    对于安全措施，请确保使用：

    esc_url（$url:string，$protocols:array|null，$_context:string）；

    例子：

    echo esc_url（get_permalink（），'textdomain'）；

    请参见https://developer.wordpress.org/plugins/security/securing-output/

你必须登录在能够贡献笔记或反馈之前。