{"id":20984725,"url":"https://github.com/prgfx/prgfx.neos.linkeditor","last_synced_at":"2025-03-13T11:12:59.475Z","repository":{"id":196536956,"uuid":"694344922","full_name":"PRGfx/Prgfx.Neos.LinkEditor","owner":"PRGfx","description":"Neos Link-Editor extension for editing query arguments","archived":false,"fork":false,"pushed_at":"2023-10-02T20:45:55.000Z","size":100,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-20T18:17:47.626Z","etag":null,"topics":["neoscms"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PRGfx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-09-20T20:11:31.000Z","updated_at":"2023-11-28T15:17:45.000Z","dependencies_parsed_at":null,"dependency_job_id":"fe3fa3db-0a77-4ec5-a0bf-d59ee5396ddd","html_url":"https://github.com/PRGfx/Prgfx.Neos.LinkEditor","commit_stats":null,"previous_names":["prgfx/prgfx.neos.linkeditor"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRGfx%2FPrgfx.Neos.LinkEditor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRGfx%2FPrgfx.Neos.LinkEditor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRGfx%2FPrgfx.Neos.LinkEditor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRGfx%2FPrgfx.Neos.LinkEditor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PRGfx","download_url":"https://codeload.github.com/PRGfx/Prgfx.Neos.LinkEditor/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243392315,"owners_count":20283563,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["neoscms"],"created_at":"2024-11-19T05:54:20.927Z","updated_at":"2025-03-13T11:12:59.452Z","avatar_url":"https://github.com/PRGfx.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Version](https://poser.pugx.org/prgfx/neos-linkeditor/version)](//packagist.org/packages/prgfx/neos-linkeditor)\n\n# Prgfx.Neos.LinkEditor\n\nAllows configuring inputs for query arguments in the link-editor.\nIntended for adding tracking parameters.\n\n`composer require prgfx/neos-linkeditor`\n\n## Usage\n```yaml\nMy.Package:NodeType:\n  properties:\n    text:\n      ui:\n        inline:\n          editorOptions:\n            linking:\n              linkAttributes:\n                # specify the label for a single query argument\n                utm_campaign: Campaign\n                # more options can be specified in an object\n                utm_source:\n                  label: UTM source\n                  help: Description for this parameter\n                # all labels accept translation IDs\n                other:\n                  label: My.Package:Main:i18nLabel\n                  placeholder: Example value\n                # unset attributes or attributes without label are ignored\n                ignored_attribute: ~\n```\n\n### Group Inputs\nIn case you have multiple types of inputs, you can group them in a \"meaningful\" way:\n```yaml\n# ...\n   linking:\n    linkAttributes:\n      utm_campaign:\n        label: Campaign\n        group: tracking\n```\nGroups can be configured in the frontend settings:\n```yaml\nPrgfx:\n  Neos:\n    LinkEditor:\n      parameterGroups:\n        tracking:\n          # supports MyPackage:Source:key translation keys as well\n          label: Tracking parameters\n          # optional; if a value is set in that group, the group will always be expanded\n          collapsed: true\n```\nThe default group is called `default`, in case you want to overwrite its settings.\n\n## Augment Links\nFor 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.\nFor this you can overwrite the `Prgfx.Neos.LinkEditor:AdditionalArguments` fusion prototype:\n```neosfusion\nprototype(My.Package:RssItem) {\n    prototype(Prgfx.Neos.LinkEditor:AdditionalArguments) {\n        utm_source = 'rss'\n    }\n}\n```\n\nThe attributes will be appended to links going through `Neos.Fusion:UriBuilder`, `Neos.Neos:NodeUri` and `Neos.Neos:ConvertUris`.\nYou can disable this behavior with the respective settings:\n```yaml\nPrgfx:\n  Neos:\n    LinkEditor:\n      augmentLinks:\n        NodeUri: true\n        UriBuilder: true\n        ConvertUris: true\n```\n\n## Note\nThis package overwrites the default LinkEditor to allow passing additional linking options to enable the parameter editor in the inspector editor.\nYou can disable this behavior in the settings:\n```yaml\nNeos:\n  Neos:\n    Ui:\n      frontendConfiguration:\n        Prgfx.Neos.LinkEditor:\n          linkEditor:\n            replace: false\n```\nSee the package settings for more information\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprgfx%2Fprgfx.neos.linkeditor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprgfx%2Fprgfx.neos.linkeditor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprgfx%2Fprgfx.neos.linkeditor/lists"}