wordpress链接的调用方法

本文详细介绍WordPress中链接(URL)的各种调用方法，涵盖从基础到高级的应用场景。

一、基础链接调用函数

网站首页链接

// 获取首页URL
echo home_url(); // 输出: https://wodepress.com
echo home_url('/contact/'); // 输出: https://wodepress.com/contact/
当前页面/文章链接

// 获取当前文章或页面的 permalink
echo get_permalink(); // 必须在Loop内使用
echo get_permalink($post_id); // 指定文章ID获取链接
页面链接获取

// 通过页面ID获取链接
echo get_page_link(42);

// 通过页面别名（slug）获取
$page = get_page_by_path('about-us'); echo get_permalink($ page->ID);

二、主题文件链接

主题目录相关

// 获取主题根目录URL
echo get_template_directory_uri(); // 父主题
echo get_stylesheet_directory_uri(); // 子主题（如果在子主题中使用）

// 常用组合：引用主题内资源
echo get_template_directory_uri() . '/assets/css/style.css';
echo get_stylesheet_directory_uri() . '/images/logo.png';
包含主题文件

// 安全地包含主题文件
get_header(); // 包含 header.php
get_footer(); // 包含 footer.php
get_sidebar(); // 包含 sidebar.php

// 包含自定义模板部分
get_template_part('content', 'single'); // 包含 content-single.php

三、内容链接处理

附件/上传文件链接

// 获取特色图片URL
$thumbnail_url = get_the_post_thumbnail_url($ post_id, 'full');

// 获取附件直接链接
echo wp_get_attachment_url($attachment_id);

// 获取指定尺寸的附件链接
echo wp_get_attachment_image_src($attachment_id, 'medium')[0];
分类/标签链接

// 获取分类链接
echo get_category_link( $category_id); echo get_term_link($ term, 'category');

// 获取标签链接
echo get_tag_link($tag_id);

四、导航菜单链接

自定义菜单调用

// 在主题中注册菜单位置
function register_my_menus() {
register_nav_menus(array(
'primary' => '主导航菜单',
'footer' => '底部菜单'
));
}
add_action('init', 'register_my_menus');
输出导航菜单

// 基础调用
wp_nav_menu(array('theme_location' => 'primary'));

// 完整参数示例
wp_nav_menu(array(
'theme_location' => 'primary',
'menu' => '',
'container' => 'nav',
'container_class' => 'main-navigation',
'menu_class' => 'nav-menu',
'fallback_cb' => false,
'depth' => 2,
'walker' => new Custom_Walker_Nav_Menu() // 自定义Walker
));

五、高级链接操作

分页链接

// 文章分页（使用  时）
wp_link_pages(array(
'before' => '
页码: ',
'after' => '
',
'pagelink' => '%'
));

// 文章列表分页（存档页）
echo paginate_links(array(
'total' => $wp_query->max_num_pages,
'current' => max(1, get_query_var('paged')),
'prev_text' => '<< 上一页',
'next_text' => '下一页 >>'
));
自定义查询链接

// 添加查询参数生成链接
echo add_query_arg('view', 'list', get_permalink());
// 输出: https://wodepress.com/page-name/?view=list

// 多参数
echo add_query_arg(array(
'view' => 'grid',
'sort' => 'price'
), get_permalink());
去除URL中的协议头

// 获取无协议URL（避免混合内容警告）
echo esc_url(home_url('/', 'relative')); // //wodepress.com/

六、REST API获取链接

通过API获取各类链接

复制代码

// 获取站点信息（包含首页链接）
fetch('/wp-json/')
  .then(res => res.json())
  .then(data => console.log(data.home));

// 获取文章列表（包含permalink）
fetch('/wp-json/wp/v2/posts')
  .then(res => res.json())
  .then(posts => {
    posts.forEach(post => {
      console.log(post.link);        // 文章链接
      console.log(post.guid.rendered); // 固定链接
    });
  });

七、最佳实践建议

始终使用API函数：不要硬编码URL，使用home_url(),site_url()等函数

转义输出：使用esc_url()函数包裹链接输出，防止XSS攻击

使用相对协议：//wodepress.com可自动适配HTTP/HTTPS

缓存菜单：大型站点的复杂菜单建议缓存或使用Transients

这些方法覆盖了WordPress开发中99%的链接调用场景，wordpress模板开发过程中最常用到的，掌握了这些，基础的wordpress模板开发足够用了。

原文

https://www.jianzhanpress.com/?p=9273