当サイト、Codex 日本語版は今後積極的な更新は行わない予定です。後継となる新ユーザーマニュアルは、https://ja.wordpress.org/support/ にあります。
万が一、当サイトで重大な問題を発見した際などは、フォーラムWordSlack #docs チャンネルでお知らせください。</p>

「テンプレートタグ/wp link pages」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(要更新(パラメータ追加)、フッタ等追加)
({{原文|Function Reference/wp link pages|95722}} <!-- 22:58, 2 December 2010 Sahaskatta 版 -->)
29行目: 29行目:
  
 
[[en:Template Tags/wp_link_pages]]
 
[[en:Template Tags/wp_link_pages]]
 +
{{Languages|
 +
{{en|Template Tags/wp_link_pages}}
 +
{{ja|テンプレートタグ/wp_link_pages}}
 +
}}
 +
 +
== Description ==
 +
 +
Displays page-links for paginated posts (i.e. includes the <code>&lt;!--nextpage--&gt;</code> [[Write_Post_SubPanel#Quicktags | Quicktag]] one or more times). This works in much the same way as [[Template_Tags/link_pages|link_pages()]] (deprecated), the difference being that arguments are given in query string format. This tag must be within [[The_Loop]].
 +
 +
== Usage ==
 +
 +
%%% <?php wp_link_pages( $args ); ?> %%%
 +
 +
=== Default Usage ===
 +
 +
%%% <?php $args = array(
 +
'before'          => '<p>' . __('Pages:'),
 +
'after'            => '</p>',
 +
'link_before'      => '',
 +
'link_after'      => '',
 +
'next_or_number'  => 'number',
 +
'nextpagelink'    => __('Next page'),
 +
'previouspagelink' => __('Previous page'),
 +
'pagelink'        => '%',
 +
'more_file'        => '',
 +
'echo'            => 1 ); ?> %%%
 +
 +
== Parameters ==
 +
 +
; before : (''string'') Text to put before all the links. Defaults to <tt>&lt;p&gt;Pages:</tt>.
 +
 +
; after : (''string'') Text to put after all the links. Defaults to <tt>&lt;/p&gt;</tt>.
 +
 +
; link_before : (''string'') Text that goes before the text of the link. Defaults to <tt>(blank)</tt>. Version 2.7 or later required.
 +
 +
; link_after : (''string'') Text that goes after the text of the link. Defaults to <tt>(blank)</tt>. Version 2.7 or later required.
 +
 +
; next_or_number : (''string'') Indicates whether page numbers should be used. Valid values are:
 +
:* <tt>number</tt> (Default)
 +
:* <tt>next</tt> (Valid in WordPress 1.5 or after)
 +
 +
; nextpagelink : (''string'') Text for link to next page. Defaults to <tt>Next page</tt>. (Valid in WordPress 1.5 or after)
 +
 +
; previouspagelink: (''string'') Text for link to previous page. Defaults to <tt>Previous page</tt>. (Valid in WordPress 1.5 or after)
 +
 +
; pagelink : (''string'') Format string for page numbers. <tt> % </tt> in the string will be replaced with the number, so <tt>Page %</tt> would generate "Page 1", "Page 2", etc. Defaults to <tt>%</tt>.
 +
 +
; more_file : (''string'') Page the links should point to. Defaults to the current page.
 +
 +
; echo : (''boolean'') Toggles whether to echo or return the result. The default is ''true''. Valid values:
 +
:* <tt>1 (True)</tt> - Default
 +
:* <tt>0 (False)</tt>
 +
 +
== Examples ==
 +
 +
=== Default Usage ===
 +
 +
Displays page-links by default with paragraph tags before and after, using ''Next page'' and ''Previous page'', listing them with page numbers as ''Page 1, Page 2'' and so on.
 +
 +
<?php wp_link_pages(); ?>
 +
 +
=== Page-links in Paragraph Tags ===
 +
 +
Displays page-links wrapped in paragraph tags.
 +
 +
<?php wp_link_pages('before=&lt;p&gt;&after=&lt;/p&gt;&next_or_number=number&pagelink=page %'); ?>
 +
 +
=== Page-links in DIV ===
 +
 +
Displays page-links in DIV for CSS reference as <tt>&lt;div id="page-links"&gt;</tt>.
 +
 +
<?php wp_link_pages('before=&lt;div id="page-links"&gt;&after=&lt;/div&gt;'); ?>
 +
 +
== Changelog ==
 +
 +
Since: 0.71
 +
 +
== Source File ==
 +
 +
<tt>wp_link_pages()</tt> is located in {{Trac|wp-includes/post-template.php}}.
 +
 +
== Related ==
 +
 +
{{Tag Post Tags}}
 +
 +
{{Tag Footer}}
 +
{{原文|Function Reference/wp link pages|95722}} <!-- 22:58, 2 December 2010 Sahaskatta 版 -->
 +
 +
{{DEFAULTSORT:Wp_link_pages}}
 +
[[Category:Template Tags]]

2010年12月21日 (火) 12:51時点における版

このページ「テンプレートタグ/wp link pages」は情報が古くなっている可能性があります。最新版英語)も合わせてご覧ください。翻訳にご協力くださる方はぜひご相談ください

  • バージョン 2.7 でパラメータ 'link_before', 'link_after' が追加されています。
  • 書式: <?php wp_link_pages('引数'); ?>
  • 説明: 記事内をで分割した場合の他セクション(記事内のページ)へのリンク。
  • 位置: ループ内
  • 引数:
    • before (文字列)- リンクの直前に出力するコードやテキスト。デフォルト値は「<br />」。
    • after (文字列)- リンクの直後に出力するコードやテキスト。デフォルト値は「<br />」。
    • next_or_number (next/number)- リンクラベルのタイプ。
      • number(デフォルト。ページ数リンク。指定すると「nextpagelink」「previouspagelink」は無視される)
      • next(テキストリンク。指定すると「pagelink」は無視される)
    • nextpagelink (文字列)- 次ページへのリンクのラベルとして使うテキスト。デフォルト値は「next page」。
    • previouspagelink (規定値)- 前ページへのリンクのラベルとして使うテキスト。デフォルト値は「previous page」。
    • pagelink (文字列)- ページ番号の出力形式。「%」記号を含めるとその部分が実際のページ番号の数字として出力される。デフォルト値は「%」。
    • more_file (文字列)- リンク先として使うファイル名。現時点のバージョンではこの引数を指定してもデフォルト値が採用される。
  • コード記述例: <?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?>
  • 出力例:<p> Page 1 <a href="http://example.com/?p=3&page=2">Page 2 </a> <a href="http://example.com/?p=3&page=3">Page 3</a></p>

変更履歴

  • 2.7 : パラメータに link_beforelink_after が追加されました。

テンプレート:Tag Link Tags


テンプレートタグへのクエリ文字列型パラメータの渡し方関数リファレンステンプレートタグ目次もご覧ください。

[http://wpdocs.sourceforge.jp{{localurl: テンプレート:en テンプレート:ja }} 日本語] •

Description

Displays page-links for paginated posts (i.e. includes the <!--nextpage--> Quicktag one or more times). This works in much the same way as link_pages() (deprecated), the difference being that arguments are given in query string format. This tag must be within The_Loop.

Usage

%%% <?php wp_link_pages( $args ); ?> %%%

Default Usage

%%% <?php $args = array(

'before' => '

' . __('Pages:'), 'after' => '

',

'link_before' => , 'link_after' => , 'next_or_number' => 'number', 'nextpagelink' => __('Next page'), 'previouspagelink' => __('Previous page'), 'pagelink' => '%', 'more_file' => , 'echo' => 1 ); ?> %%%

Parameters

before 
(string) Text to put before all the links. Defaults to <p>Pages:.
after 
(string) Text to put after all the links. Defaults to </p>.
link_before 
(string) Text that goes before the text of the link. Defaults to (blank). Version 2.7 or later required.
link_after 
(string) Text that goes after the text of the link. Defaults to (blank). Version 2.7 or later required.
next_or_number 
(string) Indicates whether page numbers should be used. Valid values are:
  • number (Default)
  • next (Valid in WordPress 1.5 or after)
nextpagelink 
(string) Text for link to next page. Defaults to Next page. (Valid in WordPress 1.5 or after)
previouspagelink
(string) Text for link to previous page. Defaults to Previous page. (Valid in WordPress 1.5 or after)
pagelink 
(string) Format string for page numbers.  % in the string will be replaced with the number, so Page % would generate "Page 1", "Page 2", etc. Defaults to %.
more_file 
(string) Page the links should point to. Defaults to the current page.
echo 
(boolean) Toggles whether to echo or return the result. The default is true. Valid values:
  • 1 (True) - Default
  • 0 (False)

Examples

Default Usage

Displays page-links by default with paragraph tags before and after, using Next page and Previous page, listing them with page numbers as Page 1, Page 2 and so on.

<?php wp_link_pages(); ?>

Page-links in Paragraph Tags

Displays page-links wrapped in paragraph tags.

<?php wp_link_pages('before=<p>&after=</p>&next_or_number=number&pagelink=page %'); ?>

Page-links in DIV

Displays page-links in DIV for CSS reference as <div id="page-links">.

<?php wp_link_pages('before=<div id="page-links">&after=</div>'); ?>

Changelog

Since: 0.71

Source File

wp_link_pages() is located in wp-includes/post-template.php.

Related

投稿タグ: body_class(), next_image_link(), next_post_link(), next_posts_link(), post_class(), post_password_required(), posts_nav_link(), previous_image_link(), previous_post_link(), previous_posts_link(), single_post_title(), sticky_class(), the_category(), the_category_rss(), the_content(), the_content_rss(), the_excerpt(), the_excerpt_rss(), the_ID(), the_meta(), the_shortlink(), the_tags(), the_title(), the_title_attribute(), the_title_rss(), wp_link_pages(),


関数リファレンステンプレートタグ目次もご覧ください。

最新英語版: WordPress Codex » Function Reference/wp link pages最新版との差分