Creating Links to Posts and Categories in WordPress

A useful WordPress function which will links to posts dynamically so you don't have to embed a post URL into the page.

So, you have a blog with hundreds of posts, each of which is interlinked. Then you decide to change your domain name, permalink structure or something else, and you must update all the posts again. Why not update them with a dynamic link and let WordPress generate your URL?

You will need RunPHP or similar for these to work inside posts and pages, but they are not needed if you use them in templates.

The first function will create a link to a post. You must specify a post ID to link to, you can optionally specify a title for the link (the text to show), and you can return the link as a string variable instead of printing it on the page. The post/page title will be used instead if no title is passed. These functions should be placed within functions.php in your themes folder.

function linkToPost($postid, $linkTitle = "", $echo = true)
{
  $linkurl = get_permalink($postid);
  
  if ($linkTitle == "")
    $linkTitle = get_the_title($postid);
    
  $link = '<a href="' . $linkurl . '" >' . $linkTitle . '</a>';
  
  if ($echo === true) 
    echo $link; 
  else 
    return $link;
}

The second function works the same way as the first. However, it will link to categories instead.

function linkToCat($catID, $linkTitle = "")
{
  $cat = get_category_link($catID);
  $link = '<a href="' . $cat . '" >' . $linkTitle . '</a>';
  echo $link;
}

Usage

Let's say you are writing a post and want to link to another post with an ID of 53 (ID numbers can be found when viewing/editing posts in the WordPress admin screens). To create a simple link to post 53, use the following:

<?php LinkToPost(53); ?>

This will be executed by RunPHP so that when the post is viewed, you will have a nice link that will always be correct.

To change the title to something other than the post title, use the functions like this:

<?php LinkToPost(53,"this is my new title"); ?>

And you can capture the output into a variable like this:

<?php $cleanLink = LinkToPost(53,"this is my title", false); ?>