WordPress中獲取頁面鏈接和標題的相關PHP函數用法解析

來源于：

https://www.jb51.net/article/76563.htm

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

（字符串）（可選）標題內容的分隔符，一般設置成 “|” 或者 “-”。

默認值：?（?）

$display

（布爾）（可選）是否直接打印標題，如果設置成 False 則返回標題，可以存儲到變量里。

默認值：True（直接打印輸出）

$seplocation

（字符串）（可選）分隔符所在位置，左邊還是右邊，如果傳遞 “right” 則為右邊，其它任何內容都是左邊。

默認值：空字符串（左邊）

返回值

（字符串）如果 $display 參數設置成 False，才能返回標題的內容，根據不同的標題會返回不同的內容，默認情況下返回的內容是這樣的：

• 文章頁：文章標題
• 日期頁：日期
• 分類頁：分類標題
• 作者頁：作者名字

如果你想更加詳細的了解，可以閱讀下邊的函數源碼：

/**
?* Display or retrieve page title for all areas of blog.
?*
?* By default, the page title will display the separator before the page title,
?* so that the blog title will be before the page title. This is not good for
?* title display, since the blog title shows up on most tabs and not what is
?* important, which is the page that the user is looking at.
?*
?* There are also SEO benefits to having the blog title after or to the 'right'
?* or the page title. However, it is mostly common sense to have the blog title
?* to the right with most browsers supporting tabs. You can achieve this by
?* using the seplocation parameter and setting the value to 'right'. This change
?* was introduced around 2.5.0, in case backwards compatibility of themes is
?* important.
?*
?* @since 1.0.0
?*
?* @param string $sep Optional, default is '?'. How to separate the various items within the page title.
?* @param bool $display Optional, default is true. Whether to display or retrieve title.
?* @param string $seplocation Optional. Direction to display title, 'right'.
?* @return string|null String on retrieve, null when displaying.
?*/
function wp_title($sep = '?', $display = true, $seplocation = '') {
??global $wp_locale;
??
??$m = get_query_var('m');
??$year = get_query_var('year');
??$monthnum = get_query_var('monthnum');
??$day = get_query_var('day');
??$search = get_query_var('s');
??$title = '';
??
??$t_sep = '%WP_TITILE_SEP%'; // Temporary separator, for accurate flipping, if necessary
??
??// If there is a post
??if ( is_single() || ( is_home() && !is_front_page() ) || ( is_page() && !is_front_page() ) ) {
????$title = single_post_title( '', false );
??}
??
??// If there's a post type archive
??if ( is_post_type_archive() ) {
????$post_type = get_query_var( 'post_type' );
????if ( is_array( $post_type ) )
??????$post_type = reset( $post_type );
????$post_type_object = get_post_type_object( $post_type );
????if ( ! $post_type_object->has_archive )
??????$title = post_type_archive_title( '', false );
??}
??
??// If there's a category or tag
??if ( is_category() || is_tag() ) {
????$title = single_term_title( '', false );
??}
??
??// If there's a taxonomy
??if ( is_tax() ) {
????$term = get_queried_object();
????if ( $term ) {
??????$tax = get_taxonomy( $term->taxonomy );
??????$title = single_term_title( $tax->labels->name . $t_sep, false );
????}
??}
??
??// If there's an author
??if ( is_author() && ! is_post_type_archive() ) {
????$author = get_queried_object();
????if ( $author )
??????$title = $author->display_name;
??}
??
??// Post type archives with has_archive should override terms.
??if ( is_post_type_archive() && $post_type_object->has_archive )
????$title = post_type_archive_title( '', false );
??
??// If there's a month
??if ( is_archive() && !empty($m) ) {
????$my_year = substr($m, 0, 4);
????$my_month = $wp_locale->get_month(substr($m, 4, 2));
????$my_day = intval(substr($m, 6, 2));
????$title = $my_year . ( $my_month ? $t_sep . $my_month : '' ) . ( $my_day ? $t_sep . $my_day : '' );
??}
??
??// If there's a year
??if ( is_archive() && !empty($year) ) {
????$title = $year;
????if ( !empty($monthnum) )
??????$title .= $t_sep . $wp_locale->get_month($monthnum);
????if ( !empty($day) )
??????$title .= $t_sep . zeroise($day, 2);
??}
??
??// If it's a search
??if ( is_search() ) {
????/* translators: 1: separator, 2: search phrase */
????$title = sprintf(__('Search Results %1$s %2$s'), $t_sep, strip_tags($search));
??}
??
??// If it's a 404 page
??if ( is_404() ) {
????$title = __('Page not found');
??}
??
??$prefix = '';
??if ( !empty($title) )
????$prefix = " $sep ";
??
??/**
???* Filter the parts of the page title.
???*
???* @since 4.0.0
???*
???* @param array $title_array Parts of the page title.
???*/
??$title_array = apply_filters( 'wp_title_parts', explode( $t_sep, $title ) );
??
???// Determines position of the separator and direction of the breadcrumb
??if ( 'right' == $seplocation ) { // sep on right, so reverse the order
????$title_array = array_reverse( $title_array );
????$title = implode( " $sep ", $title_array ) . $prefix;
??} else {
????$title = $prefix . implode( " $sep ", $title_array );
??}
??
??/**
???* Filter the text of the page title.
???*
???* @since 2.0.0
???*
???* @param string $title??? Page title.
???* @param string $sep???? Title separator.
???* @param string $seplocation Location of the separator (left or right).
???*/
??$title = apply_filters( 'wp_title', $title, $sep, $seplocation );
??
??// Send it out
??if ( $display )
????echo $title;
??else
????return $title;
??
}

很顯然默認情況下標題是比較簡陋的，對 SEO 并不是很友好。

例子

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

其它

標題可以使用 wp_title 過濾器定制，此函數位于：wp-includes/general-template.php