IDiscoverableReferenceProvider
extends
IReferenceProvider
in
Tags
Table of Contents
Methods
- getCacheKey() : string|null
- Return a custom cache key to be used for caching the metadata This could be for example the current user id if the reference access permissions are different for each user
- getCachePrefix() : string
- Return true if the reference metadata can be globally cached
- getIconUrl() : string
- getId() : string
- getOrder() : int
- getTitle() : string
- jsonSerialize() : array<string|int, mixed>
- matchReference() : bool
- Validate that a given reference identifier matches the current provider
- resolveReference() : IReference|null
- Return a reference with its metadata for a given reference identifier
Methods
getCacheKey()
Return a custom cache key to be used for caching the metadata This could be for example the current user id if the reference access permissions are different for each user
public
getCacheKey(string $referenceId) : string|null
Should return null, if the cache is only related to the reference id and has no further dependency
Parameters
- $referenceId : string
Tags
Return values
string|nullgetCachePrefix()
Return true if the reference metadata can be globally cached
public
getCachePrefix(string $referenceId) : string
Parameters
- $referenceId : string
Tags
Return values
stringgetIconUrl()
public
getIconUrl() : string
Tags
Return values
string —url to an icon that can be displayed next to the reference provider title
getId()
public
getId() : string
Tags
Return values
string —Unique id that identifies the reference provider
getOrder()
public
getOrder() : int
Tags
Return values
int —Initial order for reference provider sorting
getTitle()
public
getTitle() : string
Tags
Return values
string —User facing title of the widget
jsonSerialize()
public
jsonSerialize() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed> —representation of the provider
matchReference()
Validate that a given reference identifier matches the current provider
public
matchReference(string $referenceText) : bool
Parameters
- $referenceText : string
Tags
Return values
boolresolveReference()
Return a reference with its metadata for a given reference identifier
public
resolveReference(string $referenceText) : IReference|null
Parameters
- $referenceText : string