Repository files navigation

While the documentation for theYoast SEO plugin can be found onYoast.com, hereyou can browse the source of the project, find and discuss open issues and evencontribute yourself.

• The-Online.com
• WP Engine

Here's aguide on how to install Yoast SEO in your WordPress site.

At Yoast, we make use a specific toolset to develop our code. Please ensure you have the following tools installed before contributing.

• Composer
• Yarn
• Grunt

After installing the aforementioned tools, you can use the steps below to acquire a development version of Yoast SEO.Please note that this will download the latest development version of Yoast SEO. While this version is usually stable,it is not recommended for use in a production environment.

Within your WordPress installation, navigate towp-content/plugins and run the following commands:

git clone https://github.com/Yoast/wordpress-seo.gitcd wordpress-seo

To install all the necessary dependencies, run the following commands:

composer installyarngrunt build

Please note that if you change anything in the JavaScript or CSS, you'll have to rungrunt build:js orgrunt build:css, respectively.

Yoast SEO uses some JavaScript code that is managed outside of this repository. This code is being maintained in a monorepo:Yoast/javascript. If you need to change anything in one or more of the packages included in the monorepo, you'll need to do the following:

git clone https://github.com/Yoast/javascript.git# Only the first time.yarn link-monorepo# You will be prompted for the location of your Yoast/javascript clone. This will is "./javascript" if you cloned it inside the wordpress-seo directory. Your preference will be saved in a .yoast file for later use.grunt build

Thislinks allYoast managed JavaScript packages to your installation of the plugin. Most branches on the wordpress-seo repository also exist on the javascript repository. Please find which branch to use in the table below. If the branch you're looking for does not exist, feel free to default to develop (or create the branch yourself if you're making changes).

You can now modify the code of the linked packages directly from thenode_modules (as they're now symlinked to yourjavascript clone) or your javascript directory. Please remember to run agrunt build:js from thewordpress-seo directory after making changes in order to apply those changes to the plugin.

If you don't want to use the latest development version of the Yoast JavaScript packages anymore, you can restore the versions as specified in thepackage.json by running the following command:

yarn unlink-monorepogrunt build

This is a developer's portal for Yoast SEO and should not be used for support. Please visit thesupport forums.

If you find an issue,let us know here! Please followthese guidelines on how to write a good bug report.

It may help us a lot if you can provide a backtrace of the error encountered. You can usecode in this gist to enable the backtrace in your website's configuration.

Anyone is welcome to contribute to Yoast SEO. Pleaseread the guidelines for contributing to thisrepository.

There are various ways you can contribute:

• Raise an issue on GitHub.
• Send us a Pull Request with your bug fixes and/or new features.
• Translate Yoast SEO into different languages.
• Provide feedback andsuggestions on enhancements.