getForm( )

Gets a new registration form for the specified event.

Description

Use the getForm() function to retrieve the information you need to create a custom registration form for a specified event.

Retrieve event IDs from the Events/Events collection to specify which event's form to get.

Note: To work with the Wix Events API, you need to publish your site.

Syntax

function getForm(eventId: string): Promise<Form>

getForm Parameters

NAME

TYPE

DESCRIPTION

eventId

string

ID of the event to get a registration form for.

Returns

Fulfilled - A registration form object for the specified event.

Return Type:

Promise<Form>

Was this helpful?

Gets an registration form

Copy Code

1import wixEventsFrontend from 'wix-events-frontend';
2
3// ...
4
5const eventId = // get an event ID
6
7wixEventsFrontend.getForm(eventId)
8  .then((result) => {
9    let form = result;
10  });

Get and submit a registration form

Copy Code

1import wixEventsFrontend from 'wix-events-frontend';
2import wixData from 'wix-data';
3
4$w.onReady(function () {  
5  let eventId;
6
7  // Run a query that returns only one event. Add
8  // additional filtering to the query if necessary.
9  wixData.query("Events/Events")
10    .eq("title", "My Event")
11    .find()
12    .then((results) => {
13      if (results.items.length > 0) {
14        eventId = results.items[0]._id;
15      } else {
16        console.log("Could not find event");
17      }
18    });
19  
20  $w("#submit").onClick(() => {
21    const formValues = getFormValues();
22
23    wixEventsFrontend.rsvp.createRsvp(eventId, formValues)
24      .then((result) => {
25        console.log("RSVP created.")
26      })
27      .catch((error) => {
28        console.log(`Error message: ${error.message}`);
29        if (error.fields) {
30          console.log(`Incorrect fields: ${error.fields}`);	
31        }
32      });	
33  });
34});
35
36function getFormValues() {
37  return [
38    {"name": "rsvpStatus", "value": "YES"},
39    {"name": "firstName", "value": $w("#firstName").value},
40    {"name": "lastName", "value": $w("#lastName").value},
41    {"name": "email", "value": $w("#email").value},
42    {"name": "custom", "value": $w("#foodAllergies").value},
43
44    // When a form contains an address, the way you format the
45    // address information for submission depends on what type
46    // of input elements you use to gather that information.
47
48    // Wix address input element.
49    {"name": "address", "value": $w("#address").value},
50
51    // Single element which is not an address
52    // input element, such as a text input.
53    {"name": "address", "value": [$w("#address").value]},
54
55    // Multiple elements for the
56    // various parts of an address.
57    {
58      "name": "address", 
59      "value": [
60        $w("#street").value,
61        $w("#city").value,
62        $w("#state").value,
63        $w("#country").value,
64        $w("#postalCode").value
65      ]
66    },
67
68    // When a form contains an input for adding more guests to an
69    // RSVP, format the guest names for submission in an array
70    // where each element is the full name of a guest.
71    {"name": "additionalGuests", "value": $w('#additionalGuests').value},
72    {
73      "name": "guestNames",
74      "value": [
75        `${$w("#guest1FirstName").value} ${$w("#guest1LastName").value}`,
76        `${$w("#guest2FirstName").value} ${$w("#guest2LastName").value}`,
77      ]
78    }
79  ];
80}