1. The instructions assume you have git and Docker installed.
2. You need a UCSC VPN connection to use the Campus Directory block in the UCSC Gutenberg Blocks plugin.

1. Clone this repo

   • git clone https://github.com/ucsc/wp-dev.ucsc.git && cd wp-dev.ucsc

2. Edit your hosts file and add 127.0.0.1 wp-dev.ucsc or use the command below

   • sudo echo "127.0.0.1 wp-dev.ucsc" >> /etc/hosts

3. Change .env.example.txt to .env and update the variables if you like.

4. Build and start the WordPress server with HTTPS & PHP LDAP module (Allow time for this command to finish)

   • docker compose up -d

5. Run the following script to clone the theme and plugins to the correct project directories.

   • ./setup.sh

6. Next we install WordPress, activate the theme & plugin, run composer install on the theme as well as npm install on both the plugin and the theme

   • docker compose -f docker-compose-install.yml run theme_composer_install
   • docker compose -f docker-compose-install.yml run theme_npm_install
   • docker compose -f docker-compose-install.yml run plugin_npm_install (may take up to 2 minutes to complete)
   • docker compose -f docker-compose-install.yml run wordpress_install

Your installation is now complete.

Now that WordPress is installed and the plugins and theme are built, we can start watching for changes to code and rebuild when necessary

• Starts the WordPress server environment
  • docker compose up -d
• Starts the Node development environments for the theme and blocks plugin
  • docker compose -f docker-compose-start.yml up -d

At this point you should be able to visit https://wp-dev.ucsc/wp-admin in a browser. In Google Chrome you will get a error saying "Your connection is not private", this is due to the local certificates. You can click Advanced -> proceed to wp-dev.ucsc. To login:

• username: admin
• password password

The PHP Debug plugin is required. On the debug tab click Create a launch.json file and select type php.

You can replace the contents of launch.json with the following:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "/var/www/html/wp-content/plugins/ucsc-gutenberg-blocks": "${workspaceRoot}"
      },
      "hostname": "wp-dev.ucsc"
    }
  ]
}