Description
This plugin retrieves the permalink URL for a page or post based on the ID with the shortcode [permalink].
What’s the point of this plugin?
In creating my own sites with WordPress, I started noticing that I like to link to articles within other articles. Then I’m always changing my mind about stuff, messing around with page/post slugs, and screwing with my permalinks. It’s very annoying to then have to go back and change links wherever I placed them.
This plugin is pretty simple. It just retrieves the URL of a page or post based on WordPress’s unique, numerical ID for it, which never changes. For me personally, using the [permalink] shortcode every time I link to another page or post within my site makes life easier because I don’t have to worry about the URL changing. Also, when I move my site from my local dev server to the live web server, I don’t have to worry about any of these links.
Anyways, I thought what the heck, why not share? — I keep pasting this code snippet in all my personal website themes anyway.
However, keep in mind this plugin will be more useful for people like me who are always working under the HTML tab when editing pages and posts. If you’re looking for a similar shortcode that constructs the entire HTML link for you, check out this plugin by Justin Tadlock.
Usage Examples
Since all this plugin does is retrieve the URL to the post or page, you need to format a standard HTML link in whatever way you normally would. Then, instead manually writing in the post or page’s URL, you retrieve it with the [permalink] shortcode. Inside, you reference the WordPress’s numeric ID for the post or page.
<a href="[permalink id="123"]">Your Text</a>
<a href="[permalink id="123"]" title="Your Link Title">Your Text</a>
<a href="[permalink id="123"]#some_section_of_page">Your Text</a>
Extended Usage Examples
In v1.0.1, I added the optional feature to allow you to use a page’s slug to reference the permalink you’re trying to retrieve.
<a href="[permalink slug="your-page"]">Your Text</a>
If you’re referencing anything other than a page, you need to specify the post type with the optional “post_type” parameter.
<a href="[permalink slug="your-post" post_type="post"]">Your Text</a>
If you can use the Post ID, it will consume less resources on your server to retrieve the permalinks that way.
So why use the slug at all? Why not just always use the ID? Well personally, I added this in for myself. When I setup demo websites for my WordPress themes, I’m always importing many of the same pages that innerlink with eachother. As you know, when importing pages and posts between different websites, ID’s will generally change. By using this shortcode and referencing page/post slugs, I can keep URL’s intact when I’m importing/exporting pages to different websites.
Installation
- Upload
theme-blvd-simple-permalink
folder to the/wp-content/plugins/
directory - Activate the plugin through the ‘Plugins’ menu in WordPress
- Retrieve the URL to a page or post with its respective numeric ID like this:
[permalink id="123"]
Contributors and Developers
“Simple Permalink” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Simple Permalink” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Change Log
1.0.1
- Added optional feature to get permalink based on slug and post type, opposed to using the post ID.
1.0.0
- This is the first release.