fromholdio/silverstripe-dbhtmlanchors

Quick and easy method of identifying anchors in DBHTMLText and DBHTMLVarchar fields

Maintainers

Details

github.com/fromholdio/silverstripe-dhtmlanchors

Homepage

Source

Issues

Installs: 1 195

Dependents: 0

Suggesters: 1

Security: 0

Stars: 2

Watchers: 1

Forks: 0

Open Issues: 0

Type:silverstripe-vendormodule

pkg:composer/fromholdio/silverstripe-dbhtmlanchors

2.1.0 2025-09-18 16:25 UTC

Requires

BSD-3-Clause 4ea63f7b59febeb045dd41f09a36cf77ab67e52c

HTML5silverstripedbfielddbhtmltext

This package is auto-updated.

Last update: 2025-10-18 16:40:32 UTC

README

Quick and easy method of identifying anchors in DBHTMLText and DBHTMLVarchar fields.

Requirements

SilverStripe 4

Installation

composer require fromholdio/silverstripe-dbhtmlanchors

Detail

Upon install, the DBHTMLAnchorsExtension is automatically applied to DBHTMLText and DBHTMLVarchar.

This adds a getAnchors() accessor to each of these DBFields.

When called on the field object, it processes any shortcodes, and then searches the html elements for name and id attributes that can be used as anchor link targets.

The list of anchor values is returned as a simple array.

Usage example

Add a DBHTMLText or DBHTMLVarchar to your data object. The Content field of SiteTree is a common example of one that already exists.

private static $db = [
    'Content' => 'HTMLText'
];

In your code, get the field object, and call getAnchors(). Make sure you get the field object, not the field's value.

// CORRECT
$contentField = $this->dbObject('Content');
$anchors = $contentField->getAnchors();

// WRONG
$contentField = $this->Content;
$anchors = $contentField->getAnchors();

The value returned will be either null for no results, or an associative array, with key and value both containing the anchor value.

// return value from ->getAnchors()
[
    'sectionone' => 'sectionone',
    'sectiontwo' => 'sectiontwo'
]