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 字符串编码截取函数(兼容utf-8和gb2312)
May 02 PHP
很让人受教的 提高php代码质量36计
Sep 05 PHP
PHP错误Cannot use object of type stdClass as array in错误的解决办法
Jun 12 PHP
从零开始学YII2框架(六)高级应用程序模板
Aug 20 PHP
thinkphp中html:list标签传递多个参数实例
Oct 30 PHP
php使用递归计算文件夹大小
Dec 24 PHP
标准版Eclipse搭建PHP环境的详细步骤
Nov 18 PHP
Centos6.5和Centos7 php环境搭建方法
May 27 PHP
PHP 在数组中搜索给定的简单实例 array_search 函数
Jun 13 PHP
CodeIgniter整合Smarty的方法详解
Aug 25 PHP
php获得刚插入数据的id 的几种方法总结
May 31 PHP
PHP结合Ffmpeg快速搭建流媒体服务的实践记录
Oct 31 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
PHP数据库操作四:mongodb用法分析
2017/08/16 PHP
ThinkPHP5&amp;5.1框架关联模型分页操作示例
2019/08/03 PHP
PHP检查文件是否存在,不存在自动创建及读取文件内容操作示例
2020/01/23 PHP
JavaScript入门教程(10) 认识其他对象
2009/01/31 Javascript
JavaScript中几种常见排序算法小结
2011/02/22 Javascript
JS日期和时间选择控件升级版(自写)
2013/08/02 Javascript
ECMAScript6块级作用域及新变量声明(let)
2015/06/12 Javascript
jQuery实现彩带延伸效果的网页加载条loading动画
2015/10/29 Javascript
js 判断各种数据类型的简单方法(推荐)
2016/08/29 Javascript
jquery注册文本框获取焦点清空,失去焦点赋值的简单实例
2016/09/08 Javascript
Bootstrap popover用法详解
2016/12/22 Javascript
Angular多选、全选、批量选择操作实例代码
2017/03/10 Javascript
H5上传本地图片并预览功能
2017/05/08 Javascript
vue+axios实现登录拦截的实例代码
2017/05/22 Javascript
20行JS代码实现网页刮刮乐效果
2017/06/23 Javascript
解决vue router组件状态刷新消失的问题
2018/08/01 Javascript
微信小程序使用npm支持踩坑
2018/11/07 Javascript
Vue数据双向绑定的深入探究
2018/11/27 Javascript
详解Vue中组件传值的多重实现方式
2019/08/16 Javascript
小程序富文本提取图片可放大缩小
2020/05/26 Javascript
[00:20]DOTA2荣耀之路7:-ah fu-抢盾
2018/05/31 DOTA
python二叉树遍历的实现方法
2013/11/21 Python
python自定义类并使用的方法
2015/05/07 Python
Python中函数的参数传递与可变长参数介绍
2015/06/30 Python
Python的Django框架中的表单处理示例
2015/07/17 Python
Python实现类似jQuery使用中的链式调用的示例
2016/06/16 Python
Python实现利用最大公约数求三个正整数的最小公倍数示例
2017/09/30 Python
python样条插值的实现代码
2018/12/17 Python
详解python 破解网站反爬虫的两种简单方法
2020/02/09 Python
用Python开发app后端有优势吗
2020/06/29 Python
浅谈HTML5 Web Worker的使用
2018/01/05 HTML / CSS
英国经济型酒店品牌:Travelodge
2019/12/17 全球购物
党员政治学习材料
2014/05/14 职场文书
卖房协议书样本
2014/10/30 职场文书
汽车4S店销售经理岗位职责
2015/04/02 职场文书
课改心得体会范文
2016/01/25 职场文书