Using TitleLink

TitleLink is used by dropping shortcut references into your content that you are writing. Suppose that you have written and published an article called "Growing African Violets". You are now writing a new article about plants you can grow indoors, and you want to reference and link to your African Violet article. You might use it this way: "If you don't have a lot of natural light you might try {ln:growing African Violets}."

When the web page is displayed it will link to your article on violets. Suppose however that the text you want to display isn't the same as the title you want to link to. You can do it this way: "In low light I had good luck raising {ln:growing african violets 'violets} indoors." This will show the link as "violets" but point to the content with the title "growing african violets".

Linking is not limited to the title. You can link to the title_alias field as well. If you used the word "violets" by itself in the title_alieas then all you would have to do to link to it is {ln:violets}.

Linking isn't cases sensitive so you don't have to match case to make the link work.

When using JoomFish you always have to keep in mind that the translated titles aren't found by TitleLink. That means you have to use the titles of the original articles even in the translated versions. TitleLink only finds the original article, JoomFish changes it to the translated one.

Adding "nw:" tells TitleLink to open the link in a new window.

By default, TitleLink will retry a search in all installed plugins. This second try will search for partial matches, so one could have an article titled "One Two Three", and a TitleLink {ln:one two} would find that article. To disable the retry, just use "em:" (for "exact match") as in {ln:em:one two}.

When the second try was a hit, TitleLink will use your partial phrase (e.g. "one two") as the displayed text. To let TitleLink replace your phrase with the correct title of the article, use "rep:" (for "replace") as option. {ln:rep:one two} would then create a link with "One Two Three" as displayed text.

TitleLink can be used as a shortcut for creating external links. Rather than just putting a URL in your text you can easilly turn it into a link as follows: {ln:http://joomlacode.org/gf/project/titlelink/}

You can even have the link open a new window with the nw: modifier. {ln:nw:http://joomlacode.org/gf/project/titlelink/}

Suppose however you want it to display something else. Here how you would do that: {ln:nw:http://joomlacode.org/gf/project/titlelink/ 'TitleLink at JoomlaCode}

You can even create links to google, yahoo, wikipedia or site-internal searches by using the key words google, yahoo, wikipedia or search.

Other sites which support keywords are called by using the command search-<selector> where <selector> is one of the sites listed at the end of this document.

See the syntax and examples section for details!