Installation
Prerequisites
Section titled “Prerequisites”Before Installation
Section titled “Before Installation”Project names should contain no hyphens, capitals or punctuation marks.
This includes
- GitHub repository name
- DDEV .config file values
Installation Steps
Section titled “Installation Steps”-
Create a new GitHub repository with this repository as template.
-
Clone the newly created repository to your computer.
-
Change the name in .ddev/config.yaml to correct project name (usually the repository name)
.ddev/config.yaml name: lumbermillname: yourprojectname -
Create
auth.jsonin the project root and paste the following content, this file is used for installing Advanced Custom Fieldsauth.json {"http-basic": {"connect.advancedcustomfields.com": {"username": "b3JkZXJfaWQ9Njc3OTl8dHlwZT1kZXZlbG9wZXJ8ZGF0ZT0yMDE1LTEwLTMxIDEzOjE3OjA4","password": "https://localhost"}}}There is no need to change the values
-
Start DDEV
Terminal window ddev start -
Build theme assets
Terminal window ddev npm run build -
Run the WordPress installation by opening the project in your browser.
Terminal window ddev launch -
Installation Values
- Language: English (Australia)
- Site Title: Project Name
- Username: project-name-instance
- Email: wordpress@instance.studio
Replace Project Name/project-name with the project name
-
Store the login details somewhere safe.
Bitwarden is a solid choice. Share passwords securely via secrets.instance.studio.
-
Login to the wp-admin area.
-
Update the Permalink settings found under Settings in the menu to
Post name
My pages are 404’ing
Add the following .htaccess file to the web folder
<IfModule mod_rewrite.c>
# BEGIN WordPress
RewriteEngine OnRewriteRule .\* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]RewriteBase /RewriteRule ^index\.php$ - [L]RewriteCond %{REQUEST_FILENAME} !-fRewriteCond %{REQUEST_FILENAME} !-dRewriteRule . /index.php [L]
# END WordPress
</IfModule>
