Download the PHP package nickjacobs/silverstripe-edit-links without Composer

SilverStripe Edit Links

Front-end edit badges for SilverStripe pages and Elemental blocks. Editors browsing the live site see a small pencil badge on the page and on every block; hovering reveals the class name, record ID and title, and admins get a link straight to the CMS edit form.

By default the module auto-injects the badges into every HTML response, so no template changes are needed. A $EditLink template variable is available if you'd rather place them yourself.

Requirements

• SilverStripe Framework and CMS 6
• dnadesign/silverstripe-elemental 6 (optional, enables block badges and CMS buttons)
• tractorcow/silverstripe-fluent (optional, see Fluent)

Installation

Run dev/build?flush=1, then go to Settings > Edit links in the CMS and tick the badges you want on. The tab is only shown to members with the settings_permission (ADMIN by default).

How it works

1. A SiteTree extension captures the page being served.
2. After the page has rendered, an HTTP middleware builds a manifest: the page badge HTML plus one badge per Elemental block keyed by the block's anchor id, the same id="$Anchor" Elemental writes on every holder.
3. It appends the manifest, the stylesheet and a small script before </body>.
4. The script drops the page badge into <body> and each block badge into its holder, adding position: relative where needed.

Nothing is written to the response for visitors who can't see badges, and CMS preview requests are skipped.

Blocks are walked recursively, so nested areas (an element list, for example) get badges too. A block rendered without its holder, or with a custom holder that drops id="$Anchor", is simply skipped.

Manual placement

Set auto_inject: false and put $EditLink where you want the badge:

$EditLink renders nothing when badges are disabled or the visitor can't see them, and pulls in the stylesheet via Requirements when it does render. The badge is absolutely positioned; the stylesheet already makes an .element holder relative when it contains one.

Configuration

SiteConfig switches

Styling

Colours and sizing are CSS custom properties. Override them in your own stylesheet:

Extension hooks

• EditLinkService::updateBadgeData(ArrayData $data, string $type, DataObject $record) to add fields to the badge template.
• EditLinkService::updateManifest(array &$manifest, SiteTree $page) to add or remove entries before injection.
• Override the template at templates/NickJacobs/EditLinks/EditLink.ss in your project.

Fluent

On a Fluent site, edit links carry the locale being viewed:

This matters more than it looks. Fluent resolves the CMS locale from the query parameter first, then from a persisted cookie. Without the parameter, clicking a badge on a non-default locale opens whichever locale the editor last used in the CMS — usually the wrong one, and the record often will not resolve there at all. Worse, Fluent persists whatever it resolved, so an editor can carry on editing the wrong locale without an obvious signal.

The parameter name is read from Fluent's own query_param config rather than hardcoded, and the locale is captured while the page is served, because Fluent restores its state before the badges are injected.

Set carry_locale: false to turn this off.

Fluent is not a dependency. Without it installed, links are unchanged.

CMS buttons

With Elemental installed and cms_buttons on, a block's edit form in the CMS gains three actions: Back to page, View live and Preview draft. Set cms_buttons: false to drop them.

Development

The stylesheet is compiled from client/src/edit-links.scss; the built file is committed.

Licence

BSD-3-Clause.