updated linkit contrib module to last beta version

This commit is contained in:
2018-04-17 14:53:21 +02:00
parent c0fbcb7706
commit 76ff40f8bb
136 changed files with 5138 additions and 3860 deletions
@@ -1,33 +1,54 @@
Linkit
===========
Linkit provides an **enriched linking experience for internal and external
linking** with editors by using an autocomplete field. Linkit has by default
support for nodes, users, taxonomy terms, files, comments and
**basic support for all types of entities** that defines a canonical link
template.
Linkit provides an **enriched linking experience for internal and
external linking** with editors by using an autocomplete field. Linkit
has by default support for nodes, users, taxonomy terms, files,
comments and **basic support for all types of entities** that defines a
canonical link template.
Installation
------------
* Normal module installation procedure. See
https://www.drupal.org/documentation/install/modules-themes/modules-8
https://www.drupal.org/documentation/install/modules-themes/modules-8
* **Enable Linkit**
To enable Linkit, go to `/admin/config/content/formats` and edit the
desired text format you want to enable Linkit for. Linkit will alter
the default link plugin, so make sure that it is enabled. When the
default link plugin is enabled, you will have to select a Linkit
profile to use in the "Drupal link" tab under the toolbar configuration.
* **Enable Linkit filter**
Linkit will insert URLs in a format like "entity:node/1". The Linkit
filter will then transform that URL into a "real" URL when rendering
the text. **Note: The Linkit filter must run before "Limit allowed HTML
tags and correct faulty HTML"**.
* If the **Limit allowed HTML tags and correct faulty HTML** filter is
enabled, add *data-entity-type* and *data-entity-uuid* to the `<a>` tag
in the *Allowed HTML* tags (i.e. `<a href data-entity-type data-entity-uuid>`).
* (optional) **Use automatic titles with the Linkit filter**
If automatic titles is enabled in the Linkit filter settings, and
**Limit allowed HTML tags and correct faulty HTML** is enabled, add
*title* to the `<a>` tag in the *Allowed HTML* tags (i.e.
`<a href data-entity-type data-entity-uuid title>`).
Configuration
------------
After the installation, you have to create a Linkit profile. The profile will
contain information about which plugins to use.
Profiles can be created at `/admin/config/content/linkit`
A default Linkit profile will have been installed as a step in the
module installation process. The profile will contain information about
which plugins to use.
When you have created a profile, you need to enable the Linkit plugin on the
text format you want to use. Formats are found at
`admin/config/content/formats`.
You can create additional profiles at `/admin/config/content/linkit`.
Plugins examples
------------
There are plugin implementation examples in the linkit_test module bundled with
Linkit core.
There are plugin implementation examples in the linkit_test module
bundled with Linkit core.