This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

slink

Description

slink provides a way to insert named links into pages and posts, and have those links translated into HTML or execute PHP as defined in a separate configuration file. It uses a Markdown-like syntax that should be understandable by anyone who uses Markdown.

The possibilities of slink are boundless, some example uses are:

  • insert relative links into your posts, and change them any time without editing the posts
  • insert images into your posts, conveniently linked to somewhere outside of WordPress
  • create shorthand for common links
  • include other pages into your posts without writing any PHP
  • execute any PHP you want while the page is being generated by WordPress

slink’s intended audience is:

  • WordPress developers who support non-PHP-savvy users that are updating content in WordPress. The content-side syntax is no more difficult than Markdown, so it should be easier for those users than coding name=value pairs as with the WP tag implementation.
  • anybody who wants to create shorthand for commonly used elements in their WordPress content. For instance, the download box on my page, which I use in several places, has the markup defined in the slink_config file, so if I want to change it, I only need to do so in one place.

Version History

0.2

  • fix for bad handling of “http://” in post body

0.1

  • Initial Release

Post/Page Syntax

To use a named tag in a page or post, use this syntax:

[name: text] ( uri ) 

name the name of the link, as defined in the configuration file text the text that the user wants to appear associated with this link. uri the uri of the link. Usage is dependent on the type of link, for example an anchor might use this as part of the href, whereas an img might use it as part of the src.

Configuration File

The slink_config.php file should be edited to establish named links:

HTML

slink_html( 'name', 'html' ); 

name Case-insensitive name of the named link. html

The html to insert. $text and $uri can be inserted into the html to refer to those parameters as entered in the post/page.

slink_html( ‘name’, ” );

PHP

slink_php( 'name', 'code'  ); 

name Case-insensitive name of the named link. code

The php code to execute. Like the HTML, $text and $uri can be used to refer to those parameters as entered in the post/page. The code need not return any value, but if it does, it should be a string, which will be inserted into the php. If you want to apply slink filtering to your return value, return slink_filter( $result ).

slink_php( ‘name’, ‘return my_php_function( $uri, $text );’ );

Installation

  1. Unzip slink.zip to the /wp-content/plugins/ directory
  2. Copy the slink_config_default.php to slink_config.php. Edit this file to define your named links (see Configuration File for instructions).
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
  4. Place named links in your WordPress content (see Post/Page Syntax for instructions).

FAQ

slink’s version is 0.x, does that mean it is incomplete?

Yes. As of this writing, the plugin has only been used on a few sites. So feedback from other users will of course improve it. If adoption is great enough, we will probably put an admin panel onto slink. Don’t worry, if we do that, your config file settings will get imported by the upgrade.

How can I get help?

The documentation here is the best place to start. Failing that, you can always send me an email.

Why won’t the include_page tag work?

Two reasons:

Contributors & Developers

“slink” is open source software. The following people have contributed to this plugin.

Translate “slink” into your language.

Interested in development?

Browse the code or subscribe to the development log by RSS.