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


Posted in PHP onDecember 17, 2015

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

PHP 相关文章推荐
亲密接触PHP之PHP语法学习笔记1
Dec 17 PHP
解决phpmyadmin中文乱码问题。。。
Jan 18 PHP
神盾加密解密教程(三)PHP 神盾解密工具
Jun 08 PHP
PHP之autoload运行机制实例分析
Aug 28 PHP
php5.3提示Function ereg() is deprecated Error问题解决方法
Nov 12 PHP
关于URL最大长度限制的相关资料查证
Dec 23 PHP
PHP生成随机数的方法实例分析
Jan 22 PHP
php监测数据是否成功插入到Mysql数据库的方法
Nov 25 PHP
php 开发中加密的几种方法总结
Mar 22 PHP
PHP基于迭代实现文件夹复制、删除、查看大小等操作的方法
Aug 11 PHP
php pdo连接数据库操作示例
Nov 18 PHP
浅析PHP中的 inet_pton 网络函数
Dec 16 PHP
php提交post数组参数实例分析
Dec 17 #PHP
PHP实现发送邮件的方法(基于简单邮件发送类)
Dec 17 #PHP
PHP响应post请求上传文件的方法
Dec 17 #PHP
CentOS下PHP7的编译安装及MySQL的支持和一些常见问题的解决办法
Dec 17 #PHP
通过PHP简单实例介绍文件上传
Dec 16 #PHP
PHP上传文件参考配置大文件上传
Dec 16 #PHP
谈谈 PHP7新增功能
Dec 16 #PHP
You might like
10个可以简化php开发过程的MySQL工具
2010/04/11 PHP
解决file_get_contents无法请求https连接的方法
2013/12/17 PHP
PHP函数func_num_args用法实例分析
2015/12/07 PHP
Mac系统完美安装PHP7详细教程
2017/06/06 PHP
PHPMailer ThinkPHP实现自动发送邮件功能
2018/06/10 PHP
PHP chop()函数讲解
2019/02/11 PHP
javascript(jquery)利用函数修改全局变量的代码
2009/11/02 Javascript
JavaScript 页面坐标相关知识整理
2010/01/09 Javascript
js实现飞入星星特效代码
2014/10/17 Javascript
实现js保留小数点后N位的代码
2014/11/13 Javascript
开启BootStrap学习之旅
2016/05/04 Javascript
jQuery ajax 当async为false时解决同步操作失败的问题
2016/11/18 Javascript
解决vue2.x中数据渲染以及vuex缓存的问题
2017/07/13 Javascript
JS中的多态实例详解
2017/10/15 Javascript
Vue 页面状态保持页面间数据传输的一种方法(推荐)
2018/11/01 Javascript
sortable+element 实现表格行拖拽的方法示例
2019/06/07 Javascript
详解在Vue.js编写更好的v-for循环的6种技巧
2020/04/14 Javascript
[02:30]辉夜杯主赛事第二日胜者组半决赛 CDEC.Y赛后采访
2015/12/26 DOTA
Python进阶-函数默认参数(详解)
2017/05/18 Python
python机器人行走步数问题的解决
2018/01/29 Python
Python通过调用mysql存储过程实现更新数据功能示例
2018/04/03 Python
Pycharm Available Package无法显示/安装包的问题Error Loading Package List解决
2020/09/18 Python
Python日志器使用方法及原理解析
2020/09/27 Python
解决python3.x安装numpy成功但import出错的问题
2020/11/17 Python
彪马俄罗斯官网:PUMA俄罗斯
2019/07/13 全球购物
JAVA语言如何进行异常处理,关键字:throws,throw,try,catch,finally分别代表什么意义?在try块中可以抛出异常吗?
2013/07/02 面试题
企业宣传方案
2014/03/04 职场文书
秋天的图画教学反思
2014/05/01 职场文书
物业管理工作方案
2014/05/10 职场文书
给校长的建议书500字
2014/05/15 职场文书
新教师2015年度工作总结
2015/07/22 职场文书
php去除数组中为0的元素的实例分析
2021/11/17 PHP
Spring Boot 底层原理基础深度解析
2022/04/03 Java/Android
德劲DE1107指针试高灵敏度全波段收音机机评
2022/04/05 无线电
JAVA长虹键法之建造者Builder模式实现
2022/04/10 Java/Android
分析SQL窗口函数之排名窗口函数
2022/04/21 Oracle