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.). This help file describes all the included filters.
The Freelinking link format is:
[[indicator:target|title|tooltip|arg1|arg2|…]]
Everything except the target is optional. If you do not specity a indicator the default one configured at Freelinking Settings page (Administration » Configuration » Content authoring » Freelinking settings) will be used.
The indicator is used to select the what filter to use.
There are three built-in filters (Nowiki, Showtext, Redact) These
will not generate links. In addition to these, the project includes a
small set of plugin filters. These are in the
subdirectory plugins
of the project.
Below is an overview of all the filters that is included in the project:
Will strip the nowiki-indicator and show the rest, including the double brackets, verbatim.
Example:
[[nowiki:this is not a freelink]]
becomes:
[[this is not a freelink]]
similar to Nowiki, but will also strip double brackets before showing the text.
Example:
[[showtext:this is not a freelink]]
becomes:
this is not a freelink
The Redact filter works like Showtext for logged in users, but will redact the content of marked up content before showing it to the anonymous user.
Example:
[[redact:sensitive stuff]]
becomes:
sensitive stuff
for logged in users, and
******
for anonymous users.
freelinking_nodetitle.inc
)Example:
[[nodetitle:First page]]
becomes:
<a class="freelink freelink-nodetitle freelink-internal" title="Click to view a local node." href="/node/1">test</a>
Note: If you have two nodes with the same title, there is no way to control what node is linked to. If you change the title of the page linked to, the freelink will no longer work.
freelinking_nid.inc
)Example:
[[nid:2]]
becomes:
<a class="freelink freelink-nid freelink-internal" title="Click to view a local node." href="/node/2">First page</a>
freelinking_user.inc
Example:
[[user:1]]
becomes:
<a class="freelink freelink-user freelink-internal" title="Click to view a user profile." href="/user/1">admin</a>
Example:
[[user:admin]]
becomes:
<a class="freelink freelink-user freelink-internal" title="Click to view a user profile." href="/user/1">admin</a>
freelinking_path.inc
Example:
[[path:/breaking-news]]
becomes:
<a class="freelink freelink-path freelink-internal" title="Click to view a local node." href="/breaking-news">Breaking news</a>
freelinking_file.inc
Example:
[[file:logo.png]]
becomes:
<a class="freelink freelink-file freelink-internal" title="Click to view a local file." href="http://
freelinking_search.inc
Example:
[[search:test]]
becomes:
<a class="freelink freelink-search freelink-internal" title="Search this site for contents like “test”." href="/search/node/test">test</a>
freelinking_external.inc
Example:
[[https://groups.drupal.org/frontpage]]
becomes:
<a class="freelink freelink-external" title="Click to visit an external secure URL." href="https://groups.drupal.org/frontpage">https://groups.drupal.org/frontpage</a>
You may configure Freelinking to poll the URL for title and availability, but this may lead to slow page loads.
Example:
[[google:drupal]]
becomes:
<a class="freelink freelink-google freelink-external" title="Search Google for contents like “drupal”." href="http://www.google.com/search?q=drupal&hl=en">Google Search "drupal"</a>
freelinking_dev.inc
)Use the short name of the project as the target. You may configure Freelinking to poll the URL for title and availability, but this may lead to slow page loads.
Example:
[[drupalproject:freelinking]]
becomes:
<a class="freelink freelink-drupalproject freelink-external" title="Click to view project Drupal.org." href="http://drupal.org/project/freelinking">Drupal.org: “freelinking”</a>
Use the Drupal.org nid as the the target. You may configure Freelinking to poll the URL for title and availability, but this may lead to slow page loads.
Example:
[[drupalorg:1]]
becomes:
<a class="freelink freelink-drupalorgnid freelink-external" title="Click to view node on Drupal.org." href="http://drupal.org/node/1">Drupal.org: “#1”</a>
freelinking_wiki.inc
)The indicators supported by this plugin
are: wikibooks
, wikipedia
,
wikinews
, wikiquote
, wikisource
and wiktionary
.
Example:
[[wikipedia:Main Page]]
becomes:
<a class="freelink freelink-wikipedia freelink-external" title="Click to visit a wikipedia page." href="http://en.wikipedia.org/wiki/Main_Page">Main_Page</a>