当前位置:首页 > CMS教程 > WordPress > 列表

WordPress中获取页面链接和标题的相关PHP函数用法解析

发布:smiling 来源: PHP粉丝网  添加日期:2021-06-30 09:23:43 浏览: 评论:0 

这篇文章主要介绍了WordPress中获取页面链接和标题的相关PHP函数用法解析,分别为get_permalink()和wp_title()函数的使用,需要的朋友可以参考下。

get_permalink()(获取文章或页面链接)

get_permalink() 用来根据固定连接返回文章或者页面的链接。在获取链接时 get_permalink() 函数需要知道要获取的文章的 ID,如果在循环中则自动默认使用当前文章。

用法:

get_permalink( $id, $leavename );

参数:

$id

(混合)(可选)文章或者页面的 ID(整数);还可以是文章对象。

默认值:在循环中自动调用当前的文章

$leavename

(布尔)(可选)转化成链接是是否忽略文章别名。如果设置成 True,那么将返回 http://www.example.com/%postname% 而不是 http://www.example.com/my-post-name

默认值:None

返回值

(字符串 | 布尔)成功获取链接则返回链接,失败则返回 False.

例子:

根据 ID 获取文章或页面的链接:

<a href="<?php echo get_permalink( 268 ); ?>">获取指定 ID 的文章或页面链接</a>

循环中获取当前文章的链接:

<?php echo get_permalink(); ?>

根据页面标题获取页面链接:

<a href="<?php echo esc_url( get_permalink( get_page_by_title( '留言板' ) ) ); ?>">留言板</a>

其它

此函数位于:wp-includes/link-template.php

wp_title()(获取网页标题)

wp_title() 用来获取当前网页的标题,也就是 title 标签里边的内容。

wp_title() 能在不同的页面自动生成不同的标题(比如首页就是网站标题、文章页就是文章标题)。WordPress 官方的主题都在使用这个函数生成标题,但是在国内的主题中却总是被忽视(因为默认情况下这个函数对 SEO 并不是太好)。

我还是推荐使用这个函数调用标题,更加符合主题开发规范,如果你要让他变的更加符合 SEO,可以使用过滤器优化一下,本文结尾有优化方法。

用法

wp_title( $sep, $display, $seplocation );

参数

$sep

(字符串)(可选)标题内容的分隔符,一般设置成 “|” 或者 “-”。

默认值:&raquo;(»)

$display

(布尔)(可选)是否直接打印标题,如果设置成 False 则返回标题,可以存储到变量里。

默认值:True(直接打印输出)

$seplocation

(字符串)(可选)分隔符所在位置,左边还是右边,如果传递 “right” 则为右边,其它任何内容都是左边。

默认值:空字符串(左边)

返回值

(字符串)如果 $display 参数设置成 False,才能返回标题的内容,根据不同的标题会返回不同的内容,默认情况下返回的内容是这样的:

文章页:文章标题

日期页:日期

分类页:分类标题

作者页:作者名字

如果你想更加详细的了解,可以阅读下边的函数源码:

  1. /** 
  2.  * Display or retrieve page title for all areas of blog. 
  3.  * 
  4.  * By default, the page title will display the separator before the page title, 
  5.  * so that the blog title will be before the page title. This is not good for 
  6.  * title display, since the blog title shows up on most tabs and not what is 
  7.  * important, which is the page that the user is looking at. 
  8.  * 
  9.  * There are also SEO benefits to having the blog title after or to the 'right' 
  10.  * or the page title. However, it is mostly common sense to have the blog title 
  11.  * to the right with most browsers supporting tabs. You can achieve this by 
  12.  * using the seplocation parameter and setting the value to 'right'. This change 
  13.  * was introduced around 2.5.0, in case backwards compatibility of themes is 
  14.  * important. 
  15.  * 
  16.  * @since 1.0.0 
  17.  * 
  18.  * @param string $sep Optional, default is '»'. How to separate the various items within the page title. 
  19.  * @param bool $display Optional, default is true. Whether to display or retrieve title. 
  20.  * @param string $seplocation Optional. Direction to display title, 'right'. 
  21.  * @return string|null String on retrieve, null when displaying. 
  22.  */ 
  23. function wp_title($sep = '»'$display = true, $seplocation = '') { 
  24.   global $wp_locale
  25.    
  26.   $m = get_query_var('m'); 
  27.   $year = get_query_var('year'); 
  28.   $monthnum = get_query_var('monthnum'); 
  29.   $day = get_query_var('day'); 
  30.   $search = get_query_var('s'); 
  31.   $title = ''
  32.    
  33.   $t_sep = '%WP_TITILE_SEP%'// Temporary separator, for accurate flipping, if necessary 
  34.    
  35.   // If there is a post 
  36.   if ( is_single() || ( is_home() && !is_front_page() ) || ( is_page() && !is_front_page() ) ) { 
  37.     $title = single_post_title( '', false ); 
  38.   } 
  39.    
  40.   // If there's a post type archive 
  41.   if ( is_post_type_archive() ) { 
  42.     $post_type = get_query_var( 'post_type' ); 
  43.     if ( is_array$post_type ) ) 
  44.       $post_type = reset( $post_type ); 
  45.     $post_type_object = get_post_type_object( $post_type ); 
  46.     if ( ! $post_type_object->has_archive ) 
  47.       $title = post_type_archive_title( '', false ); 
  48.   } 
  49.    
  50.   // If there's a category or tag 
  51.   if ( is_category() || is_tag() ) { 
  52.     $title = single_term_title( '', false ); 
  53.   } 
  54.    
  55.   // If there's a taxonomy 
  56.   if ( is_tax() ) { 
  57.     $term = get_queried_object(); 
  58.     if ( $term ) { 
  59.       $tax = get_taxonomy( $term->taxonomy ); 
  60.       $title = single_term_title( $tax->labels->name . $t_sep, false ); 
  61.     } 
  62.   } 
  63.    
  64.   // If there's an author 
  65.   if ( is_author() && ! is_post_type_archive() ) { 
  66.     $author = get_queried_object(); 
  67.     if ( $author ) 
  68.       $title = $author->display_name; 
  69.   } 
  70.    
  71.   // Post type archives with has_archive should override terms. 
  72.   if ( is_post_type_archive() && $post_type_object->has_archive ) 
  73.     $title = post_type_archive_title( '', false ); 
  74.    
  75.   // If there's a month 
  76.   if ( is_archive() && !emptyempty($m) ) { 
  77.     $my_year = substr($m, 0, 4); 
  78.     $my_month = $wp_locale->get_month(substr($m, 4, 2)); 
  79.     $my_day = intval(substr($m, 6, 2)); 
  80.     $title = $my_year . ( $my_month ? $t_sep . $my_month : '' ) . ( $my_day ? $t_sep . $my_day : '' ); 
  81.   } 
  82.    
  83.   // If there's a year 
  84.   if ( is_archive() && !emptyempty($year) ) { 
  85.     $title = $year
  86.     if ( !emptyempty($monthnum) ) 
  87.       $title .= $t_sep . $wp_locale->get_month($monthnum); 
  88.     if ( !emptyempty($day) ) 
  89.       $title .= $t_sep . zeroise($day, 2); 
  90.   } 
  91.    
  92.   // If it's a search 
  93.   if ( is_search() ) { 
  94.     /* translators: 1: separator, 2: search phrase */ 
  95.     $title = sprintf(__('Search Results %1$s %2$s'), $t_sepstrip_tags($search)); 
  96.   } 
  97.    
  98.   // If it's a 404 page 
  99.   if ( is_404() ) { 
  100.     $title = __('Page not found'); 
  101.   } 
  102.    
  103.   $prefix = ''
  104.   if ( !emptyempty($title) ) 
  105.     $prefix = " $sep "
  106.    
  107.   /** 
  108.    * Filter the parts of the page title. 
  109.    * 
  110.    * @since 4.0.0 
  111.    * 
  112.    * @param array $title_array Parts of the page title. 
  113.    */ 
  114.   $title_array = apply_filters( 'wp_title_parts'explode$t_sep$title ) ); 
  115.    
  116.    // Determines position of the separator and direction of the breadcrumb 
  117.   if ( 'right' == $seplocation ) { // sep on right, so reverse the order 
  118.     $title_array = array_reverse$title_array ); 
  119.     $title = implode( " $sep "$title_array ) . $prefix
  120.   } else { 
  121.     $title = $prefix . implode( " $sep "$title_array ); 
  122.   } 
  123.    
  124.   /** 
  125.    * Filter the text of the page title. 
  126.    * 
  127.    * @since 2.0.0 
  128.    * 
  129.    * @param string $title    Page title. 
  130.    * @param string $sep     Title separator. 
  131.    * @param string $seplocation Location of the separator (left or right). 
  132.    */ 
  133.   $title = apply_filters( 'wp_title'$title$sep$seplocation ); 
  134.    
  135.   // Send it out 
  136.   if ( $display ) 
  137.     echo $title
  138.   else 
  139.     return $title
  140.    

很显然默认情况下标题是比较简陋的,对 SEO 并不是很友好。

例子:

<title><?php wp_title( '|', true, 'right' ); ?></title>

其它

标题可以使用 wp_title 过滤器定制,此函数位于:wp-includes/general-template.php

Tags: WordPress页面链接 PHP函数

分享到: