Api

Api

Top level api object from which all other api modules are available.

Name

Type

Description

article

Article

Required - See Article

configurator

DWConfigurator

Required -

document

Document

Required - See Document

newsItem

NewsItem

Required - See NewsItem

events

Events

Required - See Events

router

Router

Required - See Router

browser

Browser

Required - See Browser

ui

Ui

Required - See Ui

upload

Upload

Required - See Upload

settings

Settings

Required - See Settings

user

User

Required - See User

history

History

Required -

stateHandler

StateHandler

Required - Reference to a StateHandler

editorSession

EditorSession

Required - Substance editorSession

doc

Doc

Required - The editorSession document

getVersion()⇒ string

Get current version of the Writer

Returns: string - Version tag

getClientVersion()

Gets internal writer-client version currently running

getConfigValue(id, path, defaultValue)⇒ *

Get configuration value in a plugins local configuration data section. If no path is given the full configuration object for the plugin instance is returned.

Returns: * - The value of the wanted configuration path or default value

Parameters

Param

Type

Description

id

string

Required - Plugin id to fetch configuration value for

path

string

Required - Optional configuration path in the data section

defaultValue

*

Required - Optional default value if no value is found

Example

{
   "vendor": "vendor.tld",
   "name": "myplugin",
   "enabled": true,
   "data": {
     "mykey": "Configuration value"
   }
 },

Example

import {api} from 'writer'
var apiEndpoint = api.getConfigValue('myplugin', 'mykey');`

hasLocalConfiguration()⇒ Boolean

Check if the configuration has been overridden with local configuration

getPluginModule(moduleId)⇒ Object

Return a fresh instance of a specific plugin provided module

Parameters

Param

Type

Description

moduleId

string

Required - Module id

getPluginModulesForTarget(targetId)

Get modules targeted at a specific consumer

Parameters

Param

Type

Description

targetId

string

Required - Target id of the consumer

Types

ApiOptions: Object

Parameters

Param

Type

options

Name

Type

Default

Description

configurator

DWConfigurator

Required - If true will always allow save regardless of workflow permissions

pluginConfigurations

object | null

Plugin configuration object

newsItem

XMLDocument

Required - Article NewsML document

temporaryArticleId

string

Last updated