Endpoints: Web Widgets

Web Widgets are simple JavaScript that can be embedded into any website's HTML to display Omnilert alerts.

This feature provides an easy, quick way to display your recent alerts on the web automatically, directly from Omnilert as soon as they're sent.

The Web Widget configuration screen has the following important settings:

• Duration: How long Widget items will remain posted until they "expire". Expired feed items will be removed within 15 minutes of their expiration. We recommend setting the default duration to at least 10 hours, as you can always cancel publishing if the item needs to be removed sooner.
• Feed Date/Time Format: The format for the date and time shown in the feed's timestamp.
• Items to Show: Each widget can be configured to show one or more messages. How many concurrent alerts should this feed display? Set to "Last 1" if you'd only like the most recent, unexpired alert to show.
• Widget Format: Choose between "Standard" (HTML tabled format) and HTML5 (non-tabled <DIV> formatting) for the content returned by the widget. Note: Each widget format has it's own CSS classes for styling purposes. 

Finally, there will be an option to copy your Widget Feed Code.

The feed code is the HTML source code that you'll embed into your website's source. When rendered, it'll create the table with your widget items.

The Widget's HTML will be "unstyled", so your webmaster may need to add some stylesheet classes to your local CSS.

Important Notes and Tips:

• Some HTML tags are supported. Basic HTML tags are supported in the widget. If HTML tags are present in your outgoing content, the browser will render them. This will work for simple tags such as anchor links and images.
• URLs will become links: Web addresses entered into the body text content of messages will automatically become clickable links when the web widget renders in the browser. (e.g. omnilert.com, www.omnilert.com, or https://www.omnilert.com all would be seen as clickable links in a web widget.) 
• Always send a test message to new initialize widgets: Be sure to send an initial "test" message to your new widgets. Until used for the first time, your Widget's URL will return an "HTTP 403" error as its content won't exist until the Widget is used.
• How to cancel a widget message: Expired web widget messages will stop publishing on the next cleanup interval (about every 15 minutes). However, you can also cancel a widget message before it expires on the timeline. (Learn more)