/** * Google app-script to utilise Elementor Pro From webhook. * * In order to enable this script, follow these steps: * * From your Google Sheet, from the "Exstensions" menu select "App Script"… * Paste the script from this gist into the script code editor and hit Save. * From the "Deploy" menu, select Deploy as web app… * Choose to execute the app as yourself, and allow Anyone, even anonymous to execute the script. (Note: depending on your Google Apps instance, this option may not be available. You will need to contact your Google Apps administrator, or else use a Gmail account.) * Now click Deploy. You may be asked to review permissions now. * The URL that you get will be the webhook that you can use in your elementor form, You can test this webhook in your browser first by pasting it. * It will say "Yepp this is the webhook URL, request received". * Last all you have to do is set up and Elementor Pro Form with a form name and Webhook action pointing to the URL from above. * * Update: 09/06/2022 * - Name the sheet: you can now add a field (could be hidden) to your form labeled "e_gs_SheetName" and set the defualt value to the name of the sheet you want to use. * - Set the Order: you can now add a form field (hidden) labeled "e_gs_order" and set its defualt value to the names of the columns you want to seperated by comma in the order you want, any other colum not in that list will be added after. * - Exclude Columns: you can now add a field (could be hidden) labeled "e_gs_exclude" and set its value to the names of the columns you want to exclude seperated by comma. */ // Change to true to enable email notifications let emailNotification = false; let emailAddress = "kamslsafi@gmail.com"; // DO NOT EDIT THESE NEXT PARAMS let isNewSheet = false; let postedData = []; const EXCLUDE_PROPERTY = 'e_gs_exclude'; const ORDER_PROPERTY = 'e_gs_order'; const SHEET_NAME_PROPERTY = 'e_gs_SheetName'; /** * this is a function that fires when the webapp receives a GET request * Not used but required. */ function doGet( e ) { return HtmlService.createHtmlOutput( "Yepp this is the webhook URL, request received" ); } // Webhook Receiver - triggered with form webhook to published App URL. function doPost( e ) { let params = JSON.stringify( e.parameter ); params = JSON.parse( params ); postedData = params; insertToSheet( params ); // HTTP Response return HtmlService.createHtmlOutput( "post request received" ); } /** * flattenObject * Flattens a nested object for easier use with a spreadsheet * @param ob * @returns {{}} */ const flattenObject = ( ob ) => { let toReturn = {}; for ( let i in ob ) { if ( ! ob.hasOwnProperty( i ) ) { continue; } if ( ( typeof ob[ i ] ) !== 'object' ) { toReturn[ i ] = ob[ i ]; continue; } let flatObject = flattenObject( ob[ i ] ); for ( let x in flatObject ) { if ( ! flatObject.hasOwnProperty( x ) ) { continue; } toReturn[ i + '.' + x ] = flatObject[ x ]; } } return toReturn; } /** * getHeaders * normalize headers * @param formSheet * @param keys * @returns {*[]} */ const getHeaders = ( formSheet, keys ) => { let headers = []; // retrieve existing headers if ( ! isNewSheet ) { headers = formSheet.getRange( 1, 1, 1, formSheet.getLastColumn() ).getValues()[0]; } const newHeaders = keys.filter( h => ! headers.includes( h ) ); headers = [ ...headers, ...newHeaders ]; // maybe set order headers = getColumnsOrder( headers ); // maybe exclude headers headers = excludeColumns( headers ); // filter out control columns headers = headers.filter( header => ! [ EXCLUDE_PROPERTY, ORDER_PROPERTY, SHEET_NAME_PROPERTY ].includes( header ) ); return headers; }; /** * getValues * normalize values * @param headers * @param flat * @returns {*[]} */ const getValues = ( headers, flat ) => { const values = []; // push values based on headers headers.forEach( ( h ) => values.push( flat[ h ] ) ); return values; } /** * insertRowData * inserts values to a given sheet at a given row * @param sheet * @param row * @param values * @param bold */ const insertRowData = ( sheet, row, values, bold = false ) => { const currentRow = sheet.getRange( row, 1, 1, values.length ); currentRow.setValues( [ values ] ) .setFontWeight( bold ? "bold" : "normal" ) .setHorizontalAlignment( "center" ); } /** * setHeaders * Insert headers * @param sheet * @param values */ const setHeaders = ( sheet, values ) => insertRowData( sheet, 1, values, true ); /** * setValues * Insert Data into Sheet * @param sheet * @param values */ const setValues = ( sheet, values ) => { const lastRow = Math.max( sheet.getLastRow(), 1 ); sheet.insertRowAfter( lastRow ); insertRowData( sheet, lastRow + 1, values ); } /** * getFormSheet * Find or create sheet for form * @param sheetName * @returns Sheet */ const getFormSheet = ( sheetName ) => { const activeSheet = SpreadsheetApp.getActiveSpreadsheet(); // create sheet if needed if ( activeSheet.getSheetByName( sheetName ) == null ) { const formSheet = activeSheet.insertSheet(); formSheet.setName( sheetName ); isNewSheet = true; } return activeSheet.getSheetByName( sheetName ); } /** * insertToSheet * magic function where it all happens * @param data */ const insertToSheet = ( data ) => { const flat = flattenObject( data ), keys = Object.keys( flat ), formSheet = getFormSheet( getSheetName( data ) ), headers = getHeaders( formSheet, keys ), values = getValues( headers, flat ); setHeaders( formSheet, headers ); setValues( formSheet, values ); if ( emailNotification ) { sendNotification( data, getSheetURL() ); } } /** * getSheetName * get sheet name based on form field named "e_gs_SheetName" if exists or used form name * @param data * @returns string */ const getSheetName = ( data ) => data[SHEET_NAME_PROPERTY] || data["form_name"]; /** * getSheetURL * get sheet url as string * @returns string */ const getSheetURL = () => SpreadsheetApp.getActiveSpreadsheet().getActiveSheet().getUrl(); /** * stringToArray * split and trim comma seperated string to array * @param str * @returns {*} */ const stringToArray = ( str ) => str.split( "," ).map( el => el.trim() ); /** * getColumnsOrder * used to set the columns order, set this by adding a form field (hidden) named "e_gs_order" * and set its value to the names of the columns you want to seperated by comma in the order you want, * any other colum not in that field will be added after * @param data * @param headers * @returns {*} */ const getColumnsOrder = ( headers ) => { if ( ! postedData[ORDER_PROPERTY] ) { return headers; } let sortingArr = stringToArray( postedData[ORDER_PROPERTY] ); // filter out non existing headers sortingArr = sortingArr.filter( h => headers.includes( h ) ); // filterout sorted headers headers = headers.filter( h => ! sortingArr.includes( h ) ); return [ ...sortingArr, ...headers ]; } /** * excludeColumns * used to exclude columns, set this by adding a form field (hidden) named "e_gs_exclude" * and set its value to the names of the columns you want to exclude seperated by comma * @param data * @param headers * @returns {*} */ const excludeColumns = ( headers ) => { if ( ! postedData[EXCLUDE_PROPERTY] ) { return headers; } const columnsToExclude = stringToArray( postedData[EXCLUDE_PROPERTY] ); return headers.filter( header => ! columnsToExclude.includes( header ) ); } /** * sendNotification * send email notification if enabled * @param data * @param url */ const sendNotification = ( data, url ) => { MailApp.sendEmail( emailAddress, "A new Elementor Pro Forms submission has been inserted to your sheet", // mail subject `A new submission has been received via ${data['form_name']} form and inserted into your Google sheet at: ${url}`, //mail body { name: 'Automatic Emailer Script' } ); };