WordPress.org

Make WordPress Core

Ticket #17302: get_adjacent_post_link.diff

File get_adjacent_post_link.diff, 4.3 KB (added by yoavf, 4 years ago)
  • wp-includes/link-template.php

     
    14001400} 
    14011401 
    14021402/** 
     1403 * Get previous post link that is adjacent to the current post. 
     1404 * 
     1405 * @since 3.2.0 
     1406 * 
     1407 * @param string $format Optional. Link anchor format. 
     1408 * @param string $link Optional. Link permalink format. 
     1409 * @param bool $in_same_cat Optional. Whether link should be in same category. 
     1410 * @param string $excluded_categories Optional. Excluded categories IDs. 
     1411 * @return string 
     1412 */ 
     1413function get_previous_post_link($format='« %link', $link='%title', $in_same_cat = false, $excluded_categories = '') { 
     1414        return get_adjacent_post_link($format, $link, $in_same_cat, $excluded_categories, true); 
     1415} 
     1416 
     1417/** 
    14031418 * Display previous post link that is adjacent to the current post. 
    14041419 * 
    14051420 * @since 1.5.0 
     1421 * @uses get_previous_post_link() 
    14061422 * 
    14071423 * @param string $format Optional. Link anchor format. 
    14081424 * @param string $link Optional. Link permalink format. 
     
    14101426 * @param string $excluded_categories Optional. Excluded categories IDs. 
    14111427 */ 
    14121428function previous_post_link($format='« %link', $link='%title', $in_same_cat = false, $excluded_categories = '') { 
    1413         adjacent_post_link($format, $link, $in_same_cat, $excluded_categories, true); 
     1429        echo get_previous_post_link($format, $link, $in_same_cat, $excluded_categories); 
    14141430} 
    14151431 
    14161432/** 
     1433 * Get previous post link that is adjacent to the current post. 
     1434 * 
     1435 * @since 3.2.0 
     1436 * 
     1437 * @param string $format Optional. Link anchor format. 
     1438 * @param string $link Optional. Link permalink format. 
     1439 * @param bool $in_same_cat Optional. Whether link should be in same category. 
     1440 * @param string $excluded_categories Optional. Excluded categories IDs. 
     1441 * @return string 
     1442 */ 
     1443function get_next_post_link($format='« %link', $link='%title', $in_same_cat = false, $excluded_categories = '') { 
     1444        return get_adjacent_post_link($format, $link, $in_same_cat, $excluded_categories, false); 
     1445} 
     1446 
     1447/** 
    14171448 * Display next post link that is adjacent to the current post. 
    14181449 * 
    14191450 * @since 1.5.0 
     1451 * @uses get_next_post_link() 
    14201452 * 
    14211453 * @param string $format Optional. Link anchor format. 
    14221454 * @param string $link Optional. Link permalink format. 
     
    14241456 * @param string $excluded_categories Optional. Excluded categories IDs. 
    14251457 */ 
    14261458function next_post_link($format='%link »', $link='%title', $in_same_cat = false, $excluded_categories = '') { 
    1427         adjacent_post_link($format, $link, $in_same_cat, $excluded_categories, false); 
     1459        echo get_next_post_link($format, $link, $in_same_cat, $excluded_categories); 
    14281460} 
    14291461 
    14301462/** 
    1431  * Display adjacent post link. 
     1463 * Get adjacent post link. 
    14321464 * 
    14331465 * Can be either next post link or previous. 
    14341466 * 
    1435  * @since 2.5.0 
     1467 * @since 3.2.0 
    14361468 * 
    14371469 * @param string $format Link anchor format. 
    14381470 * @param string $link Link permalink format. 
    14391471 * @param bool $in_same_cat Optional. Whether link should be in same category. 
    14401472 * @param string $excluded_categories Optional. Excluded categories IDs. 
    14411473 * @param bool $previous Optional, default is true. Whether display link to previous post. 
     1474 * @return string 
    14421475 */ 
    1443 function adjacent_post_link($format, $link, $in_same_cat = false, $excluded_categories = '', $previous = true) { 
     1476function get_adjacent_post_link($format, $link, $in_same_cat = false, $excluded_categories = '', $previous = true) { 
    14441477        if ( $previous && is_attachment() ) 
    14451478                $post = & get_post($GLOBALS['post']->post_parent); 
    14461479        else 
     
    14691502        echo apply_filters( "{$adjacent}_post_link", $format, $link ); 
    14701503} 
    14711504 
     1505 
    14721506/** 
     1507 * Display adjacent post link. 
     1508 * 
     1509 * Can be either next post link or previous. 
     1510 * 
     1511 * @since 2.5.0 
     1512 * @uses get_adjacent_post_link() 
     1513 * 
     1514 * @param string $format Link anchor format. 
     1515 * @param string $link Link permalink format. 
     1516 * @param bool $in_same_cat Optional. Whether link should be in same category. 
     1517 * @param string $excluded_categories Optional. Excluded categories IDs. 
     1518 * @param bool $previous Optional, default is true. Whether display link to previous post. 
     1519 */ 
     1520function adjacent_post_link( $format, $link, $in_same_cat = false, $excluded_categories = '', $previous = true) { 
     1521        echo get_adjacent_post_link( $format, $link, $in_same_cat, $excluded_categories, $previous ); 
     1522} 
     1523 
     1524/** 
    14731525 * Retrieve get links for page numbers. 
    14741526 * 
    14751527 * @since 1.5.0