class SiteTreeExtension extends DataExtension

Plug-ins for additional functionality in your SiteTree classes.

Properties

$class from Extension

Methods

__construct()

No description

from Extension
static 
add_to_class(string $class, string $extensionClass, mixed $args = null)

Called when this extension is added to a particular class

from Extension
setOwner(SS_Object $owner, string $ownerBaseClass = null)

Set the owner of this extension.

from Extension
clearOwner()

No description

from Extension
getOwner()

Returns the owner of this extension.

from Extension
static string
get_classname_without_arguments(string $extensionStr)

Helper method to strip eval'ed arguments from a string thats passed to {@link DataObject::$extensions} or {@link Object::add_extension()}.

from Extension
static 
get_extra_config($class, $extension, $args)

No description

static 
unload_extra_statics($class, $extension)

No description

validate(ValidationResult $validationResult)

Hook for extension-specific validation.

augmentSQL(SQLQuery $query)

Edit the given query object to support queries for this extension

augmentDatabase()

Update the database schema as required by this extension.

augmentWrite(array $manipulation)

Augment a write-record request.

onBeforeWrite()

No description

onAfterWrite()

No description

onBeforeDelete()

No description

onAfterDelete()

No description

requireDefaultRecords()

No description

populateDefaults()

No description

can($member)

No description

canEdit($member)

No description

canDelete($member)

No description

canCreate($member)

No description

array
extraStatics($class = null, $extension = null)

Define extra database fields

updateCMSFields(FieldList $fields)

This function is used to provide modifications to the form in the CMS by the extension. By default, no changes are made. {@link DataObject->getCMSFields()}.

updateFrontEndFields(FieldList $fields)

This function is used to provide modifications to the form used for front end forms. {@link DataObject->getFrontEndFields()}

updateCMSActions(FieldList $actions)

This is used to provide modifications to the form actions used in the CMS. {@link DataObject->getCMSActions()}.

updateSummaryFields(array $fields)

this function is used to provide modifications to the summary fields in CMS by the extension By default, the summaryField() of its owner will merge more fields defined in the extension's $extra_fields['summary_fields']

updateFieldLabels(array $labels)

this function is used to provide modifications to the fields labels in CMS by the extension By default, the fieldLabels() of its owner will merge more fields defined in the extension's $extra_fields['field_labels']

onBeforePublish(SiteTree $original)

Hook called before the page's {@link SiteTree::doPublish()} action is completed

onAfterPublish(SiteTree $original)

Hook called after the page's {@link SiteTree::doPublish()} action is completed

onBeforeUnpublish()

Hook called before the page's {@link SiteTree::doUnpublish()} action is completed

onAfterUnpublish()

Hook called after the page's {@link SiteTree::doUnpublish()} action is completed

boolean|null
canAddChildren(Member $member)

Hook called to determine if a user may add children to this SiteTree object

boolean|null
canPublish(Member $member)

Hook called to determine if a user may publish this SiteTree object

updateRelativeLink(string $base, string|boolean $action)

Hook called to modify the $base url of this page, with a given $action, before {@link SiteTree::RelativeLink()} calls {@link Controller::join_links()} on the $base and $action

Details

in Extension at line 42
__construct()

in Extension at line 54
static add_to_class(string $class, string $extensionClass, mixed $args = null)

Called when this extension is added to a particular class

Parameters

string $class
string $extensionClass
mixed $args

in Extension at line 66
setOwner(SS_Object $owner, string $ownerBaseClass = null)

Set the owner of this extension.

Parameters

SS_Object $owner The owner object,
string $ownerBaseClass The base class that the extension is applied to; this may be the class of owner, or it may be a parent. For example, if Versioned was applied to SiteTree, and then a Page object was instantiated, $owner would be a Page object, but $ownerBaseClass would be 'SiteTree'.

in Extension at line 74
clearOwner()

in Extension at line 85
SS_Object getOwner()

Returns the owner of this extension.

Return Value

SS_Object

in Extension at line 97
static string get_classname_without_arguments(string $extensionStr)

Helper method to strip eval'ed arguments from a string thats passed to {@link DataObject::$extensions} or {@link Object::add_extension()}.

Parameters

string $extensionStr E.g. "Versioned('Stage','Live')"

Return Value

string Extension classname, e.g. "Versioned"

in DataExtension at line 10
static get_extra_config($class, $extension, $args)

Parameters

$class
$extension
$args

in DataExtension at line 32
static unload_extra_statics($class, $extension)

Parameters

$class
$extension

in DataExtension at line 42
validate(ValidationResult $validationResult)

Hook for extension-specific validation.

Parameters

ValidationResult $validationResult Local validation result

Exceptions

ValidationException

in DataExtension at line 50
augmentSQL(SQLQuery $query)

Edit the given query object to support queries for this extension

Parameters

SQLQuery $query Query to augment.

in DataExtension at line 59
augmentDatabase()

Update the database schema as required by this extension.

When duplicating a table's structure, remember to duplicate the create options as well. See {@link Versioned->augmentDatabase} for an example.

in DataExtension at line 67
augmentWrite(array $manipulation)

Augment a write-record request.

Parameters

array $manipulation Array of operations to augment.

in DataExtension at line 70
onBeforeWrite()

in DataExtension at line 73
onAfterWrite()

in DataExtension at line 76
onBeforeDelete()

in DataExtension at line 79
onAfterDelete()

in DataExtension at line 82
requireDefaultRecords()

in DataExtension at line 85
populateDefaults()

in DataExtension at line 88
can($member)

Parameters

$member

in DataExtension at line 91
canEdit($member)

Parameters

$member

in DataExtension at line 94
canDelete($member)

Parameters

$member

in DataExtension at line 97
canCreate($member)

Parameters

$member

in DataExtension at line 112
array extraStatics($class = null, $extension = null)

Define extra database fields

Return a map where the keys are db, has_one, etc, and the values are additional fields/relations to be defined.

Parameters

$class since this method might be called on the class directly
$extension since this can help to extract parameters to help set indexes

Return Value

array Returns a map where the keys are db, has_one, etc, and the values are additional fields/relations to be defined.

in DataExtension at line 129
updateCMSFields(FieldList $fields)

This function is used to provide modifications to the form in the CMS by the extension. By default, no changes are made. {@link DataObject->getCMSFields()}.

Please consider using {@link updateFormFields()} to globally add formfields to the record. The method {@link updateCMSFields()} should just be used to add or modify tabs, or fields which are specific to the CMS-context.

Caution: Use {@link FieldList->addFieldToTab()} to add fields.

Parameters

FieldList $fields FieldList with a contained TabSet

in DataExtension at line 140
updateFrontEndFields(FieldList $fields)

This function is used to provide modifications to the form used for front end forms. {@link DataObject->getFrontEndFields()}

Caution: Use {@link FieldList->push()} to add fields.

Parameters

FieldList $fields FieldList without TabSet nesting

in DataExtension at line 149
updateCMSActions(FieldList $actions)

This is used to provide modifications to the form actions used in the CMS. {@link DataObject->getCMSActions()}.

Parameters

FieldList $actions FieldList

in DataExtension at line 160
updateSummaryFields(array $fields)

this function is used to provide modifications to the summary fields in CMS by the extension By default, the summaryField() of its owner will merge more fields defined in the extension's $extra_fields['summary_fields']

Parameters

array $fields Array of field names

in DataExtension at line 180
updateFieldLabels(array $labels)

this function is used to provide modifications to the fields labels in CMS by the extension By default, the fieldLabels() of its owner will merge more fields defined in the extension's $extra_fields['field_labels']

Parameters

array $labels Array of field labels

at line 16
onBeforePublish(SiteTree $original)

Hook called before the page's {@link SiteTree::doPublish()} action is completed

Parameters

SiteTree $original &$original The current Live SiteTree record prior to publish

at line 24
onAfterPublish(SiteTree $original)

Hook called after the page's {@link SiteTree::doPublish()} action is completed

Parameters

SiteTree $original &$original The current Live SiteTree record prior to publish

at line 30
onBeforeUnpublish()

Hook called before the page's {@link SiteTree::doUnpublish()} action is completed

at line 37
onAfterUnpublish()

Hook called after the page's {@link SiteTree::doUnpublish()} action is completed

at line 49
boolean|null canAddChildren(Member $member)

Hook called to determine if a user may add children to this SiteTree object

Parameters

Member $member The member to check permission against, or the currently logged in user

Return Value

boolean|null Return false to deny rights, or null to yield to default

See also

SiteTree::canAddChildren()

at line 61
boolean|null canPublish(Member $member)

Hook called to determine if a user may publish this SiteTree object

Parameters

Member $member The member to check permission against, or the currently logged in user

Return Value

boolean|null Return false to deny rights, or null to yield to default

See also

SiteTree::canPublish()

Hook called to modify the $base url of this page, with a given $action, before {@link SiteTree::RelativeLink()} calls {@link Controller::join_links()} on the $base and $action

Parameters

string $base &$base The URL of this page relative to siteroot, not including the action
string|boolean $action &$action The action or subpage called on this page. (Legacy support) If this is true, then do not reduce the 'home' urlsegment to an empty link