Auth0-contact-form NPM

Auth0 Contact Form

Install

npm i --save auth0-contact-form jquery@2 bootstrap@3

Usage

Needs jQuery and bootstrap.js, because they are peer dependencies.

Example

index.js

import 'jquery';
import 'bootstrap';
import ContactForm from 'auth0-contact-form';

const metricsLib = window.metricsLib;
const $ = jQuery;
const options = {
  onFormSuccess(metricsData) {
    metricsLib.track('contact-form-success', metricsData);
  }
};

const contactForm = new ContactForm(options);

$('.btn').click(contactForm.show);

index.styl

@import '../node_modules/auth0-contact-form/build/contact-form.css'

Options

Option	Type	Default	Description
onModalOpen	function	() => {}	On modal open callback, has `metricsData` arg with metrics data.
onFormSuccess	function	() => {}	On form success callback, has `metricsData` arg with metrics data.
onFormFail	function	() => {}	On form fail callback, has `metricsData` arg with metrics data.
postUrl	string	'https://webtask.it.auth0.com/api/run/auth0-generic/contact-form-mandrill'	Url to send post data of form.
modalTitle	string	'Contact Sales Team'	Modal title.

Methods

Method	Argument	Description
show		Shows contact form modal

Handle query string

Also this package exports a function handleQueryString that triggers the contact form if ?contact=true is on the url.

Example:

import 'jquery';
import 'bootstrap';
import { handleQueryString } from 'auth0-contact-form';

const options = {
  postUrl: 'https://myserver.com/contact'
};

handleQueryString(options);

Development

Run:

git clone git@github.com:auth0/contact-form.git
cd contact-form
npm install
npm start

And point your browser at http://localhost:3001.

Release

Make sure you have bump and git-extras Follow the next steps:

  # Once finished your changes and commit them, run:
  bump {patch,minor,major,VERSION}

  # Then create the changelog for the release, using
  # the retrieved version by last command:
  git changelog --tag <version>

  # Then, just run:
  git add . && git release <version>

  # Publish to npm
  npm publish

  # Done!

Issue Reporting

If you have found a bug or if you have a feature request, please report them at this repository issues section. Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.