contact-form/README.md
2020-02-02 13:18:45 +01:00

1.6 KiB

ghost-contact-form

Add a beautiful, fully functional contact form to your Ghost blog or website without paying for external services.

Not running on Ghost? This solution also works with Gatsby, Hugo, Hexo, Nuxt and any other static site generator.

Tutorial

Prerequisites

  • A supported version of Node.js
  • npm to manage packages

Quickstart Install

$ git clone https://github.com/styxlab/ghost-contact-form.git
$ cd ghost-contact-form
$ sh install.sh

Configure

Adapt the .env file to your needs. The following variables must be defined.

SMTP_HOST = mail.server.com
SMTP_USER = user@server.com
SMTP_PASS = strong password
ALLOW_ORIGIN = https://your-blog.com
EMAIL_FROM = noreply@your-blog.com
EMAIL_TO = your@email.com

Additionally, you can add a port vairable PORT = , if you want to change thedefault port 7000 to something else.

Usage

$ node ghost-contact-svc.js

You should see the message Listening on http://localhost:7000.

Test Locally

http://localhost:7000/v1/demo

Deploy (More detailed info in the tutorial)

  • copy the work folder ghost-contact-form to your server
  • use ghost-contact.service as a starting point for running ghost-contact-svc.js as a systemd deamon
  • configure your webserver to map endpoint http://localhost:7000/ to a public endpoint, e.g. https://api.your-blog.com/
  • Use the files in folder ghost-admin to configure your front-end
  • Other front-end config files upon request!