Codex

Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

id:Tag Templat/wp link pages

Penjelasan

Berfungsi untuk menampilkan halaman post dengan menggunakan satu atau lebih tanda <!--nextpage--> Quicktag ). Fungsi ini hampir sama dengan link_pages() (tidak digunakan lagi), bedanya adalah argumen diberikan dengan jenis format string yang berbeda. Tag ini harus digunakan di dalam The_Loop.

Penggunaan

 <?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'             => ); ?> 

Parameter

before 
(string) Teks yang diletakkan sebelum semua tautan. Standar <p>Pages:.
after 
(string) Teks yang diletakkan setelah semua tautan. Standar </p>.
link_before 
(string) Teks yang diletakkan sebelum teks tautan. Standar (blank). Versi 2.7 atau setelahnya.
link_after 
(string) Teks yang diletakkan setelah teks tautan. Standar (blank). Versi 2.7 atau setelahnya.
next_or_number 
(string) Mengindikasikan apakah nomor halaman harus digunakan atau tidak. Nilai yang sah adalah:
  • number (Standar)
  • next (Sah di WordPress 1.5 atau setelahnya)
nextpagelink 
(string) Teks untuk tautan ke halaman selanjutnya. Standarnya adalah Next page. (Sah di WordPress 1.5 atau setelahnya)
previouspagelink
(string) Teks untuk tautan ke halaman sebelumnya. Standarnya adalah Previous page. (Sah di WordPress 1.5 atau setelahnya)
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

See also index of Function Reference and index of Template Tags.