/jordy

WordPress theme which provide useful features to create WordPress API endpoints

Primary LanguagePHPMIT LicenseMIT

Jordy

Jordy is a WordPress theme which provide useful features to create WordPress API endpoints queryable from modern stack front-end (such as GatsbyJS, Gridsome etc.).

Requirements

Getting started

Clone the repo :

$ git clone https://github.com/toinelin/jordy.git

Create jordy.dev vhost using dnsmasq (macOS) :

=> Full tuto here

Install dnsmasq :

# Install dnsmasq
$ brew up && brew install dnsmasq
# Copy the default configuration file.
$ cp $(brew list dnsmasq | grep /dnsmasq.conf.example$) /usr/local/etc/dnsmasq.conf
# Copy the daemon configuration file into place.
$ sudo cp $(brew list dnsmasq | grep /homebrew.mxcl.dnsmasq.plist$) /Library/LaunchDaemons/
# Start Dnsmasq automatically.
$ sudo launchctl load /Library/LaunchDaemons/homebrew.mxcl.dnsmasq.plist

Update dnsmasq.conf :

$ vim /usr/local/etc/dnsmasq.conf

Add address option :

address=/dev/127.0.0.1

Restart dnsmasq :

$ sudo launchctl stop homebrew.mxcl.dnsmasq
$ sudo launchctl start homebrew.mxcl.dnsmasq

Create resolver :

$ sudo mkdir -p /etc/resolver
$ cd /etc/resolver
$ sudo touch jordy.dev
$ sudo vim jordy.dev

Paste it this

sudo tee /etc/resolver/dev >/dev/null <<EOF
nameserver 127.0.0.1
EOF

Generate SSL certification for dev

=> Full tuto here

Create certificate authority (w'ill create it on /docker/caddy/ssl but you should store CA keys in safe place and use it globaly)

$ cd docker/caddy/ssl
$ openssl genrsa -des3 -out JordyRootCA.key 2048
$ openssl req -x509 -new -nodes -key JordyRootCA.key -sha256 -days 1825 -out JordyRootCA.pem

=> Install certificate authority

$ openssl genrsa -out jordy.dev.key 2048
$ openssl req -new -key jordy.dev.key -out jordy.dev.csr # Copy the absolute path of jordy.dev.key

Create a jordy.dev.ext file and paste it this :

authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
subjectAltName = @alt_names

[alt_names]
DNS.1 = jordy.dev

Create the certificate :

$ openssl x509 -req -in jordy.dev.csr -CA JordyRootCA.pem -CAkey JordyRootCA.key -CAcreateserial -out jordy.dev.crt -days 1825 -sha256 -extfile jordy.dev.ext

Then delete jordy.dev.csr

Scripts

Start development

$ cd docker
$ sh ./bin/dev.sh

Build production

$ cd docker
$ sh ./bin/prod.sh

Kill Docker containers

$ cd docker
$ sh ./bin/kill.sh

Generate mysql export (use as cron to generate mysql backup over time)

$ cd docker
$ sh ./bin/export.sh

Install Jordy WordPress Theme

$ cd docker
$ sh ./bin/install.sh

Next steps

TODO

  • Add WordPress CLI for automation
  • Create docker env for dev / prod
  • Add Caddy container for reverse proxy / https
  • [-] Add user restriction for nginx and mysql
  • Create the WordPress API Theme
  • [] Create automated script to generate vhost and CA
  • [] Improve TTFB with cache
  • [] Improve documentation
  • [] Improve branding

Credits

Thomas Sutton
Brad Touesnard @ Delicious Brain
bounca.org
tylerlwsmith