From 075c487a03f42d9aee1d20251a126085194c6957 Mon Sep 17 00:00:00 2001 From: Tom J Nowell Date: Mon, 19 Feb 2024 10:00:34 +0000 Subject: [PATCH] Improve the Drupal and Craft examples of adding a new site (#217) --- docs/en-US/adding-a-new-site/index.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/docs/en-US/adding-a-new-site/index.md b/docs/en-US/adding-a-new-site/index.md index 7956026..5461da5 100644 --- a/docs/en-US/adding-a-new-site/index.md +++ b/docs/en-US/adding-a-new-site/index.md @@ -157,7 +157,7 @@ sites: folders: public_html/wp-content/: git: - repo: repo to clone... + repo: "repo to clone..." overwrite_on_clone: true ``` @@ -167,6 +167,8 @@ This creates a WP site named `acmecorp` at `http://acme.test` in the `www/acmeco ### Drupal +This creates a Drupal site named `drupal-site` at `http://drupal.test` in the `www/drupal-site/public_html` folder. + ```yaml sites: drupal-site: @@ -179,12 +181,15 @@ sites: create-project: drupal/recommended-project custom: wp_type: none + public_dir: public_html/web ``` -This creates a Drupal site named `drupal-site` at `http://drupal.test` in the `www/drupal-site/public_html` folder. You will need to create a database using PHPMyAdmin for this site. +You will need to create a database using PHPMyAdmin for this site, and you might need to create custom Nginx rules. The example also assumes a `public_html/web` subfolder is the webroot based on Drupal recommendations at the time of writing. ### CraftCMS +This should set up a copy of Craft CMS in the `public_html` folder, and tells VVV to serve the `public_html/web` subfolder as the root, you may need to adjust the Nginx configuration of this site, or decide to change the folder configuration: + ```yaml sites: craft: @@ -197,13 +202,16 @@ sites: create-project: craftcms/craft custom: wp_type: none + public_dir: public_html/web ``` -This creates a Craft CMS site named `cratt` at `http://craft.test` in the `www/craft/public_html` folder. +This creates a Craft CMS site named `craft` at `http://craft.test` in the `www/craft/public_html` folder. Set up a database/user for Craft to use then head to `https://craft.test/index.php?p=admin/install` to continue the installation. After provisioning, you will need to complete setup by following [the official Craft CMS install instructions](https://craftcms.com/docs/3.x/installation.html). -### Additional Options +Note that while this will install Craft for you via composer, nothing prevents setting `wp_type: none;` and manually installing Craft by hand. + +### Additional Configuration Options The custom site template supports options such as changing the version of WordPress, database names, site titles, and more. [For a full list of what the official site template supports, check the readme on Github](https://github.com/Varying-Vagrant-Vagrants/custom-site-template).