Documentation

 

Plugin appearance / CSS

The two main UI components are:

  • Status indicator: Status indicator
  • A popup box to handle ambiguous and invalid addresses: Popup example

You can customize the look and feel of the UI to match your website simply by adding some style rules to your CSS document.

Tips

Since the plugin is designed to survive in some hostile web page environments, it was necessary for us to force certain rules to preserve usability. If you experience difficulty getting your style rules to override some of our defaults, try using the !important declaration. We also strongly recommend the use of browser inspector tools, furnished with every major modern desktop web browser: Chrome, Safari, Firefox, IE, and Opera.

The CSS for our default UI is prepended to your <head> tag, which means all rules after them will cascade on top.

Table of CSS classes

CSS classDescription
.smarty-uiA class which contains any other plugin UI elements. This is a catch-all class.
.smarty-dotsThe "loader" dots animation that shows while the address is verifying; it is hidden by default, but appears over the last input of the address.
.smarty-popupThe containing element of the popup boxes that handle ambiguous, invalid, or missing secondary addresses. These aren't true pop-up windows; they're just div elements positioned over the form.
.smarty-popup-headerThe top part of a popup which holds the (short) message text and the close ("X") button.
.smarty-popup-ambiguous-headerSame as .smarty-popup-header, but only for popups dealing with ambiguous addresses.
.smarty-popup-invalid-headerSame as .smarty-popup-header, but only for popups dealing with invalid addresses.
.smarty-popup-missing-input-headerSame as .smarty-popup-header, but only for popups dealing with addresses missing input required for verification.
.smarty-popup-missing-secondary-headerSame as .smarty-popup-header, but only for popups dealing with addresses missing secondary numbers. Note: verifySecondary must be set to true for this header to appear.
.smarty-popup-secondary-number-formThis form allows the user to add the apartment/unit number without having to close the smarty-popup. Only for popups dealing with addresses missing secondary numbers. Note: verifySecondary must be set to true for this form to appear.
#smarty-secondary-number-input-boxThe input box where the user enters the missing apartment/unit number. Only for popups dealing with addresses missing secondary numbers. Note: verifySecondary must be set to true for this form to appear.
#smarty-popup-secondary-number-form-submit-buttonThe submit button for when the user enters in the missing apartment/unit number. Only for popups dealing with addresses missing secondary numbers. Note: verifySecondary must be set to true for this form to appear.
.smarty-popup-typed-addressDisplays the address that was typed in and sent for validation.
.smarty-choice-listThe container for the list of ambiguous address result options in a popup window.
.smarty-choice-altThe container for the "Try again" (certifyMessage button) and "Use as it is" (changeMessage button).
.smarty-choice-abortThe link(s) in a popup window which abort the verification process (the user agrees to review the address).
.smarty-choice-overrideThe alternate option in a popup window for invalid or missing secondary addresses where the user certifies their address is correct.
.smarty-tagThe container for the status indicator attached to the last input field of each mapped address. It appears as an encircled, gray check mark. Go to an example.
.smarty-tag-grayedThe styles applied to the tag when the address is NOT in a verified state.
.smarty-tag-greenThe styles applied to the tag when the address IS in a verified state.
.smarty-tag-checkThe check mark displayed in the tag.
.smarty-tag-textThe text (such as "Verify," "Verified," or "Undo") that appears when a tag is hovered on.
.smarty-autocompleteThe containing element for autocomplete suggestions.
.smarty-suggestionAn autocomplete suggestion (is an <a> tag).
.smarty-active-suggestionClass applied to the currently-selected .smarty-suggestion element.

Having trouble?

Take a look at these troubleshooting tips we put together with lots of love.