Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve the Drupal and Craft examples of adding a new site #217

Merged
merged 2 commits into from
Feb 19, 2024
Merged

Improve the Drupal and Craft examples of adding a new site #217

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d56be6e
Improve the Drupal and Craft examples of adding a new site
tomjn Feb 18, 2024
08dda33
Mention the setup URL for Craft and creating a database
tomjn Feb 18, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 12 additions & 4 deletions docs/en-US/adding-a-new-site/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -157,7 +157,7 @@ sites:
folders:
public_html/wp-content/:
git:
repo: repo to clone...
repo: "repo to clone..."
overwrite_on_clone: true
```

Expand All @@ -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:
Expand All @@ -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:
Expand All @@ -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).

Expand Down