The Short Links plugin / Quick Links plugin alows to quickly create links from one post to another without needing to enter cumbersome HTML syntax like:
<a href="destination">link title</a>. (This is especially useful for forums or manuals in which you probably do not allow plain html links anyways.)
This plugin provides a toolbar button which lets you select a link destination post and then offers several options:
- Quickly insert a link with short link syntax like
- Easily insert a link with short link syntax and additional options like
[[destination-slug .class _target title]]
- Quickly insert a snippet of a post into another post or message
|Last tested in version:|
Per-collection settings (6.9.3+)
Short Link Syntax
This plugin acts as a renderer plugin with support for a variety of syntax options, like:
((destination-slug)) ((destination-url)) ((123)) ((destination text to display)) ((#anchor text to display)) ((destination#anchor text to display)) ((destination .class text to display)) ((destination .class1.class2 text to display)) ((destination .class _target text to display))
All these syntaxes can be used with
[[...]] as well as
((...)) (which produces a slightly different behaviour if no
text to display is specified; see below.)
If you use the toolbar button, you will have easy access to these options:
Below are more details about the syntax…
Specifying the destination
There are 3 possible forms to specify the destination of the link:
- Enter the Slug of a post. For example
[[wiki-links-plugin]]will create a link like this: Short Links Plugin / Quick Links Plugin
- Enter a Slug in CamelCase. For example
[[WikiLinksPlugin]]will create a link like this: Short Links Plugin / Quick Links Plugin
- Enter the full URL to an external site. For example
[[http://fplanque.com]]will create a link like this: http://fplanque.com
Specifying class names (6.9.2+)
Classes MUST start with a
. . Multiple classes can be separated by
Classes are optional. If they are specified they must be specified in second position (after first space). Any
. that comes later (after second space) will be considered part of the Link Title.
[[post-slug .btn.btn-info]] [[wiki-links-plugin .btn.btn-default text one]] [[WikiLinksPlugin .btn.btn-primary text two]] [[http://fplanque.com .text-warning text three]]
Specifying a Target (6.9.2+)
Target MUST start with a
Target is optional. If specified, it must be specified after optional classes and before title. Any
_ that comes later will be considered part of the title.
[[post-slug .btn.btn-info _blank]] [[http://fplanque.com .text-warning _blank text three]] `((#anchor _top link words))`
Specifying a Link Title / Link Text
The link title is/text to display optional (see below). You can add an explicit text to display after the destination (separate with space). For example:
[[wiki-links-plugin text one]]will create a link like this: text one
[[WikiLinksPlugin text two]]will create a link like this: text two
[[http://fplanque.com text three]]will create a link like this: text three
Omitting the title / Automatic title
The link title / text to display is optional. If you don’t specify a title, the
((...)) and the
[[...]] syntaxes behave differently:
[[...]], if you don’t specify a link title, the plugin will try to use the title of the destination post (works with slugs & CamelCase). Example:
[[WikiLinks]]becomes: Short Links Plugin / Quick Links Plugin
((...)), if you don’t specify a link title, the plugin will display each word of your link and capitalize the first letter of each word. Example:
((WikiLinks))becomes: Wiki Links
Note: when using the form
((...)), it is interesting to have several slugs for each destination post. This allows you to easily use links in text. For example:
The ((WikiLinks)) functionality is provided by the ((WikiLinksPlugin)).
There is an option you can turn on in the Plugin Settings (Per Collection / Blog) to link any CamelCase word, even without brackets.
Inserting a Snippet + Link (6.9.3+)
This is the third option provided by the toolbar button:
This allows you to insert a full snippet + image. This is particularly useful when referencing a post in a Newsletter for example.
It would be nice to have the option/check box for a separate window which will opens if you click onto the link …
[ ] Link will be opened in an extra window.
@ednong You want that for all links (easy) created by this plugin or just for specific links created by this plugin (requires to invent a new syntax for the tags) ?
for all - it would be nice to have an option in the settings of the blog.
And for this plugin too - so I can e.g. external links let open a new window. And yes, then you need an advanced syntax …
@ednong Your answer does not actually reply the question :p