We were tired to alter every link and image in posts, pages or widgets when switching from development to live environments.
e.g. when you insert an image in TinyMCE on your development environment (
http://dev.example.com), the image has a hard URL:
When switching to your live environment (
http://live.example.com), you change your WordPress Site URL, but the image in the content is still
This is very frustrating, you have to alter each page, post, widget etcetera…
This plugin solves that problem. It automatically adds a data-wp-id tag when you insert an image or link in your TinyMCE.
The data-wp-id tag contains a unique ID from the wp-post table in WordPress.
When displaying the content on the front-end this plugin automatically recognizes the data-wp-id tag and replaces the
href="" with the correct permalink.
You can use the tag anywhere you want, simply add the
123 is the ID).
So, how does it work?
The plugin automatically adds the data-wp-id when inserting an image or link in the WordPress editor.
Normally, when you insert an image into the WP editor, WordPress would generate image tags like this:
<img src="http://dev.example.com/media/2014/05/example-150x150.jpg" class="size-thumbnail" width="150" height="150" />
But this Plugin will generate a link like this:
<img data-wp-id="123" src="#" class="size-thumbnail" width="150" height="150" />
… And finally on the Front-End, the Plugin will output is as:
<img src="http://live.example.com/media/2014/05/example-150x150.jpg" class="size-thumbnail" width="150" height="150" />
Another example, adding a link:
Normally WordPress will generate a link like this:
<a href="http://dev.example.com/example-page" target="_blank" />
But this Plugin will generate it like this:
<a data-wp-id="100" href="#" target="_blank" />
…And finally on the Front-End, the Plugin will output it as:
<a href="http://live.example.com/example-page" target="_blank" />
- Upload the
wp-softlinksfolder to the
- Activate the plugin through the ‘Plugins’ menu in WordPress
data-wp-id="1234"in any HTML tag of your choice.
- How does it work?
The plugin has a hook on the_content that parses the content. Every HTML tag that contains a data-wp-id, will be converted in a perfect link or source.
- How does it work under the hood?
- Do I have to add the data-wp-id tag manually?
You can, but it will be inserted automatically by the Plugin, when inserting an Image or Link in the WordPress editor.
- Can you give me an example?
Sure, you add a data-wp-id to an image:
<img src="#" data-wp-id="24" class="size-thumbnail" />, it will be converted to a clean URL:
<img src="http://www.example.com/media/2014/05/example-150x150.jpg" class="size-thumbnail" />
- Can I use this with HTTPS?
Yes, because the plugin uses the WordPress Site URL to generate a link.
- Can I use it with any HTML tag?
Sure, you can use any HTML tag, and it recognizes automatically if the tag needs a
- How does it work with image sizes?
WordPress adds a class to any image size (e.g. size-thumbnail). The plugin recognizes this class and will return the correct link.
- Can I use it in my plugins and themes?
Currently not, but we are working on that.
There are no reviews for this plugin.
Contributors & Developers
“WP SoftLinks” is open source software. The following people have contributed to this plugin.Contributors
Fixed screenshots, improved readme.txt
Fixed data-wp-id tag in stead of shortcode.