Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/prgfx/prgfx.neos.linkeditor
Neos Link-Editor extension for editing query arguments
https://github.com/prgfx/prgfx.neos.linkeditor
neoscms
Last synced: 1 day ago
JSON representation
Neos Link-Editor extension for editing query arguments
- Host: GitHub
- URL: https://github.com/prgfx/prgfx.neos.linkeditor
- Owner: PRGfx
- License: gpl-3.0
- Created: 2023-09-20T20:11:31.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-10-02T20:45:55.000Z (about 1 year ago)
- Last Synced: 2024-11-06T07:06:34.094Z (14 days ago)
- Topics: neoscms
- Language: TypeScript
- Homepage:
- Size: 97.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[![Version](https://poser.pugx.org/prgfx/neos-linkeditor/version)](//packagist.org/packages/prgfx/neos-linkeditor)
# Prgfx.Neos.LinkEditor
Allows configuring inputs for query arguments in the link-editor.
Intended for adding tracking parameters.`composer require prgfx/neos-linkeditor`
## Usage
```yaml
My.Package:NodeType:
properties:
text:
ui:
inline:
editorOptions:
linking:
linkAttributes:
# specify the label for a single query argument
utm_campaign: Campaign
# more options can be specified in an object
utm_source:
label: UTM source
help: Description for this parameter
# all labels accept translation IDs
other:
label: My.Package:Main:i18nLabel
placeholder: Example value
# unset attributes or attributes without label are ignored
ignored_attribute: ~
```### Group Inputs
In case you have multiple types of inputs, you can group them in a "meaningful" way:
```yaml
# ...
linking:
linkAttributes:
utm_campaign:
label: Campaign
group: tracking
```
Groups can be configured in the frontend settings:
```yaml
Prgfx:
Neos:
LinkEditor:
parameterGroups:
tracking:
# supports MyPackage:Source:key translation keys as well
label: Tracking parameters
# optional; if a value is set in that group, the group will always be expanded
collapsed: true
```
The default group is called `default`, in case you want to overwrite its settings.## Augment Links
For similar use-cases you may want to append additional arguments to links in certain contexts, e.g. set a "utm_source" argument in your email or RSS rendering.
For this you can overwrite the `Prgfx.Neos.LinkEditor:AdditionalArguments` fusion prototype:
```neosfusion
prototype(My.Package:RssItem) {
prototype(Prgfx.Neos.LinkEditor:AdditionalArguments) {
utm_source = 'rss'
}
}
```The attributes will be appended to links going through `Neos.Fusion:UriBuilder`, `Neos.Neos:NodeUri` and `Neos.Neos:ConvertUris`.
You can disable this behavior with the respective settings:
```yaml
Prgfx:
Neos:
LinkEditor:
augmentLinks:
NodeUri: true
UriBuilder: true
ConvertUris: true
```## Note
This package overwrites the default LinkEditor to allow passing additional linking options to enable the parameter editor in the inspector editor.
You can disable this behavior in the settings:
```yaml
Neos:
Neos:
Ui:
frontendConfiguration:
Prgfx.Neos.LinkEditor:
linkEditor:
replace: false
```
See the package settings for more information