Script Data Attributes

The current signalog.plug widget reads data-* attributes from the <script> tag that loads widget.js.

It does not currently attach document-level click handlers for custom trigger attributes on arbitrary page elements. For custom buttons today, use SignalogPlugin.openWidget().

Required attribute

data-site-id

Your Signalog site/app id. Without it, the widget aborts mounting.

<script
  async
  src="https://cdn.signalog.co/widget.js"
  data-site-id="YOUR_SITE_ID"
></script>

Optional attributes

Attribute	Accepted values	Description
data-mode	window, drawer, modal	Sets the mode used when the widget opens. fab and hidden are ignored during boot for openMode.
data-position	bottom-right, bottom-left	Sets the floating launcher position. Defaults to bottom-right.
data-label	Any string	Sets the floating launcher label. Defaults to Help.
data-trigger	none	Hides the default floating button at boot.

Examples

Default install

<script
  async
  src="https://cdn.signalog.co/widget.js"
  data-site-id="YOUR_SITE_ID"
></script>

Drawer mode

<script
  async
  src="https://cdn.signalog.co/widget.js"
  data-site-id="YOUR_SITE_ID"
  data-mode="drawer"
></script>

Custom launcher label and position

<script
  async
  src="https://cdn.signalog.co/widget.js"
  data-site-id="YOUR_SITE_ID"
  data-label="Help"
  data-position="bottom-left"
></script>

Hide the default launcher

Use this when your product UI has its own feedback buttons.

<script
  async
  src="https://cdn.signalog.co/widget.js"
  data-site-id="YOUR_SITE_ID"
  data-trigger="none"
></script>

Then open panels from your own UI:

<button onclick="SignalogPlugin.openWidget({ trigger: 'bugReport' })">
  Report bug
</button>

Coming soon: declarative trigger attributes

Declarative click triggers are planned, but are not active in the current signalog.plug bundle.

The planned shape is:

<button data-signalog-trigger="feedback">Share feedback</button>
<button data-signalog-trigger="bugReport">Report bug</button>
<button data-signalog-trigger="featureRequest">Request feature</button>
<button data-signalog-trigger="changeLogs">View changelog</button>

Planned trigger values:

Attribute value	Opens
feedback	General feedback form
bugReport	Bug report form
featureRequest	Feature request form
changeLogs	Changelog / updates view

Until this ships, custom click triggers use JavaScript:

SignalogPlugin.openWidget({ trigger: 'feedback' })
SignalogPlugin.openWidget({ trigger: 'bugReport' })
SignalogPlugin.openWidget({ trigger: 'featureRequest' })
SignalogPlugin.openWidget({ trigger: 'changeLogs' })

See Custom Trigger Buttons for framework examples.