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