I'm very pleased to present "Pluglink". As its name indicates, it is a plugin which automatically places links on pieces of text of your choice in your Joomla! 1.5 articles. You may use it with a simple text expression or a more advanced perl regular expression.

Pluglink is still under development but is already relatively stable. It probably requires still too much the use of regex to be really practical for users which don't like perl regular expressions (Are there any?). If I find time, this will be adressed in further versions (with a component?). Anyway, I advise users to check regularly for new versions as Pluglink will still improve in the near future if only for bug corrections...

Note that Pluglink was previously named Bot link (until version 0.2.0). Bot link only works in Joomla! 1.0.x, while Pluglink only works in Joomla! 1.5.x (native). However Pluglink will recognize Bot link's markups in Joomla! 1.5 articles.

Syntax

{%pluglink (text="text"|regex="pattern" [text="text"]) link="url" [class="class" alt="text" title="text" html="1" case="1" popup="1"]}

Of note, Pluglink will also recognize bot_link markups {%bot_link ...}to ensure backwards compatibility with articles migrated from Joomla! 1.0.x using Bot link.

The "%" characters after the "{" in the examples on these pages were introduced to prevent recognition by the plugin...

Arguments

text

If used alone, means the text to search for. Used in combination with the regex argument, means the text to replace the regular expression matches (optional).

regex

A perl-style regular expression to search for. If used, the "case" argument will be ignored.

The expression inside the delimiters has to be set in parenthesese (Have a look at the examples). If a second set of parentheses is used, only its content will be linked by the plugin leaving the rest untouched. If a third set is used, the middle set delimits a text portion that will be replaced by the expression delimited by the third (and most inner set) The link will be placed around this last text portion. Any other set of parenthesis should be commented.

For deeper documentation, look at PHP manual's chapter about Pattern syntax.

link

A valid url. Internal urls are processed through the sefRelToAbs() function.

class

Specifies a class for the links markups of this specific plugin markup. Overrides the default "class" parameter of the plugin.

alt

The alt attribute of the links markups

title

The tooltip displayed by the link

case

Optional. Ignored if the regex argument is used

0 - Case insensitive (default)

1 - Case sensitive

html

0 - The plugin will ignore the HTML markups of your content and translate the HTML special characters (e.g. " will be translated to "). (default)

1 - The plugin will treat the HTML markups and special characters as normal text.

In both cases, links already present in the text will not be affected by Pluglink.

popup

Optional.

0 - Open link in the same window (default)

1 - Open link in a popup window