1 <?php

     2 /**

     3  * WordPress Link Template Functions

     4  *

     5  * @package WordPress

     6  * @subpackage Template

     7  */

     8 

     9 /**

    10  * Display the permalink for the current post.

    11  *

    12  * @since 1.2.0

    13  * @uses apply_filters() Calls 'the_permalink' filter on the permalink string.

    14  */

    15 function the_permalink() {

    16 	echo apply_filters('the_permalink', get_permalink());

    17 }

    18 

    19 /**

    20  * Retrieve trailing slash string, if blog set for adding trailing slashes.

    21  *

    22  * Conditionally adds a trailing slash if the permalink structure has a trailing

    23  * slash, strips the trailing slash if not. The string is passed through the

    24  * 'user_trailingslashit' filter. Will remove trailing slash from string, if

    25  * blog is not set to have them.

    26  *

    27  * @since 2.2.0

    28  * @uses $wp_rewrite

    29  *

    30  * @param $string String a URL with or without a trailing slash.

    31  * @param $type_of_url String the type of URL being considered (e.g. single, category, etc) for use in the filter.

    32  * @return string

    33  */

    34 function user_trailingslashit($string, $type_of_url = '') {

    35 	global $wp_rewrite;

    36 	if ( $wp_rewrite->use_trailing_slashes )

    37 		$string = trailingslashit($string);

    38 	else

    39 		$string = untrailingslashit($string);

    40 

    41 	// Note that $type_of_url can be one of following:

    42 	// single, single_trackback, single_feed, single_paged, feed, category, page, year, month, day, paged

    43 	$string = apply_filters('user_trailingslashit', $string, $type_of_url);

    44 	return $string;

    45 }

    46 

    47 /**

    48  * Display permalink anchor for current post.

    49  *

    50  * The permalink mode title will use the post title for the 'a' element 'id'

    51  * attribute. The id mode uses 'post-' with the post ID for the 'id' attribute.

    52  *

    53  * @since 0.71

    54  *

    55  * @param string $mode Permalink mode can be either 'title', 'id', or default, which is 'id'.

    56  */

    57 function permalink_anchor($mode = 'id') {

    58 	global $post;

    59 	switch ( strtolower($mode) ) {

    60 		case 'title':

    61 			$title = sanitize_title($post->post_title) . '-' . $post->ID;

    62 			echo '<a id="'.$title.'"></a>';

    63 			break;

    64 		case 'id':

    65 		default:

    66 			echo '<a id="post-' . $post->ID . '"></a>';

    67 			break;

    68 	}

    69 }

    70 

    71 /**

    72  * Retrieve full permalink for current post or post ID.

    73  *

    74  * @since 1.0.0

    75  *

    76  * @param int $id Optional. Post ID.

    77  * @param bool $leavename Optional, defaults to false. Whether to keep post name or page name.

    78  * @return string

    79  */

    80 function get_permalink($id = 0, $leavename = false) {

    81 	$rewritecode = array(

    82 		'%year%',

    83 		'%monthnum%',

    84 		'%day%',

    85 		'%hour%',

    86 		'%minute%',

    87 		'%second%',

    88 		$leavename? '' : '%postname%',

    89 		'%post_id%',

    90 		'%category%',

    91 		'%author%',

    92 		$leavename? '' : '%pagename%',

    93 	);

    94 

    95 	if ( is_object($id) && isset($id->filter) && 'sample' == $id->filter ) {

    96 		$post = $id;

    97 		$sample = true;

    98 	} else {

    99 		$post = &get_post($id);

   100 		$sample = false;

   101 	}

   102 

   103 	if ( empty($post->ID) ) return false;

   104 

   105 	if ( $post->post_type == 'page' )

   106 		return get_page_link($post->ID, $leavename, $sample);

   107 	elseif ($post->post_type == 'attachment')

   108 		return get_attachment_link($post->ID);

   109 

   110 	$permalink = get_option('permalink_structure');

   111 

   112 	if ( '' != $permalink && !in_array($post->post_status, array('draft', 'pending')) ) {

   113 		$unixtime = strtotime($post->post_date);

   114 

   115 		$category = '';

   116 		if ( strpos($permalink, '%category%') !== false ) {

   117 			$cats = get_the_category($post->ID);

   118 			if ( $cats ) {

   119 				usort($cats, '_usort_terms_by_ID'); // order by ID

   120 				$category = $cats[0]->slug;

   121 				if ( $parent = $cats[0]->parent )

   122 					$category = get_category_parents($parent, false, '/', true) . $category;

   123 			}

   124 			// show default category in permalinks, without

   125 			// having to assign it explicitly

   126 			if ( empty($category) ) {

   127 				$default_category = get_category( get_option( 'default_category' ) );

   128 				$category = is_wp_error( $default_category ) ? '' : $default_category->slug;

   129 			}

   130 		}

   131 

   132 		$author = '';

   133 		if ( strpos($permalink, '%author%') !== false ) {

   134 			$authordata = get_userdata($post->post_author);

   135 			$author = $authordata->user_nicename;

   136 		}

   137 

   138 		$date = explode(" ",date('Y m d H i s', $unixtime));

   139 		$rewritereplace =

   140 		array(

   141 			$date[0],

   142 			$date[1],

   143 			$date[2],

   144 			$date[3],

   145 			$date[4],

   146 			$date[5],

   147 			$post->post_name,

   148 			$post->ID,

   149 			$category,

   150 			$author,

   151 			$post->post_name,

   152 		);

   153 		$permalink = get_option('home') . str_replace($rewritecode, $rewritereplace, $permalink);

   154 		$permalink = user_trailingslashit($permalink, 'single');

   155 		return apply_filters('post_link', $permalink, $post, $leavename);

   156 	} else { // if they're not using the fancy permalink option

   157 		$permalink = trailingslashit(get_option('home')) . '?p=' . $post->ID;

   158 		return apply_filters('post_link', $permalink, $post, $leavename);

   159 	}

   160 }

   161 

   162 /**

   163  * Retrieve permalink from post ID.

   164  *

   165  * @since 1.0.0

   166  *

   167  * @param int $post_id Optional. Post ID.

   168  * @param mixed $deprecated Not used.

   169  * @return string

   170  */

   171 function post_permalink($post_id = 0, $deprecated = '') {

   172 	return get_permalink($post_id);

   173 }

   174 

   175 /**

   176  * Retrieve the permalink for current page or page ID.

   177  *

   178  * Respects page_on_front. Use this one.

   179  *

   180  * @since 1.5.0

   181  *

   182  * @param int $id Optional. Post ID.

   183  * @param bool $leavename Optional, defaults to false. Whether to keep page name.

   184  * @param bool $sample Optional, defaults to false. Is it a sample permalink.

   185  * @return string

   186  */

   187 function get_page_link( $id = false, $leavename = false, $sample = false ) {

   188 	global $post;

   189 

   190 	$id = (int) $id;

   191 	if ( !$id )

   192 		$id = (int) $post->ID;

   193 

   194 	if ( 'page' == get_option('show_on_front') && $id == get_option('page_on_front') )

   195 		$link = get_option('home');

   196 	else

   197 		$link = _get_page_link( $id , $leavename, $sample );

   198 

   199 	return apply_filters('page_link', $link, $id);

   200 }

   201 

   202 /**

   203  * Retrieve the page permalink.

   204  *

   205  * Ignores page_on_front. Internal use only.

   206  *

   207  * @since 2.1.0

   208  * @access private

   209  *

   210  * @param int $id Optional. Post ID.

   211  * @param bool $leavename Optional. Leave name.

   212  * @param bool $sample Optional. Sample permalink.

   213  * @return string

   214  */

   215 function _get_page_link( $id = false, $leavename = false, $sample = false ) {

   216 	global $post, $wp_rewrite;

   217 

   218 	if ( !$id )

   219 		$id = (int) $post->ID;

   220 	else

   221 		$post = &get_post($id);

   222 

   223 	$pagestruct = $wp_rewrite->get_page_permastruct();

   224 

   225 	if ( '' != $pagestruct && ( ( isset($post->post_status) && 'draft' != $post->post_status && 'pending' != $post->post_status ) || $sample ) ) {

   226 		$link = get_page_uri($id);

   227 		$link = ( $leavename ) ? $pagestruct : str_replace('%pagename%', $link, $pagestruct);

   228 		$link = trailingslashit(get_option('home')) . "$link";

   229 		$link = user_trailingslashit($link, 'page');

   230 	} else {

   231 		$link = trailingslashit(get_option('home')) . "?page_id=$id";

   232 	}

   233 

   234 	return apply_filters( '_get_page_link', $link, $id );

   235 }

   236 

   237 /**

   238  * Retrieve permalink for attachment.

   239  *

   240  * This can be used in the WordPress Loop or outside of it.

   241  *

   242  * @since 2.0.0

   243  *

   244  * @param int $id Optional. Post ID.

   245  * @return string

   246  */

   247 function get_attachment_link($id = false) {

   248 	global $post, $wp_rewrite;

   249 

   250 	$link = false;

   251 

   252 	if (! $id) {

   253 		$id = (int) $post->ID;

   254 	}

   255 

   256 	$object = get_post($id);

   257 	if ( $wp_rewrite->using_permalinks() && ($object->post_parent > 0) && ($object->post_parent != $id) ) {

   258 		$parent = get_post($object->post_parent);

   259 		if ( 'page' == $parent->post_type )

   260 			$parentlink = _get_page_link( $object->post_parent ); // Ignores page_on_front

   261 		else

   262 			$parentlink = get_permalink( $object->post_parent );

   263 		if ( is_numeric($object->post_name) || false !== strpos(get_option('permalink_structure'), '%category%') )

   264 			$name = 'attachment/' . $object->post_name; // <permalink>/<int>/ is paged so we use the explicit attachment marker

   265 		else

   266 			$name = $object->post_name;

   267 		if (strpos($parentlink, '?') === false)

   268 			$link = user_trailingslashit( trailingslashit($parentlink) . $name );

   269 	}

   270 

   271 	if (! $link ) {

   272 		$link = trailingslashit(get_bloginfo('url')) . "?attachment_id=$id";

   273 	}

   274 

   275 	return apply_filters('attachment_link', $link, $id);

   276 }

   277 

   278 /**

   279  * Retrieve the permalink for the year archives.

   280  *

   281  * @since 1.5.0

   282  *

   283  * @param int|bool $year False for current year or year for permalink.

   284  * @return string

   285  */

   286 function get_year_link($year) {

   287 	global $wp_rewrite;

   288 	if ( !$year )

   289 		$year = gmdate('Y', time()+(get_option('gmt_offset') * 3600));

   290 	$yearlink = $wp_rewrite->get_year_permastruct();

   291 	if ( !empty($yearlink) ) {

   292 		$yearlink = str_replace('%year%', $year, $yearlink);

   293 		return apply_filters('year_link', get_option('home') . user_trailingslashit($yearlink, 'year'), $year);

   294 	} else {

   295 		return apply_filters('year_link', trailingslashit(get_option('home')) . '?m=' . $year, $year);

   296 	}

   297 }

   298 

   299 /**

   300  * Retrieve the permalink for the month archives with year.

   301  *

   302  * @since 1.0.0

   303  *

   304  * @param bool|int $year False for current year. Integer of year.

   305  * @param bool|int $month False for current month. Integer of month.

   306  * @return string

   307  */

   308 function get_month_link($year, $month) {

   309 	global $wp_rewrite;

   310 	if ( !$year )

   311 		$year = gmdate('Y', time()+(get_option('gmt_offset') * 3600));

   312 	if ( !$month )

   313 		$month = gmdate('m', time()+(get_option('gmt_offset') * 3600));

   314 	$monthlink = $wp_rewrite->get_month_permastruct();

   315 	if ( !empty($monthlink) ) {

   316 		$monthlink = str_replace('%year%', $year, $monthlink);

   317 		$monthlink = str_replace('%monthnum%', zeroise(intval($month), 2), $monthlink);

   318 		return apply_filters('month_link', get_option('home') . user_trailingslashit($monthlink, 'month'), $year, $month);

   319 	} else {

   320 		return apply_filters('month_link', trailingslashit(get_option('home')) . '?m=' . $year . zeroise($month, 2), $year, $month);

   321 	}

   322 }

   323 

   324 /**

   325  * Retrieve the permalink for the day archives with year and month.

   326  *

   327  * @since 1.0.0

   328  *

   329  * @param bool|int $year False for current year. Integer of year.

   330  * @param bool|int $month False for current month. Integer of month.

   331  * @param bool|int $day False for current day. Integer of day.

   332  * @return string

   333  */

   334 function get_day_link($year, $month, $day) {

   335 	global $wp_rewrite;

   336 	if ( !$year )

   337 		$year = gmdate('Y', time()+(get_option('gmt_offset') * 3600));

   338 	if ( !$month )

   339 		$month = gmdate('m', time()+(get_option('gmt_offset') * 3600));

   340 	if ( !$day )

   341 		$day = gmdate('j', time()+(get_option('gmt_offset') * 3600));

   342 

   343 	$daylink = $wp_rewrite->get_day_permastruct();

   344 	if ( !empty($daylink) ) {

   345 		$daylink = str_replace('%year%', $year, $daylink);

   346 		$daylink = str_replace('%monthnum%', zeroise(intval($month), 2), $daylink);

   347 		$daylink = str_replace('%day%', zeroise(intval($day), 2), $daylink);

   348 		return apply_filters('day_link', get_option('home') . user_trailingslashit($daylink, 'day'), $year, $month, $day);

   349 	} else {

   350 		return apply_filters('day_link', trailingslashit(get_option('home')) . '?m=' . $year . zeroise($month, 2) . zeroise($day, 2), $year, $month, $day);

   351 	}

   352 }

   353 

   354 /**

   355  * Retrieve the permalink for the feed type.

   356  *

   357  * @since 1.5.0

   358  *

   359  * @param string $feed Optional, defaults to default feed. Feed type.

   360  * @return string

   361  */

   362 function get_feed_link($feed = '') {

   363 	global $wp_rewrite;

   364 

   365 	$permalink = $wp_rewrite->get_feed_permastruct();

   366 	if ( '' != $permalink ) {

   367 		if ( false !== strpos($feed, 'comments_') ) {

   368 			$feed = str_replace('comments_', '', $feed);

   369 			$permalink = $wp_rewrite->get_comment_feed_permastruct();

   370 		}

   371 

   372 		if ( get_default_feed() == $feed )

   373 			$feed = '';

   374 

   375 		$permalink = str_replace('%feed%', $feed, $permalink);

   376 		$permalink = preg_replace('#/+#', '/', "/$permalink");

   377 		$output =  get_option('home') . user_trailingslashit($permalink, 'feed');

   378 	} else {

   379 		if ( empty($feed) )

   380 			$feed = get_default_feed();

   381 

   382 		if ( false !== strpos($feed, 'comments_') )

   383 			$feed = str_replace('comments_', 'comments-', $feed);

   384 

   385 		$output = trailingslashit(get_option('home')) . "?feed={$feed}";

   386 	}

   387 

   388 	return apply_filters('feed_link', $output, $feed);

   389 }

   390 

   391 /**

   392  * Retrieve the permalink for the post comments feed.

   393  *

   394  * @since 2.2.0

   395  *

   396  * @param int $post_id Optional. Post ID.

   397  * @param string $feed Optional. Feed type.

   398  * @return string

   399  */

   400 function get_post_comments_feed_link($post_id = '', $feed = '') {

   401 	global $id;

   402 

   403 	if ( empty($post_id) )

   404 		$post_id = (int) $id;

   405 

   406 	if ( empty($feed) )

   407 		$feed = get_default_feed();

   408 

   409 	if ( '' != get_option('permalink_structure') ) {

   410 		$url = trailingslashit( get_permalink($post_id) ) . 'feed';

   411 		if ( $feed != get_default_feed() )

   412 			$url .= "/$feed";

   413 		$url = user_trailingslashit($url, 'single_feed');

   414 	} else {

   415 		$type = get_post_field('post_type', $post_id);

   416 		if ( 'page' == $type )

   417 			$url = trailingslashit(get_option('home')) . "?feed=$feed&page_id=$post_id";

   418 		else

   419 			$url = trailingslashit(get_option('home')) . "?feed=$feed&p=$post_id";

   420 	}

   421 

   422 	return apply_filters('post_comments_feed_link', $url);

   423 }

   424 

   425 /**

   426  * Display the comment feed link for a post.

   427  *

   428  * Prints out the comment feed link for a post. Link text is placed in the

   429  * anchor. If no link text is specified, default text is used. If no post ID is

   430  * specified, the current post is used.

   431  *

   432  * @package WordPress

   433  * @subpackage Feed

   434  * @since 2.5.0

   435  *

   436  * @param string $link_text Descriptive text.

   437  * @param int $post_id Optional post ID.  Default to current post.

   438  * @param string $feed Optional. Feed format.

   439  * @return string Link to the comment feed for the current post.

   440 */

   441 function post_comments_feed_link( $link_text = '', $post_id = '', $feed = '' ) {

   442 	$url = get_post_comments_feed_link($post_id, $feed);

   443 	if ( empty($link_text) )

   444 		$link_text = __('Comments Feed');

   445 

   446 	echo apply_filters( 'post_comments_feed_link_html', "<a href='$url'>$link_text</a>", $post_id, $feed );

   447 }

   448 

   449 /**

   450  * Retrieve the feed link for a given author.

   451  *

   452  * Returns a link to the feed for all posts by a given author. A specific feed

   453  * can be requested or left blank to get the default feed.

   454  *

   455  * @package WordPress

   456  * @subpackage Feed

   457  * @since 2.5.0

   458  *

   459  * @param int $author_id ID of an author.

   460  * @param string $feed Optional. Feed type.

   461  * @return string Link to the feed for the author specified by $author_id.

   462 */

   463 function get_author_feed_link( $author_id, $feed = '' ) {

   464 	$author_id = (int) $author_id;

   465 	$permalink_structure = get_option('permalink_structure');

   466 

   467 	if ( empty($feed) )

   468 		$feed = get_default_feed();

   469 

   470 	if ( '' == $permalink_structure ) {

   471 		$link = trailingslashit(get_option('home')) . "?feed=$feed&author=" . $author_id;

   472 	} else {

   473 		$link = get_author_posts_url($author_id);

   474 		if ( $feed == get_default_feed() )

   475 			$feed_link = 'feed';

   476 		else

   477 			$feed_link = "feed/$feed";

   478 

   479 		$link = trailingslashit($link) . user_trailingslashit($feed_link, 'feed');

   480 	}

   481 

   482 	$link = apply_filters('author_feed_link', $link, $feed);

   483 

   484 	return $link;

   485 }

   486 

   487 /**

   488  * Retrieve the feed link for a category.

   489  *

   490  * Returns a link to the feed for all post in a given category. A specific feed

   491  * can be requested or left blank to get the default feed.

   492  *

   493  * @package WordPress

   494  * @subpackage Feed

   495  * @since 2.5.0

   496  *

   497  * @param int $cat_id ID of a category.

   498  * @param string $feed Optional. Feed type.

   499  * @return string Link to the feed for the category specified by $cat_id.

   500 */

   501 function get_category_feed_link($cat_id, $feed = '') {

   502 	$cat_id = (int) $cat_id;

   503 

   504 	$category = get_category($cat_id);

   505 

   506 	if ( empty($category) || is_wp_error($category) )

   507 		return false;

   508 

   509 	if ( empty($feed) )

   510 		$feed = get_default_feed();

   511 

   512 	$permalink_structure = get_option('permalink_structure');

   513 

   514 	if ( '' == $permalink_structure ) {

   515 		$link = trailingslashit(get_option('home')) . "?feed=$feed&cat=" . $cat_id;

   516 	} else {

   517 		$link = get_category_link($cat_id);

   518 		if( $feed == get_default_feed() )

   519 			$feed_link = 'feed';

   520 		else

   521 			$feed_link = "feed/$feed";

   522 

   523 		$link = trailingslashit($link) . user_trailingslashit($feed_link, 'feed');

   524 	}

   525 

   526 	$link = apply_filters('category_feed_link', $link, $feed);

   527 

   528 	return $link;

   529 }

   530 

   531 /**

   532  * Retrieve permalink for feed of tag.

   533  *

   534  * @since 2.3.0

   535  *

   536  * @param int $tag_id Tag ID.

   537  * @param string $feed Optional. Feed type.

   538  * @return string

   539  */

   540 function get_tag_feed_link($tag_id, $feed = '') {

   541 	$tag_id = (int) $tag_id;

   542 

   543 	$tag = get_tag($tag_id);

   544 

   545 	if ( empty($tag) || is_wp_error($tag) )

   546 		return false;

   547 

   548 	$permalink_structure = get_option('permalink_structure');

   549 

   550 	if ( empty($feed) )

   551 		$feed = get_default_feed();

   552 

   553 	if ( '' == $permalink_structure ) {

   554 		$link = trailingslashit(get_option('home')) . "?feed=$feed&tag=" . $tag->slug;

   555 	} else {

   556 		$link = get_tag_link($tag->term_id);

   557 		if ( $feed == get_default_feed() )

   558 			$feed_link = 'feed';

   559 		else

   560 			$feed_link = "feed/$feed";

   561 		$link = trailingslashit($link) . user_trailingslashit($feed_link, 'feed');

   562 	}

   563 

   564 	$link = apply_filters('tag_feed_link', $link, $feed);

   565 

   566 	return $link;

   567 }

   568 

   569 /**

   570  * Retrieve edit tag link.

   571  *

   572  * @since 2.7.0

   573  *

   574  * @param int $tag_id Tag ID

   575  * @return string

   576  */

   577 function get_edit_tag_link( $tag_id = 0, $taxonomy = 'post_tag' ) {

   578 	$tag = get_term($tag_id, $taxonomy);

   579 

   580 	if ( !current_user_can('manage_categories') )

   581 		return;

   582 

   583 	$location = admin_url('edit-tags.php?action=edit&taxonomy=' . $taxonomy . '&tag_ID=' . $tag->term_id);

   584 	return apply_filters( 'get_edit_tag_link', $location );

   585 }

   586 

   587 /**

   588  * Display or retrieve edit tag link with formatting.

   589  *

   590  * @since 2.7.0

   591  *

   592  * @param string $link Optional. Anchor text.

   593  * @param string $before Optional. Display before edit link.

   594  * @param string $after Optional. Display after edit link.

   595  * @param int|object $tag Tag object or ID

   596  * @return string|null HTML content, if $echo is set to false.

   597  */

   598 function edit_tag_link( $link = '', $before = '', $after = '', $tag = null ) {

   599 	$tag = get_term($tag, 'post_tag');

   600 

   601 	if ( !current_user_can('manage_categories') )

   602 		return;

   603 

   604 	if ( empty($link) )

   605 		$link = __('Edit This');

   606 

   607 	$link = '<a href="' . get_edit_tag_link( $tag->term_id ) . '" title="' . __( 'Edit tag' ) . '">' . $link . '</a>';

   608 	echo $before . apply_filters( 'edit_tag_link', $link, $tag->term_id ) . $after;

   609 }

   610 

   611 /**

   612  * Retrieve the permalink for the feed of the search results.

   613  *

   614  * @since 2.5.0

   615  *

   616  * @param string $search_query Optional. Search query.

   617  * @param string $feed Optional. Feed type.

   618  * @return string

   619  */

   620 function get_search_feed_link($search_query = '', $feed = '') {

   621 	if ( empty($search_query) )

   622 		$search = esc_attr( urlencode(get_search_query()) );

   623 	else

   624 		$search = esc_attr( urlencode(stripslashes($search_query)) );

   625 

   626 	if ( empty($feed) )

   627 		$feed = get_default_feed();

   628 

   629 	$link = trailingslashit(get_option('home')) . "?s=$search&feed=$feed";

   630 

   631 	$link = apply_filters('search_feed_link', $link);

   632 

   633 	return $link;

   634 }

   635 

   636 /**

   637  * Retrieve the permalink for the comments feed of the search results.

   638  *

   639  * @since 2.5.0

   640  *

   641  * @param string $search_query Optional. Search query.

   642  * @param string $feed Optional. Feed type.

   643  * @return string

   644  */

   645 function get_search_comments_feed_link($search_query = '', $feed = '') {

   646 	if ( empty($search_query) )

   647 		$search = esc_attr( urlencode(get_search_query()) );

   648 	else

   649 		$search = esc_attr( urlencode(stripslashes($search_query)) );

   650 

   651 	if ( empty($feed) )

   652 		$feed = get_default_feed();

   653 

   654 	$link = trailingslashit(get_option('home')) . "?s=$search&feed=comments-$feed";

   655 

   656 	$link = apply_filters('search_feed_link', $link);

   657 

   658 	return $link;

   659 }

   660 

   661 /**

   662  * Retrieve edit posts link for post.

   663  *

   664  * Can be used within the WordPress loop or outside of it. Can be used with

   665  * pages, posts, attachments, and revisions.

   666  *

   667  * @since 2.3.0

   668  *

   669  * @param int $id Optional. Post ID.

   670  * @param string $context Optional, default to display. How to write the '&', defaults to '&'.

   671  * @return string

   672  */

   673 function get_edit_post_link( $id = 0, $context = 'display' ) {

   674 	if ( !$post = &get_post( $id ) )

   675 		return;

   676 

   677 	if ( 'display' == $context )

   678 		$action = 'action=edit&';

   679 	else

   680 		$action = 'action=edit&';

   681 

   682 	switch ( $post->post_type ) :

   683 	case 'page' :

   684 		if ( !current_user_can( 'edit_page', $post->ID ) )

   685 			return;

   686 		$file = 'page';

   687 		$var  = 'post';

   688 		break;

   689 	case 'attachment' :

   690 		if ( !current_user_can( 'edit_post', $post->ID ) )

   691 			return;

   692 		$file = 'media';

   693 		$var  = 'attachment_id';

   694 		break;

   695 	case 'revision' :

   696 		if ( !current_user_can( 'edit_post', $post->ID ) )

   697 			return;

   698 		$file = 'revision';

   699 		$var  = 'revision';

   700 		$action = '';

   701 		break;

   702 	default :

   703 		if ( !current_user_can( 'edit_post', $post->ID ) )

   704 			return apply_filters( 'get_edit_post_link', '', $post->ID, $context );;

   705 		$file = 'post';

   706 		$var  = 'post';

   707 		break;

   708 	endswitch;

   709 

   710 	return apply_filters( 'get_edit_post_link', admin_url("$file.php?{$action}$var=$post->ID"), $post->ID, $context );

   711 }

   712 

   713 /**

   714  * Display edit post link for post.

   715  *

   716  * @since 1.0.0

   717  *

   718  * @param string $link Optional. Anchor text.

   719  * @param string $before Optional. Display before edit link.

   720  * @param string $after Optional. Display after edit link.

   721  * @param int $id Optional. Post ID.

   722  */

   723 function edit_post_link( $link = null, $before = '', $after = '', $id = 0 ) {

   724 	if ( !$post = &get_post( $id ) )

   725 		return;

   726 

   727 	if ( !$url = get_edit_post_link( $post->ID ) )

   728 		return;

   729 

   730 	if ( null === $link )

   731 		$link = __('Edit This');

   732 

   733 	$link = '<a class="post-edit-link" href="' . $url . '" title="' . esc_attr( __( 'Edit post' ) ) . '">' . $link . '</a>';

   734 	echo $before . apply_filters( 'edit_post_link', $link, $post->ID ) . $after;

   735 }

   736 

   737 /**

   738  * Retrieve delete posts link for post.

   739  *

   740  * Can be used within the WordPress loop or outside of it. Can be used with

   741  * pages, posts, attachments, and revisions.

   742  *

   743  * @since 2.9.0

   744  *

   745  * @param int $id Optional. Post ID.

   746  * @param string $context Optional, default to display. How to write the '&', defaults to '&'.

   747  * @return string

   748  */

   749 function get_delete_post_link($id = 0, $context = 'display') {

   750 	if ( !$post = &get_post( $id ) )

   751 		return;

   752 

   753 	if ( 'display' == $context )

   754 		$action = 'action=trash&';

   755 	else

   756 		$action = 'action=trash&';

   757 

   758 	switch ( $post->post_type ) :

   759 	case 'page' :

   760 		if ( !current_user_can( 'delete_page', $post->ID ) )

   761 			return;

   762 		$file = 'page';

   763 		$var  = 'post';

   764 		break;

   765 	case 'attachment' :

   766 		if ( !current_user_can( 'delete_post', $post->ID ) )

   767 			return;

   768 		$file = 'media';

   769 		$var  = 'attachment_id';

   770 		break;

   771 	case 'revision' :

   772 		if ( !current_user_can( 'delete_post', $post->ID ) )

   773 			return;

   774 		$file = 'revision';

   775 		$var  = 'revision';

   776 		$action = '';

   777 		break;

   778 	default :

   779 		if ( !current_user_can( 'edit_post', $post->ID ) )

   780 			return apply_filters( 'get_delete_post_link', '', $post->ID, $context );;

   781 		$file = 'post';

   782 		$var  = 'post';

   783 		break;

   784 	endswitch;

   785 

   786 	return apply_filters( 'get_delete_post_link', wp_nonce_url( admin_url("$file.php?{$action}$var=$post->ID"), "trash-{$file}_" . $post->ID ), $context );

   787 }

   788 

   789 /**

   790  * Retrieve edit comment link.

   791  *

   792  * @since 2.3.0

   793  *

   794  * @param int $comment_id Optional. Comment ID.

   795  * @return string

   796  */

   797 function get_edit_comment_link( $comment_id = 0 ) {

   798 	$comment = &get_comment( $comment_id );

   799 	$post = &get_post( $comment->comment_post_ID );

   800 

   801 	if ( $post->post_type == 'page' ) {

   802 		if ( !current_user_can( 'edit_page', $post->ID ) )

   803 			return;

   804 	} else {

   805 		if ( !current_user_can( 'edit_post', $post->ID ) )

   806 			return;

   807 	}

   808 

   809 	$location = admin_url('comment.php?action=editcomment&c=') . $comment->comment_ID;

   810 	return apply_filters( 'get_edit_comment_link', $location );

   811 }

   812 

   813 /**

   814  * Display or retrieve edit comment link with formatting.

   815  *

   816  * @since 1.0.0

   817  *

   818  * @param string $link Optional. Anchor text.

   819  * @param string $before Optional. Display before edit link.

   820  * @param string $after Optional. Display after edit link.

   821  * @return string|null HTML content, if $echo is set to false.

   822  */

   823 function edit_comment_link( $link = null, $before = '', $after = '' ) {

   824 	global $comment, $post;

   825 

   826 	if ( $post->post_type == 'page' ) {

   827 		if ( !current_user_can( 'edit_page', $post->ID ) )

   828 			return;

   829 	} else {

   830 		if ( !current_user_can( 'edit_post', $post->ID ) )

   831 			return;

   832 	}

   833 

   834 	if ( null === $link )

   835 		$link = __('Edit This');

   836 

   837 	$link = '<a class="comment-edit-link" href="' . get_edit_comment_link( $comment->comment_ID ) . '" title="' . __( 'Edit comment' ) . '">' . $link . '</a>';

   838 	echo $before . apply_filters( 'edit_comment_link', $link, $comment->comment_ID ) . $after;

   839 }

   840 

   841 /**

   842  * Display edit bookmark (literally a URL external to blog) link.

   843  *

   844  * @since 2.7.0

   845  *

   846  * @param int $link Optional. Bookmark ID.

   847  * @return string

   848  */

   849 function get_edit_bookmark_link( $link = 0 ) {

   850 	$link = get_bookmark( $link );

   851 

   852 	if ( !current_user_can('manage_links') )

   853 		return;

   854 

   855 	$location = admin_url('link.php?action=edit&link_id=') . $link->link_id;

   856 	return apply_filters( 'get_edit_bookmark_link', $location, $link->link_id );

   857 }

   858 

   859 /**

   860  * Display edit bookmark (literally a URL external to blog) link anchor content.

   861  *

   862  * @since 2.7.0

   863  *

   864  * @param string $link Optional. Anchor text.

   865  * @param string $before Optional. Display before edit link.

   866  * @param string $after Optional. Display after edit link.

   867  * @param int $bookmark Optional. Bookmark ID.

   868  */

   869 function edit_bookmark_link( $link = '', $before = '', $after = '', $bookmark = null ) {

   870 	$bookmark = get_bookmark($bookmark);

   871 

   872 	if ( !current_user_can('manage_links') )

   873 		return;

   874 

   875 	if ( empty($link) )

   876 		$link = __('Edit This');

   877 

   878 	$link = '<a href="' . get_edit_bookmark_link( $link ) . '" title="' . __( 'Edit link' ) . '">' . $link . '</a>';

   879 	echo $before . apply_filters( 'edit_bookmark_link', $link, $bookmark->link_id ) . $after;

   880 }

   881 

   882 // Navigation links

   883 

   884 /**

   885  * Retrieve previous post link that is adjacent to current post.

   886  *

   887  * @since 1.5.0

   888  *

   889  * @param bool $in_same_cat Optional. Whether link should be in same category.

   890  * @param string $excluded_categories Optional. Excluded categories IDs.

   891  * @return string

   892  */

   893 function get_previous_post($in_same_cat = false, $excluded_categories = '') {

   894 	return get_adjacent_post($in_same_cat, $excluded_categories);

   895 }

   896 

   897 /**

   898  * Retrieve next post link that is adjacent to current post.

   899  *

   900  * @since 1.5.0

   901  *

   902  * @param bool $in_same_cat Optional. Whether link should be in same category.

   903  * @param string $excluded_categories Optional. Excluded categories IDs.

   904  * @return string

   905  */

   906 function get_next_post($in_same_cat = false, $excluded_categories = '') {

   907 	return get_adjacent_post($in_same_cat, $excluded_categories, false);

   908 }

   909 

   910 /**

   911  * Retrieve adjacent post link.

   912  *

   913  * Can either be next or previous post link.

   914  *

   915  * @since 2.5.0

   916  *

   917  * @param bool $in_same_cat Optional. Whether link should be in same category.

   918  * @param string $excluded_categories Optional. Excluded categories IDs.

   919  * @param bool $previous Optional. Whether to retrieve previous post.

   920  * @return string

   921  */

   922 function get_adjacent_post($in_same_cat = false, $excluded_categories = '', $previous = true) {

   923 	global $post, $wpdb;

   924 

   925 	if ( empty($post) || !is_single() || is_attachment() )

   926 		return null;

   927 

   928 	$current_post_date = $post->post_date;

   929 

   930 	$join = '';

   931 	$posts_in_ex_cats_sql = '';

   932 	if ( $in_same_cat || !empty($excluded_categories) ) {

   933 		$join = " INNER JOIN $wpdb->term_relationships AS tr ON p.ID = tr.object_id INNER JOIN $wpdb->term_taxonomy tt ON tr.term_taxonomy_id = tt.term_taxonomy_id";

   934 

   935 		if ( $in_same_cat ) {

   936 			$cat_array = wp_get_object_terms($post->ID, 'category', 'fields=ids');

   937 			$join .= " AND tt.taxonomy = 'category' AND tt.term_id IN (" . implode(',', $cat_array) . ")";

   938 		}

   939 

   940 		$posts_in_ex_cats_sql = "AND tt.taxonomy = 'category'";

   941 		if ( !empty($excluded_categories) ) {

   942 			$excluded_categories = array_map('intval', explode(' and ', $excluded_categories));

   943 			if ( !empty($cat_array) ) {

   944 				$excluded_categories = array_diff($excluded_categories, $cat_array);

   945 				$posts_in_ex_cats_sql = '';

   946 			}

   947 

   948 			if ( !empty($excluded_categories) ) {

   949 				$posts_in_ex_cats_sql = " AND tt.taxonomy = 'category' AND tt.term_id NOT IN (" . implode($excluded_categories, ',') . ')';

   950 			}

   951 		}

   952 	}

   953 

   954 	$adjacent = $previous ? 'previous' : 'next';

   955 	$op = $previous ? '<' : '>';

   956 	$order = $previous ? 'DESC' : 'ASC';

   957 

   958 	$join  = apply_filters( "get_{$adjacent}_post_join", $join, $in_same_cat, $excluded_categories );

   959 	$where = apply_filters( "get_{$adjacent}_post_where", $wpdb->prepare("WHERE p.post_date $op %s AND p.post_type = %s AND p.post_status = 'publish' $posts_in_ex_cats_sql", $current_post_date, $post->post_type), $in_same_cat, $excluded_categories );

   960 	$sort  = apply_filters( "get_{$adjacent}_post_sort", "ORDER BY p.post_date $order LIMIT 1" );

   961 

   962 	$query = "SELECT p.* FROM $wpdb->posts AS p $join $where $sort";

   963 	$query_key = 'adjacent_post_' . md5($query);

   964 	$result = wp_cache_get($query_key, 'counts');

   965 	if ( false !== $result )

   966 		return $result;

   967 

   968 	$result = $wpdb->get_row("SELECT p.* FROM $wpdb->posts AS p $join $where $sort");

   969 	if ( null === $result )

   970 		$result = '';

   971 

   972 	wp_cache_set($query_key, $result, 'counts');

   973 	return $result;

   974 }

   975 

   976 /**

   977  * Get adjacent post relational link.

   978  *

   979  * Can either be next or previous post relational link.

   980  *

   981  * @since 2.8.0

   982  *

   983  * @param string $title Optional. Link title format.

   984  * @param bool $in_same_cat Optional. Whether link should be in same category.

   985  * @param string $excluded_categories Optional. Excluded categories IDs.

   986  * @param bool $previous Optional, default is true. Whether display link to previous post.

   987  * @return string

   988  */

   989 function get_adjacent_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '', $previous = true) {

   990 	if ( $previous && is_attachment() )

   991 		$post = & get_post($GLOBALS['post']->post_parent);

   992 	else

   993 		$post = get_adjacent_post($in_same_cat,$excluded_categories,$previous);

   994 

   995 	if ( empty($post) )

   996 		return;

   997 

   998 	if ( empty($post->post_title) )

   999 		$post->post_title = $previous ? __('Previous Post') : __('Next Post');

  1000 

  1001 	$date = mysql2date(get_option('date_format'), $post->post_date);

  1002 

  1003 	$title = str_replace('%title', $post->post_title, $title);

  1004 	$title = str_replace('%date', $date, $title);

  1005 	$title = apply_filters('the_title', $title, $post);

  1006 

  1007 	$link = $previous ? "<link rel='prev' title='" : "<link rel='next' title='";

  1008 	$link .= esc_attr( $title );

  1009 	$link .= "' href='" . get_permalink($post) . "' />\n";

  1010 

  1011 	$adjacent = $previous ? 'previous' : 'next';

  1012 	return apply_filters( "{$adjacent}_post_rel_link", $link );

  1013 }

  1014 

  1015 /**

  1016  * Display relational links for the posts adjacent to the current post.

  1017  *

  1018  * @since 2.8.0

  1019  *

  1020  * @param string $title Optional. Link title format.

  1021  * @param bool $in_same_cat Optional. Whether link should be in same category.

  1022  * @param string $excluded_categories Optional. Excluded categories IDs.

  1023  */

  1024 function adjacent_posts_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '') {

  1025 	echo get_adjacent_post_rel_link($title, $in_same_cat, $excluded_categories = '', true);

  1026 	echo get_adjacent_post_rel_link($title, $in_same_cat, $excluded_categories = '', false);

  1027 }

  1028 

  1029 /**

  1030  * Display relational link for the next post adjacent to the current post.

  1031  *

  1032  * @since 2.8.0

  1033  *

  1034  * @param string $title Optional. Link title format.

  1035  * @param bool $in_same_cat Optional. Whether link should be in same category.

  1036  * @param string $excluded_categories Optional. Excluded categories IDs.

  1037  */

  1038 function next_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '') {

  1039 	echo get_adjacent_post_rel_link($title, $in_same_cat, $excluded_categories = '', false);

  1040 }

  1041 

  1042 /**

  1043  * Display relational link for the previous post adjacent to the current post.

  1044  *

  1045  * @since 2.8.0

  1046  *

  1047  * @param string $title Optional. Link title format.

  1048  * @param bool $in_same_cat Optional. Whether link should be in same category.

  1049  * @param string $excluded_categories Optional. Excluded categories IDs.

  1050  */

  1051 function prev_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '') {

  1052 	echo get_adjacent_post_rel_link($title, $in_same_cat, $excluded_categories = '', true);

  1053 }

  1054 

  1055 /**

  1056  * Retrieve boundary post.

  1057  *

  1058  * Boundary being either the first or last post by publish date within the contraitns specified

  1059  * by in same category or excluded categories.

  1060  *

  1061  * @since 2.8.0

  1062  *

  1063  * @param bool $in_same_cat Optional. Whether returned post should be in same category.

  1064  * @param string $excluded_categories Optional. Excluded categories IDs.

  1065  * @param bool $previous Optional. Whether to retrieve first post.

  1066  * @return object

  1067  */

  1068 function get_boundary_post($in_same_cat = false, $excluded_categories = '', $start = true) {

  1069 	global $post, $wpdb;

  1070 

  1071 	if ( empty($post) || !is_single() || is_attachment() )

  1072 		return null;

  1073 

  1074 	$cat_array = array();

  1075 	$excluded_categories = array();

  1076 	if ( !empty($in_same_cat) || !empty($excluded_categories) ) {

  1077 		if ( !empty($in_same_cat) ) {

  1078 			$cat_array = wp_get_object_terms($post->ID, 'category', 'fields=ids');

  1079 		}

  1080 

  1081 		if ( !empty($excluded_categories) ) {

  1082 			$excluded_categories = array_map('intval', explode(',', $excluded_categories));

  1083 

  1084 			if ( !empty($cat_array) )

  1085 				$excluded_categories = array_diff($excluded_categories, $cat_array);

  1086 

  1087 			$inverse_cats = array();

  1088 			foreach ( $excluded_categories as $excluded_category)

  1089 				$inverse_cats[] = $excluded_category * -1;

  1090 			$excluded_categories = $inverse_cats;

  1091 		}

  1092 	}

  1093 

  1094 	$categories = implode(',', array_merge($cat_array, $excluded_categories) );

  1095 

  1096 	$order = $start ? 'ASC' : 'DESC';

  1097 

  1098 	return get_posts( array('numberposts' => 1, 'order' => $order, 'orderby' => 'ID', 'category' => $categories) );

  1099 }

  1100 

  1101 /**

  1102  * Get boundary post relational link.

  1103  *

  1104  * Can either be start or end post relational link.

  1105  *

  1106  * @since 2.8.0

  1107  *

  1108  * @param string $title Optional. Link title format.

  1109  * @param bool $in_same_cat Optional. Whether link should be in same category.

  1110  * @param string $excluded_categories Optional. Excluded categories IDs.

  1111  * @param bool $start Optional, default is true. Whether display link to first post.

  1112  * @return string

  1113  */

  1114 function get_boundary_post_rel_link($title = '%title', $in_same_cat = false, $excluded_categories = '', $start = true) {

  1115 	$posts = get_boundary_post($in_same_cat,$excluded_categories,$start);

  1116 	// Even though we limited get_posts to return only 1 item it still returns an array of objects.

  1117 	$post = $posts[0];

  1118 

  1119 	if ( empty($post) )

  1120 			 return;

  1121 

  1122 		if ( empty($post->post_title) )

  1123 				$post->post_title = $start ? __('First Post') : __('Last Post');

  1124 

  1125 	$date = mysql2date(get_option('date_format'), $post->post_date);

  1126 

  1127 	$title = str_replace('%title', $post->post_title, $title);

  1128 	$title = str_replace('%date', $date, $title);

  1129 	$title = apply_filters('the_title', $title, $post);

  1130 

  1131 	$link = $start ? "<link rel='start' title='" : "<link rel='end' title='";

  1132 	$link .= esc_attr($title);

  1133 	$link .= "' href='" . get_permalink($post) . "' />\n";

  1134 

  1135 	$boundary = $start ? 'start' : 'end';