Enhanced Toolbar Link Dialog - A plugin to handle internal links
What the heck is Enhanced Toolbar Link Dialog about? Glad you asked! Enhanced Toolbar Link Dialog is a perfect helper if you…
- Can't remember all the pesky and way to long Page URLs,
- Want to build up or optimize your internal link structure for SEO without any effort
- Looking for a convenient way to deal with internal links
Enhanced Toolbar Link Dialog is a Kirby 3 plugin which makes it easy to add internal or external references to your content by extending the default link dialog of Kirby's textarea fields.
Panel view
How to use
After you've installed Enhanced Toolbar Link Dialog successfully, open a page of your choice and click the link toolbar button. Make sure the toolbar or the link button isn't switched off.
After you clicked the link toolbar button, a modal window gets openend which consists two tabs:
The "External Link" tab is exactly what you've had before.
Where it gets interesting is the "Internal Link" tab. Within this tab you can:
- search for specific pages (by page title)
- paginate through all existing pages (published/unpublished)
- specify where to open the linked document in KirbyText
As soon as you have found your page, you can select and insert it into your document.
Installation
Composer
composer require gearsdigital/enhanced-toolbar-link-dialog
Git submodule
git submodule add https://github.com/gearsdigital/enhanced-toolbar-link-dialog.git site/plugins/enhanced-toolbar-link-dialog
Download
Download and copy this repository to /site/plugins/enhanced-toolbar-link-dialog.
Configuration
| Option | Default | Description |
|---|---|---|
gearsdigital.enhanced-toolbar-link-dialog.link.title |
"{{page.title}}" String |
The list item text is created using the Kirby Query Language and therefore customizable. It is totally up to you, how the page will appear to your users. Within the query you have access to page, site and kirby. |
gearsdigital.enhanced-toolbar-link-dialog.tab.order |
"0" - String |
You can choose between two values. "0" "External Link" Tab is initially active."1" "Internal Link" Tab is initially active. |
gearsdigital.enhanced-toolbar-link-dialog.search.filter |
null |
Filter to apply to search query when retrieving list of internal links. Must be an array of string values compatible with filterBy() function. |
gearsdigital.enhanced-toolbar-link-dialog.search.pageSize |
"5" |
Configure the page size in search result list. |
Examples
// site/config/config.php
return [
'gearsdigital.enhanced-toolbar-link-dialog.link.title' => '### {{ page.title }} ###',
'gearsdigital.enhanced-toolbar-link-dialog.tab.order' => '1', // Internal Link Tab is active
'gearsdigital.enhanced-toolbar-link-dialog.search.filter' => [ 'page_type', '==', 'textpage' ]
];Available translations
- German
- English
- Czech
- French
- Dutch
Pull requests with additonal translations are very much appreciated!
You can (if you really need to) override and adapt all translations to your needs.
// site/config/config.php
'gearsdigital.enhanced-toolbar-link-dialog' => [
'translations' => [
'en' => [
'gearsdigital.enhanced-toolbar-link-dialog.target.blank' => 'Open in new window'
],
'de' => [
'gearsdigital.enhanced-toolbar-link-dialog.target.blank' => 'Im neuen Fenster öffnen'
],
],
]This is the list of all available translation keys:
'gearsdigital.enhanced-toolbar-link-dialog.internal' => 'Internal Link',
'gearsdigital.enhanced-toolbar-link-dialog.external' => 'External Link',
'gearsdigital.enhanced-toolbar-link-dialog.empty' => 'No pages found',
'gearsdigital.enhanced-toolbar-link-dialog.target.title' => 'Link Target',
'gearsdigital.enhanced-toolbar-link-dialog.target.help' => 'Specify where to open the linked document.',
'gearsdigital.enhanced-toolbar-link-dialog.target.blank' => 'Blank',
'gearsdigital.enhanced-toolbar-link-dialog.target.self' => 'Self',
'gearsdigital.enhanced-toolbar-link-dialog.target.top' => 'Top',
'gearsdigital.enhanced-toolbar-link-dialog.target.parent' => 'Parent',
'gearsdigital.enhanced-toolbar-link-dialog.title.title' => 'Title',
'gearsdigital.enhanced-toolbar-link-dialog.anchor.title' => 'Anchor (#)',
'gearsdigital.enhanced-toolbar-link-dialog.tab.order' => '0'
License
MIT