Hikari Internal Links

Don't worry anymore of linking a post or a category, to later change its title or slug, or changing your posts permalinks, and creating invalid links to your own site pages.

 

Hikari Internal Links provides a shortcode that dynamically generates links to most Wordpress resources. You can query these resources based on their ID or slug, and these links are generated dynamically. Therefore if you change a resource's title or permalink, its links will be updated automatically.

 

 

 

Features

 

• A shortcode generates links to internal pages dynamically
• If the permalink changes, links are updated automatically
• You can get links based on resources ID or slug
• If resource isn't found, you get a warning text surrounded by class wpdberror, which is hidden from your visitors and shown to you with a yellow background so that it's easy to notice and fix

 

 

Available Resources

 

• posts, pages and custom types, based on ID or slug
• comments, based on ID
• categories, tags and custom taxonomies, based on ID or slug
• feeds for categories, tags, comments of a post, based on their ID or slug
• if current resource was already set to global variable, you can use ID 0 to link to current resource

 

 

This plugin is a fork from Michael Toppa (http://www NULL.toppa NULL.com)'s Post-to-Post Links II (http://www NULL.toppa NULL.com/post-to-post-links-wordpress-plugin).

 

 

License

 

© Copyright Hikari (http://wordpress.Hikari.ws), 2010

If you want to redistribute this software, please leave a link to this post together with it and mention me as its author

Parts of this code are provided or based on ideas and/or code written by others

 

Important contributors to this plugin (listed in alphabetical order):

• This plugin is a fork from Michael Toppa (http://www NULL.toppa NULL.com)'s Post-to-Post Links II (http://www NULL.toppa NULL.com/post-to-post-links-wordpress-plugin)
• original Post to Post plugin was developed by Scott Reilly (http://coffee2code NULL.com): Easy Post-to-Post Links (http://coffee2code NULL.com/wp-plugins/easy-post-to-post-links/)

 

If you want to extend the plugin features, please contact me so I can add your work to my official release.

 

 

Download

 

You can follow Hikari Internal Links updates and older versions at Wordpress.org Plugin Directory (http://wordpress NULL.org/extend/plugins/hikari-internal-links/), or you can get the last version from the direct link hikari-internal-links.zip (http://downloads NULL.wordpress NULL.org/plugin/hikari-internal-links NULL.zip).

 

 

Donate

 

If you enjoy Hikari Internal Links please consider a donation. You can do it through Paypal:

 

 

There are also several ways you can show your appreciation:

 

• blogging about it
• linking it from your site (without using rel=nofollow)
• browsing the site sidebars
• suggesting it to your friends
• visiting other posts thru the site and adding valuable comments
• saying thanks on comments
• offering codes that add new features
• etc, use your imagination

 

 

Installation

 

Hikari Internal Links requires at least Wordpress 2.8 and PHP5 to work.

 

You can use the built in installer and upgrader, or you can install the plugin manually.

 

1. Download the zip file, upload it to your server and extract all its content to your /wp-content/plugins folder. Make sure the plugin has its own folder (for exemple /wp-content/plugins/hikari-internal-links/).
2. Activate the plugin through the 'Plugins' menu in WordPress admin page.
3. Now you can its [hkLink] shortcode anywhere you want, linking pratically any page on your site! :)
4. For a full description of its shortcode parameters, please refere to Hikari Internal Links – Exemples

 

 

Upgrading and Uninstalling

 

I consider very ambiguous the way some plugins should be upgraded and the proper way of uninstalling them, so I believe I should explicitly explain it for my plugins.

I've made an article just to explain in full details which options we have to upgrade and uninstall our plugins and what happens with each option, and how it works with my plugins: Uninstalling my plugins.

 

For upgrading, simply delete it and follow installation setps again.

 

 

Support & Requests

 

If you want to request any new feature, leave a comment on this post explaining it with as many details as possible. I can't assure it will be added, but if it is viable, I like it AND have the time, I'll do my best.

 

If something seems to not be working and you need help, first read the FAQ and then leave a comment explaining what's happening. If you need to post a picture, please link it instead of using an img tag.

 

 

Frequently Asked Questions

 

1. Where can I see a list of all shortcode parameters and exemples of it being used?

   For a full description of its shortcode parameters, please refere to Hikari Internal Links – Exemples.

2. What happens if I build a link based on slug and later change that resource's slug?

   Most resources can be queried by ID or slug, this feature is provided to offer flexibility on its use. When a resource is queried, the value used to query must refere to a existing resource. If you query using ID and change the resource ID, then there's no way to find what it used to refere to... same thing goes for using slug and later changing the slug.

    

   I suggest using ID always when possible and never change resources IDs, that's not needed at all and could only be done editing directly the database.

3. Where's the options page?

   There's none, currently I see no need to set options. Just use the shortcode anywhere you want :)

 

 

Cangelog

 

• 0.06
  • First public release.

 

 

Known bugs

 

• none ATM

 

To-do stuff

 

Here are my ideas that I wish to implement in the future.

 

• Add support to multipaged posts
• Find out how to get custom taxonomies feed permalinks and add support to them

 

 

Thanks

 

Thanks to Scott Reilly and Michael Toppa for developing their original plugins.

 

And of course, thanks to everybody that add valuable comments to my site!

participate