wordpress-seo
Last commit date
admin
3 years ago
css
3 years ago
images
3 years ago
inc
3 years ago
js
3 years ago
lib
3 years ago
packages
3 years ago
src
3 years ago
vendor
3 years ago
vendor_prefixed
3 years ago
index.php
10 years ago
license.txt
8 years ago
readme.txt
3 years ago
wp-seo-main.php
3 years ago
wp-seo.php
3 years ago
wpml-config.xml
3 years ago
readme.txt
307 lines
| 1 | === Yoast SEO === |
| 2 | Contributors: yoast, joostdevalk, tdevalk |
| 3 | Donate link: https://yoa.st/1up |
| 4 | License: GPLv3 |
| 5 | License URI: http://www.gnu.org/licenses/gpl.html |
| 6 | Tags: SEO, XML sitemap, Content analysis, Readability, Schema |
| 7 | Tested up to: 6.1 |
| 8 | Stable tag: 20.1 |
| 9 | Requires PHP: 5.6.20 |
| 10 | |
| 11 | Improve your WordPress SEO: Write better content and have a fully optimized WordPress site using the Yoast SEO plugin. |
| 12 | |
| 13 | == Description == |
| 14 | |
| 15 | ### Yoast SEO: the #1 WordPress SEO plugin |
| 16 | |
| 17 | Since 2008 Yoast SEO has helped millions of websites worldwide to **rank higher in search engines**. |
| 18 | |
| 19 | Yoast’s mission is **SEO for Everyone**. Our plugin’s users range from the bakery around the corner to some of the most popular sites on the planet. |
| 20 | |
| 21 | Yoast SEO Free contains everything that you need to manage your SEO, and the [Yoast SEO Premium](https://yoa.st/1v8) plugin and its extensions unlock even more tools and functionality. |
| 22 | |
| 23 | #### GET AHEAD OF THE COMPETITION |
| 24 | To rank highly in search engines, you need to beat the competition. You need a better, faster, stronger website than the people who sell or do the same kinds of things as you. |
| 25 | |
| 26 | Yoast SEO is the most-used WordPress SEO plugin, and has helped millions of people like you to get ahead, and to stay ahead. |
| 27 | |
| 28 | #### TAKING CARE OF YOUR WORDPRESS SEO |
| 29 | Yoast SEO is packed full of features, designed to help visitors and search engines to get the most out of your website. Some of our favourites are: |
| 30 | |
| 31 | * Automated technical SEO improvements, like **canonical URLs** and **meta tags**. |
| 32 | * Advanced **XML sitemaps**; making it easy for Google to understand your site structure. |
| 33 | * Title and meta description templating, for **better branding** and consistent snippets in the search results. |
| 34 | * An in-depth Schema.org integration that will **increase your chance of getting rich results**, by helping search engines to understand your content. |
| 35 | * Full control over **site breadcrumbs**, so that users and search engines always know where they are. |
| 36 | * **Faster loading times** for your whole website, due to an innovative way of managing data in WordPress. |
| 37 | * **[Premium]** E-mail support for our [Yoast SEO Premium](https://yoa.st/1v8) users. |
| 38 | * **[Premium]** The possibility to expand Yoast SEO with the [News SEO](https://yoa.st/1uv), [Video SEO](https://yoa.st/1uw), [Local SEO](https://yoa.st/1uu) and [WooCommerce SEO](https://yoa.st/3rh) extensions. |
| 39 | * **[Premium]** **New!** Yoast SEO Premium comes with wide-ranging crawl settings that help you improve how search engines crawl your site. |
| 40 | * **[Premium]** **New!** Yoast SEO Premium comes with an IndexNow integration to ping search engines like Microsoft Bing whenever you publish or update content. |
| 41 | |
| 42 | #### WRITE KILLER CONTENT WITH YOAST SEO |
| 43 | We know content is king, that's why Yoast SEO is famous for its **state-of-the-art content and SEO analysis**. Yoast SEO gives you: |
| 44 | |
| 45 | * **SEO analysis**: an invaluable tool while writing SEO-friendly content with the right (focus) keyphrases in mind. |
| 46 | * **Readability analysis**: ensures that humans and search engines can read and understand your content. |
| 47 | * **Full language support** for: English, German, French, Dutch, Spanish, Italian, Russian, Indonesian, Polish, Portuguese, Arabic, Swedish, Hebrew, Hungarian, Turkish, Czech, Norwegian, Slovak and Greek. |
| 48 | * **A Google preview**, which shows what your listings will look like in the search results. Even on mobile devices! |
| 49 | * **Innovative Schema blocks** for the WordPress block editor, so that your FAQ and HowTo content can be shown directly in the search results. Plus a breadcrumbs block to guide your users. |
| 50 | * **[Premium] Internal linking blocks** to easily improve the structure of your content. Easily add a **table of contents block**, a **related links block**, a **subpages** block, or **siblings block**! Plus, we’ll keep adding these easy-to-add blocks to improve your site structure. |
| 51 | * **[Premium]** Social previews to show you how your content will be shown on Twitter and Facebook. Plus: Social Appearance Templates to guarantee a consistent look. |
| 52 | * **[Premium]** The Insights tool that shows you what your text focuses on. This way you can keep your article in line with your keyphrases. |
| 53 | * **[Premium]** Optimize your content for synonyms and related keyphrases. |
| 54 | * **[Premium]** Optimize your article for different word forms of your keyphrases, as the singular and plural. But also different verb forms, synonyms, and related keyphrases. This makes for more natural content! |
| 55 | * **[Premium]** Automatic internal linking suggestions: write your article and get automatic suggested posts to link to! |
| 56 | * **[Premium]** An orphaned content filter to detect posts that have no links pointing towards them! |
| 57 | * **[Premium]** SEO workouts to make working on your site as easy as ABC. These SEO workflows will get your site into shape in no time! |
| 58 | * **[Premium]** **New!** Yoast SEO Premium comes with a new word complexity feature that gives you actionable feedback on using difficult words. This feature is in beta and English only for now. |
| 59 | * **New!** Yoast SEO Free and Premium come with a new inclusive language analysis that helps you write inclusive content. This feature is opt-in and English-only for now. |
| 60 | |
| 61 | #### KEEP YOUR SITE IN PERFECT SHAPE |
| 62 | |
| 63 | Whether you are an online entrepreneur, blogger or content creator, a developer, a (WordPress) SEO expert or a business owner, Yoast SEO helps you keep your website in perfect shape by: |
| 64 | |
| 65 | * Tuning the engine of your website, so you can work on creating great content! |
| 66 | * Giving you **cornerstone content** and **internal linking** features to help you optimize your site structure in a breeze. |
| 67 | * Translating your content to **structured data** where possible, to help search engines understand your website. |
| 68 | * Helping you manage your team: with our **SEO roles** you can give colleagues access to specific sections of the Yoast SEO plugin. |
| 69 | * **[Premium] Automatically creating redirects** when URLs change or when pages are deleted, and providing tools to manage or create redirects. |
| 70 | * **[Premium]** Showing you **social previews** to manage the way your page is shared on social networks like Facebook and Twitter. |
| 71 | |
| 72 | #### TRUST THE EXPERTS |
| 73 | |
| 74 | Yoast is powered by a team of expert developers, testers, software architects, and SEO consultants. They work constantly to stay at the cutting edge of WordPress SEO, and to improve the plugin with every release. |
| 75 | |
| 76 | Yoast SEO is the **only WordPress SEO plugin made by world-renowned SEO experts**. |
| 77 | |
| 78 | ### GET PREMIUM SUPPORT |
| 79 | |
| 80 | The Yoast team offers regular support on the WordPress.org forums. But we hope you understand that we prioritize our Premium customers. This one-on-one email support is available to people who have purchased Yoast SEO Premium. |
| 81 | |
| 82 | Did you know that [Yoast SEO Premium](https://yoa.st/1v8) contains a lot of extra features: |
| 83 | |
| 84 | * A **redirect manager** that prevents “404: page not found” errors |
| 85 | * Optimize without worrying about over-optimization with **intelligent word form recognition** available in multiple languages. |
| 86 | * **Internal linking blocks** to structure your site easily. |
| 87 | * **Internal linking suggestions** while you’re writing. |
| 88 | * Preview your content to see what it will look like in the search results and when shared on social media using the **Google preview** and **social preview**. |
| 89 | * **Cornerstone content checks** that point search engines to your most important pages. |
| 90 | * Connect Yoast SEO to Zapier to easily **create zaps that instantly share your published posts** with 2000+ destinations like Twitter, Facebook, and much more. |
| 91 | |
| 92 | If you are serious about your WordPress SEO, install the [Yoast SEO Premium plugin](https://yoa.st/1v8)! **Costs a little, saves a lot of time!** |
| 93 | |
| 94 | #### OUR EXTENSIONS TO FURTHER IMPROVE YOUR WORDPRESS SEO |
| 95 | Check out these SEO add-ons by Yoast: |
| 96 | |
| 97 | * **[Yoast Local SEO](https://yoa.st/1uu)** optimizes your website for a local audience. |
| 98 | * **[Yoast Video SEO](https://yoa.st/1uw)** ensures that Google understands what your video is about, increasing the chances of ranking in the video results. |
| 99 | * **[Yoast News SEO](https://yoa.st/1uv)** for news websites that want to improve their visibility and performance in Google News. |
| 100 | * **[WooCommerce SEO](https://yoa.st/3rh)** for all online shops that want to perform better in the search results and social media. |
| 101 | |
| 102 | These extensions work fine with the free version of Yoast SEO. Of course, the premium extensions also include 24/7 support. |
| 103 | |
| 104 | Oh, don't forget: our **[Yoast Academy](https://yoa.st/3ri)** is for all entrepreneurs, bloggers, and anyone who wants to learn more about optimizing websites, improving your WordPress SEO, and if you want to take your content to the next level! |
| 105 | |
| 106 | ### INTEGRATIONS |
| 107 | |
| 108 | Yoast SEO integrates seamlessly into a range of themes and plugins. We work particularly well with: |
| 109 | |
| 110 | * The [WordPress block editor](https://wordpress.org/support/article/wordpress-editor/) (or ‘Gutenberg’ editor). |
| 111 | * The official [AMP](https://wordpress.org/plugins/amp/) plugin, which changes your templates to use the ‘AMP’ HTML format. |
| 112 | * Google’s [Web Stories](https://wordpress.org/plugins/web-stories/) plugin, which helps you to create ‘[web stories](https://amp.dev/about/stories/)’. |
| 113 | * The [Advanced Custom Fields](https://wordpress.org/plugins/advanced-custom-fields/) plugin, when you also activate the [ACF Content Analysis for Yoast SEO](https://wordpress.org/plugins/acf-content-analysis-for-yoast-seo/) plugin. |
| 114 | * The [Elementor](https://wordpress.org/plugins/elementor/) website builder. |
| 115 | * [Zapier](https://zapier.com/apps/yoast-seo/integrations), which helps you automate your publishing flow. |
| 116 | * [Algolia](https://wordpress.org/plugins/wp-search-with-algolia/) integration to improve the quality of your site search. |
| 117 | * [WordProof](https://wordproof.com/), which helps you prove ownership by adding timestamps. |
| 118 | |
| 119 | ### BUG REPORTS |
| 120 | |
| 121 | Do you want to report a bug for Yoast SEO? Best to do so in the WordPress SEO [repository on GitHub](https://github.com/Yoast/wordpress-seo). Please note that GitHub is not a support forum and issues will be closed if they don’t meet the bug requirements. |
| 122 | |
| 123 | ### READ MORE |
| 124 | |
| 125 | Want more information on search engine optimization and Yoast SEO? Have a look at: |
| 126 | |
| 127 | * The [Yoast SEO Plugin](https://yoa.st/1v8) official homepage. |
| 128 | * The [Yoast SEO Help center](https://yoa.st/1va). |
| 129 | * [WordPress SEO - The definitive Guide by Yoast](https://yoa.st/1v6). |
| 130 | * Other [WordPress Plugins](https://yoa.st/1v9) by Team Yoast. |
| 131 | * Also follow Yoast on [Facebook](https://facebook.com/yoast), [Instagram](https://www.instagram.com/yoast/) & [Twitter](https://twitter.com/yoast). |
| 132 | |
| 133 | == Installation == |
| 134 | Starting with Yoast SEO consists of just two steps: installing and setting up the plugin. Yoast SEO is designed to work with your site’s specific needs, so don’t forget to go through the Yoast SEO first-time configuration as explained in the ‘after activation’ step! |
| 135 | |
| 136 | ### INSTALL YOAST SEO FROM WITHIN WORDPRESS |
| 137 | |
| 138 | 1. Visit the plugins page within your dashboard and select ‘Add New’; |
| 139 | 1. Search for ‘Yoast SEO’; |
| 140 | 1. Activate Yoast SEO from your Plugins page; |
| 141 | 1. Go to ‘after activation’ below. |
| 142 | |
| 143 | ### INSTALL YOAST SEO MANUALLY |
| 144 | |
| 145 | 1. Upload the ‘wordpress-seo’ folder to the /wp-content/plugins/ directory; |
| 146 | 1. Activate the Yoast SEO plugin through the ‘Plugins’ menu in WordPress; |
| 147 | 1. Go to ‘after activation’ below. |
| 148 | |
| 149 | ### AFTER ACTIVATION |
| 150 | |
| 151 | 1. You should see (a notice to start) the Yoast SEO first-time configuration; |
| 152 | 1. Go through this configuration and set up the plugin for your site; |
| 153 | 1. You’re done! |
| 154 | |
| 155 | == Frequently Asked Questions == |
| 156 | |
| 157 | = How do the XML Sitemaps in the Yoast SEO plugin work? = |
| 158 | |
| 159 | Having an XML sitemap can be beneficial for SEO, as Google can retrieve essential pages of a website very fast, even if the internal linking of a site isn’t flawless. |
| 160 | The sitemap index and individual sitemaps are updated automatically as you add or remove content and will include the post types you want search engines to index. Post Types marked as noindex will not appear in the sitemap. [Learn more about XML Sitemaps](https://yoa.st/3qt). |
| 161 | |
| 162 | = How can I add my website to Google Search Console? = |
| 163 | |
| 164 | It is straightforward to add your website to Google Search Console. |
| 165 | 1. Create a Google Search Console account and login into your account. |
| 166 | 2. Click ‘Add a property’ under the search drop-down. |
| 167 | 3. Enter your website URL in the box and click ‘Continue’. |
| 168 | 4. Click the arrow next to ‘HTML tag’ to expand the option. |
| 169 | 5. Copy the meta tag. |
| 170 | 6. Log in to your WordPress website. |
| 171 | 7. Click on ‘SEO’ in the dashboard. |
| 172 | 8. Click on ‘General’. |
| 173 | 9. Click on the ‘Webmaster Tools’ tab. |
| 174 | 10. Paste the code in the Google field and click ‘Save Changes’. |
| 175 | 11. Go back to Google Search Console and click ‘Verify’. |
| 176 | |
| 177 | If you want more details steps, please visit [our article on our help center](https://yoa.st/3qu). |
| 178 | |
| 179 | = How do I implement Yoast SEO breadcrumbs? = |
| 180 | |
| 181 | The steps below are a temporary solution as manual edits made to theme files may be overwritten with future theme updates. Please contact the theme developer for a permanent solution. We’ve written an article about the [importance of breadcrumbs for SEO](https://yoa.st/3qv). |
| 182 | |
| 183 | To implement the [breadcrumbs](https://yoa.st/3qw) function in Yoast SEO, you will have to edit your theme. We recommend that prior to any editing of the theme files, a backup is taken. Your host provider can help you take a backup. |
| 184 | Copy the following code into your theme where you want the breadcrumbs to be. If you are not sure, you will need to experiment with placement: |
| 185 | |
| 186 | <code> |
| 187 | <?php |
| 188 | if ( function_exists( 'yoast_breadcrumb' ) ) { |
| 189 | yoast_breadcrumb( '<p id="breadcrumbs">','</p>' ); |
| 190 | } |
| 191 | ?> |
| 192 | </code> |
| 193 | |
| 194 | Common places where you could place your breadcrumbs are inside your `single.php` and/or `page.php` file just above the page’s title. Another option that makes it really easy in some themes is by just pasting the code in `header.php` at the very end. |
| 195 | |
| 196 | In most non-WooTheme themes, this code snippet should not be added to your `functions.php` file. |
| 197 | Alternatively, you can manually add the breadcrumb shortcode to individual posts or pages: `[wpseo_breadcrumb]` |
| 198 | |
| 199 | If you need more details or a step by step guide, read our [Implementation guide for Yoast SEO breadcrumbs](https://yoa.st/3qx). |
| 200 | |
| 201 | = How do I noindex URLS? = |
| 202 | |
| 203 | Yoast SEO provides multiple options for setting a URL or group of URLs to noindex. [Read more about how to do this in this guide](https://yoa.st/3qy/). |
| 204 | |
| 205 | = Google shows the wrong description, how do I fix this? = |
| 206 | |
| 207 | If you’ve crafted nice meta descriptions for your blog posts, nothing is more annoying than Google showing another description for your site completely in the search result snippet. |
| 208 | |
| 209 | Possible causes could be: |
| 210 | 1. wrong description in code |
| 211 | 2. Google cache is outdated |
| 212 | 3. Search term manipulation |
| 213 | 4. Google ignored the meta description |
| 214 | |
| 215 | You can [read more here on how to solve the issue with the wrong description](https://yoa.st/3qz). |
| 216 | |
| 217 | = How often is Yoast SEO updated? = |
| 218 | |
| 219 | Yoast SEO is updated every two weeks. If you want to know why, please read [this post on why we release every two weeks](https://yoa.st/3q-)! |
| 220 | |
| 221 | = How do I get support? = |
| 222 | |
| 223 | As our free plugin is used by millions of people worldwide, we cannot offer you all one on one support. If you have trouble with the Yoast SEO for WordPress plugin, you can get help on the support forums here at [wordpress.org](https://wordpress.org/support/plugin/wordpress-seo/) or by checking out our help center at [yoast.com/help/](https://yoa.st/3r1). |
| 224 | |
| 225 | The plugins you buy at Yoast are called ‘premium plugins’ (even if Premium isn’t in its name) and include a complete year of free updates and premium support. This means you can contact our support team if you have any questions about that plugin. |
| 226 | |
| 227 | [Read more on how to get support](https://yoa.st/3r2) |
| 228 | |
| 229 | = What happens to my data if I enable usage tracking? = |
| 230 | |
| 231 | [This page on yoast.com explains what data we collect to improve Yoast SEO](https://yoa.st/4w7). We only collect data when you explicitly opt in. Read more about how we handle your data in [our Privacy Policy](https://yoa.st/4w8). |
| 232 | |
| 233 | = I have a different question than listed here = |
| 234 | |
| 235 | Your question has most likely been answered on our help center: [yoast.com/help/](https://yoa.st/1va). |
| 236 | |
| 237 | == Screenshots == |
| 238 | |
| 239 | 1. The modern interface makes Yoast SEO easy to work with. |
| 240 | 2. Easily manage how your posts and pages appear in SERPs. |
| 241 | 3. Yoast SEO Premium has extra crawl optimization options. |
| 242 | 4. Yoast SEO integrates with tools like Semrush and Wincher. |
| 243 | 5. The famous SEO and readability analyses in Yoast SEO. |
| 244 | 6. See what your post looks like in Google. |
| 245 | 7. The First-time configuration helps you get started quickly. |
| 246 | 8. The inclusive language analysis in Yoast SEO. |
| 247 | |
| 248 | == Changelog == |
| 249 | |
| 250 | = 20.1 = |
| 251 | |
| 252 | Release date: 2023-02-07 |
| 253 | |
| 254 | Create a more inclusive online world with Yoast SEO 20.1. Our improved inclusive language analysis provides real-time feedback and offers suggestions to help your content reach a broader audience. For our Premium users, there's a bonus - a new Mastodon integration to take your online presence to the next level. Get it now! Find out more about what's new in Yoast SEO 20.1 in [our release post](https://yoa.st/release-7-2-23)! |
| 255 | |
| 256 | #### Enhancements |
| 257 | |
| 258 | * Adds a link to the first time configuration in the plugin overview when this is not completed yet. |
| 259 | * Adds the site name to the Google preview for mobile. |
| 260 | * Improves the _inclusive language analysis_ by expanding the number of non-inclusive phrases recognized as well as by improving the feedback, for example by adding more inclusive alternatives or fixing inconsistencies. Specifically, this includes the following changes: |
| 261 | * Adds word form support (singular vs. plural, different verb forms) for some non-inclusive phrases. |
| 262 | * Improves the feedback strings and suggested alternatives for phrases containing the terms "crazy" and "OCD". |
| 263 | * Improves the feedback strings pertaining to medical conditions. |
| 264 | * Improves the feedback strings for "binge", "preferred pronouns", and "preferred name". |
| 265 | * Changes the scoring and improves the feedback string for "ladies and gentleman". |
| 266 | * Changes the feedback in the publish box from "OK" to "Potentially non-inclusive". |
| 267 | * Excludes the phrases "binge drinking/drinks/drink" and "exotic shorthairs/longhairs" from being targeted as non-inclusive. |
| 268 | |
| 269 | #### Bugfixes |
| 270 | |
| 271 | * Fixes a bug where the _Format archives_ settings would not work correctly when the `post_format` taxonomy is disabled. |
| 272 | * Fixes a bug where the _Media pages_ settings would not work correctly when the `attachment` post type is filtered out via `wpseo_indexable_excluded_post_types`. |
| 273 | * Fixes a bug where the highlighting feature in the Classic editor would not work when inline HTML tags were present. |
| 274 | * Fixes a bug where the settings' introduction modal would not be visible on wider screens with less than ~700 pixels height. |
| 275 | * Fixes a bug where `wpseo_opengraph_image_size` is used to set custom size to `og:image` but doesn't work when uploading an image with the same size as the custom size. |
| 276 | |
| 277 | #### Other |
| 278 | |
| 279 | * Improves the translations comments in _Settings > Site connections_ and a translatable string used by screen readers. |
| 280 | |
| 281 | = 20.0 = |
| 282 | |
| 283 | Release date: 2023-01-24 |
| 284 | |
| 285 | We're proud to introduce a brand new settings interface in Yoast SEO 20.0. We've worked hard to make this interface both beautiful and helpful. It's now much easier and enjoyable to work on your SEO. Plus, it's the start of much more cool stuff to come! Find out more about what's new in Yoast SEO 20.0 in [our release post](https://yoa.st/release-24-1-23)! |
| 286 | |
| 287 | #### Enhancements |
| 288 | |
| 289 | * NEW: Introduces a brand-new design for Yoast SEO's settings pages: |
| 290 | * Completely overhauled the old 'settings' admin pages with a sleek and modern interface. |
| 291 | * Combines, moves and improves various admin pages. |
| 292 | * Adds the ability to search through site settings to quickly discover and modify your desired setting. |
| 293 | * Adds extra information and help for all controls. |
| 294 | * Vastly improves accessibility (including better support for keyboard navigation). |
| 295 | * Key features are now listed on the 'Site features' page under 'General'. |
| 296 | * Webmaster Tools settings have moved to 'Site connections' page under 'General'. |
| 297 | * Open Graph settings can now be found in 'Site features' under 'General'. |
| 298 | * Adds an introduction modal with videos to quickly help you on your way. |
| 299 | * Improves the link focus styles in the first time configuration. |
| 300 | |
| 301 | #### Other |
| 302 | |
| 303 | * Displays a notification urging to upgrade Premium if the version is below 20.0, since some settings might be missing from the new user interface. |
| 304 | |
| 305 | = Earlier versions = |
| 306 | For the changelog of earlier versions, please refer to [the changelog on yoast.com](https://yoa.st/yoast-seo-changelog). |
| 307 |