Configuring plugins and the Freelinking filter

Freelinking now allows you to configure each text format in an unique way

1. To configure the module, navigate to the text format you want to enable Freelinking on at Administration » Configuration » Text Formats.
2. Enable the Freelinking option underneath the Enabled filters heading.
3. If you plan to use freelinking for External links, deactivate the “Convert URLs into links” filter for the same text formats.
4. Enable one or more freelinking plugins for this text format such as “Node” or “Node Title”. Note: Builtin plugins such as redacted are always enabled.

The Freelinking filter format provides the following global options:

• Default plugin:
  • Set the default plugin to use when no indicator is specified. The indicator is the first argument of within the freelinking markup, which follows “[[”.
• Ignore Unkown Plugin Indicators (UPI):
  • Choose whether or not to ignore markup that is invalid or not enabled, or display a themable error message.

Now let's try it out using the Node Title plugin.

1. Navigate to the Add content page, and click a Content Type configured to use the Text Format with Freelinking filter activated.
2. Confirm that the selected Text Format is correct.
3. Add the following content to the Body: [[nodetitle:My Page]], and save the new content.

One of the following will appear on the page:

1. An anchor link with the link text “My Page” — Freelinking has found content matching “My Page”.
2. The text “My Page” — No matching content was found and the “Do Nothing” fail over option is set.
3. The text “Node title My Page does not exist” — No matching content was found and the “Insert an error message” fail over option is set.

The fail over option allows you to configure different behaviors for plugins.

This should give you a good idea about how to configure Freelinking to provide wiki-like markup for you and your users on your web site.