云策 WordPress 开发者社区

函数文档

link_pages()

查看官方原文 ↗
💡 云策文档标注

概述

link_pages() 是一个已弃用的 WordPress 函数，用于基于参数打印页面列表。它已被 wp_link_pages() 替代，自 2.1.0 版本起弃用。

关键要点

  • link_pages() 函数已弃用，建议使用 wp_link_pages() 替代。
  • 函数接受多个参数，如 $before、$after、$next_or_number 等，用于自定义页面列表输出。
  • 内部调用 _deprecated_function() 标记弃用，并返回 wp_link_pages() 的结果。
  • 相关函数包括 wp_link_pages() 和 _deprecated_function()。

代码示例

function link_pages($before='', $after='', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page',
                    $pagelink='%', $more_file='') {
    _deprecated_function( __FUNCTION__, '2.1.0', 'wp_link_pages()' );

    $args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file');
    return wp_link_pages($args);
}

注意事项

  • 自 WordPress 2.1.0 版本起，link_pages() 已被弃用，开发者应迁移到 wp_link_pages() 以避免未来兼容性问题。
  • 函数参数与 wp_link_pages() 兼容，但直接使用 wp_link_pages() 是推荐做法。
📄 原文内容

Print list of pages based on arguments.

Description

See also

Parameters

$beforestringrequired
$afterstringrequired
$next_or_numberstringrequired
$nextpagelinkstringrequired
$previouspagelinkstringrequired
$pagelinkstringrequired
$more_filestringrequired

Return

string

Source

function link_pages($before='<br />', $after='<br />', $next_or_number='number', $nextpagelink='next page', $previouspagelink='previous page',
					$pagelink='%', $more_file='') {
	_deprecated_function( __FUNCTION__, '2.1.0', 'wp_link_pages()' );

	$args = compact('before', 'after', 'next_or_number', 'nextpagelink', 'previouspagelink', 'pagelink', 'more_file');
	return wp_link_pages($args);
}

View all references View on Trac View on GitHub

Uses Description
wp_link_pages()wp-includes/post-template.php

The formatted output of a list of pages.
_deprecated_function()wp-includes/functions.php

Marks a function as deprecated and inform when it has been used.

Changelog

Version Description
2.1.0 Deprecated. Use wp_link_pages()
0.71 Introduced.