Publish Forms

Once you've set up everything in your form to your liking, click one of the following buttons at the bottom of the window:

Save - Saves your content without advancing the form to the next step in the process.
Back - Enables you to go back to the previous screen and make changes. Any changes that have not been saved will be lost.
Cog icon - Delete or un-publish your form. Before you've published, this control enables you to delete the form. After you have published your form, this icon enables you to change your form to private mode (in other words, you can un-publish your form).
Publish This Form ("Republish This Form") - When you select Publish This Form, the page will be rendered, a URL hotlink will be generated, and widgets will be created. You can also see the available date, which shows when the page was published and made available for use. Most importantly, the form will become live. No one will know your site URL until you promote the activity.

Widgets

After you publish, Salsa Engage generates URLs and widgets that enable you to...

• Link to a stand-alone Salsa Engage hosted form

Image_2020-09-24_at_4.58.38_PM.png

This page is hosted natively by Salsa Labs and is included as part of your subscription.

Pros	Cons
No website needed. Form is secure. Fully customizable layout/content. Form is mobile-responsive. URL can be customized for a fee.	URL will start with https://yourorgdomain.salsalabs.org, which while most organizations discover is not a problem, can be something to consider. Look and feel is not identical to the website.

• Embed your Salsa Engage form into your own website

If you already have your own website, you can copy and paste the code to include the form itself on your website.

Pros

Cons

Since sign-up form is integrated into an existing website, branding is retained.
Retains the URL of that web page.

Assumes you have access to edit your own CMS. If you do not have the ability/access to your CMS, reliance on a contractor or other department can make this more challenging.
Responsiveness - If the site into which the code is pasted is not natively mobile responsive, the form could have challenges.
Lack of security - embedding this code into a web page that is not natively secure may have the appearance to outsiders of not being secure, however the form itself is always securely encrypted.

For Events in particular, if you'd like your embedded event to skip right to the registration form, paste the second chunk of code into your website instead of the first.

• Embed a button in your website that links to the Salsa Engage hosted form

Image_2020-09-24_at_4.48.26_PM.png

Use this widget to embed a button in your website that links from your web page to your new form. To the right of the widget is a sample of what the button looks like.

Pros	Cons
Buttons are a widely-used design option. Allows for click tracking	Directs to an external form on another web page. Look and feel may not be identical to your web site branding

Beneath the button, you can click Configure Button. This will open a Button Settings window in which you can change the text, font, and colors of your button. Once you've made your changes, click Save Configuration ».

Widget Tip for Web Developers

In some cases, you may need to wait for the Engage form widget to load before manipulating it. For example, if you use a script to customize values in hidden fields, change CSS or other styling of fields, etc.

Engage features a Javascript invocation of a known global Javascript hook when a widget has finished loading, named window.salsaWidgetFinished(activityId).

Activity ID will be the actual ID of the activity of the widget, in order to support cases where more than 1 widget is embedded on a given HTML page;

If this function EXISTS it will be invoked at the end of the widget load. If the function does not exist, nothing changes. Errors that occur in the function will be ignored and allow the page to still load correctly.