Below is a list of currently supported electronic signature shortcodes:
First, note when you install the plugin, if you are using WordPress’ native editor and not a plugin (i.e. Tiny MCE, CK editors, various bootstrap systems..) you will see a shortcode generator that just saves you the hassle of having to look this up – like this:
clicking it will open up like this…
- REQUIRED ===============
- [swiftsign swift_form_id=”123456789″] — First you must open the electronic signature doc with this, and replace the 123…89 with your SwiftCloud Form ID number (see the onboarding process for this if you’re not sure what this is). The very last thing on the page should be…
- [swift_button] // this generates the final submission button
- [/swiftsign] // this closes the document. Anything below here – typically your website footer, will be ignored. Anything above the [swiftsign… will also be ignored, i.e. not converted into signed PDFs.
- [swift_email] // this has to be somewhere between the starting and ending tags – anywhere in the doc.
- OPTIONAL / AS NEEDED ====================
- [swift_name] // note our system will split a single name field into first and last names, and FirstCap it in the marketing automatically if you’re using our marketing suite / autoresponders / etc.
- [swiftsignature] // generates the actual signature drawing area (or the user can type and choose a font). This defaults to small, but you can optionally use [swiftsignature size=”large”] or [swiftsignature size=”medium”] if you prefer.
- [swift_initials] // same, just smaller for initials only…
- [swift_date_today] // this pre-fills today’s date and disallows editing, so the user cannot change today’s date. Recommended.
- [swift_textbox name=”fieldnamehere” class=”this_is_for_CSS” value=”preloadtext” placeholder=”disappears_onclick” required] // this is a mess of options all in one, but you’ll get the idea. Field name MUST be unique to the page, you cannot repeat fieldnames, so people often use name1, name2 etc. if needed. Required simply makes the field required, placeholder disappears onclick i.e. as a tip or suggestion or field label. Preloadtext will stay there when clicked, for example, a URL field may often have value=”http://” and placeholder=”http://YourSiteHere.com”]. The CSS is just for programmer types who know what that is and want to override the design styling.
- [swift_textarea name=”bigtextarea”] // generates a multi-line text area, which could fit a multi-line home address for example
- [swift_url name=”url” value=”http://” placeholder=”http://YourSite.com”] // we do have a URL-specific field, which will enforce validation
- [swift_checkbox name=”favorite_color” options=”red,blue,green”] // generates checkboxes… notice the field name cannot have spaces, but underscores are allowed.
- [swift_radio name=”gender” options=”male,female” checked=”male”] // radio button with only one choice allowed. Note these are formatted the same as checkboxes, but radio will only allow 1, while checkbox will allow multiple.
- [swift_circleword name=”CreditCards” options=”Visa, MC, Amex, Discover”] // circleword is like a checkbox, but designed to clone the style of paper.
- [swift_dropdown name=”airspeed_velocity_swallow” option_values=”african,european” selected_option=”african”] // dropdown with pre-selected choice
- [swift_date name=”birthday”] // this generates a datepicker that’s changeable — // UPDATED: [swift_date_dropdown] is easier to use
- [swift_date_today] // this generates only today’s date, and it cannot be changed.
- [swift_date_long] // same, but longer – like Tuesday, 23 December, 2017
- [swift_date_time_now] // this adds the time of day to above… note date-format is subject to your settings (USA vs. rest of world MM/DD/YYYY vs. DD/MM/YYYY)
- THANK YOU PAGE ONLY ====================
- [swiftsign_capture_name] // use this only on the thank-you page to thank the signor by name. Example: Add “Thanks [swiftsign_capture_name]!” to your /thanks-signed page and it will say “Thanks John!” if your signor had entered John Doe as their name (our system will return only the first name).
- FIELD SHORTCODE ADVANCED OPTIONS – add into any field: ============
- noneditable – this disallows the user from editing – say for example a sales price, interest rate, delivery date. Typically used with a pre-filled doc – so you could generate a signable contract from a CRM or some other web-form. Example: [swift_textbox name=”purchaseprice” noneditable] // this would show the purchase price but user cannot edit – so you’d have to fill via GET or POST.
- Field Length options: short, long, and full_line (medium is the default). Note any field allows CSS (see above) and thus can be CSS-adjusted to any specific length you need, however, we’ll make it easy for non-coders – you can add any of these into a field, and it will adjust the width. Short is 1/2 as wide as default, long is 2x as wide / long as default, and full-line is 100% of the container-div, i.e. the whole page-width.
- [swift_file_upload] UPLOAD – Beta Testing July 2017. Optional name for naming whatever the client / user is uploading.
- [swiftsign_affiliate_name] UPDATE Sept 2017: For use with our Bloodhound Tracking Plugin (for Ad-Tracking, Affiliate / JV Tracking, Sales Rep tracking) – this will add a hidden variable of the ad-source or affiliate or sales rep’s name into the e-signature. It will not be visible to on the final signed PDF nor to the signor, but will be included in the email to the form-owner / signature-recipient(s).
Pre-Loading Electronic Signature Variables
We have 3 methods of pre-loading variables into a signable webpage, which are:
- GET // simplest. Use if you can fit all the variables into a 256-character URL limit i.e. only have a few basic variables to pre-fill. Example: http://YourSite.com/apply/?loanamount=”123,000″&rate=”13%”&APR=”14.2%”
- POST // Examples to follow – contact us if needed…
- API Session // this is in beta, but in short, the user will need to log in, and we’ll look up session-data (typically pulled from a CRM – example: you took a loan application over the phone, and have most of the data for a contract ready to sign. Certain fields (name) you want editable (in case you misspelled it), others you don’t (loan amount, APR, etc.). This allows for sessions to be saved and resumed. SSL required for this and this is currently in private beta – contact us to get set up.
UPDATE: Conditional Logic
We have started basic conditional logic – this allows you to show or hide certain areas based on the answers. Here’s an example, where asking the value of the home is only relevant if the user actually owns a home – otherwise we hide that section.
In the below example, the blue field is the trigger, and the green field / text only shows up if the user has clicked yes – otherwise it stays hidden, and the user will never even know it is there.
- In the above example, everything between the two green tags – what’s your home worth – would only appear IF someone clicked yes to owning their home.
- The pink fields are the controls – these must match.
- The blue “hide” is the default behavior when the page first loads. Usually, this is set to hide, but show is also an option.
Need some other field type? Let us know and we’ll update the plugin and update this doc – we want it to be useful for you!