https://github.com/matfish2/craft-ref-tags-ui
Generate Reference Tags directly from the Element Editor
https://github.com/matfish2/craft-ref-tags-ui
craft-plugin craftcms
Last synced: 9 months ago
JSON representation
Generate Reference Tags directly from the Element Editor
- Host: GitHub
- URL: https://github.com/matfish2/craft-ref-tags-ui
- Owner: matfish2
- License: other
- Created: 2022-06-17T10:00:50.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2022-06-30T11:46:25.000Z (almost 4 years ago)
- Last Synced: 2025-07-02T09:46:16.440Z (12 months ago)
- Topics: craft-plugin, craftcms
- Language: PHP
- Homepage: https://plugins.craftcms.com/ref-tags-ui?craft4
- Size: 424 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
## Craft Reference Tags UI
This package provides an advanced UI component that allows the user to
generate [Reference Tags](https://craftcms.com/docs/4.x/reference-tags.html) directly from the element editor.
### Requirements
This plugin requires Craft CMS 4.x or later.
### Installation
1. Include the package:
```
composer require matfish/craft-ref-tags-ui
```
2. Install the plugin:
```
php craft plugin/install ref-tags-ui
```
### Usage
On any Element editor page (Entry, Asset, Category, Tag) click `Ctrl+Alt+R` to
trigger the modal:
By Default the modal will load Global Sets, as this is the most common use case.
Once all required fields have been filled in, the Reference Tag will be displayed at the bottom. Clicking on it will
copy the tag to the clipboard and close the modal.
Now you can simply paste the tag in every text field on your page.
Remember that when rendering the field on the Front end you will need to use the `parseRefs` filter:
```twig
{{ entry.myField | parseRefs }}
```
#### Changing the default trigger
Create a `config/ref-tags-ui.php` file:
```
'Ctrl+Alt+R'
];
```
Set the `trigger` value to whatever combination you prefer. E.g:
```
'trigger'=>'Ctrl+Shift+H'
```
### License
You can try Reference Tags UI in a development environment for as long as you like. Once your site goes live, you are
required to purchase a license for the plugin. License is purchasable through
the [Craft Plugin Store](https://plugins.craftcms.com/ref-tags-ui).
For more information, see
Craft's [Commercial Plugin Licensing](https://craftcms.com/docs/3.x/plugins.html#commercial-plugin-licensing).