Freelinking

Last updated on
27 June 2017

Freelinking implements a filter for the easier creation of HTML links to other pages in the site or external sites with a wiki style format such as [[indicator:identifier]].

For example: [[nodetitle:Page One]] becomes:

<a href="/node/1" title="Click to view a local node."
  class="freelink freelink-nodetitle freelink-internal">Page One</a>

Note that there must be no space after the colon after the indicator.

A number of ready-to-use filters are included in the Freelinking framework (e.g. Nodetitle. Nid, User, Google search, Drupal search, Drupal projects, Wikipedia, etc.).

There is a framework that allow developers to add new plugins. Read PLUGIN.txt for more instructions regarding how to add new plugin.

There is a framework that allow developers to add new plugins. Read the help file “Creating plugins for Freelinking ver. 3” for instructions regarding how to add new plugin.

Requirements

Recommended modules

  • Advanced help:

    When this module is enabled, you will have access to extended online help.

Installation

  1. Install as you would normally install a contributed drupal module. See: Installing modules for further information.
  2. Go to Administration » Configuration » Text Formats and activate the Freelinking filter for the text formats you want to facilitate freelinking for (e.g. Filtered HTML and Full HTML).
  3. If you plan to use freelinking for External links, deactivate the Convert URLs into links filter for the same text formats.
  4. Configure the module at Administration » Configuration » Content authoring » Freelinking settings. See next section for details.
  5. Clean the cache.

Configuration

To configure the module, navigate to Administration » Configuration » Content authoring » Freelinking settings.

The first setting is a pull-down menu to let you set the default indicator to use when no indicator is specified. “Nodetitle” mimics previous versions of Freelinking.

The global options and options to increase performance are global, and apply to all plugins. Please see the description of each checkbox to determine what each does.

The rest of the configuration pages are for plugin-specific options.

If you change the configiration, remember to press Save configuration to make the changes effective.

If you change the configiration, remember to press Save configuration to make the changes effective.

Related modules

  • The freelinking package includes the Freelinking prepopulate submodule that provides a plugin to create new nodes. Nodetitle may use this a fallback to provide links to create content that does not exist. This submodule requires Prepopulate.

Troubleshooting

If you do not see freelinking working at all, first make sure that it is enabled for the text format you're using for testing. To check if there is a conflict with other filters, try first to disable all other filters and only leave Freelinking activated. Clean the cache and then test editing a node with a freelink and save it. If it works, try adding other input filters until you get to the right order in which they have to be in order to work correctly.