From 5037dc0c5354194b4d20629f29b8742fca445132 Mon Sep 17 00:00:00 2001 From: Rachel Whitton Date: Mon, 2 Dec 2024 15:43:48 -0600 Subject: [PATCH] Consolidate add-site-dashboard to getstarted guide, update links throughout --- source/content/add-site-dashboard.md | 54 ------------------- source/content/crisis-response-upstream.md | 2 +- .../account-mgmt/traffic/01-introduction.md | 2 +- .../content/guides/getstarted/06-addsite.md | 47 +++++++--------- .../content/guides/launch/01-introduction.md | 2 +- .../05-wordpress-phpstorm.md | 2 +- source/content/supported-drupal.md | 4 +- .../2024-10-04-drupal-11-site-creation.md | 2 +- 8 files changed, 27 insertions(+), 88 deletions(-) delete mode 100644 source/content/add-site-dashboard.md diff --git a/source/content/add-site-dashboard.md b/source/content/add-site-dashboard.md deleted file mode 100644 index ba3521fe27..0000000000 --- a/source/content/add-site-dashboard.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -title: Create a New CMS Site -description: Create a WordPress or Drupal site using the Dashboard. -contributors: [wordsmither] -contenttype: [doc] -innav: [true] -categories: [create] -cms: [wordpress, drupal] -audience: [developers] -product: [--] -integration: [--] -tags: [--] -showtoc: true ---- - - Pantheon CMS site contains three components: code, files, and a database containing the content and configurations of your Content Management System (CMS). When you create a site, you are creating each of these components in the Dev environment. Then, when you are ready, you will create your Test and Live environments. - - - -## Create the Dev Environment - -To create a CMS site: - - - - - -### Install the CMS - - - -You have successfully finished adding a site in its Dev environment. Click **Visit Dev Site** to view your site. - -## Create the Test environment - - - -You have successfully finished adding a site in its Test environment. Click **Visit Test Site** to view your site. - -## Create the Live environment - -After you [purchase a plan](/guides/getstarted/purchase), you can deploy your site live. But first, you have to create the Live environment. - - - -When you complete this step, your site will be live for anyone to see, at the Pantheon URL. For detailed information about launching your site, refer to our [Launch Essentials](/guides/launch/) guide. - - - - - -You have successfully finished adding a site in its Live environment. Click **Visit Live Site** to view your site. - -At this point, you have a live site with a Pantheon URL, like `http://my-site.pantheonsite.io/`. To change that to a more friendly URL, you'll need to purchase a domain from a DNS provider. Refer to our [Domains on Pantheon Guide](/guides/domains) for more information. diff --git a/source/content/crisis-response-upstream.md b/source/content/crisis-response-upstream.md index a600d16768..cc5ab4e407 100644 --- a/source/content/crisis-response-upstream.md +++ b/source/content/crisis-response-upstream.md @@ -74,7 +74,7 @@ These plugins were selected to improve the content creation and moderation proce If not, use your email address for the username and click on **Forgot Password**. Be sure to set a strong password. -1. After the site is configured correctly in the Dev environment, you can [create the Test and Live environments](/add-site-dashboard#create-the-test-environment), copying your code and the initial database to each. +1. After the site is configured correctly in the Dev environment, you can [create the Test and Live environments](/guides/getstarted/addsite/#create-the-test-environment), copying your code and the initial database to each. 1. If you update your site code or add a new plugin, you can use the [Pantheon WebOps workflow](/pantheon-workflow). On your site's Pantheon dashboard, once changes are [committed](/guides/sftp/sftp-development), the Deploys panel in the Test environment will prompt you to deploy the changes to the Test environment. diff --git a/source/content/guides/account-mgmt/traffic/01-introduction.md b/source/content/guides/account-mgmt/traffic/01-introduction.md index 0e56de5d7b..23c60defd7 100644 --- a/source/content/guides/account-mgmt/traffic/01-introduction.md +++ b/source/content/guides/account-mgmt/traffic/01-introduction.md @@ -16,7 +16,7 @@ audience: [sysadmin] product: [--] integration: [--] --- -Access Metrics through the Live tab of the Site Dashboard once a [Live environment has been initialized](/add-site-dashboard#create-the-test-environment). The number of unique visits displayed in Pantheon’s Site Dashboard determines the traffic Pantheon will apply for evaluating use on your site under your pricing plan. The Site Dashboard also includes other information you may use to project future traffic, including number of pages served. +Access Metrics through the Live tab of the Site Dashboard once a [Live environment has been initialized](/guides/getstarted/addsite/#create-the-live-environment). The number of unique visits displayed in Pantheon’s Site Dashboard determines the traffic Pantheon will apply for evaluating use on your site under your pricing plan. The Site Dashboard also includes other information you may use to project future traffic, including number of pages served. To access metrics for another environment, use the [Terminus](/terminus) `metrics` command: diff --git a/source/content/guides/getstarted/06-addsite.md b/source/content/guides/getstarted/06-addsite.md index a5829cdb7d..5720e12af2 100644 --- a/source/content/guides/getstarted/06-addsite.md +++ b/source/content/guides/getstarted/06-addsite.md @@ -11,7 +11,7 @@ product: [--] integration: [--] tags: [--] contributors: [wordsmither] -reviewed: "2023-03-21" +reviewed: "2024-12-02" showtoc: true permalink: docs/guides/getstarted/addsite editpath: getstarted/addsite.md @@ -20,48 +20,41 @@ editpath: getstarted/addsite.md There are dozens of ways to add a site on Pantheon. This section covers the most common scenarios for new users: creating a new CMS site (a site running WordPress or Drupal), or migrating an existing WordPress or Drupal site. For additional scenarios, see the [Adding a Site to Pantheon](/add-site) section at the end of this document. ## Create a New CMS Site +Pantheon CMS site contains three components: code, files, and a database containing the content and configurations of your Content Management System (CMS). When you create a site, you are creating each of these components in the Dev environment. Then, when you are ready, you will create your Test and Live environments. -To create a CMS site: - -1. [Go to the workspace](/guides/account-mgmt/workspace-sites-teams/workspaces#switch-between-workspaces) and select the **Create New Site** button: - - ![Create new site button](../../../images/dashboard/new-dashboard/2024/create-new-site-button.png) - -1. Select **WordPress** or **Drupal**. - - ![Select CMS](../../../images/dashboard/new-dashboard/2024/create-new-site-cms.png) - - If you select Drupal, you will have the option to select the Drupal version you want to use. + - ![Select Drupal version](../../../images/dashboard/new-dashboard/2024/create-new-site-cms-drupal-11crop.png) +### Create the Dev Environment +To create a CMS site: -1. Enter the name and select a region for this site. If this site is to be part of a Professional Workspace, select a Workspace from **Choose a Workspace for the Site**. Click **Continue**. It can take several minutes to create a new site on Pantheon. + - +#### Install the CMS + - Site names are limited to 51 characters and can contain only numbers, letters, and dashes. Site names cannot start or end with a dash. +You have successfully finished adding a site in its Dev environment. Click **Visit Dev Site** to view your site. - Site names cannot be changed after site creation. +### Create the Test environment - + - ![Enter site information](../../../images/create-new-site-info.png) +You have successfully finished adding a site in its Test environment. Click **Visit Test Site** to view your site. - +### Create the Live environment - You can navigate away from this page during this process, but later, you'll have to go to the **Sites** tab to access your site. If possible, stay on this tab to simplify accessing the site when the creation is complete. +After you [purchase a plan](/guides/getstarted/purchase), you can deploy your site live. But first, you have to create the Live environment. - + -1. Click **Visit your Pantheon Site Dashboard** when the process is complete. +When you complete this step, your site will be live for anyone to see, at the Pantheon URL. For detailed information about launching your site, refer to our [Launch Essentials](/guides/launch/) guide. - ![Site creation completed](../../../images/create-site-done.png) + -At this point, you have a Dev environment for your site code, but you do not have a Dev environment for your CMS. To create that: + - +You have successfully finished adding a site in its Live environment. Click **Visit Live Site** to view your site. -You have successfully finished adding a site in its Dev environment! +At this point, you have a live site with a Pantheon URL, like `http://my-site.pantheonsite.io/`. To change that to a more friendly URL, you'll need to purchase a domain from a DNS provider. Refer to our [Domains on Pantheon Guide](/guides/domains) for more information. ## Migrate an Existing Site diff --git a/source/content/guides/launch/01-introduction.md b/source/content/guides/launch/01-introduction.md index 1d57eb9571..9dbe1ff6de 100644 --- a/source/content/guides/launch/01-introduction.md +++ b/source/content/guides/launch/01-introduction.md @@ -27,7 +27,7 @@ This guide will show you how to create, configure, and launch your site on the P ## Essential Steps in This Guide -- [Create the Live environment](/add-site-dashboard#create-the-live-environment) +- [Create the Live environment](/guides/getstarted/addsite/#create-the-live-environment) - [Select Your Site Plan](/guides/launch/plans/) diff --git a/source/content/guides/local-development/05-wordpress-phpstorm.md b/source/content/guides/local-development/05-wordpress-phpstorm.md index 740bccd427..ab281c07d5 100644 --- a/source/content/guides/local-development/05-wordpress-phpstorm.md +++ b/source/content/guides/local-development/05-wordpress-phpstorm.md @@ -24,7 +24,7 @@ Refer to [WordPress Development using PhpStorm](https://confluence.jetbrains.com ## Create a WordPress site -[Create a new WordPress site](/add-site-dashboard) on Pantheon if you don't already have one. This site should be empty to develop your new plugin or theme. +[Create a new WordPress site](/guides/getstarted/addsite/#create-a-new-cms-site) on Pantheon if you don't already have one. This site should be empty to develop your new plugin or theme. ## Clone the Code Repository diff --git a/source/content/supported-drupal.md b/source/content/supported-drupal.md index 562953c915..76a8cbbf39 100644 --- a/source/content/supported-drupal.md +++ b/source/content/supported-drupal.md @@ -25,7 +25,7 @@ The following table indicates availability of the specified Drupal versions, as | 6 | ❌ | ❌ | ❌ | ## Drupal 10 and 11 on Pantheon -Refer to [Create a New CMS Site](/add-site-dashboard) for how to create a new Drupal 10 or 11 site from the Pantheon dashboard. +Refer to [Create a New CMS Site](/guides/getstarted/addsite/#create-a-new-cms-site) for how to create a new Drupal 10 or 11 site from the Pantheon dashboard. If you already have a Drupal 10 site on Pantheon, you can upgrade your existing site to [Drupal 11 via Composer](https://www.drupal.org/docs/upgrading-drupal/upgrading-from-drupal-8-or-later/how-to-upgrade-from-drupal-10-to-drupal-11). @@ -37,7 +37,7 @@ terminus site:create