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.
- fix for bad handling of “http://” in post body
- Initial Release
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.
The slink_config.php file should be edited to establish named links:
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’, ” );
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 );’ );
- Unzip slink.zip to the
- Copy the slink_config_default.php to slink_config.php. Edit this file to define your named links (see Configuration File for instructions).
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Place named links in your WordPress content (see Post/Page Syntax for instructions).
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?
Why won’t the include_page tag work?