Joomla! API

link
since	1.7.0
package	Application

Class constructor.

__construct(array options = array()) : mixed

inherited

since	1.7.0

Arguments

options: arrayAssociative array of options

Response

mixed

Returns the lineEnd

_getLineEnd() : string

inherited

since	1.7.0

Response

string

Returns a string containing the unit for indenting HTML

_getTab() : string

inherited

since	1.7.0

Response

string

Adds an image to the Opensearch description.

addImage(\Joomla\CMS\Document\Opensearch\OpensearchImage image) : \Joomla\CMS\Document\OpensearchDocument

since	1.7.0

Arguments

image: \Joomla\CMS\Document\Opensearch\OpensearchImageThe image to add to the description.

Response

\Joomla\CMS\Document\OpensearchDocumentinstance of $this to allow chaining

Adds a linked script to the page

addScript(string url, array options = array(), array attribs = array()) : \Joomla\CMS\Document\Document

inherited deprecated

since	1.7.0
deprecated	5.0 Use WebAssetManager

Arguments

url: stringURL to the linked script.
options: arrayArray of options. Example: array('version' => 'auto', 'conditional' => 'lt IE 9', 'preload' => array('preload'))
attribs: arrayArray of attributes. Example: array('id' => 'scriptid', 'async' => 'async', 'data-test' => 1)

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Adds a script to the page

addScriptDeclaration(string content, string type = 'text/javascript') : \Joomla\CMS\Document\Document

inherited deprecated

since	1.7.0
deprecated	5.0 Use WebAssetManager

Arguments

content: stringScript
type: stringScripting mime (defaults to 'text/javascript')

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Add option for script

addScriptOptions(string key, mixed options, bool merge = true) : \Joomla\CMS\Document\Document

inherited

since	3.5

Arguments

key: stringName in Storage
options: mixedScrip options as array or string
merge: boolWhether merge with existing (true) or replace (false)

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Adds a stylesheet declaration to the page

addStyleDeclaration(string content, string type = 'text/css') : \Joomla\CMS\Document\Document

inherited deprecated

since	1.7.0
deprecated	5.0 Use WebAssetManager

Arguments

content: stringStyle declarations
type: stringType of stylesheet (defaults to 'text/css')

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Adds a linked stylesheet to the page

addStyleSheet(string url, array options = array(), array attribs = array()) : \Joomla\CMS\Document\Document

inherited deprecated

since	1.7.0
deprecated	5.0 Use WebAssetManager

Arguments

url: stringURL to the linked style sheet
options: arrayArray of options. Example: array('version' => 'auto', 'conditional' => 'lt IE 9', 'preload' => array('preload'))
attribs: arrayArray of attributes. Example: array('id' => 'stylesheet', 'data-test' => 1)

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Adds a URL to the Opensearch description.

addUrl(\Joomla\CMS\Document\Opensearch\OpensearchUrl url) : \Joomla\CMS\Document\OpensearchDocument

since	1.7.0

Arguments

url: \Joomla\CMS\Document\Opensearch\OpensearchUrlThe url to add to the description.

Response

\Joomla\CMS\Document\OpensearchDocumentinstance of $this to allow chaining

Return the base URI of the document.

getBase() : string

inherited

since	1.7.0

Response

string

Get the contents of the document buffer

getBuffer() : mixed

inherited

since	1.7.0

Response

mixed

Returns the document charset encoding.

getCharset() : string

inherited

since	1.7.0

Response

string

Return the description of the document.

getDescription() : string

inherited

since	1.7.0

Response

string

Returns the document direction declaration.

getDirection() : string

inherited

since	1.7.0

Response

string

Returns the document generator

getGenerator() : string

inherited

since	1.7.0

Response

string

Returns the global Document object, only creating it if it doesn't already exist.

getInstance(string type = 'html', array attributes = array()) : static

inherited static deprecated

since	1.7.0
deprecated	5.0 Use the \Joomla\CMS\Document\FactoryInterface instead

Arguments

type: stringThe document type to instantiate
attributes: arrayArray of attributes

Response

staticThe document object.

Returns the document language.

getLanguage() : string

inherited

since	1.7.0

Response

string

Returns the document base url

getLink() : string

inherited

since	1.7.0

Response

string

Return the media version

getMediaVersion() : string

inherited

since	3.2

Response

string

Gets a meta tag.

getMetaData(string name, string attribute = 'name') : string

inherited

since	1.7.0

Arguments

name: stringName of the meta HTML tag
attribute: stringAttribute to use in the meta HTML tag

Response

string

Return the document MIME encoding that is sent to the browser.

getMimeEncoding() : string

inherited

since	1.7.0

Response

string

Returns the document modified date

getModifiedDate() : string|\Joomla\CMS\Date\Date

inherited

since	1.7.0

Response

string|\Joomla\CMS\Date\Date

Return the preload manager

getPreloadManager() : \Joomla\CMS\Document\PreloadManagerInterface

inherited

since	4.0.0

Response

\Joomla\CMS\Document\PreloadManagerInterface

Get script(s) options

getScriptOptions(string key = null) : array

inherited

since	3.5

Arguments

key: stringName in Storage

Response

arrayOptions for given $key, or all script options

Return the title of the document.

getTitle() : string

inherited

since	1.7.0

Response

string

Returns the document type

getType() : string

inherited

since	1.7.0

Response

string

Return WebAsset manager

getWebAssetManager() : \Joomla\CMS\WebAsset\WebAssetManager

inherited

since	4.0.0

Response

\Joomla\CMS\WebAsset\WebAssetManager

Load a renderer

loadRenderer(string type) : \Joomla\CMS\Document\RendererInterface

inherited

since	1.7.0
throws	`\RuntimeException`

Arguments

type: stringThe renderer type

Response

\Joomla\CMS\Document\RendererInterface

Parses the document and prepares the buffers

parse(array params = array()) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

params: arrayThe array of parameters

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Generate the Link header for assets configured for preloading

preloadAssets() : void

inherited

since	4.0.0

Outputs the document

render(bool cache = false, array params = array()) : string

inherited

since	1.7.0

Arguments

cache: boolIf true, cache the output
params: arrayAssociative array of attributes

Response

stringThe rendered data

Sets the base URI of the document

setBase(string base) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

base: stringThe base URI to be set

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Set the contents of the document buffer

setBuffer(string content, array options = array()) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

content: stringThe content to be set in the buffer.
options: arrayArray of optional elements.

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the document charset

setCharset(string type = 'utf-8') : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

type: stringCharset encoding string

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the description of the document

setDescription(string description) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

description: stringThe description to set

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the global document direction declaration. Default is left-to-right (ltr).

setDirection(string dir = 'ltr') : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

dir: stringThe language direction to be set

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Set the factory instance

setFactory(\Joomla\CMS\Document\FactoryInterface factory) : \Joomla\CMS\Document\Document

inherited

since	4.0.0

Arguments

factory: \Joomla\CMS\Document\FactoryInterfaceThe factory instance

Response

\Joomla\CMS\Document\Document

Sets the document generator

setGenerator(string generator) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

generator: stringThe generator to be set

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the global document language declaration. Default is English (en-gb).

setLanguage(string lang = 'en-gb') : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

lang: stringThe language to be set

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the line end style to Windows, Mac, Unix or a custom string.

setLineEnd(string style) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

style: string"win", "mac", "unix" or custom string.

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the document link

setLink(string url) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

url: stringA url

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Set the assets version

setMediaVersion(string mediaVersion) : \Joomla\CMS\Document\Document

inherited

since	3.2

Arguments

mediaVersion: stringMedia version to use

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets or alters a meta tag.

setMetaData(string name, mixed content, string attribute = 'name') : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

name: stringName of the meta HTML tag
content: mixedValue of the meta HTML tag as array or string
attribute: stringAttribute to use in the meta HTML tag

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the document MIME encoding that is sent to the browser.

setMimeEncoding(string type = 'text/html', bool sync = true) : \Joomla\CMS\Document\Document

inherited

This usually will be text/html because most browsers cannot yet accept the proper mime settings for XHTML: application/xhtml+xml and to a lesser extent application/xml and text/xml. See the W3C note ({@link https://www.w3.org/TR/xhtml-media-types/}) for more details.

since	1.7.0
link

Arguments

type: stringThe document type to be sent
sync: boolShould the type be synced with HTML?

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the document modified date

setModifiedDate(string|\Joomla\CMS\Date\Date date) : \Joomla\CMS\Document\Document

inherited

since	1.7.0
throws	`\InvalidArgumentException`

Arguments

date: string|\Joomla\CMS\Date\DateThe date to be set

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Set the preload manager

setPreloadManager(\Joomla\CMS\Document\PreloadManagerInterface preloadManager) : \Joomla\CMS\Document\Document

inherited

since	4.0.0

Arguments

preloadManager: \Joomla\CMS\Document\PreloadManagerInterfaceThe preload manager service

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the short name

setShortName(string name) : \Joomla\CMS\Document\OpensearchDocument

since	1.7.0

Arguments

name: stringThe name.

Response

\Joomla\CMS\Document\OpensearchDocumentinstance of $this to allow chaining

Sets the string used to indent HTML

setTab(string string) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

string: stringString used to indent ("\11", "\t", ' ', etc.).

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Sets the title of the document

setTitle(string title) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

title: stringThe title to be set

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Set the document type

setType(string type) : \Joomla\CMS\Document\Document

inherited

since	1.7.0

Arguments

type: stringType document is to set to

Response

\Joomla\CMS\Document\Documentinstance of $this to allow chaining

Set WebAsset manager

setWebAssetManager(\Joomla\CMS\WebAsset\WebAssetManager webAsset) : \Joomla\CMS\Document\Document

inherited

since	4.0.0

Arguments

webAsset: \Joomla\CMS\WebAsset\WebAssetManagerThe WebAsset instance

Response

\Joomla\CMS\Document\Document

ShortName element

required

since	1.7.0

Type(s)

string

Images collection

optional

since	1.7.0

Type(s)

object

The url collection

since	1.7.0

Type(s)

array

Document title

inherited

since	1.7.0

Type(s)

string

Document description

inherited

since	1.7.0

Type(s)

string

Document full URL

inherited

since	1.7.0

Type(s)

string

Document base URL

inherited

since	1.7.0

Type(s)

string

Contains the document language setting

inherited

since	1.7.0

Type(s)

string

Contains the document direction setting

inherited

since	1.7.0

Type(s)

string

Document generator

inherited

since	1.7.0

Type(s)

string

Document modified date

inherited

since	1.7.0

Type(s)

Date

Tab string

inherited

since	1.7.0

Type(s)

string

Contains the line end string

inherited

since	1.7.0

Type(s)

string

Contains the character encoding string

inherited

since	1.7.0

Type(s)

string

Document mime type

inherited

since	1.7.0

Type(s)

string

Document namespace

inherited

since	1.7.0

Type(s)

string

Document profile

inherited

since	1.7.0

Type(s)

string

Array of linked scripts

inherited deprecated

since	1.7.0
deprecated	5.0 Use WebAssetManager

Type(s)

array

Array of scripts placed in the header

inherited deprecated

since	1.7.0
deprecated	5.0 Use WebAssetManager

Type(s)

array

Array of scripts options

inherited

Type(s)

array

Array of linked style sheets

inherited deprecated

since	1.7.0
deprecated	5.0 Use WebAssetManager

Type(s)

array

Array of included style declarations

inherited deprecated

since	1.7.0
deprecated	5.0 Use WebAssetManager

Type(s)

array

Array of meta tags

inherited

since	1.7.0

Type(s)

array

The rendering engine

inherited

since	1.7.0

Type(s)

object

The document type

inherited

since	1.7.0

Type(s)

string

Array of buffered output

inherited static

since	1.7.0

Type(s)

mixed

Document instances container.

inherited static

since	1.7.3

Type(s)

array

Media version added to assets

inherited

since	3.2

Type(s)

string

Factory for creating JDocument API objects

inherited

since	4.0.0

Type(s)

FactoryInterface

Preload manager

inherited

since	4.0.0

Type(s)

PreloadManagerInterface

The supported preload types

inherited

since	4.0.0

Type(s)

array

Web Asset instance

inherited

since	4.0.0

Type(s)

WebAssetManager

OpensearchDocument

Methods

__construct

Arguments

Response

_getLineEnd

Response

_getTab

Response

addImage

Arguments

Response

addScript

Arguments

Response

addScriptDeclaration

Arguments

Response

addScriptOptions

Arguments

Response

addStyleDeclaration

Arguments

Response

addStyleSheet

Arguments

Response

addUrl

Arguments

Response

getBase

Response

getBuffer

Response

getCharset

Response

getDescription

Response

getDirection

Response

getGenerator

Response

getInstance

Arguments

Response

getLanguage

Response

getLink

Response

getMediaVersion

Response

getMetaData

Arguments

Response

getMimeEncoding

Response

getModifiedDate

Response

getPreloadManager

Response

getScriptOptions

Arguments

Response

getTitle

Response

getType

Response

getWebAssetManager

Response

loadRenderer

Arguments

Response

parse

Arguments

Response

preloadAssets

render

Arguments

Response

setBase