This module is an extension to the CKEditor module.
It also supports CKEditor installed through the Wysiwyg module.
This module allows to easily create links to Drupal internal paths through CKEditor's Link button and dialog.
It is composed of 2 parts:
- A client-side CKEditor plugin that adds features to CKEditor's default Link plugin.
- A server-side input format filter that converts the raw paths added through the plugin into aliased and, if applicable, language prefixed URLs.
Features
- Integrates with CKEditor's default Link button and dialog (no separate button/dialog)
- Adds a new option Internal path to the Link Type select box, that gets selected by default
- When Internal path is selected, displays an autocomplete textfield: just type some letters to get a list of suggestions!
- Natively supports linking to nodes, taxonomy terms, and menu item paths
- Exposes hooks for developers who want to extend the module
- Full multilingual support
- Link paths added through the plugin respect the standard URL format:
/BASE/PATH/raw/internal/path - The input format filter CKEditor Link Filter converts these raw paths into aliased URLs.
- A lot more!
Extensions
The following modules extend CKEditor Link:
- CKEditor Link File adds support for linking to files.
- CKEditor Link User adds support for linking to users.
- CKEditor Link OG integrates CKEditor Link with Organic Groups.
Requirements and Compatibility
Currently, CKEditor Link needs the following to run:
- the CKEditor module, version 6.x-1.0 or above or the Wysiwyg module, version 6.x-2.1 or above
- the CKEditor editor, version 3.1 or above.
- Clean URLs need to be enabled.
Installation (Drupal 6)
Instructions below apply to 6.x-2.x.
Copy the ckeditor_link folder to your sites/all/modules directory.
Go to admin/build/modules and enable the module.
Set permissions
Go to admin/user/permissions and grant the CKEditor Link related permissions to the desired roles.
When using the CKEditor module
Go to admin/settings/ckeditor and edit the desired profile.
Under "Editor appearance" > "Plugins", check the "CKEditor Link" box.
Save changes.
When using the Wysiwyg module
Go to admin/settings/wysiwyg and edit the CKEditor profile.
Under "Buttons and plugins", check both "Link" and "CKEditor Link" boxes.
Save changes.
Set up CKEditor Link Filter
Go to admin/settings/filters and edit the desired input format.
Check the "CKEditor Link Filter" box.
Save changes.
If you use other path converting filters like Pathologic or Path Filter, make sure that CKEditor Link Filter comes before them:
Edit the input format again.
Click on the "Rearrange" tab.
Drag and drop CKEditor Link Filter before these filters in the list.
Save changes.
Configure CKEditor Link
Go to admin/settings/ckeditor_link.
Change settings as desired.
Save changes.
Installation (Drupal 7)
Instructions below apply to 7.x-2.x.
Copy the ckeditor_link folder to your sites/all/modules directory.
Go to admin/modules and enable the module.
Set permissions
Go to admin/people/permissions and grant the CKEditor Link related permissions to the desired roles.
When using the CKEditor module
Go to admin/config/content/ckeditor and edit the desired profile.
Under "Editor appearance" > "Plugins", check the "CKEditor Link" box.
Save changes.
When using the Wysiwyg module
Go to admin/config/content/wysiwyg and edit the desired CKEditor-enabled input format.
Under "Buttons and plugins", check both "Link" and "CKEditor Link" boxes.
Save changes.
Set up CKEditor Link Filter
Go to admin/config/content/formats and edit the desired text format.
Check the "CKEditor Link Filter" box.
If you use other path converting filters like Pathologic or Path Filter, make sure that CKEditor Link Filter comes before them:
Under "Filter processing order", drag and drop CKEditor Link Filter before these filters in the list.
Save changes.
Configure CKEditor Link
Go to admin/config/content/ckeditor_link.
Change settings as desired.
Save changes.
Related modules
Check out the CKEditor SWF module that allows to easily insert SWF animations, FLV videos and MP3 audio files through CKEditor!
Contact
This module is sponsored by Absyx.
If you like this module, please review Absyx.
Downloads
Recommended releases
Other releases
Development releases
Project Information
- Maintenance status: Actively maintained
- Development status: Under active development
- Module categories: Content, Filters/Editors, Multilingual, Path Management
- Reported installs: 26999 sites currently report using this module. View usage statistics.
- Downloads: 81,637
- Last modified: January 14, 2013
