Compare commits
7 commits
php-refact
...
master
Author | SHA1 | Date | |
---|---|---|---|
|
a342ad0842 | ||
|
332fec136e | ||
|
e66970f2a9 | ||
|
18605d862e | ||
|
f11560681e | ||
|
4d2ffda447 | ||
|
f2fa52d987 |
16 changed files with 2892 additions and 355 deletions
2
.dockerignore
Normal file
2
.dockerignore
Normal file
|
@ -0,0 +1,2 @@
|
|||
node_modules
|
||||
vendor
|
5
.gitignore
vendored
5
.gitignore
vendored
|
@ -1,4 +1,5 @@
|
|||
node_modules
|
||||
development.yml
|
||||
production.yml
|
||||
local.json
|
||||
development.json
|
||||
production.json
|
||||
vendor
|
||||
|
|
|
@ -1,3 +0,0 @@
|
|||
{
|
||||
"esversion": 6
|
||||
}
|
5
Dockerfile
Normal file
5
Dockerfile
Normal file
|
@ -0,0 +1,5 @@
|
|||
FROM node:14-alpine
|
||||
WORKDIR /app
|
||||
COPY . .
|
||||
RUN npm ci
|
||||
ENTRYPOINT [ "node", "index.js" ]
|
61
README.md
61
README.md
|
@ -15,10 +15,10 @@ A basic node server for sending email forms.
|
|||
</form>
|
||||
```
|
||||
|
||||
This project is, in some way, a clone of a great free service: [Formspree.io](https://formspree.io/). Although Formspree is great, it might **not** be the best option for everyone; 2 key factors drived me to create this clone:
|
||||
This project is, in some way, a clone of an excellent free service: [Formspree.io](https://formspree.io/). Although Formspree is outstanding, it might **not** be the best option for everyone; 2 key factors drove me to create this clone:
|
||||
|
||||
1. Setup (and maintenance) should be minimal.
|
||||
Formspree is opensource and it's code is on GitHub, but the setup process is way more than a trivial task, not to mention the requirements. Requirement 1 not met.
|
||||
Formspree is opensource, and its code is on GitHub, but the setup process is way more than a trivial task, not to mention the requirements. Requirement 1 not met.
|
||||
|
||||
1. Should allow me to send attachments.
|
||||
Formspree does not allow you to send email forms with attachments (at least not at the time when this written). Requirement 2 not met.
|
||||
|
@ -32,38 +32,39 @@ This project is, in some way, a clone of a great free service: [Formspree.io](ht
|
|||
|
||||
Clone this repo on your server or download the zip file.
|
||||
|
||||
Once you have the code, run `npn install --production` to download and install all the project dependencies required to run this project.
|
||||
Once you have the code, run `npm install --production` to download and install all the project dependencies required to run this project.
|
||||
|
||||
Next step, configure your server. Open `config/config.yml` which should look like this:
|
||||
Next step, configure your server. Open `config/config.json` which should look like this:
|
||||
|
||||
```yml
|
||||
emails:
|
||||
mailgun:
|
||||
url:
|
||||
key:
|
||||
```json
|
||||
{
|
||||
"emails": [],
|
||||
"mailgun": {
|
||||
"url": "",
|
||||
"key": ""
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
And update the values to match your preferences:
|
||||
|
||||
- **emails** is an array of email addresses. This emails are the **ONLY** emails this server will be allowed to send emails to (authorized emails)
|
||||
- **emails** is an array of email addresses. These emails are the **ONLY** emails this server will be allowed to send emails to (authorized emails)
|
||||
- **mailgun.url** your Mailgun API URL
|
||||
- **mailgun.key** you Mailgun Domain API Key
|
||||
|
||||
An example of a `config.yml` file:
|
||||
An example of a `config.json` file:
|
||||
|
||||
```yml
|
||||
emails:
|
||||
- sales@example.com
|
||||
- contact@example.com
|
||||
- support@example.com
|
||||
mailgun:
|
||||
url: https://api.mailgun.net/v3/example.com/messages
|
||||
key: key-l0r3m1p5umd0l0r5174m37c0n53c737u
|
||||
```json
|
||||
{
|
||||
"emails": ["sales@example.com", "contact@example.com", "support@example.com"],
|
||||
"mailgun": {
|
||||
"url": "https://api.mailgun.net/v3/example.com/messages",
|
||||
"key": "key-l0r3m1p5umd0l0r5174m37c0n53c737u"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Contact** uses [indecent.js][indecent] for loading its YAML configuration files, this allows you to override the above settings based on the value of `NODE_ENV`. You can read more about that in the [module documentation][indecent].
|
||||
|
||||
[indecent]: https://github.com/eruizdechavez/indecent.js
|
||||
**Contact** uses `NODE_ENV` environment variable for loading its JSON configuration files, this allows you to override the above settings with other JSON files, for example, `config/production.json`.
|
||||
|
||||
## Server Usage
|
||||
|
||||
|
@ -73,15 +74,15 @@ To run the server, just run `node index.js`. You can use other node runners to k
|
|||
|
||||
Once your server is up and running, all you need to do is create an HTML form and point it to your server.
|
||||
|
||||
Your form's action should point to your **contact** server using a valid email address (defined in the YAML file). If the email address is not in the whitelist the email will not be sent.
|
||||
Your form's action should point to your **contact** server using a valid email address (defined in the YAML file). If the email address is not in the whitelist, the email will not be sent.
|
||||
|
||||
### Fields
|
||||
|
||||
- **_from**: *Required*. This is usually the email address of the user submitting the email form. It will be used as the Form field.
|
||||
- **_subject**: *Optional*. The email subject.
|
||||
- **_info**: *Optional*. This text will be included in the email body before the values. Useful for providing some context in the email body.
|
||||
- **_attachment**: *Optional*. A file can be attached to the email form using this for the name of an `<input type="file"/>`. When sending attachments do not forget to include `enctype="multipart/form-data"` in your form tag.
|
||||
- **_next**: *Optional*. A URL to redirect the user once the form was submited succesfully.
|
||||
- **_fake**: *For testing*. If `true`, the email will not be sent and instead a JSON paylod will be shown. Useful when testing the form with a REST client.
|
||||
- **\_from**: _Required_. This is usually the email address of the user submitting the email form. It will be used as the Form field.
|
||||
- **\_subject**: _Optional_. The email subject.
|
||||
- **\_info**: _Optional_. This text will be included in the email body before the values. Useful for providing some context in the email body.
|
||||
- **\_attachment**: _Optional_. A file can be attached to the email form using this for the name of an `<input type="file"/>`. When sending attachments do not forget to include `enctype="multipart/form-data"` in your form tag.
|
||||
- **\_next**: _Optional_. A URL to redirect the user once the form was submitted successfully.
|
||||
- **\_fake**: _For testing_. If `true`, the email will not be sent and instead a JSON payload will be shown. Useful when testing the form with a REST client.
|
||||
|
||||
All other form fields will be send by title casing the name. For example `<input type="text" name="first_name" />` will be displayed in the email as "First Name:"
|
||||
All other form fields will be sent by title casing the name. For example `<input type="text" name="first_name" />` will be displayed in the email as "First Name:"
|
||||
|
|
|
@ -1,6 +0,0 @@
|
|||
{
|
||||
"require": {
|
||||
"rmccue/requests": "^1.7",
|
||||
"xamin/handlebars.php": "^0.10.4"
|
||||
}
|
||||
}
|
109
composer.lock
generated
109
composer.lock
generated
|
@ -1,109 +0,0 @@
|
|||
{
|
||||
"_readme": [
|
||||
"This file locks the dependencies of your project to a known state",
|
||||
"Read more about it at https://getcomposer.org/doc/01-basic-usage.md#composer-lock-the-lock-file",
|
||||
"This file is @generated automatically"
|
||||
],
|
||||
"content-hash": "a54bd6daf1501e5092742fd20e496fec",
|
||||
"packages": [
|
||||
{
|
||||
"name": "rmccue/requests",
|
||||
"version": "v1.7.0",
|
||||
"source": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/rmccue/Requests.git",
|
||||
"reference": "87932f52ffad70504d93f04f15690cf16a089546"
|
||||
},
|
||||
"dist": {
|
||||
"type": "zip",
|
||||
"url": "https://api.github.com/repos/rmccue/Requests/zipball/87932f52ffad70504d93f04f15690cf16a089546",
|
||||
"reference": "87932f52ffad70504d93f04f15690cf16a089546",
|
||||
"shasum": ""
|
||||
},
|
||||
"require": {
|
||||
"php": ">=5.2"
|
||||
},
|
||||
"require-dev": {
|
||||
"requests/test-server": "dev-master"
|
||||
},
|
||||
"type": "library",
|
||||
"autoload": {
|
||||
"psr-0": {
|
||||
"Requests": "library/"
|
||||
}
|
||||
},
|
||||
"notification-url": "https://packagist.org/downloads/",
|
||||
"license": [
|
||||
"ISC"
|
||||
],
|
||||
"authors": [
|
||||
{
|
||||
"name": "Ryan McCue",
|
||||
"homepage": "http://ryanmccue.info"
|
||||
}
|
||||
],
|
||||
"description": "A HTTP library written in PHP, for human beings.",
|
||||
"homepage": "http://github.com/rmccue/Requests",
|
||||
"keywords": [
|
||||
"curl",
|
||||
"fsockopen",
|
||||
"http",
|
||||
"idna",
|
||||
"ipv6",
|
||||
"iri",
|
||||
"sockets"
|
||||
],
|
||||
"time": "2016-10-13T00:11:37+00:00"
|
||||
},
|
||||
{
|
||||
"name": "xamin/handlebars.php",
|
||||
"version": "v0.10.4",
|
||||
"source": {
|
||||
"type": "git",
|
||||
"url": "https://github.com/XaminProject/handlebars.php.git",
|
||||
"reference": "b85cee07eae96db0e1eec224ca90f5ce1e4d857a"
|
||||
},
|
||||
"dist": {
|
||||
"type": "zip",
|
||||
"url": "https://api.github.com/repos/XaminProject/handlebars.php/zipball/b85cee07eae96db0e1eec224ca90f5ce1e4d857a",
|
||||
"reference": "b85cee07eae96db0e1eec224ca90f5ce1e4d857a",
|
||||
"shasum": ""
|
||||
},
|
||||
"require-dev": {
|
||||
"phpunit/phpunit": "~4.4",
|
||||
"squizlabs/php_codesniffer": "~1.5"
|
||||
},
|
||||
"type": "library",
|
||||
"autoload": {
|
||||
"psr-0": {
|
||||
"Handlebars": "src/"
|
||||
}
|
||||
},
|
||||
"notification-url": "https://packagist.org/downloads/",
|
||||
"license": [
|
||||
"MIT"
|
||||
],
|
||||
"authors": [
|
||||
{
|
||||
"name": "fzerorubigd",
|
||||
"email": "fzerorubigd@gmail.com"
|
||||
},
|
||||
{
|
||||
"name": "Behrooz Shabani (everplays)",
|
||||
"email": "everplays@gmail.com"
|
||||
}
|
||||
],
|
||||
"description": "Handlebars processor for php",
|
||||
"homepage": "https://github.com/XaminProject/handlebars.php",
|
||||
"time": "2016-12-12T13:51:02+00:00"
|
||||
}
|
||||
],
|
||||
"packages-dev": [],
|
||||
"aliases": [],
|
||||
"minimum-stability": "stable",
|
||||
"stability-flags": [],
|
||||
"prefer-stable": false,
|
||||
"prefer-lowest": false,
|
||||
"platform": [],
|
||||
"platform-dev": []
|
||||
}
|
BIN
composer.phar
BIN
composer.phar
Binary file not shown.
7
config/config.json
Normal file
7
config/config.json
Normal file
|
@ -0,0 +1,7 @@
|
|||
{
|
||||
"emails": [],
|
||||
"mailgun": {
|
||||
"url": "",
|
||||
"key": ""
|
||||
}
|
||||
}
|
|
@ -1,4 +0,0 @@
|
|||
emails:
|
||||
mailgun:
|
||||
url:
|
||||
key:
|
13
docker-compose.yml
Normal file
13
docker-compose.yml
Normal file
|
@ -0,0 +1,13 @@
|
|||
services:
|
||||
node:
|
||||
build:
|
||||
context: .
|
||||
restart: always
|
||||
ports:
|
||||
- 8081:8081
|
||||
networks:
|
||||
- palmiers
|
||||
|
||||
networks:
|
||||
palmiers:
|
||||
external: true
|
|
@ -1,5 +1,6 @@
|
|||
<!DOCTYPE html>
|
||||
<html>
|
||||
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<style media="screen">
|
||||
|
@ -9,6 +10,7 @@
|
|||
}
|
||||
</style>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<p>{{info}}</p>
|
||||
<table>
|
||||
|
@ -28,4 +30,5 @@
|
|||
<p> </p>
|
||||
<p> </p>
|
||||
</body>
|
||||
|
||||
</html>
|
||||
|
|
65
index.js
65
index.js
|
@ -3,27 +3,38 @@ const restify = require('restify');
|
|||
const Handlebars = require('handlebars');
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
const config = require('indecent');
|
||||
|
||||
const corsMiddleware = require('restify-cors-middleware');
|
||||
const cors = corsMiddleware({
|
||||
preflightMaxAge: 5,
|
||||
origins: ['*'],
|
||||
});
|
||||
const { chain, get, indexOf, merge, set, startCase } = require('lodash');
|
||||
|
||||
const knownEmails = get(config, 'emails');
|
||||
let defaults;
|
||||
try {
|
||||
defaults = JSON.parse(fs.readFileSync(path.join(__dirname, 'config', 'config.json'), { encoding: 'utf8' }));
|
||||
} catch (err) {
|
||||
console.log(err.message);
|
||||
defaults = {};
|
||||
}
|
||||
let environment;
|
||||
|
||||
try {
|
||||
environment = JSON.parse(
|
||||
fs.readFileSync(path.join(__dirname, 'config', `${process.env.NODE_ENV}.json`), { encoding: 'utf8' })
|
||||
);
|
||||
} catch (err) {
|
||||
console.log(err.message);
|
||||
environment = {};
|
||||
}
|
||||
|
||||
const config = merge(defaults, environment);
|
||||
const knownEmails = get(config, 'emails');
|
||||
const MAILGUN_URL = get(config, 'mailgun.url');
|
||||
const MAILGUN_API_KEY = get(config, 'mailgun.key');
|
||||
|
||||
const FORM_FIELDS = [
|
||||
'_from',
|
||||
'_subject',
|
||||
'_to',
|
||||
'_attachment'
|
||||
];
|
||||
|
||||
const PRIVATE_FIELDS = [
|
||||
'_fake',
|
||||
'_info',
|
||||
'_next'
|
||||
];
|
||||
const FORM_FIELDS = ['_from', '_subject', '_to', '_attachment'];
|
||||
const PRIVATE_FIELDS = ['_fake', '_info', '_next'];
|
||||
|
||||
const htmlSource = fs.readFileSync(path.join(__dirname, 'html_template.hbs'), { encoding: 'utf8' });
|
||||
const textSource = fs.readFileSync(path.join(__dirname, 'text_template.hbs'), { encoding: 'utf8' });
|
||||
|
@ -31,11 +42,17 @@ const htmlTemplate = Handlebars.compile(htmlSource);
|
|||
const textTemplate = Handlebars.compile(textSource);
|
||||
|
||||
var server = restify.createServer();
|
||||
server.use(restify.CORS());
|
||||
server.use(restify.bodyParser());
|
||||
server.pre(cors.preflight);
|
||||
server.use(cors.actual);
|
||||
server.use(
|
||||
restify.plugins.bodyParser({
|
||||
mapParams: true,
|
||||
})
|
||||
);
|
||||
|
||||
server.get('/status', (req, res, next) => {
|
||||
res.send('contact running');
|
||||
return next();
|
||||
});
|
||||
|
||||
server.post('/:_to', (req, res, next) => {
|
||||
|
@ -49,13 +66,14 @@ server.post('/:_to', (req, res, next) => {
|
|||
formData,
|
||||
auth: {
|
||||
user: 'api',
|
||||
pass: MAILGUN_API_KEY
|
||||
pass: MAILGUN_API_KEY,
|
||||
},
|
||||
url: MAILGUN_URL,
|
||||
method: 'post'
|
||||
method: 'post',
|
||||
};
|
||||
|
||||
sendMail(fields, params).then(response => {
|
||||
sendMail(fields, params)
|
||||
.then(response => {
|
||||
const redirect = get(fields, 'next');
|
||||
if (redirect) {
|
||||
res.redirect(redirect, next);
|
||||
|
@ -64,7 +82,8 @@ server.post('/:_to', (req, res, next) => {
|
|||
}
|
||||
|
||||
return next();
|
||||
}).catch(error => {
|
||||
})
|
||||
.catch(error => {
|
||||
return next(error);
|
||||
});
|
||||
});
|
||||
|
@ -104,8 +123,8 @@ function parseRequest (req) {
|
|||
value,
|
||||
options: {
|
||||
filename: get(attachment, 'name'),
|
||||
contentType: get(attachment, 'type')
|
||||
}
|
||||
contentType: get(attachment, 'type'),
|
||||
},
|
||||
});
|
||||
}
|
||||
|
||||
|
|
46
index.php
46
index.php
|
@ -1,46 +0,0 @@
|
|||
<?php
|
||||
require_once './vendor/autoload.php';
|
||||
// phpinfo();
|
||||
|
||||
// $response = Requests::get('https://api.github.com/events');
|
||||
// var_dump(json_decode($response->body));
|
||||
|
||||
// var_dump($_GET);
|
||||
// var_dump($_POST);
|
||||
|
||||
$method = $_SERVER['REQUEST_METHOD'];
|
||||
|
||||
// if ($method == 'GET') {
|
||||
// echo 'contact running';
|
||||
// exit;
|
||||
// }
|
||||
|
||||
const FORM_FIELDS = [
|
||||
'_from',
|
||||
'_subject',
|
||||
'_to',
|
||||
'_attachment',
|
||||
];
|
||||
|
||||
const PRIVATE_FIELDS = [
|
||||
'_fake',
|
||||
'_info',
|
||||
'_next',
|
||||
];
|
||||
|
||||
$formData = [
|
||||
'from' => $_POST['_from'],
|
||||
'subject' => $_POST['_subject'],
|
||||
'to' => $_POST['_to'],
|
||||
'attachment' => $_POST['_attachment'],
|
||||
];
|
||||
|
||||
$fields = [
|
||||
'fake' => $_POST['_fake'],
|
||||
'info' => $_POST['_info'],
|
||||
'next' => $_POST['_next'],
|
||||
];
|
||||
|
||||
var_dump($formData, $fields);
|
||||
|
||||
echo 'DONE';
|
2654
package-lock.json
generated
Normal file
2654
package-lock.json
generated
Normal file
File diff suppressed because it is too large
Load diff
12
package.json
12
package.json
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"name": "contact",
|
||||
"version": "1.0.1",
|
||||
"version": "2.0.0",
|
||||
"description": "A basic clone of formspree.io for internal use",
|
||||
"main": "index.js",
|
||||
"homepage": "https://github.com/eruizdechavez/contact",
|
||||
|
@ -17,11 +17,11 @@
|
|||
},
|
||||
"private": true,
|
||||
"dependencies": {
|
||||
"handlebars": "4.0.5",
|
||||
"indecent": "1.0.1",
|
||||
"lodash": "4.13.1",
|
||||
"request": "2.72.0",
|
||||
"restify": "4.1.1"
|
||||
"handlebars": "4.1.2",
|
||||
"lodash": "4.17.11",
|
||||
"request": "2.88.0",
|
||||
"restify": "8.3.2",
|
||||
"restify-cors-middleware": "1.1.1"
|
||||
},
|
||||
"devDependencies": {
|
||||
"semistandard": "*"
|
||||
|
|
Loading…
Reference in a new issue