Modern WordPress template

Introduction

This template is using Bedrock, an open source project and completely free to use.

This project uses Sage theme which is an advanced WordPress starter theme with Tailwind CSS and Laravel Blade support out of the box.

Instructions

Prerequisite

Make sure you have Docker and Lando installed on your system

Environment setup

After cloning the repository, create .env from an .env.example

cp .env.example .env

Generate salts by pasting the environment variables from roots website

Setup

First, stop all Docker containers to avoid conflicts

docker stop $(docker ps -qa)

Automated setup

Change into root and run (you might not need this step)

sudo chmod u+x ./bootstrap.sh

then start the development environment

./bootstrap.sh

If the development environment is working correctly, you can skip to configuring .htaccess.

---

Manual setup

If an automated setup fails for some reason or you don't trust shell scripts, you'll need to start development environment manually

First, start the projects' lando dev environment

lando start

after containers are up, install dependencies from project root and theme folder:

lando composer install

and

cd web/app/themes/sage

lando composer install

Install and build node dependencies (might not need this step)

lando yarn
lando yarn build

Load demo db

Next you'll need to load demo database that's in projects' root directory, from project root run

lando wp db create

lando db-import demo.*

---

Configuring htaccess

In order for permalinks to work correctly you'll manually need to update .htaccess, go to permalinks admin page and save settings.

Configuring certificates

You can follow this guide if you find browser warnings anoying, beware if you use firefox as it controls it's own store and it needs additional browser configuration.

---

NOTE:

The credentials for admin account are weak since this is a development environment and should be changed / removed before deployment.

username: admin
password: password

go to: https://wordpress.lndo.site

for hmr capabilities: http://localhost:3000