Skip to content

Commit f680e85

Browse files
Add to faq improve on PR 344 (dwyl#398)
* Add-FAQ-to-README * Address Sean's code review feedback for FAQ (dwyl#344) Co-authored-by: athenaozanich <athenaozanich@gmail.com>
1 parent d4c8902 commit f680e85

File tree

1 file changed

+10
-7
lines changed

1 file changed

+10
-7
lines changed

README.md

+10-7
Original file line numberDiff line numberDiff line change
@@ -25,19 +25,19 @@ when you don't (*want* to) *have* a *server*.
2525
+ No "*Backend*" to Deploy/Maintain/Pay for
2626
+ ***Fully Customisable*** - every aspect is customisable!
2727
+ Email *sent via* ***Google Mail*** which is ***Whitelisted Everywhere*** (*high deliverability success*)
28-
+ **Collect/Store** any **form data** in a ***Spreadsheet*** for easy viewing
28+
+ **Collect/Store** any **form data** in a ***Spreadsheet*** for easy viewing
2929
(*perfect if you need to share it with non-technical people*)
3030

3131
## What?
3232

3333
Instead of using a server to send your email,
34-
which is *easy* but requires *maintenance*,
34+
which is *easy* but requires *maintenance*,
3535
use Google to send mail on your behalf
3636
and use Google Spreadsheets to keep track of the data!
3737

3838
> You *could* use a "*free*" service like http://formspree.io/ to process your form submissions
39-
if you don't care where you are sending your data and want to manage the data submitted
40-
in your email inbox (*messy ... yuck*!)
39+
if you don't care where you are sending your data and want to manage the data submitted
40+
in your email inbox (*messy ... yuck*!)
4141
*Or*... you can *invest* a few minutes and keep data private/manageable.
4242
*Take your pick*.
4343

@@ -99,7 +99,7 @@ Then *create* your new version:
9999

100100
![20 a-publish](https://cloud.githubusercontent.com/assets/194400/10558288/50980aa8-74c2-11e5-8576-72084a564779.png)
101101

102-
Select the *latest* project version to deploy.
102+
Select the *latest* project version to deploy.
103103
:warning: Note: You *must* select the `Anyone, even anonymous` option for the 'Who has access to the app' dropdown or form responses will not be added to the spreadsheet! :warning:
104104

105105
![21 deploy-new-version](https://cloud.githubusercontent.com/assets/194400/10558251/570a5428-74c1-11e5-8ced-5dd26d3de3c4.png)
@@ -230,7 +230,7 @@ You can modify this though, via the script editor. The line:
230230
result += "<h4 style='text-transform: capitalize; margin-bottom: 0'>" + key + "</h4><div>" + obj[key] + "</div>";
231231
```
232232

233-
has all you need. You can adjust the markup to suit you. We chose an `<h4>` because it was the best size for the email, and added the small amount of CSS to it to fix the capitalisation (the keys are all lower case in the JS object) and a bit of default spacing. While inline styles like this are generally bad practice on normal web pages, for email HTML they're about the only reliable way to do CSS!
233+
has all you need. You can adjust the markup to suit you. We chose an `<h4>` because it was the best size for the email, and added the small amount of CSS to it to fix the capitalisation (the keys are all lower case in the JS object) and a bit of default spacing. While inline styles like this are generally bad practice on normal web pages, for email HTML they're about the only reliable way to do CSS!
234234
We went with a `<div>` for the value part, because it could be anything - single-line, multiline (a `<p>` for example wouldn't cut it).
235235

236236
While we're here, there's also a `replyTo` option for the `sendEmail()` method which is commented out by default:
@@ -260,7 +260,7 @@ the data into a spreadsheet is safer and less prone to data loss.
260260

261261
![record_data example](https://cloud.githubusercontent.com/assets/194400/10581613/8b4f9ad4-767b-11e5-90cc-962a9d6acc91.png)
262262

263-
This will record the data received from the `POST` as a *row* in the spreadsheet.
263+
This will record the data received from the `POST` as a *row* in the spreadsheet.
264264
See: [**google-apps-script.js**](google-apps-script.js) for the full code you can *copy-paste*.
265265

266266
### 15. Save a New Version and Re-Publish it
@@ -381,6 +381,9 @@ Let us know if you have any questions!
381381

382382
- No. While data that is sent over POST may be more protected, the information could easily be intercepted by a third party or middleman, and Google has complete access to the data inside a Google Spreadsheet. Email is also not a very secure communication medium by default. We would recommend you invest in a secure platform and server for storing your data if this is a requirement.
383383

384+
8. _What if my data is sent or stored in the wrong order?_
385+
386+
- If your data is in the wrong order, it is recommended to verify that you are loading the clientside JS correctly. The most effective way to do this is to place a `debugger` call inside the `handleFormSubmit()` function, and, if it hits the debugger and opens the respective Dev Tools for the broswer/environment, then the clientside JS is being loaded correctly. If the debugger isn't hit, then the JS is **not** either not loaded or not targeting your form, defaulting the data to a plain object which will have its own alphabetic ordering instead.
384387

385388
## Background Reading
386389

0 commit comments

Comments
 (0)