Install Plugins

Beginners guide on how to use the WordPress Dashboard, an SFTP client, and your text editor of choice to work quickly, safely and easily on Pantheon's Git-based platform.

Discuss in our Forum Discuss in Slack

This lesson demonstrates how to develop using the WordPress Dashboard in SFTP mode. We'll install a few plugins and submit each one to version control as individual commits.

  1. Navigate to Code in the Dev tab of your Site Dashboard. Confirm your Connection Mode is set to SFTP.

  2. Now log in to your Dev site by clicking the Site Admin button.

    Add new plugin

  3. On the left admin menu, select Plugins, then Add New.

  4. Search for the Yoast plugin, then click Install Now:

    Install Pantheon Advanced Page Cache plugin

    If you encounter a prompt for FTP credentials, you're either working on the wrong environment or you're using the wrong connection mode. Don't try to authenticate FTP prompts within the WordPress Dashboard, it won't work (by design). Using the WordPress Dashboard to add or modify code is only allowed using the SFTP connection mode on the Dev environment.

  5. Return to the Pantheon Site Dashboard and click the yellow notification to review file changes as a result of our actions in the WordPress Dashboard:

    View file changes prompt

    You should see the following files for our recently installed plugin:

    View advanced page cache plugin files

  6. Rather than piling a bunch of changes on top of this plugin, get into the habit of saving code in small incremental amounts with meaningful commit messages.

    Write a message that summarizes your work to let your team (and your future self) know what these changes do and which feature(s) they pertain to. For example, Add Yoast plugin Version: 5.7 is much better than New plugin or asdfasdf.

    Click Commit to submit work from the WordPress Dashboard to Git in the Site Dashboard:

    Commit advanced page cache plugin files

  7. For practice, add these plugins next, each with their own commit message. These plugins allow your site to take advantage of some of Pantheon's performance optimizations:

    • Pantheon Advanced Page Cache

    • WordPress Native PHP Sessions

    • Pantheon HUD

      The commit log within the Pantheon Site Dashboard should look something like this:

      Several Plugins Added

Bam! You just nailed our first demonstration of using version control with WordPress on Pantheon sites. Follow this same approach to update plugins and for any other development tasks you normally handle in the WordPress Dashboard.