Skip to content

Conversation

@mhsdesign
Copy link
Member

The Neos UI ships with neos/neos-ui#3996 a new link editor. Its backwards-compatible to already set links and also supports the same options though in a different structure (see documentation).

Following legacy options should be rewritten to use the declaration in linkTypes instead. They will be upcasted (via neos/neos-ui#4037) at runtime if no new declaration in linkTypes is made. Using new and old syntax simultaneously will lead to old syntax being ignored fully.

  • assets use linkTypes.Asset.enabled: false instead to disabled asset links
  • nodes use linkTypes.Node.enabled: false instead to disabled asset links
  • nodeTypes use linkTypes.Node.baseNodeType with a NodeType filter string instead
  • startingPoint use linkTypes.Node.startingPoint instead
  • placeholder obsolete finds no application in the new link editor can be safely removed

The anchor option for the inline editor to enable anchor support was removed. Instead anchors can be set via the "Advanced Options" to both Asset and Node links. For Web links the anchor is naturally part of the full link input at all times.

  inline:
    editorOptions:
      linking:
-       anchor: true
        title: true
        relNofollow: true
        targetBlank: true

Upgrade instructions

Review instructions

Checklist

  • Code follows the PSR-2 coding style
  • Tests have been created, run and adjusted as needed
  • The PR is created against the lowest maintained branch
  • Reviewer - PR Title is brief but complete and starts with FEATURE|TASK|BUGFIX
  • Reviewer - The first section explains the change briefly for change-logs
  • Reviewer - Breaking Changes are marked with !!! and have upgrade-instructions

@mhsdesign mhsdesign force-pushed the feature/new-link-editor-documentation branch from 5b2740c to 3c2c969 Compare December 14, 2025 18:36
Copy link
Member

@Sebobo Sebobo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tried to build the docs locally but failed. Used a simple preview to at least verify the structure. Adjusted a few minor typos. Just wondered about the deprecation sentence.

Btw. you used a wild mix of tabs and spaces.

@Sebobo Sebobo moved this to In review in Neos 9.1 Release Board Dec 15, 2025
@mhsdesign mhsdesign force-pushed the feature/new-link-editor-documentation branch from 5f4beff to 0200f8f Compare December 15, 2025 09:21
@mhsdesign mhsdesign merged commit f4e117c into neos:9.1 Dec 15, 2025
15 checks passed
@github-project-automation github-project-automation bot moved this from In review to Done in Neos 9.1 Release Board Dec 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants