=== The SEO Framework – Fast, Automated, Effortless. === Contributors: Cybr Donate link: https://github.com/sponsors/sybrew Tags: seo, xml sitemap, google search, open graph, schema.org, twitter card, performance, headless Requires at least: 5.5 Tested up to: 6.3 Requires PHP: 7.2.0 Stable tag: 4.2.8 License: GPLv3 License URI: http://www.gnu.org/licenses/gpl-3.0.html The fastest feature-complete SEO plugin for professional WordPress websites. Secure, fast, automated, and ethical SEO. Do less; get better results. == Description == **The fastest and only feature-complete SEO plugin that follows the guidelines and rules imposed by WordPress and search engines.** Start using proven methods to optimize your website for SEO. Clean, dedicated, extensible, unrestricted, ad-free, and no strings attached. To top it off, this is the [fastest full-featured SEO plugin](https://twitter.com/TheSEOFramework/status/1493352649445580804/photo/1), and it blends right into your WordPress website, without leaving you in the dark. It's easy to get started. Activate this plugin, and your site's instantly protected against prominent SEO attacks. The SEO Framework will also prefill all critical meta tags for you. A real time-saver. Ingenious. [Migrate](https://theseoframework.com/?p=511) | [Setup](https://theseoframework.com/?p=2428) | [Improve](https://theseoframework.com/?p=2663) | [Extensions](https://theseoframework.com/extensions/) | [API](https://theseoframework.com/?p=82) | [Support](https://theseoframework.com/?p=3478) | [Privacy](https://theseoframework.com/?p=1701#pluginprivacyinformation) = We poured over 18 000 hours into this plugin. Here are the results: = * **It is brilliant.** The SEO Framework is an [expert system](https://en.wikipedia.org/wiki/Expert_system) for SEO. It is the only solution that can intelligently generate critical SEO meta tags in any language by reading your WordPress environment. This automation saves you a considerable amount of time that could be used to write more content or focus on other tasks. It also removes the need for advanced SEO knowledge. * **It comes preconfigured.** With The SEO Framework, we provide an excellent starting point for your website by rationally optimizing all your pages. Naturally, you can also tweak it however you like. If you're not an SEO expert, learn what you may wish to optimize in our [Setup guide](https://theseoframework.com/?p=2428). * **It helps you optimize your metadata.** We made the only SEO plugin that follows Google's webmaster guidelines to the letter. It took years of research and tweaking to translate this well inside your WordPress interface. Finally, you can freely optimize your pages without having to worry about making critical mistakes. * **It creates a beautiful overview.** On your post overview pages, you'll find color-coded guidelines. They suggest you how to improve your pages as you hover over them with your mouse. For example, when your titles are unbranded or when WordPress blocks indexing. Instinctively, touch-and keyboard navigation is also supported. * **It includes exceptional support.** We don't outsource our support. We're here for you. Feel free to drop by [our support forums](https://wordpress.org/support/plugin/autodescription/) at any time to ask a question. More than 1400 inquiries have been answered personally, typically within 48 hours in the past five years. * **It leaves no room for errors.** We focus on the quality of features you need over the quantity on features you don't. This trait makes this plugin unique, faster, more accurate, nearly bug-free, and more sustainable. The added benefit is that your site is unlikely to get penalized by search engines. We won't steer you into writing unnatural content or allow you to trick search engines. * **It remains genuine and pure.** We built The SEO Framework for small to large corporations and enterprises. The interface is entirely accessible and seamlessly integrates within your dashboard. Therefore, interacting with this plugin feels natural. It might feel dull, but your WordPress dashboard shouldn't be a billboard for our branding. We won't ever change this. * **It improves search presence.** The SEO Framework ranks your website distinctively by enabling breadcrumbs for Google Search, and by automatically generating titles and descriptions according to Google's guidelines. It also notifies Google, Bing, and all connected search networks automatically of your website's changes with its built-in sitemap. * **It makes social sharing easy.** The SEO Framework automatically supports and allows you to further tailor the Open Graph, Facebook, and Twitter Cards protocols. It helps your posts stand out when they're shared on various social networks, including Pinterest, Discord, and Whatsapp. * **It feels more than accessible.** We handpicked our color scheme so that people with any medically recognized color-vision deficiency can distinguish the guidelines set by search engines. We also implemented full keyboard-navigation and screen-reader support. * **It protects you from mistakes.** The SEO Framework steers you from making significant and common SEO mistakes. It leaves little room for you to mess up because the plugin already does everything SEO for you. For example, it automatically prevents duplicated content mistakes by enforcing strict canonical rules. * **It follows best-practices and beyond.** The biggest problems with WordPress plugins are security and compatibility. As part-time security researchers, we focus on making this plugin impenetrable. The SEO Framework also uses WordPress's API whenever possible, making this plugin integrate neatly with every other plugin written with that in mind. * **It has developers at heart.** We encourage other developers to enhance and add functionality to this plugin. We've done so ourselves, already, with our [extensions](https://theseoframework.com/extensions/). Check out [our API](https://theseoframework.com/?p=82), and feel free to [contribute](https://tsf.fyi/contributing)! * **It respects your privacy.** The SEO Framework sends us no information and does not create cookies. Learn more from our strictly adhered-to [privacy policy](https://theseoframework.com/?p=1701#pluginprivacyinformation). = Getting started = * Used another plugin? Easily [migrate your SEO data](https://theseoframework.com/?p=511). * Need a helping hand getting started? Read our [quick setup guide](https://theseoframework.com/?p=2428). * Want to improve your pages? Learn how to [optimize your metadata](https://theseoframework.com/?p=2663). = Do more with extensions = For additional functionality, check out our free companion plugin [Extension Manager](https://theseoframework.com/?p=2760). It provides numerous free and paid extensions, such as: * [Focus](https://theseoframework.com/?p=2305) guides you through the process of writing targeted content that ranks with **focus keywords and synonyms**. * [Articles](https://theseoframework.com/?p=2303) **enhances your published posts** by automatically adding important Structured Data. * [Transport](https://theseoframework.com/?p=3962) **migrates and transforms metadata** from Rank Math, Yoast SEO, and SEOPress to this plugin. * [Honeypot](https://theseoframework.com/?p=2300) **catches comment spammers** through four lightweight yet powerful ways. * [Cord](https://theseoframework.com/?p=3404) helps you connect your website to **Google Analytics and Facebook Pixel**. * [Local](https://theseoframework.com/?p=2306) lets you set up **important local business information** for search engines to consume. * [AMP](https://theseoframework.com/?p=2304) **binds The SEO Framework to the AMP plugin** for AMP supported articles and pages. * [Monitor](https://theseoframework.com/?p=2302) **keeps track of your website's SEO** optimizations and statistics. * [Incognito](https://theseoframework.com/?p=2301) **hides all development-comments** from The SEO Framework. * [Origin](https://theseoframework.com/?p=2299) **redirects attachment-page visitors** back to the parent post. * [Title Fix](https://theseoframework.com/?p=2298) makes sure your **title output is as configured**. Even if your theme is doing it wrong. Visit our [extensions overview page](https://theseoframework.com/extensions/) for more information. = Unbranded, free and for the professionals = The SEO Framework is a uniquely white label plugin that blends seamlessly into your WordPress dashboard. This means that we don't even put the name "The SEO Framework" anywhere within your WordPress interface. No ads, no nags. Nobody has to know about the tools you've used to create your website. Note that we output standardized development-comments distinguishing the plugin output in source code. You can remove these with our free [Incognito extension](https://theseoframework.com/?p=2301). = Behind the screens = The SEO Framework works on many things without notifying you, because the best software is fast, nimble, responsive, and should save you precious time. Here are a few things it does behind the screens. * It prevents canonical errors for categories, pages, subdomains, and WordPress Multisite domain mapping. * It stops SEO attacks that are caused by pagination exploits in WordPress by telling the search engine to look at the existing last page instead. * It discourages 404 pages and empty categories from being indexed, even when they don't send a 404 response. * It automatically notifies Google and the Bing network on website updates when sitemaps are enabled. * It discourages search engines from indexing feeds and the sitemap. This doesn't mean they won't use them; only, they won't show them in their search results. * It directs search engines from the comment pages back to the post storing those comments. = Compatibility = **The SEO Framework supports:** * PHP 7.2 and higher. * WordPress 5.5 and higher. * Internationalization through WordPress.org. * Unicode (UTF-8) character recognition and rendering, including Emoji and CJKV (Chinese, Japanese, Korean, Vietnamese). * Right to Left (RTL) languages (Arabic, Hebrew, Farsi, et al.), through its interface and metatag generation. * Complete color-vision deficiency accessibility thanks to a carefully picked color scheme. * Full keyboard navigation, so that you can inspect tooltips quickly without ever having to reach for your mouse. * Full screen-reader accessibility via field anchors, ARIA labels, and title attributes. * WordPress Multisite setups, this plugin is in fact built upon one. * Detection and output of robots.txt and sitemap.xml files. * Full integration with WordPress Core sitemaps. * Output of structured data via Schema.org JSON-LD scripts. * Altering oEmbed for improved sharing on Discord. * Detection of various other SEO tools to help you switch graciously. * Translation plugins like WPML, Polylang, WPGlobus, and MultilingualPress. * E-commerce plugins like WooCommerce and Easy Digital Downloads. * Forum plugins like bbPress and wpForo. * Editing posts and terms via WordPress's native bulk-and-quick-edit interfaces. * Headless mode via a single [constant definition](https://kb.theseoframework.com/?p=136). = Copyright legislation notice = In a few words: The SEO Framework allows search engines to do what they've been doing for the past 20 years via its preconfigured copyright settings. When you activate The SEO Framework on any site, you automatically grant rights to content aggregators, among Google, Bing, and Yandex, to obtain and use information from the site, including written work, images, audio, and video. You can control these rights via the robots-meta settings brought by this plugin. Your rights and the effectiveness of these settings are subject to your website's region and language, and the physical or virtual origin of the platform and their potential users through which your website's information is obtained and shared. It is up to the aggregator to honor your rights and the requests brought via The SEO Framework. If you wish to learn more, please refer to the [EU commission on copyright](https://ec.europa.eu/digital-single-market/en/modernisation-eu-copyright-rules). These rulings may propagate its effects through regions outside the EU. == Installation == = This plugin requires: = * PHP 7.2 or higher. * WordPress 5.5 or higher. * Any modern browser for administration. = Installation instructions: = 1. Install **The SEO Framework** either via your WordPress dashboard using plugin search or by uploading the files to your server. 1. Either network-activate this plugin or activate it on a single site. 1. That's it! The plugin now optimizes your website for SEO. It also protects your website against SEO attacks. = This plugin auto-configures its global settings = However, it would be best if you read up on our [plugin setup guide](https://theseoframework.com/?p=2428) to get the most out of The SEO Framework. = This plugin auto-configures SEO meta settings = However, you may want to read up on our [page improvement guide](https://theseoframework.com/?p=2663) to learn how you can optimize your pages. = Get more SEO power = Optionally, also install our free [Extension Manager](https://theseoframework.com/?p=2760) plugin for additional SEO solutions. == Screenshots == 1. The SEO Framework shows you how your site is performing, at a glance. These are what we call the SEO Bar. 2. Hover over, tap on, or focus any SEO Bar item and it will tell you what's asserted from your environment. 3. The SEO meta box is displayed on all pages. It's everything you need. Here you can see the pixel counters. 4. These SEO settings are shown on the term edit screen. It seamlessly blends into your WordPress interface. 5. The SEO settings page of The SEO Framework. Every setting is explained thoroughly. You're in full control. == Frequently Asked Questions == = Is The SEO Framework free? = Absolutely! It will stay free as well, without ads, tracking, bloat, or nags! This plugin is slim yet all-inclusive. It's 100% freeware, not crippleware. = Is there a premium version? = No. We treat this plugin as a premium plugin already. However, we do offer many free and paid extensions that help support this free plugin. We provide these via our free [Extension Manager plugin](https://theseoframework.com/?p=2760). = Why is there no analytics, tracking, or 404 monitoring? = SEO experts that use advanced tools such as Ahrefs, SEMrush, Screaming Frog, and Google Analytics prefer using The SEO Framework because it doesn't try to do their job haphazardly. To correctly analyze your website, it must be done from the outside. If we load these features on your site, bad robots will cause thousands of false positives that fill your database with useless information that doesn't apply to search engines. We refrain from this because it won't ever help you anyway. = I have a feature request, a question, or found a bug. = Please visit [the support forums](https://wordpress.org/support/plugin/autodescription) and kindly tell us about it. We'll try to get back to you within a week. Typically, we reply within three days. = I am a developer; how can I help? = Any input is much appreciated, and everything will be considered. Please visit the [GitHub project page](https://github.com/sybrew/the-seo-framework) to submit issues or even pull requests. Learn more [about contributing](https://tsf.fyi/contributing). = What do the colors tell me? = We use different colors to convey messages. Red is an error that you must resolve. Yellow is a non-critical warning that you may want to address. Green is good. Blue is informational and situational. Gray is undefined or unprocessable. = The sitemap doesn't contain categories, images, et al. = Not having every single page listed is not an issue. Search engines love crawling WordPress because its structure is consistent and well known. If a visitor can't find a page, then why would a search engine? Don't rely on your sitemap, but on your content and website's usability. Check out our [Extension Manager](https://theseoframework.com/?p=2760). It brings extensions, like [Articles](https://theseoframework.com/?p=2303), that fill in the gaps via modern and more robust means. = The sitemap contains unwanted links. = The SEO Framework takes all publicly queryable posts, pages, and CPT and puts them in the sitemap. If you don't want a page in the sitemap, consider enabling the `noindex` option for it. This option will also remove the page from search engine result pages. If the link shouldn't be in the sitemap because it's meant for structural reasons, then inform the plugin or theme author that created them. You should tell the author to check out the "`public` and `rewrite` post type arguments." The plugin or theme author should know what that means. In the meantime, you can disable SEO for the unwanted entries via the "General SEO Settings" under "Exclusions." = Why aren't focus keywords included? = [Google warns](https://developers.google.com/search/docs/advanced/guidelines/irrelevant-keywords) about the keyword stuffing approach implemented by some other SEO plugins. It forces users to write unnatural content, and it can have adverse effects on your site's ranking. Modern search engines use AI to understand the context of your articles. This means that as long as you write relevant content, you shouldn't have to worry about keywords. However, we implemented the same API Google uses to help you find appropriate synonyms and inflections for your keywords. This functionality is part of our premium suite of extensions. = What do the application/ld+json scripts do? = The JSON-LD scripts are search engine helpers that tell search engines how to connect and index the site. We do this via the Schema.org standard. They can tell the search engine if your site contains an internal search engine, which social sites you're connected to, and what page structure you're using. This is also referred to as **structured data**. = I don't see the breadcrumbs! = The SEO Framework does not provide the display of breadcrumbs. This is theme-territory. This plugin only annotates them for search engines via a JSON-LD script. If you wish to display breadcrumbs, then your theme should provide this. Alternatively, there are [other plugins](https://wordpress.org/plugins/search/breadcrumbs/) that help you do this. == Changelog == = 4.2.8 = This minor update makes the SEO Bar easier on the eyes. We also improved compatibility with bbPress, wpForo, and WooCommerce, and added compatibility with another thousand plugins via Advanced Query Protection’s new plugin query variable detection. We also fixed a couple of bugs, added and improved syntax detection of SEOPress and Rank Math, introduced new APIs, dusted off some code, refined tooltip placement, added Site Icon as a fallback for the sitemap title logo, and perfected support for Custom Post Types by detecting [their changed arguments](https://theseoframework.com/?p=4059). = 4.2.7 = This minor update brings you a revamped HTML parser and a new option for tuning its accuracy for descriptions. First-time installers are now notified when metadata can be transported from other SEO plugins, the SEO Bar recognizes syntax from Rank Math, and Advanced Query Protection blocks new SEO attacks that could tank your rankings. We also [fixed a couple of bugs](https://theseoframework.com/?p=4021). *Psst: Check out our [Cyber Sale](https://theseoframework.com/?p=3527).* *v4.7.2.1: Fixed syntax for PHP 7.2. Props [opicron](https://wordpress.org/support/topic/syntax-error-226/#post-16183422).* = 4.2.6 = This patch resolves an issue with WordPress 6.1, which queries template parts before posts are requested. This premature query causes TSF to fail in recognizing support for Custom Post Types, [preventing all meta output](https://theseoframework.com/?p=4015). = 4.2.5 = This minor update addresses a change in WordPress 6.0 that causes taxonomy sitemaps to crash, allows paginated deindexing to supersede forced indexing, and improves image cropping by [preserving metadata](https://theseoframework.com/?p=3929). = 4.2.4 = This minor update improves image processing, reducing TSF's load impact by roughly 20% when generating metadata. We also added WordPress 6.0 support for image filesizes, making social sharing [even more robust](https://theseoframework.com/?p=3903). = 4.2.3 = This minor update addresses a regression where the singular-archive canonical URLs always [pointed to the first page](https://theseoframework.com/?p=3858). = 4.2.2 = This minor update addresses a regression where the homepage canonical URL was [missing a trailing slash](https://theseoframework.com/?p=3841). = 4.2.1 = This minor update addresses a few regressions brought in v4.2.0; it fixes the canonical URL for paginated categories, corrects an API typo, and [rectifies a few edge cases](https://theseoframework.com/?p=3836). TSF now also supports PHP 8.1. = 4.2.0 - Perfect = *Come with me, and you'll be in a world of pure imagination. - [Gene Wilder, Anthony Newley, Leslie Bricusse](https://www.youtube.com/watch?v=SVi3-PrQ0pY)* **Release highlights** * This update brings new post-type-archive settings. You can now edit their titles, descriptions, social and visibility settings, and even add redirects on the SEO Settings page. * Fancy a custom site title for SEO purposes only? Check out the new title settings. * You will find that the sitemap's stylesheet now has its URLs centered; it also supports mobile devices. * Developers can now enjoy using the new `tsf()` function -- an alias of `the_seo_framework()`. * If you're a developer, you should also check out our perfectly tuned `memo()`. `umemo()`, and `fmemo()` [functions](https://github.com/sybrew/the-seo-framework/blob/4.2.0/inc/functions/api.php#L155-L335), which help make TSF so performant. **Perfect** TSF is finally what I (Sybre) envisioned it to become when I first named it "The SEO Framework": It's lightning-fast, hassle-free, and has all necessary options while giving you the best in class experience. I hope you enjoy what I believe is a perfect product! To me, The SEO Framework is finished. Done. It's excellent. This doesn't mean its journey ends here. Now, it's time to add features *you* want. A restyled interface, migration support, custom title generation, more structured data fields, and many other community proposals are under consideration. **A perfect tip** This update comes with updated browser styles and scripts. Not all browsers get these for you; so, the interface might appear broken (and your "inputs" seem to be "removed"). Try a different browser, or [clear your favorite browser's cache](https://kinsta.com/knowledgebase/how-to-clear-browser-cache/#how-to-force-refresh-a-single-page). That ought to do the trick. **Environment upgrade notes** WordPress 5.1 through 5.4 are no longer supported. Here's why: * [Over 66% of all WordPress sites](https://wordpress.org/about/stats/) are using WordPress v5.5 or later. * Newer versions of WordPress are faster, more reliable, and easier to work with; for both you and us. * Supporting past versions takes time away that's better used implementing new features. PHP 5.6 through 7.1 are no longer supported. Here's why: * [Almost 80% of all WordPress sites](https://wordpress.org/about/stats/) are using PHP v7.2 or later. * Newer versions of PHP are faster and more secure. For us, they're also easier to work with. * Again, supporting past versions takes time away that's better used implementing new features. **Support the development** We hope you'll love this update as much as we do. Please consider supporting us by sharing [a fantastic review](https://wordpress.org/support/plugin/autodescription/reviews/#new-topic-0), [get a license](https://theseoframework.com/pricing/), or do your friends and colleagues a favor by installing TSF for them. **Detailed log** Practice makes perfect. So does [working 16 hours a day](https://theseoframework.com/?p=3815#detailed). = Full changelog = * **You can find the full changelog [here](https://theseoframework.com/?cat=2).** == Upgrade Notice == = 4.1.0 = The v4.1.0 update brings a major upgrade. Make a backup of your database before updating. WordPress v5.1 (or higher) is now required. Downgrading to v4.0.7 is possible without side effects. = 4.0.0 = The v4.0.0 update brings a major upgrade. Make a backup of your database before updating. WordPress v4.9 (or higher) and PHP v5.6 (or higher) are now required. If you use the Extension Manager, update it to v2.1.0 (or higher) before updating this plugin. Downgrading to v3.2.4 is possible, however with the caveat that the homepage title may flip its output order back. = 3.1.1 = This is a major upgrade. Make a backup of your database before upgrading. WordPress v4.6 (or greater) and PHP v5.4 (or greater) are now required. If you use the Extension Manager, update it to v1.5.2 (or greater) before upgrading this plugin. Downgrading to v3.0.6 possible. = 3.0.0 = A major update. Make a backup of your database before upgrading. == Other Notes ==