EDS
extends DefaultRecord
in package
Model for EDS records.
Tags
Table of Contents
- $dbServiceManager : PluginManager
- Database service plugin manager
- $epubTypes : array<string|int, mixed>
- Document types that are treated as ePub links.
- $extraDetails : array<string|int, mixed>
- For storing extra data with record
- $fields : array<string|int, mixed>
- Raw data
- $highlight : bool
- Should we highlight fields in search results?
- $labels : array<string|int, mixed>
- Labels for the record
- $mainConfig : Config
- Main VuFind configuration
- $pdfTypes : array<string|int, mixed>
- Document types that are treated as PDF links.
- $ratingCache : array<string|int, mixed>
- Cache for rating data
- $recordConfig : Config
- Record-specific configuration
- $searchBackendIdentifier : string
- Used for identifying the search backend used to find the record
- $sourceIdentifier : string
- Used for identifying record source backend
- $tableManager : PluginManager
- Database table plugin manager
- $translator : TranslatorInterface
- Translator
- __construct() : mixed
- Constructor
- addLabel() : void
- Add a label for the record
- addOrUpdateRating() : void
- Add or update user's rating for the record.
- addTags() : void
- Add tags to the record.
- deleteTags() : void
- Remove tags from the record.
- getAccessLevel() : string
- Get the access level of the record.
- getAccessRestrictions() : array<string|int, mixed>
- Get access restriction notes for the record.
- getAllRecordLinks() : null|array<string|int, mixed>
- Get all record links related to the current record. Each link is returned as array.
- getAllSubjectHeadings() : array<string|int, mixed>
- Get all subject headings associated with this record. Each heading is returned as an array of chunks, increasing from least specific to most specific.
- getAuthorDataFields() : array<string|int, mixed>
- Get Author Information with Associated Data Fields
- getAwards() : array<string|int, mixed>
- Get award notes for the record.
- getBibliographyNotes() : array<string|int, mixed>
- Get notes on bibliography content.
- getBreadcrumb() : string
- Get text that can be displayed to represent this record in breadcrumbs.
- getBuildings() : array<string|int, mixed>
- Get the buildings containing the record.
- getCallNumber() : string
- Get the first call number associated with the record (empty string if none).
- getCallNumbers() : array<string|int, mixed>
- Get all call numbers associated with the record.
- getChildRecordCount() : int
- Get the number of child records belonging to this record
- getCitationFormats() : array<string|int, mixed>
- Get an array of supported, user-activated citation formats.
- getCleanDOI() : mixed
- Return the first valid DOI found in the record (false if none).
- getCleanISBN() : mixed
- Return the first valid ISBN found in the record (favoring ISBN-10 over ISBN-13 when possible).
- getCleanISBNs() : array<string|int, mixed>
- Return all ISBNs found in the record.
- getCleanISMN() : mixed
- Get just the base portion of the first listed ISMN (or false if no ISSMs).
- getCleanISSN() : mixed
- Get just the base portion of the first listed ISSN (or false if no ISSNs).
- getCleanNBN() : mixed
- Get just the first listed national bibliography number (or false if none available).
- getCleanOCLCNum() : mixed
- Get just the first listed OCLC Number (or false if none available).
- getCleanUPC() : mixed
- Get just the first listed UPC Number (or false if none available).
- getCleanUuid() : mixed
- Get just the first listed UUID (Universally unique identifier), or false if none available.
- getCoinsOpenUrl() : string
- Get the OpenURL parameters to represent this record for COinS even if supportsOpenUrl() is false for this RecordDriver.
- getComments() : array<string|int, mixed>
- Get comments associated with this record.
- getContainerEndPage() : string
- Get the end page of the item that contains this record.
- getContainerIssue() : string
- Get issue of containing record
- getContainerRecordID() : string
- Get the container record id.
- getContainerReference() : string
- Get a full, free-form reference to the context of the item that contains this record (i.e. volume, year, issue, pages).
- getContainerStartPage() : string
- Get year of containing record
- getContainerTitle() : string
- Get title of containing record
- getContainerVolume() : string
- Get volume of containing record
- getContainingCollections() : array<string|int, mixed>
- Get an associative array (id => title) of collections containing this record.
- getContainingLists() : array<string|int, mixed>
- Get a list of lists containing this record.
- getCoordinateLabels() : array<string|int, mixed>
- Get the map display (lat/lon) labels
- getCorporateAuthors() : array<string|int, mixed>
- Get the main corporate authors (if any) for the record.
- getCorporateAuthorsRoles() : array<string|int, mixed>
- Get an array of all main corporate authors roles.
- getCustomLinks() : array<string|int, mixed>
- Get the custom links of the record.
- getDateSpan() : array<string|int, mixed>
- Get the date coverage for a record which spans a period of time (i.e. a journal). Use getPublicationDates for publication dates of particular monographic items.
- getDbLabel() : string
- Get the database label of the record.
- getDbService() : T
- Get a database service object.
- getDbServiceManager() : PluginManager
- Get the service plugin manager. Throw an exception if it is missing.
- getDbTable() : Gateway
- Get a database table object.
- getDbTableManager() : PluginManager
- Get the table plugin manager. Throw an exception if it is missing.
- getDedupData() : array<string|int, mixed>
- Get information on records deduplicated with this one
- getDeduplicatedAuthors() : array<string|int, mixed>
- Deduplicate author information into associative array with main/corporate/ secondary keys.
- getDisplayCoordinates() : array<string|int, mixed>
- Get the map display (lat/lon) coordinates
- getEbookLink() : string
- Get the ebook url of the record. If missing, return false
- getEdition() : string
- Get the edition of the current record.
- getEpubLink() : string
- Get the ePub url of the record. If missing, return false
- getExtraDetail() : mixed
- Retrieve a piece of supplemental information stored using setExtraDetail().
- getFindingAids() : array<string|int, mixed>
- Get notes on finding aids related to the record.
- getFormats() : array<string|int, mixed>
- Returns an array of formats based on publication type.
- getFTCustomLinks() : array<string|int, mixed>
- Get the full text custom links of the record.
- getGeneralNotes() : array<string|int, mixed>
- Get general notes on the record.
- getGeoLocation() : array<string|int, mixed>
- Get the bbox-geo variable.
- getHierarchicalPlaceNames() : array<string|int, mixed>
- Get hierarchical place names
- getHierarchyTopID() : array<string|int, mixed>
- Get the hierarchy_top_id(s) associated with this item (empty if none).
- getHierarchyTopTitle() : array<string|int, mixed>
- Get the absolute parent title(s) associated with this item (empty if none).
- getHierarchyTrees() : mixed
- Get a list of hierarchy trees containing this record.
- getHierarchyType() : string|bool
- Get the Hierarchy Type (false if none)
- getHighlightedSnippet() : mixed
- Pick one line from the highlighted text (if any) to use as a snippet.
- getHighlightedTitle() : string
- Get a highlighted title string, if available.
- getHTMLFullText() : string
- Get the full text of the record.
- getHumanReadablePublicationDates() : array<string|int, mixed>
- Get human readable publication dates for display purposes (may not be suitable for computer processing -- use getPublicationDates() for that).
- getInstitutions() : array<string|int, mixed>
- Get the institutions holding the record.
- getISBNs() : array<string|int, mixed>
- Get an array of ISBNs
- getISSNs() : array<string|int, mixed>
- Get ISSNs (of containing record)
- getItems() : array<string|int, mixed>
- Get the items of the record.
- getItemsAbstract() : string
- Get the abstract (summary) of the record.
- getItemsAuthors() : string
- Get the authors of the record
- getItemsSubjects() : string
- Get the subject data of the record.
- getItemsTitle() : string
- Get the title of the record.
- getItemsTitleSource() : string
- Get the source of the record.
- getLabels() : array<string|int, mixed>
- Return all labels for the record
- getLanguages() : array<string|int, mixed>
- Get record languages
- getLastIndexed() : string
- Get a string representing the last date that the record was indexed.
- getLCCN() : string
- Get a LCCN, normalised according to info:lccn
- getLinkedFullTextLink() : string
- Get the linked full text url of the record. If missing, return false
- getListNotes() : array<string|int, mixed>
- Get notes associated with this record in user lists.
- getNewerTitles() : array<string|int, mixed>
- Get an array of newer titles for the record.
- getOCLC() : array<string|int, mixed>
- Get the OCLC number(s) of the record.
- getOpenUrl() : string
- Get the OpenURL parameters to represent this record (useful for the title attribute of a COinS span tag).
- getPdfLink() : string
- Get the PDF url of the record. If missing, return false
- getPhysicalDescriptions() : array<string|int, mixed>
- Get an array of physical descriptions of the item.
- getPlacesOfPublication() : array<string|int, mixed>
- Get the item's place of publication.
- getPlayingTimes() : array<string|int, mixed>
- Get an array of playing times for the record (if applicable).
- getPLink() : string
- Get the full text url of the record.
- getPreviousTitles() : array<string|int, mixed>
- Get an array of previous titles for the record.
- getPrimaryAuthor() : string
- Get the main author of the record.
- getPrimaryAuthors() : array<string|int, mixed>
- Obtain the authors from a record from the RecordInfo section
- getPrimaryAuthorsRoles() : array<string|int, mixed>
- Get an array of all main authors roles (complementing getSecondaryAuthorsRoles()).
- getPrimaryAuthorsWithHighlighting() : array<string|int, mixed>
- Get primary author information with highlights applied (if applicable)
- getProductionCredits() : array<string|int, mixed>
- Get credits of people involved in production of the item.
- getPublicationDates() : array<string|int, mixed>
- Get the publication dates of the record. See also getDateSpan().
- getPublicationDetails() : array<string|int, mixed>
- Get an array of publication detail lines combining information from getPublicationDates(), getPublishers() and getPlacesOfPublication().
- getPublicationFrequency() : array<string|int, mixed>
- Get an array of publication frequency information.
- getPublishers() : array<string|int, mixed>
- Get the publishers of the record.
- getPubType() : string
- Get the publication type of the record.
- getPubTypeId() : string
- Get the publication type id of the record.
- getRatingBreakdown() : array<string|int, mixed>
- Get rating breakdown for this record.
- getRatingData() : array<string|int, mixed>
- Get rating information for this record.
- getRawAuthorHighlights() : array<string|int, mixed>
- Get highlighted author data, if available.
- getRawData() : mixed
- Retrieve raw data from object (primarily for use in staff view and autocomplete; avoid using whenever possible).
- getRealTimeHistory() : array<string|int, mixed>
- Get an array of information about record history, obtained in real-time from the ILS.
- getRealTimeHoldings() : array<string|int, mixed>
- Get an array of information about record holdings, obtained in real-time from the ILS.
- getRelationshipNotes() : array<string|int, mixed>
- Get an array of strings describing relationships to other items.
- getSchemaOrgFormats() : string
- Get schema.org type mapping, expected to be a space-delimited string of sub-types of http://schema.org/CreativeWork, defaulting to CreativeWork itself if nothing else matches.
- getSchemaOrgFormatsArray() : array<string|int, mixed>
- Get schema.org type mapping, an array of sub-types of http://schema.org/CreativeWork, defaulting to CreativeWork itself if nothing else matches.
- getSearchBackendIdentifier() : string
- Return the search backend identifier used to find the record.
- getSecondaryAuthors() : array<string|int, mixed>
- Get an array of all secondary authors (complementing getPrimaryAuthors()).
- getSecondaryAuthorsRoles() : array<string|int, mixed>
- Get an array of all secondary authors roles (complementing getPrimaryAuthorsRoles()).
- getSeries() : array<string|int, mixed>
- Get an array of all series names containing the record. Array entries may be either the name string, or an associative array with 'name' and 'number' keys.
- getShortTitle() : string
- Get the short (pre-subtitle) title of the record.
- getSnippetCaption() : mixed
- Given a field name, return an appropriate caption.
- getSortTitle() : string
- Get a sortable title for the record (i.e. no leading articles).
- getSource() : string
- Get the item's source.
- getSourceIdentifier() : string
- Return the source backend identifier.
- getSubtitle() : string
- Get the subtitle (if any) of the record.
- getSummary() : array<string|int, mixed>
- Get an array of summary strings for the record.
- getSystemDetails() : array<string|int, mixed>
- Get an array of technical details on the item represented by the record.
- getTags() : array<string|int, mixed>
- Get tags associated with this record.
- getTargetAudienceNotes() : array<string|int, mixed>
- Get an array of note about the record's target audience.
- getThumbnail() : string
- Return a URL to a thumbnail preview of the record, if available; false otherwise.
- getTitle() : string
- Obtain the title of the record from the record info section
- getTitleSection() : string
- Get the text of the part/section portion of the title.
- getTitleStatement() : string
- Get the statement of responsibility that goes with the title (i.e. "by John Smith").
- getTOC() : array<string|int, mixed>
- Get an array of lines from the table of contents.
- getTranslator() : TranslatorInterface
- Get translator object.
- getTranslatorLocale() : string
- Get the locale from the translator.
- getUniqueID() : string
- Return the unique identifier of this record within the Solr index; useful for retrieving additional information (like tags and user comments) from the external MySQL database.
- getUPC() : array<string|int, mixed>
- Get the UPC number(s) of the record.
- getURLs() : array<string|int, mixed>
- Return an array of associative URL arrays with one or more of the following keys:
- getUuids() : array<string|int, mixed>
- Get UUIDs (Universally unique identifier). These are commonly used in, for example, digital library or repository systems and can be a useful match point with third party systems.
- getXML() : mixed
- Return an XML representation of the record using the specified format.
- hasEpubAvailable() : bool
- Get the ePub availability of the record.
- hasHTMLFullTextAvailable() : bool
- Get the full text availability of the record.
- hasLinkedFullTextAvailable() : bool
- Get the linked full text availability of the record.
- hasPdfAvailable() : bool
- Get the PDF availability of the record.
- isCollection() : bool
- Get the value of whether or not this is a collection level record
- isRatingAllowed() : bool
- Check if rating the record is allowed.
- linkUrls() : string
- Performs a regex and replaces any url's with links containing themselves as the text. Also replaces link elements with anchors.
- setDbServiceManager() : void
- Set the service plugin manager.
- setDbTableManager() : void
- Set the table plugin manager.
- setExtraDetail() : void
- Store a piece of supplemental information in the record driver.
- setLabels() : void
- Set the labels for the record
- setRawData() : void
- Set raw data to initialize the object.
- setSourceIdentifier() : void
- Set the record source backend identifier.
- setSourceIdentifiers() : void
- Set the source backend identifiers.
- setTranslator() : TranslatorAwareInterface
- Set a translator
- supportsAjaxStatus() : bool
- Returns true if the record supports real-time AJAX status lookups.
- supportsCoinsOpenUrl() : bool
- Checks the current record if it's supported for generating COinS-OpenURLs.
- supportsOpenUrl() : bool
- Checks the current record if it's supported for generating OpenURLs.
- translate() : string
- Translate a string (or string-castable object)
- translateWithPrefix() : string
- Translate a string (or string-castable object) using a prefix, or without the prefix if a prefixed translation is not found.
- tryMethod() : mixed
- Try to call the requested method and return null if it is unavailable; this is useful for checking for the existence of get methods for particular types of data without causing fatal errors.
- extractEbscoData() : array<string|int, mixed>
- Extract data from EBSCO API response using a prioritized list of selectors.
- extractEbscoDataFromItems() : array<string|int, mixed>
- Extract data from the record's "Items" array, based on a label.
- extractEbscoDataFromRecordInfo() : array<string|int, mixed>
- Extract data from the record's "RecordInfo" array, based on a path.
- extractTextDomain() : array<string|int, mixed>
- Given a translation string with or without a text domain, return an array with the raw string and the text domain separated.
- getArticleOpenUrlParams() : array<string|int, mixed>
- Get OpenURL parameters for an article.
- getBookOpenUrlParams() : array<string|int, mixed>
- Get OpenURL parameters for a book.
- getCoinsID() : string
- Get the COinS identifier.
- getDebugTranslation() : string
- Build a debug-mode translation
- getDefaultOpenUrlParams() : array<string|int, mixed>
- Get default OpenURL parameters.
- getFilteredIdentifiers() : array<string|int, mixed>
- Retrieve identifiers from the EBSCO record and retrieve values filtered by type.
- getFilteredNumbering() : string
- Extract numbering data of a particular type.
- getItemsAuthorsArray() : array<string|int, mixed>
- Obtain an array or authors indicated on the record
- getJournalOpenUrlParams() : array<string|int, mixed>
- Get OpenURL parameters for a journal.
- getOpenUrlFormat() : string
- Support method for getOpenUrl() -- pick the OpenURL format.
- getRawEDSPublicationDetails() : array<string|int, mixed>
- Attempt to build up publication details from raw EDS data.
- getRawLCCN() : string
- Get a raw, unnormalized LCCN. (See getLCCN for normalization).
- getSupportedCitationFormats() : array<string|int, mixed>
- Get an array of strings representing citation formats supported by this record's data (empty if none). For possible legal values, see /application/themes/root/helpers/Citation.php.
- getUnknownFormatOpenUrlParams() : array<string|int, mixed>
- Get OpenURL parameters for an unknown format.
- hasEbookAvailable() : bool
- Get the ebook availability of the record.
- itemIsExcluded() : bool
- Support method for getItems, used to apply filters.
- recurseIntoRecordInfo() : array<string|int, mixed>
- Recursive support method for extractEbscoDataFromRecordInfo().
- replaceBRWithCommas() : string
- Replace <br> tags that are embedded in data to commas
- sanitizeTranslationKey() : string
- Make sure there are not any illegal characters in the translation key that might prevent successful lookup in language files.
- toHTML() : string
- Parse a SimpleXml element and return it's inner XML as an HTML string
- translateString() : string
- Get translation for a string
Properties
$dbServiceManager
Database service plugin manager
protected
PluginManager
$dbServiceManager
$epubTypes
Document types that are treated as ePub links.
protected
array<string|int, mixed>
$epubTypes
= ['ebook-epub']
$extraDetails
For storing extra data with record
protected
array<string|int, mixed>
$extraDetails
= []
$fields
Raw data
protected
array<string|int, mixed>
$fields
= []
$highlight
Should we highlight fields in search results?
protected
bool
$highlight
= false
$labels
Labels for the record
protected
array<string|int, mixed>
$labels
= []
$mainConfig
Main VuFind configuration
protected
Config
$mainConfig
$pdfTypes
Document types that are treated as PDF links.
protected
array<string|int, mixed>
$pdfTypes
= ['ebook-pdf', 'pdflink']
$ratingCache
Cache for rating data
protected
array<string|int, mixed>
$ratingCache
= []
$recordConfig
Record-specific configuration
protected
Config
$recordConfig
$searchBackendIdentifier
Used for identifying the search backend used to find the record
protected
string
$searchBackendIdentifier
= ''
$sourceIdentifier
Used for identifying record source backend
protected
string
$sourceIdentifier
= ''
$tableManager
Database table plugin manager
protected
PluginManager
$tableManager
$translator
Translator
protected
TranslatorInterface
$translator
= null
Methods
__construct()
Constructor
public
__construct([Config $mainConfig = null ][, Config $recordConfig = null ]) : mixed
Parameters
- $mainConfig : Config = null
-
VuFind main configuration (omit for built-in defaults)
- $recordConfig : Config = null
-
Record-specific configuration file (omit to use $mainConfig as $recordConfig)
Return values
mixed —addLabel()
Add a label for the record
public
addLabel(string $label, string $class) : void
Parameters
- $label : string
-
Label, may be a translation key
- $class : string
-
Label class
Return values
void —addOrUpdateRating()
Add or update user's rating for the record.
public
addOrUpdateRating(int $userId, int|null $rating) : void
Parameters
- $userId : int
-
ID of the user posting the rating
- $rating : int|null
-
The user-provided rating, or null to clear any existing rating
Tags
Return values
void —addTags()
Add tags to the record.
public
addTags(UserEntityInterface $user, array<string|int, mixed> $tags) : void
Parameters
- $user : UserEntityInterface
-
The user posting the tag
- $tags : array<string|int, mixed>
-
The user-provided tags
Tags
Return values
void —deleteTags()
Remove tags from the record.
public
deleteTags(UserEntityInterface $user, array<string|int, mixed> $tags) : void
Parameters
- $user : UserEntityInterface
-
The user posting the tag
- $tags : array<string|int, mixed>
-
The user-provided tags
Tags
Return values
void —getAccessLevel()
Get the access level of the record.
public
getAccessLevel() : string
Return values
string —If not empty, will contain a numerical value corresponding to these levels of access: 0 - Not Available to search via Guest Access 1 - Metadata is searched, but only a placeholder record is displayed 2 - Display record in the results but no access to detailed record or full text 3 - Full access: search/display all content to guests 6 - Display full record but no access to full text
getAccessRestrictions()
Get access restriction notes for the record.
public
getAccessRestrictions() : array<string|int, mixed>
Return values
array<string|int, mixed> —getAllRecordLinks()
Get all record links related to the current record. Each link is returned as array.
public
getAllRecordLinks() : null|array<string|int, mixed>
NB: to use this method you must override it.
Format:
array(
array(
'title' => label_for_title
'value' => link_name
'link' => link_URI
),
...
)
Return values
null|array<string|int, mixed> —getAllSubjectHeadings()
Get all subject headings associated with this record. Each heading is returned as an array of chunks, increasing from least specific to most specific.
public
getAllSubjectHeadings([bool $extended = false ]) : array<string|int, mixed>
Parameters
- $extended : bool = false
-
Whether to return a keyed array with the following keys:
- heading: the actual subject heading chunks
- type: heading type
- source: source vocabulary
Return values
array<string|int, mixed> —getAuthorDataFields()
Get Author Information with Associated Data Fields
public
getAuthorDataFields(string $index[, array<string|int, mixed> $dataFields = [] ]) : array<string|int, mixed>
Parameters
- $index : string
-
The author index [primary, corporate, or secondary] used to construct a method name for retrieving author data (e.g. getPrimaryAuthors).
- $dataFields : array<string|int, mixed> = []
-
An array of fields to used to construct method names for retrieving author-related data (e.g., if you pass 'role' the data method will be similar to getPrimaryAuthorsRoles). This value will also be used as a key associated with each author in the resulting data array.
Return values
array<string|int, mixed> —getAwards()
Get award notes for the record.
public
getAwards() : array<string|int, mixed>
Return values
array<string|int, mixed> —getBibliographyNotes()
Get notes on bibliography content.
public
getBibliographyNotes() : array<string|int, mixed>
Return values
array<string|int, mixed> —getBreadcrumb()
Get text that can be displayed to represent this record in breadcrumbs.
public
abstract getBreadcrumb() : string
Return values
string —Breadcrumb text to represent this record.
getBuildings()
Get the buildings containing the record.
public
getBuildings() : array<string|int, mixed>
Return values
array<string|int, mixed> —getCallNumber()
Get the first call number associated with the record (empty string if none).
public
getCallNumber() : string
Return values
string —getCallNumbers()
Get all call numbers associated with the record.
public
getCallNumbers() : array<string|int, mixed>
Return values
array<string|int, mixed> —getChildRecordCount()
Get the number of child records belonging to this record
public
getChildRecordCount() : int
Return values
int —Number of records
getCitationFormats()
Get an array of supported, user-activated citation formats.
public
getCitationFormats() : array<string|int, mixed>
Return values
array<string|int, mixed> —Strings representing citation formats.
getCleanDOI()
Return the first valid DOI found in the record (false if none).
public
getCleanDOI() : mixed
Return values
mixed —getCleanISBN()
Return the first valid ISBN found in the record (favoring ISBN-10 over ISBN-13 when possible).
public
getCleanISBN() : mixed
Return values
mixed —getCleanISBNs()
Return all ISBNs found in the record.
public
getCleanISBNs([string $mode = 'prefer10' ][, bool $filterInvalid = true ]) : array<string|int, mixed>
Parameters
- $mode : string = 'prefer10'
-
Mode for returning ISBNs:
- 'only10' returns only ISBN-10s
- 'prefer10' returns ISBN-10s if available, otherwise ISBN-13s (default)
- 'normalize13' returns ISBN-13s, normalizing ISBN-10s to ISBN-13s
- $filterInvalid : bool = true
-
Whether to filter out invalid ISBNs
Return values
array<string|int, mixed> —getCleanISMN()
Get just the base portion of the first listed ISMN (or false if no ISSMs).
public
getCleanISMN() : mixed
Return values
mixed —getCleanISSN()
Get just the base portion of the first listed ISSN (or false if no ISSNs).
public
getCleanISSN() : mixed
Return values
mixed —getCleanNBN()
Get just the first listed national bibliography number (or false if none available).
public
getCleanNBN() : mixed
Return values
mixed —getCleanOCLCNum()
Get just the first listed OCLC Number (or false if none available).
public
getCleanOCLCNum() : mixed
Return values
mixed —getCleanUPC()
Get just the first listed UPC Number (or false if none available).
public
getCleanUPC() : mixed
Return values
mixed —getCleanUuid()
Get just the first listed UUID (Universally unique identifier), or false if none available.
public
getCleanUuid() : mixed
Return values
mixed —getCoinsOpenUrl()
Get the OpenURL parameters to represent this record for COinS even if supportsOpenUrl() is false for this RecordDriver.
public
getCoinsOpenUrl() : string
Return values
string —OpenURL parameters.
getComments()
Get comments associated with this record.
public
getComments() : array<string|int, mixed>
Tags
Return values
array<string|int, mixed> —getContainerEndPage()
Get the end page of the item that contains this record.
public
getContainerEndPage() : string
Return values
string —getContainerIssue()
Get issue of containing record
public
getContainerIssue() : string
Return values
string —getContainerRecordID()
Get the container record id.
public
getContainerRecordID() : string
Return values
string —Container record id (empty string if none)
getContainerReference()
Get a full, free-form reference to the context of the item that contains this record (i.e. volume, year, issue, pages).
public
getContainerReference() : string
Return values
string —getContainerStartPage()
Get year of containing record
public
getContainerStartPage() : string
Return values
string —getContainerTitle()
Get title of containing record
public
getContainerTitle() : string
Return values
string —getContainerVolume()
Get volume of containing record
public
getContainerVolume() : string
Return values
string —getContainingCollections()
Get an associative array (id => title) of collections containing this record.
public
getContainingCollections() : array<string|int, mixed>
Return values
array<string|int, mixed> —getContainingLists()
Get a list of lists containing this record.
public
getContainingLists([int $user_id = null ]) : array<string|int, mixed>
Parameters
- $user_id : int = null
-
ID of user to load tags from (null for all users)
Tags
Return values
array<string|int, mixed> —getCoordinateLabels()
Get the map display (lat/lon) labels
public
getCoordinateLabels() : array<string|int, mixed>
Return values
array<string|int, mixed> —getCorporateAuthors()
Get the main corporate authors (if any) for the record.
public
getCorporateAuthors() : array<string|int, mixed>
Return values
array<string|int, mixed> —getCorporateAuthorsRoles()
Get an array of all main corporate authors roles.
public
getCorporateAuthorsRoles() : array<string|int, mixed>
Return values
array<string|int, mixed> —getCustomLinks()
Get the custom links of the record.
public
getCustomLinks() : array<string|int, mixed>
Return values
array<string|int, mixed> —getDateSpan()
Get the date coverage for a record which spans a period of time (i.e. a journal). Use getPublicationDates for publication dates of particular monographic items.
public
getDateSpan() : array<string|int, mixed>
Return values
array<string|int, mixed> —getDbLabel()
Get the database label of the record.
public
getDbLabel() : string
Return values
string —getDbService()
Get a database service object.
public
getDbService(class-string<\VuFind\Db\Service\T> $name) : T
Parameters
- $name : class-string<\VuFind\Db\Service\T>
-
Name of service to retrieve
Tags
Return values
T —getDbServiceManager()
Get the service plugin manager. Throw an exception if it is missing.
public
getDbServiceManager() : PluginManager
Tags
Return values
PluginManager —getDbTable()
Get a database table object.
public
getDbTable(string $table) : Gateway
Parameters
- $table : string
-
Table to load.
Return values
Gateway —getDbTableManager()
Get the table plugin manager. Throw an exception if it is missing.
public
getDbTableManager() : PluginManager
Tags
Return values
PluginManager —getDedupData()
Get information on records deduplicated with this one
public
getDedupData() : array<string|int, mixed>
Return values
array<string|int, mixed> —Array keyed by source id containing record id
getDeduplicatedAuthors()
Deduplicate author information into associative array with main/corporate/ secondary keys.
public
getDeduplicatedAuthors([array<string|int, mixed> $dataFields = ['role'] ]) : array<string|int, mixed>
Parameters
- $dataFields : array<string|int, mixed> = ['role']
-
An array of extra data fields to retrieve (see getAuthorDataFields)
Return values
array<string|int, mixed> —getDisplayCoordinates()
Get the map display (lat/lon) coordinates
public
getDisplayCoordinates() : array<string|int, mixed>
Return values
array<string|int, mixed> —getEbookLink()
Get the ebook url of the record. If missing, return false
public
getEbookLink(array<string|int, mixed> $types) : string
Parameters
- $types : array<string|int, mixed>
-
Types that we are interested in checking for
Return values
string —getEdition()
Get the edition of the current record.
public
getEdition() : string
Return values
string —getEpubLink()
Get the ePub url of the record. If missing, return false
public
getEpubLink() : string
Return values
string —getExtraDetail()
Retrieve a piece of supplemental information stored using setExtraDetail().
public
getExtraDetail(string $key) : mixed
Parameters
- $key : string
-
Name of stored information
Return values
mixed —getFindingAids()
Get notes on finding aids related to the record.
public
getFindingAids() : array<string|int, mixed>
Return values
array<string|int, mixed> —getFormats()
Returns an array of formats based on publication type.
public
getFormats() : array<string|int, mixed>
Return values
array<string|int, mixed> —getFTCustomLinks()
Get the full text custom links of the record.
public
getFTCustomLinks() : array<string|int, mixed>
Return values
array<string|int, mixed> —getGeneralNotes()
Get general notes on the record.
public
getGeneralNotes() : array<string|int, mixed>
Return values
array<string|int, mixed> —getGeoLocation()
Get the bbox-geo variable.
public
getGeoLocation() : array<string|int, mixed>
Return values
array<string|int, mixed> —getHierarchicalPlaceNames()
Get hierarchical place names
public
getHierarchicalPlaceNames() : array<string|int, mixed>
Return values
array<string|int, mixed> —getHierarchyTopID()
Get the hierarchy_top_id(s) associated with this item (empty if none).
public
getHierarchyTopID() : array<string|int, mixed>
Return values
array<string|int, mixed> —getHierarchyTopTitle()
Get the absolute parent title(s) associated with this item (empty if none).
public
getHierarchyTopTitle() : array<string|int, mixed>
Return values
array<string|int, mixed> —getHierarchyTrees()
Get a list of hierarchy trees containing this record.
public
getHierarchyTrees([string $hierarchyID = false ]) : mixed
Parameters
- $hierarchyID : string = false
-
The hierarchy to get the tree for
Tags
Return values
mixed —An associative array of hierarchy trees on success (id => title), false if no hierarchies found
getHierarchyType()
Get the Hierarchy Type (false if none)
public
getHierarchyType() : string|bool
Return values
string|bool —getHighlightedSnippet()
Pick one line from the highlighted text (if any) to use as a snippet.
public
getHighlightedSnippet() : mixed
Return values
mixed —False if no snippet found, otherwise associative array with 'snippet' and 'caption' keys.
getHighlightedTitle()
Get a highlighted title string, if available.
public
getHighlightedTitle() : string
Return values
string —getHTMLFullText()
Get the full text of the record.
public
getHTMLFullText() : string
Return values
string —getHumanReadablePublicationDates()
Get human readable publication dates for display purposes (may not be suitable for computer processing -- use getPublicationDates() for that).
public
getHumanReadablePublicationDates() : array<string|int, mixed>
Return values
array<string|int, mixed> —getInstitutions()
Get the institutions holding the record.
public
getInstitutions() : array<string|int, mixed>
Return values
array<string|int, mixed> —getISBNs()
Get an array of ISBNs
public
getISBNs() : array<string|int, mixed>
Return values
array<string|int, mixed> —getISSNs()
Get ISSNs (of containing record)
public
getISSNs() : array<string|int, mixed>
Return values
array<string|int, mixed> —getItems()
Get the items of the record.
public
getItems([string $context = null ][, string $labelFilter = null ][, string $groupFilter = null ][, string $nameFilter = null ]) : array<string|int, mixed>
Parameters
- $context : string = null
-
The context in which items are being retrieved (used for context-sensitive filtering)
- $labelFilter : string = null
-
A specific label to retrieve (filter out others; null for no filter)
- $groupFilter : string = null
-
A specific group to retrieve (filter out others; null for no filter)
- $nameFilter : string = null
-
A specific name to retrieve (filter out others; null for no filter)
Return values
array<string|int, mixed> —getItemsAbstract()
Get the abstract (summary) of the record.
public
getItemsAbstract() : string
Return values
string —getItemsAuthors()
Get the authors of the record
public
getItemsAuthors() : string
Return values
string —getItemsSubjects()
Get the subject data of the record.
public
getItemsSubjects() : string
Return values
string —getItemsTitle()
Get the title of the record.
public
getItemsTitle() : string
Return values
string —getItemsTitleSource()
Get the source of the record.
public
getItemsTitleSource() : string
Return values
string —getLabels()
Return all labels for the record
public
getLabels() : array<string|int, mixed>
Return values
array<string|int, mixed> —An array of associative arrays with keys 'label' and 'class'
getLanguages()
Get record languages
public
getLanguages() : array<string|int, mixed>
Return values
array<string|int, mixed> —getLastIndexed()
Get a string representing the last date that the record was indexed.
public
getLastIndexed() : string
Return values
string —getLCCN()
Get a LCCN, normalised according to info:lccn
public
getLCCN() : string
Return values
string —getLinkedFullTextLink()
Get the linked full text url of the record. If missing, return false
public
getLinkedFullTextLink() : string
Return values
string —getListNotes()
Get notes associated with this record in user lists.
public
getListNotes([int $list_id = null ][, int $user_id = null ]) : array<string|int, mixed>
Parameters
- $list_id : int = null
-
ID of list to load tags from (null for all lists)
- $user_id : int = null
-
ID of user to load tags from (null for all users)
Tags
Return values
array<string|int, mixed> —getNewerTitles()
Get an array of newer titles for the record.
public
getNewerTitles() : array<string|int, mixed>
Return values
array<string|int, mixed> —getOCLC()
Get the OCLC number(s) of the record.
public
getOCLC() : array<string|int, mixed>
Return values
array<string|int, mixed> —getOpenUrl()
Get the OpenURL parameters to represent this record (useful for the title attribute of a COinS span tag).
public
getOpenUrl([bool $overrideSupportsOpenUrl = false ]) : string
Parameters
- $overrideSupportsOpenUrl : bool = false
-
Flag to override checking supportsOpenUrl() (default is false)
Return values
string —OpenURL parameters.
getPdfLink()
Get the PDF url of the record. If missing, return false
public
getPdfLink() : string
Return values
string —getPhysicalDescriptions()
Get an array of physical descriptions of the item.
public
getPhysicalDescriptions() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPlacesOfPublication()
Get the item's place of publication.
public
getPlacesOfPublication() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPlayingTimes()
Get an array of playing times for the record (if applicable).
public
getPlayingTimes() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPLink()
Get the full text url of the record.
public
getPLink() : string
Return values
string —getPreviousTitles()
Get an array of previous titles for the record.
public
getPreviousTitles() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPrimaryAuthor()
Get the main author of the record.
public
getPrimaryAuthor() : string
Return values
string —getPrimaryAuthors()
Obtain the authors from a record from the RecordInfo section
public
getPrimaryAuthors() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPrimaryAuthorsRoles()
Get an array of all main authors roles (complementing getSecondaryAuthorsRoles()).
public
getPrimaryAuthorsRoles() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPrimaryAuthorsWithHighlighting()
Get primary author information with highlights applied (if applicable)
public
getPrimaryAuthorsWithHighlighting() : array<string|int, mixed>
Return values
array<string|int, mixed> —getProductionCredits()
Get credits of people involved in production of the item.
public
getProductionCredits() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPublicationDates()
Get the publication dates of the record. See also getDateSpan().
public
getPublicationDates() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPublicationDetails()
Get an array of publication detail lines combining information from getPublicationDates(), getPublishers() and getPlacesOfPublication().
public
getPublicationDetails() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPublicationFrequency()
Get an array of publication frequency information.
public
getPublicationFrequency() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPublishers()
Get the publishers of the record.
public
getPublishers() : array<string|int, mixed>
Return values
array<string|int, mixed> —getPubType()
Get the publication type of the record.
public
getPubType() : string
Return values
string —getPubTypeId()
Get the publication type id of the record.
public
getPubTypeId() : string
Return values
string —getRatingBreakdown()
Get rating breakdown for this record.
public
getRatingBreakdown(array<string|int, mixed> $groups) : array<string|int, mixed>
Returns an array with the following keys:
rating - average rating (0-100) count - count of ratings groups - grouped counts
Parameters
- $groups : array<string|int, mixed>
-
Group definition (key => [min, max])
Tags
Return values
array<string|int, mixed> —getRatingData()
Get rating information for this record.
public
getRatingData([int|null $userId = null ]) : array<string|int, mixed>
Returns an array with the following keys:
rating - average rating (0-100) count - count of ratings
Parameters
- $userId : int|null = null
-
User ID, or null for all users
Tags
Return values
array<string|int, mixed> —getRawAuthorHighlights()
Get highlighted author data, if available.
public
getRawAuthorHighlights() : array<string|int, mixed>
Return values
array<string|int, mixed> —getRawData()
Retrieve raw data from object (primarily for use in staff view and autocomplete; avoid using whenever possible).
public
getRawData() : mixed
Return values
mixed —getRealTimeHistory()
Get an array of information about record history, obtained in real-time from the ILS.
public
getRealTimeHistory() : array<string|int, mixed>
Return values
array<string|int, mixed> —getRealTimeHoldings()
Get an array of information about record holdings, obtained in real-time from the ILS.
public
getRealTimeHoldings() : array<string|int, mixed>
Return values
array<string|int, mixed> —getRelationshipNotes()
Get an array of strings describing relationships to other items.
public
getRelationshipNotes() : array<string|int, mixed>
Return values
array<string|int, mixed> —getSchemaOrgFormats()
Get schema.org type mapping, expected to be a space-delimited string of sub-types of http://schema.org/CreativeWork, defaulting to CreativeWork itself if nothing else matches.
public
getSchemaOrgFormats() : string
Tags
Return values
string —getSchemaOrgFormatsArray()
Get schema.org type mapping, an array of sub-types of http://schema.org/CreativeWork, defaulting to CreativeWork itself if nothing else matches.
public
getSchemaOrgFormatsArray() : array<string|int, mixed>
Return values
array<string|int, mixed> —getSearchBackendIdentifier()
Return the search backend identifier used to find the record.
public
getSearchBackendIdentifier() : string
Return values
string —getSecondaryAuthors()
Get an array of all secondary authors (complementing getPrimaryAuthors()).
public
getSecondaryAuthors() : array<string|int, mixed>
Return values
array<string|int, mixed> —getSecondaryAuthorsRoles()
Get an array of all secondary authors roles (complementing getPrimaryAuthorsRoles()).
public
getSecondaryAuthorsRoles() : array<string|int, mixed>
Return values
array<string|int, mixed> —getSeries()
Get an array of all series names containing the record. Array entries may be either the name string, or an associative array with 'name' and 'number' keys.
public
getSeries() : array<string|int, mixed>
Return values
array<string|int, mixed> —getShortTitle()
Get the short (pre-subtitle) title of the record.
public
getShortTitle() : string
Return values
string —getSnippetCaption()
Given a field name, return an appropriate caption.
public
getSnippetCaption(string $field) : mixed
Parameters
- $field : string
-
Field name
Tags
Return values
mixed —Caption if found, false if none available.
getSortTitle()
Get a sortable title for the record (i.e. no leading articles).
public
getSortTitle() : string
Return values
string —getSource()
Get the item's source.
public
getSource() : string
Return values
string —getSourceIdentifier()
Return the source backend identifier.
public
getSourceIdentifier() : string
Return values
string —getSubtitle()
Get the subtitle (if any) of the record.
public
getSubtitle() : string
Return values
string —getSummary()
Get an array of summary strings for the record.
public
getSummary() : array<string|int, mixed>
Return values
array<string|int, mixed> —getSystemDetails()
Get an array of technical details on the item represented by the record.
public
getSystemDetails() : array<string|int, mixed>
Return values
array<string|int, mixed> —getTags()
Get tags associated with this record.
public
getTags([int $list_id = null ][, int $user_id = null ][, string $sort = 'count' ][, int $ownerId = null ]) : array<string|int, mixed>
Parameters
- $list_id : int = null
-
ID of list to load tags from (null for all lists)
- $user_id : int = null
-
ID of user to load tags from (null for all users)
- $sort : string = 'count'
-
Sort type ('count' or 'tag')
- $ownerId : int = null
-
ID of user to check for ownership
Tags
Return values
array<string|int, mixed> —getTargetAudienceNotes()
Get an array of note about the record's target audience.
public
getTargetAudienceNotes() : array<string|int, mixed>
Return values
array<string|int, mixed> —getThumbnail()
Return a URL to a thumbnail preview of the record, if available; false otherwise.
public
getThumbnail([string $size = 'small' ]) : string
Parameters
- $size : string = 'small'
-
Size of thumbnail (small, medium or large -- small is default).
Return values
string —getTitle()
Obtain the title of the record from the record info section
public
getTitle() : string
Return values
string —getTitleSection()
Get the text of the part/section portion of the title.
public
getTitleSection() : string
Return values
string —getTitleStatement()
Get the statement of responsibility that goes with the title (i.e. "by John Smith").
public
getTitleStatement() : string
Return values
string —getTOC()
Get an array of lines from the table of contents.
public
getTOC() : array<string|int, mixed>
Return values
array<string|int, mixed> —getTranslator()
Get translator object.
public
getTranslator() : TranslatorInterface
Return values
TranslatorInterface —getTranslatorLocale()
Get the locale from the translator.
public
getTranslatorLocale([string $default = 'en' ]) : string
Parameters
- $default : string = 'en'
-
Default to use if translator absent.
Return values
string —getUniqueID()
Return the unique identifier of this record within the Solr index; useful for retrieving additional information (like tags and user comments) from the external MySQL database.
public
getUniqueID() : string
Return values
string —Unique identifier.
getUPC()
Get the UPC number(s) of the record.
public
getUPC() : array<string|int, mixed>
Return values
array<string|int, mixed> —getURLs()
Return an array of associative URL arrays with one or more of the following keys:
public
getURLs() : array<string|int, mixed>
- desc: URL description text to display (optional)
- url: fully-formed URL (required if 'route' is absent)
- route: VuFind route to build URL with (required if 'url' is absent)
- routeParams: Parameters for route (optional)
- queryString: Query params to append after building route (optional)
Return values
array<string|int, mixed> —getUuids()
Get UUIDs (Universally unique identifier). These are commonly used in, for example, digital library or repository systems and can be a useful match point with third party systems.
public
getUuids() : array<string|int, mixed>
Return values
array<string|int, mixed> —getXML()
Return an XML representation of the record using the specified format.
public
getXML(string $format[, string $baseUrl = null ][, RecordLinker $linker = null ]) : mixed
Return false if the format is unsupported.
Parameters
- $format : string
-
Name of format to use (corresponds with OAI-PMH metadataPrefix parameter).
- $baseUrl : string = null
-
Base URL of host containing VuFind (optional; may be used to inject record URLs into XML when appropriate).
- $linker : RecordLinker = null
-
Record linker helper (optional; may be used to inject record URLs into XML when appropriate).
Return values
mixed —XML, or false if format unsupported.
hasEpubAvailable()
Get the ePub availability of the record.
public
hasEpubAvailable() : bool
Return values
bool —hasHTMLFullTextAvailable()
Get the full text availability of the record.
public
hasHTMLFullTextAvailable() : bool
Return values
bool —hasLinkedFullTextAvailable()
Get the linked full text availability of the record.
public
hasLinkedFullTextAvailable() : bool
Return values
bool —hasPdfAvailable()
Get the PDF availability of the record.
public
hasPdfAvailable() : bool
Return values
bool —isCollection()
Get the value of whether or not this is a collection level record
public
isCollection() : bool
NOTE: \VuFind\Hierarchy\TreeDataFormatter\AbstractBase::isCollection() duplicates some of this logic.
Return values
bool —isRatingAllowed()
Check if rating the record is allowed.
public
isRatingAllowed() : bool
Return values
bool —linkUrls()
Performs a regex and replaces any url's with links containing themselves as the text. Also replaces link elements with anchors.
public
linkUrls(string $string) : string
Parameters
- $string : string
-
String to process
Return values
string —HTML string
setDbServiceManager()
Set the service plugin manager.
public
setDbServiceManager(PluginManager $manager) : void
Parameters
- $manager : PluginManager
-
Plugin manager
Return values
void —setDbTableManager()
Set the table plugin manager.
public
setDbTableManager(PluginManager $manager) : void
Parameters
- $manager : PluginManager
-
Plugin manager
Return values
void —setExtraDetail()
Store a piece of supplemental information in the record driver.
public
setExtraDetail(string $key, mixed $val) : void
Parameters
- $key : string
-
Name of stored information
- $val : mixed
-
Information to store
Return values
void —setLabels()
Set the labels for the record
public
setLabels(array<string|int, mixed> $labels) : void
Parameters
- $labels : array<string|int, mixed>
-
An array of associative arrays with keys 'label' and 'class'
Return values
void —setRawData()
Set raw data to initialize the object.
public
setRawData(mixed $data) : void
Parameters
- $data : mixed
-
Raw data representing the record; Record Model objects are normally constructed by Record Driver objects using data passed in from a Search Results object. The exact nature of the data may vary depending on the data source -- the important thing is that the Record Driver + Search Results objects work together correctly.
Return values
void —setSourceIdentifier()
Set the record source backend identifier.
public
setSourceIdentifier(string $identifier) : void
Parameters
- $identifier : string
-
Record source identifier
Tags
Return values
void —setSourceIdentifiers()
Set the source backend identifiers.
public
setSourceIdentifiers(string $recordSourceId[, string $searchBackendId = '' ]) : void
Parameters
- $recordSourceId : string
-
Record source identifier
- $searchBackendId : string = ''
-
Search backend identifier (if different from $recordSourceId)
Return values
void —setTranslator()
Set a translator
public
setTranslator(TranslatorInterface $translator) : TranslatorAwareInterface
Parameters
- $translator : TranslatorInterface
-
Translator
Return values
TranslatorAwareInterface —supportsAjaxStatus()
Returns true if the record supports real-time AJAX status lookups.
public
supportsAjaxStatus() : bool
Return values
bool —supportsCoinsOpenUrl()
Checks the current record if it's supported for generating COinS-OpenURLs.
public
supportsCoinsOpenUrl() : bool
Return values
bool —supportsOpenUrl()
Checks the current record if it's supported for generating OpenURLs.
public
supportsOpenUrl() : bool
Return values
bool —translate()
Translate a string (or string-castable object)
public
translate(string|object|array<string|int, mixed> $target[, array<string|int, mixed> $tokens = [] ][, string $default = null ][, bool $useIcuFormatter = false ][, array<string|int, string> $fallbackDomains = [] ]) : string
Parameters
- $target : string|object|array<string|int, mixed>
-
String to translate or an array of text domain and string to translate
- $tokens : array<string|int, mixed> = []
-
Tokens to inject into the translated string
- $default : string = null
-
Default value to use if no translation is found (null for no default).
- $useIcuFormatter : bool = false
-
Should we use an ICU message formatter instead of the default behavior?
- $fallbackDomains : array<string|int, string> = []
-
Text domains to check if no match is found in the domain specified in $target
Return values
string —translateWithPrefix()
Translate a string (or string-castable object) using a prefix, or without the prefix if a prefixed translation is not found.
public
translateWithPrefix(string $prefix, string|object|array<string|int, mixed> $target[, array<string|int, mixed> $tokens = [] ][, string $default = null ][, bool $useIcuFormatter = false ][, array<string|int, string> $fallbackDomains = [] ]) : string
Parameters
- $prefix : string
-
Translation key prefix
- $target : string|object|array<string|int, mixed>
-
String to translate or an array of text domain and string to translate
- $tokens : array<string|int, mixed> = []
-
Tokens to inject into the translated string
- $default : string = null
-
Default value to use if no translation is found (null for no default).
- $useIcuFormatter : bool = false
-
Should we use an ICU message formatter instead of the default behavior?
- $fallbackDomains : array<string|int, string> = []
-
Text domains to check if no match is found in the domain specified in $target
Return values
string —tryMethod()
Try to call the requested method and return null if it is unavailable; this is useful for checking for the existence of get methods for particular types of data without causing fatal errors.
public
tryMethod(string $method[, array<string|int, mixed> $params = [] ][, mixed $default = null ]) : mixed
Parameters
- $method : string
-
Name of method to call.
- $params : array<string|int, mixed> = []
-
Array of parameters to pass to method.
- $default : mixed = null
-
A default value to return if the method is not callable
Return values
mixed —extractEbscoData()
Extract data from EBSCO API response using a prioritized list of selectors.
protected
extractEbscoData(array<string|int, mixed> $selectors) : array<string|int, mixed>
Selectors can be of the form Items:Label to invoke extractEbscoDataFromItems, or RecordInfo:Path/To/Data/Element to invoke extractEbscoDataFromRecordInfo.
Parameters
- $selectors : array<string|int, mixed>
-
Array of selector strings for extracting data.
Return values
array<string|int, mixed> —extractEbscoDataFromItems()
Extract data from the record's "Items" array, based on a label.
protected
extractEbscoDataFromItems(string $label) : array<string|int, mixed>
Parameters
- $label : string
-
Label to filter on.
Return values
array<string|int, mixed> —extractEbscoDataFromRecordInfo()
Extract data from the record's "RecordInfo" array, based on a path.
protected
extractEbscoDataFromRecordInfo(string $path) : array<string|int, mixed>
Parameters
- $path : string
-
Path to select with (slash-separated element names, with special * selector to iterate through all children).
Return values
array<string|int, mixed> —extractTextDomain()
Given a translation string with or without a text domain, return an array with the raw string and the text domain separated.
protected
extractTextDomain(string|object|array<string|int, mixed> $target) : array<string|int, mixed>
Parameters
- $target : string|object|array<string|int, mixed>
-
String to translate or an array of text domain and string to translate
Return values
array<string|int, mixed> —getArticleOpenUrlParams()
Get OpenURL parameters for an article.
protected
getArticleOpenUrlParams() : array<string|int, mixed>
Return values
array<string|int, mixed> —getBookOpenUrlParams()
Get OpenURL parameters for a book.
protected
getBookOpenUrlParams() : array<string|int, mixed>
Return values
array<string|int, mixed> —getCoinsID()
Get the COinS identifier.
protected
getCoinsID() : string
Return values
string —getDebugTranslation()
Build a debug-mode translation
protected
getDebugTranslation(string $domain, string $str, array<string|int, mixed> $tokens) : string
Parameters
- $domain : string
-
Text domain
- $str : string
-
String to translate
- $tokens : array<string|int, mixed>
-
Tokens to inject into the translated string
Return values
string —getDefaultOpenUrlParams()
Get default OpenURL parameters.
protected
getDefaultOpenUrlParams() : array<string|int, mixed>
Return values
array<string|int, mixed> —getFilteredIdentifiers()
Retrieve identifiers from the EBSCO record and retrieve values filtered by type.
protected
getFilteredIdentifiers(array<string|int, mixed> $filter) : array<string|int, mixed>
Parameters
- $filter : array<string|int, mixed>
-
Type values to retrieve.
Return values
array<string|int, mixed> —getFilteredNumbering()
Extract numbering data of a particular type.
protected
getFilteredNumbering(string $type) : string
Parameters
- $type : string
-
Numbering type to return, if present.
Return values
string —getItemsAuthorsArray()
Obtain an array or authors indicated on the record
protected
getItemsAuthorsArray() : array<string|int, mixed>
Return values
array<string|int, mixed> —getJournalOpenUrlParams()
Get OpenURL parameters for a journal.
protected
getJournalOpenUrlParams() : array<string|int, mixed>
Return values
array<string|int, mixed> —getOpenUrlFormat()
Support method for getOpenUrl() -- pick the OpenURL format.
protected
getOpenUrlFormat() : string
Return values
string —getRawEDSPublicationDetails()
Attempt to build up publication details from raw EDS data.
protected
getRawEDSPublicationDetails() : array<string|int, mixed>
Return values
array<string|int, mixed> —getRawLCCN()
Get a raw, unnormalized LCCN. (See getLCCN for normalization).
protected
getRawLCCN() : string
Return values
string —getSupportedCitationFormats()
Get an array of strings representing citation formats supported by this record's data (empty if none). For possible legal values, see /application/themes/root/helpers/Citation.php.
protected
getSupportedCitationFormats() : array<string|int, mixed>
Return values
array<string|int, mixed> —Strings representing citation formats.
getUnknownFormatOpenUrlParams()
Get OpenURL parameters for an unknown format.
protected
getUnknownFormatOpenUrlParams([string $format = 'UnknownFormat' ]) : array<string|int, mixed>
Parameters
- $format : string = 'UnknownFormat'
-
Name of format
Return values
array<string|int, mixed> —hasEbookAvailable()
Get the ebook availability of the record.
protected
hasEbookAvailable(array<string|int, mixed> $types) : bool
Parameters
- $types : array<string|int, mixed>
-
Types that we are interested in checking for
Return values
bool —itemIsExcluded()
Support method for getItems, used to apply filters.
protected
itemIsExcluded(array<string|int, mixed> $item, string $context) : bool
Parameters
- $item : array<string|int, mixed>
-
Item to check
- $context : string
-
The context in which items are being retrieved (used for context-sensitive filtering)
Return values
bool —recurseIntoRecordInfo()
Recursive support method for extractEbscoDataFromRecordInfo().
protected
recurseIntoRecordInfo(array<string|int, mixed> $data, array<string|int, mixed> $path) : array<string|int, mixed>
Parameters
- $data : array<string|int, mixed>
-
Data to recurse into
- $path : array<string|int, mixed>
-
Array representing path into data
Return values
array<string|int, mixed> —replaceBRWithCommas()
Replace <br> tags that are embedded in data to commas
protected
replaceBRWithCommas(string $data, string $group) : string
Parameters
- $data : string
-
Data to process
- $group : string
-
Group identifier
Return values
string —sanitizeTranslationKey()
Make sure there are not any illegal characters in the translation key that might prevent successful lookup in language files.
protected
sanitizeTranslationKey(string $key) : string
Parameters
- $key : string
-
Key to sanitize
Return values
string —Sanitized key
toHTML()
Parse a SimpleXml element and return it's inner XML as an HTML string
protected
toHTML(SimpleXml $data[, string $group = null ]) : string
Parameters
- $data : SimpleXml
-
A SimpleXml DOM
- $group : string = null
-
Group identifier
Return values
string —The HTML string
translateString()
Get translation for a string
protected
translateString(string $rawStr[, array<string|int, mixed> $tokens = [] ][, string $default = null ][, string $domain = 'default' ][, bool $useIcuFormatter = false ]) : string
Parameters
- $rawStr : string
-
String to translate
- $tokens : array<string|int, mixed> = []
-
Tokens to inject into the translated string
- $default : string = null
-
Default value to use if no translation is found (null for no default).
- $domain : string = 'default'
-
Text domain (omit for default)
- $useIcuFormatter : bool = false
-
Should we use an ICU message formatter instead of the default behavior?