From e7caf91c24715adcefa90dd5d31dfd19a99f2cc1 Mon Sep 17 00:00:00 2001 From: Tyler Barnes Date: Fri, 5 Feb 2021 13:10:52 -0800 Subject: [PATCH 1/3] add deprecation notice --- add-docs-deprecation-notice.js | 20 +++++++++++++++++++ package.json | 1 + plugin/deprecation-notice.json | 1 + plugin/package.json | 2 +- plugin/src/steps/check-plugin-requirements.ts | 11 ++++++++++ yarn.lock | 12 +++++++++++ 6 files changed, 46 insertions(+), 1 deletion(-) create mode 100644 add-docs-deprecation-notice.js create mode 100644 plugin/deprecation-notice.json diff --git a/add-docs-deprecation-notice.js b/add-docs-deprecation-notice.js new file mode 100644 index 00000000..5cd0258b --- /dev/null +++ b/add-docs-deprecation-notice.js @@ -0,0 +1,20 @@ +const deprecationNotice = require(`./plugin/deprecation-notice.json`) +const fs = require(`fs-extra`) +const path = require(`path`) +const globby = require(`globby`) + +;(async () => { + const docsPaths = await globby(path.join(__dirname, `docs`, `**`, `*.md`)) + + for (const mdPath of docsPaths) { + const fileContents = await fs.readFile(mdPath, `utf8`) + const relativePath = mdPath.replace(__dirname, ``) + const hasMovedToMessage = `This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress${relativePath})` + + const newFileContents = `**${hasMovedToMessage}**\n\n${deprecationNotice}\n\n${fileContents}` + + console.log(relativePath) + await fs.writeFile(mdPath, newFileContents, { encoding: `utf8` }) + process.exit() + } +})() diff --git a/package.json b/package.json index 98f67d2b..54ed2ff0 100644 --- a/package.json +++ b/package.json @@ -60,6 +60,7 @@ "eslint-plugin-prettier": "^3.3.1", "fs-extra": "^9.1.0", "gatsby-plugin-utils": "^0.3.0", + "globby": "^11.0.2", "handlebars": "^4.7.6", "husky": "^4.3.0", "identity-obj-proxy": "^3.0.0", diff --git a/plugin/deprecation-notice.json b/plugin/deprecation-notice.json new file mode 100644 index 00000000..2aa1b63c --- /dev/null +++ b/plugin/deprecation-notice.json @@ -0,0 +1 @@ +"Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin!\nYou've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that!\n\nWe've shipped this plugin as `gatsby-source-wordpress@4.0.0`.\n`gatsby-source-wordpress-experimental` is now deprecated.\nPlease upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name.\n\nWe've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`.\n\nNote that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo.\n\nThank you! πŸ’œ\n\n" diff --git a/plugin/package.json b/plugin/package.json index 8e431625..c736b5d6 100644 --- a/plugin/package.json +++ b/plugin/package.json @@ -2,7 +2,7 @@ "name": "gatsby-source-wordpress-experimental", "description": "Source data from WPGraphQL in an efficient and scalable way.", "author": "Tyler Barnes ", - "version": "7.0.5", + "version": "7.0.6", "bugs": { "url": "https://github.com/gatsbyjs/gatsby-source-wordpress-experimental/issues" }, diff --git a/plugin/src/steps/check-plugin-requirements.ts b/plugin/src/steps/check-plugin-requirements.ts index d09a09ce..1ea66750 100644 --- a/plugin/src/steps/check-plugin-requirements.ts +++ b/plugin/src/steps/check-plugin-requirements.ts @@ -1,6 +1,8 @@ import url from "url" import Range from "semver/classes/range" +import deprecationNotice from "../../deprecation-notice.json" + import type { NodePluginArgs } from "gatsby" import fetch from "node-fetch" @@ -15,6 +17,7 @@ import { supportedWpPluginVersions, genericDownloadMessage, } from "~/supported-remote-plugin-versions" +import chalk from "chalk" const parseRange = (range: string) => { const { @@ -276,6 +279,14 @@ const ensurePluginRequirementsAreMet = async ( return } + helpers.reporter.log( + formatLogMessage(` + +${chalk.bold(`Upgrade/deprecation notice:`)} + +${deprecationNotice}`) + ) + const activity = helpers.reporter.activityTimer( formatLogMessage(`ensuring plugin requirements are met`) ) diff --git a/yarn.lock b/yarn.lock index f6d35623..7511e471 100644 --- a/yarn.lock +++ b/yarn.lock @@ -10597,6 +10597,18 @@ globby@^10.0.0, globby@^10.0.1: merge2 "^1.2.3" slash "^3.0.0" +globby@^11.0.2: + version "11.0.2" + resolved "https://registry.yarnpkg.com/globby/-/globby-11.0.2.tgz#1af538b766a3b540ebfb58a32b2e2d5897321d83" + integrity sha512-2ZThXDvvV8fYFRVIxnrMQBipZQDr7MxKAmQK1vujaj9/7eF0efG7BPUKJ7jP7G5SLF37xKDXvO4S/KKLj/Z0og== + dependencies: + array-union "^2.1.0" + dir-glob "^3.0.1" + fast-glob "^3.1.1" + ignore "^5.1.4" + merge2 "^1.3.0" + slash "^3.0.0" + globby@^6.1.0: version "6.1.0" resolved "https://registry.yarnpkg.com/globby/-/globby-6.1.0.tgz#f5a6d70e8395e21c858fb0489d64df02424d506c" From 74a92b2fd38c0c02504cbe1b61c44d8c5aa5c857 Mon Sep 17 00:00:00 2001 From: Tyler Barnes Date: Fri, 5 Feb 2021 13:11:23 -0800 Subject: [PATCH 2/3] Update add-docs-deprecation-notice.js --- add-docs-deprecation-notice.js | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/add-docs-deprecation-notice.js b/add-docs-deprecation-notice.js index 5cd0258b..5e8fc6ce 100644 --- a/add-docs-deprecation-notice.js +++ b/add-docs-deprecation-notice.js @@ -13,8 +13,7 @@ const globby = require(`globby`) const newFileContents = `**${hasMovedToMessage}**\n\n${deprecationNotice}\n\n${fileContents}` - console.log(relativePath) await fs.writeFile(mdPath, newFileContents, { encoding: `utf8` }) - process.exit() + console.log(`Deprecated ${relativePath}`) } })() From 0449a467d5a7806fa790109c7377338bcc359cbf Mon Sep 17 00:00:00 2001 From: Tyler Barnes Date: Fri, 5 Feb 2021 13:14:49 -0800 Subject: [PATCH 3/3] add deprecation notices to all docs --- README.md | 17 +++++++++++++++-- docs/community-and-support.md | 17 +++++++++++++++++ docs/debugging-and-troubleshooting.md | 17 +++++++++++++++++ docs/features/caching.md | 17 +++++++++++++++++ docs/features/compatibility-api.md | 17 +++++++++++++++++ docs/features/gatsby-link.md | 17 +++++++++++++++++ docs/features/graphql-wordpress-and-gatsby.md | 17 +++++++++++++++++ docs/features/index.md | 17 +++++++++++++++++ docs/features/limit-nodes-during-development.md | 17 +++++++++++++++++ docs/features/media-item-processing.md | 17 +++++++++++++++++ docs/features/preview.md | 17 +++++++++++++++++ docs/features/security.md | 17 +++++++++++++++++ docs/getting-started.md | 17 +++++++++++++++++ docs/hosting.md | 17 +++++++++++++++++ docs/migrating-from-other-wp-source-plugins.md | 17 +++++++++++++++++ docs/plugin-options.md | 17 +++++++++++++++++ docs/problems-with-gatsby-source-graphql.md | 17 +++++++++++++++++ docs/problems-with-v3.md | 17 +++++++++++++++++ docs/tests.md | 17 +++++++++++++++++ docs/themes-starters-examples.md | 17 +++++++++++++++++ .../building-a-new-site-wordpress-and-gatsby.md | 17 +++++++++++++++++ docs/tutorials/configuring-wp-gatsby.md | 17 +++++++++++++++++ .../creating-a-new-site-from-a-starter.md | 17 +++++++++++++++++ docs/tutorials/index.md | 17 +++++++++++++++++ docs/tutorials/querying-data.md | 17 +++++++++++++++++ docs/tutorials/transforming-data.md | 17 +++++++++++++++++ docs/tutorials/using-advanced-custom-fields.md | 17 +++++++++++++++++ .../tutorials/using-self-signed-certificates.md | 17 +++++++++++++++++ docs/tutorials/using-wordpress-menus.md | 17 +++++++++++++++++ .../usage-with-popular-wp-graphql-extensions.md | 17 +++++++++++++++++ docs/why-use-this-plugin.md | 17 +++++++++++++++++ 31 files changed, 525 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 9f40d19c..d762a849 100644 --- a/README.md +++ b/README.md @@ -23,9 +23,22 @@

-# gatsby-source-wordpress@v4 BETA +# This package is now published as `gatsby-source-wordpress` -This plugin is the official recommended way to use WordPress with Gatsby. We're currently publishing on a separate package to make migrating from `gatsby-source-wordpress@v3` easier. If you're coming from `v3` ​this allows you to activate the new version of the plugin alongside `gatsby-source-wordpress` and migrate your codebase one piece at a time ⭐️ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/README.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ ## Overview 🌞 diff --git a/docs/community-and-support.md b/docs/community-and-support.md index d4c32dc1..7d11af8a 100644 --- a/docs/community-and-support.md +++ b/docs/community-and-support.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/community-and-support.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Community & Support Fortunately there are very strong WPGraphQL and Gatsby communities! diff --git a/docs/debugging-and-troubleshooting.md b/docs/debugging-and-troubleshooting.md index fb07711d..afd0caf4 100644 --- a/docs/debugging-and-troubleshooting.md +++ b/docs/debugging-and-troubleshooting.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/debugging-and-troubleshooting.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Debugging and Troubleshooting - [Debugging and Troubleshooting](#debugging-and-troubleshooting) diff --git a/docs/features/caching.md b/docs/features/caching.md index bf334f1f..2ab99e32 100644 --- a/docs/features/caching.md +++ b/docs/features/caching.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/caching.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Build Caching :ballot_box: Due to our [WPGatsby](https://github.com/gatsbyjs/wp-gatsby) WordPress plugin which tracks data changes in WordPress, we can do very aggressive caching. diff --git a/docs/features/compatibility-api.md b/docs/features/compatibility-api.md index ade79cb2..af70029b 100644 --- a/docs/features/compatibility-api.md +++ b/docs/features/compatibility-api.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/compatibility-api.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Compatibility API Because we have so many remote depencies (WordPress, WPGraphQL, and WPGatsby), we've baked a remote compatibility API into this plugin. diff --git a/docs/features/gatsby-link.md b/docs/features/gatsby-link.md index 14cb1b06..b2c1f76e 100644 --- a/docs/features/gatsby-link.md +++ b/docs/features/gatsby-link.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/gatsby-link.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Gatsby Link Anchor tag src's in html that are links to your WP instance are automatically rewritten to relative links (`https://yoursite.com/beautiful-page` becomes `/beautiful-page`). For this reason, it's recommended to use your WordPress page and post [uri's](https://github.com/TylerBarnes/using-gatsby-source-wordpress-experimental/blob/master/gatsby-node.js#L29) to create your [Gatsby page paths](https://github.com/TylerBarnes/using-gatsby-source-wordpress-experimental/blob/master/gatsby-node.js#L68). diff --git a/docs/features/graphql-wordpress-and-gatsby.md b/docs/features/graphql-wordpress-and-gatsby.md index b749d850..e73c38b1 100644 --- a/docs/features/graphql-wordpress-and-gatsby.md +++ b/docs/features/graphql-wordpress-and-gatsby.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/graphql-wordpress-and-gatsby.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # GraphQL, WordPress and Gatsby This document is intended to provide more information on how GraphQL to allow WordPress to be a diff --git a/docs/features/index.md b/docs/features/index.md index 59527ee7..fd8a492e 100644 --- a/docs/features/index.md +++ b/docs/features/index.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/index.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Features 1. :zap: [Build Caching](./caching.md) diff --git a/docs/features/limit-nodes-during-development.md b/docs/features/limit-nodes-during-development.md index 1ed3f8d2..534fb5b0 100644 --- a/docs/features/limit-nodes-during-development.md +++ b/docs/features/limit-nodes-during-development.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/limit-nodes-during-development.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Limit nodes during development For very large sites it may take quite a while to start `gatsby develop` when you start working on a project. To mitigate this annoyance, we've added a plugin option to limit the number of nodes that will be pulled on any type. diff --git a/docs/features/media-item-processing.md b/docs/features/media-item-processing.md index e497027f..a0bccd96 100644 --- a/docs/features/media-item-processing.md +++ b/docs/features/media-item-processing.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/media-item-processing.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Image/File Processing & Handling ## Only referenced media items are sourced diff --git a/docs/features/preview.md b/docs/features/preview.md index 291cfe07..4b4e6a95 100644 --- a/docs/features/preview.md +++ b/docs/features/preview.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/preview.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Preview This plugin supports [Preview](https://www.gatsbyjs.com/preview/) and has been designed to replicate the normal WordPress admin preview experience as closely as possible. diff --git a/docs/features/security.md b/docs/features/security.md index b6cc10b3..c2a272ad 100644 --- a/docs/features/security.md +++ b/docs/features/security.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/features/security.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Security This plugin is built with your WP site security in mind. For that reason, we've intentionally left out any authentication options. The reason is that any data fetched by Gatsby should be considered public data. Any Gatsby site may potentially have a publically queryable GraphQL server running when Gatsby is running in Preview mode (either via self-hosted Preview or on Gatsby Cloud). If we were to source data from WordPress while authenticated, all of the data we sourced would be available in Gatsby, which means it could easily be leaked to anyone who happens upon your Preview instance. For this reason, auth options have been intentionally excluded. diff --git a/docs/getting-started.md b/docs/getting-started.md index 4b0da32c..69d2cdff 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/getting-started.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Installation & Getting Started :baby_chick: If you've had previous experience with Gatsby or you like to move fast, you can use the quick start steps below to get up and running quickly. If you'd like to take a step back and learn more first, head over to our [tutorials](./tutorials/index.md) :footprints: diff --git a/docs/hosting.md b/docs/hosting.md index 823882ea..124e75f9 100644 --- a/docs/hosting.md +++ b/docs/hosting.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/hosting.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Hosting WordPress :house: Any mid-to-high performance WordPress host will work great. You may also have success on low performance WordPress hosts for smaller or medium sized sites, but a better server is recommended. diff --git a/docs/migrating-from-other-wp-source-plugins.md b/docs/migrating-from-other-wp-source-plugins.md index 522e2653..0c2024f3 100644 --- a/docs/migrating-from-other-wp-source-plugins.md +++ b/docs/migrating-from-other-wp-source-plugins.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/migrating-from-other-wp-source-plugins.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Migrating from Other WP Source Plugins :bird: From what we've seen migrating is a fairly painless process as the GraphQL schema structure is not too different from older Gatsby WordPress source plugins. diff --git a/docs/plugin-options.md b/docs/plugin-options.md index 9a33a6fe..5ad6dce9 100644 --- a/docs/plugin-options.md +++ b/docs/plugin-options.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/plugin-options.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Plugin Options [comment]: # "This file is automatically generated. Do not edit it directly. Instead, edit the Joi schema in ./plugin/src/steps/declare-plugin-options-schema.js" diff --git a/docs/problems-with-gatsby-source-graphql.md b/docs/problems-with-gatsby-source-graphql.md index 7d5525ca..adf475c9 100644 --- a/docs/problems-with-gatsby-source-graphql.md +++ b/docs/problems-with-gatsby-source-graphql.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/problems-with-gatsby-source-graphql.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Problems with `gatsby-source-graphql` :broken_heart: `gatsby-source-graphql` skips the Gatsby Node model altogether, and allows you to directly pull data from WPGraphQL. At first this seems really attractive as things just work, but as your site grows beyond a handful of pages, a few problems arise. diff --git a/docs/problems-with-v3.md b/docs/problems-with-v3.md index e25186b2..2b8e9198 100644 --- a/docs/problems-with-v3.md +++ b/docs/problems-with-v3.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/problems-with-v3.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Problems with Gatsby Source WordPress v3 :broken_heart: `gatsby-source-wordpress@v3`, the last major version of this plugin, utilized the [WP REST API](https://developer.wordpress.org/rest-api/) for sourcing WP data into Gatsby. This worked but was problematic for a few reasons. diff --git a/docs/tests.md b/docs/tests.md index 3541aef9..28ebbc69 100644 --- a/docs/tests.md +++ b/docs/tests.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tests.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Running Tests - `yarn test` will run the entire suite diff --git a/docs/themes-starters-examples.md b/docs/themes-starters-examples.md index e14ca5b4..6cf5768a 100644 --- a/docs/themes-starters-examples.md +++ b/docs/themes-starters-examples.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/themes-starters-examples.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Official Starters [gatsby-starter-wordpress-blog](https://github.com/gatsbyjs/gatsby-starter-wordpress-blog) diff --git a/docs/tutorials/building-a-new-site-wordpress-and-gatsby.md b/docs/tutorials/building-a-new-site-wordpress-and-gatsby.md index 5d7d2c9b..bc280f08 100644 --- a/docs/tutorials/building-a-new-site-wordpress-and-gatsby.md +++ b/docs/tutorials/building-a-new-site-wordpress-and-gatsby.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tutorials/building-a-new-site-wordpress-and-gatsby.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Creating a new site from scratch ## What this tutorial covers: diff --git a/docs/tutorials/configuring-wp-gatsby.md b/docs/tutorials/configuring-wp-gatsby.md index d5a3b049..65338ec5 100644 --- a/docs/tutorials/configuring-wp-gatsby.md +++ b/docs/tutorials/configuring-wp-gatsby.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tutorials/configuring-wp-gatsby.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Configuring WPGatsby WPGatsby is a required plugin which modifies WPGraphQL and WordPress to work with Gatsby. It enables builds and previews. See [Installation](../getting-started.md#required-wordpress-dependencies) for more info about WPGatsby. diff --git a/docs/tutorials/creating-a-new-site-from-a-starter.md b/docs/tutorials/creating-a-new-site-from-a-starter.md index 73b43e98..b794f390 100644 --- a/docs/tutorials/creating-a-new-site-from-a-starter.md +++ b/docs/tutorials/creating-a-new-site-from-a-starter.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tutorials/creating-a-new-site-from-a-starter.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Creating a new site from a starter This is the recommended way to build new sites so that you start with good best practises and don't need to re-implement everything yourself. diff --git a/docs/tutorials/index.md b/docs/tutorials/index.md index 9a2ead09..2af6bd9d 100644 --- a/docs/tutorials/index.md +++ b/docs/tutorials/index.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tutorials/index.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Tutorials 1. [Creating a new site using a starter (recommended)](./creating-a-new-site-from-a-starter.md) diff --git a/docs/tutorials/querying-data.md b/docs/tutorials/querying-data.md index a26b1672..c55c08a6 100644 --- a/docs/tutorials/querying-data.md +++ b/docs/tutorials/querying-data.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tutorials/querying-data.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Querying WordPress Data with Gatsby Source WordPress This tutorial assumes that you already have a [Gatsby site running](https://github.com/gatsbyjs/gatsby-source-wordpress-experimental/blob/master/docs/getting-started.md) diff --git a/docs/tutorials/transforming-data.md b/docs/tutorials/transforming-data.md index c6615ef7..4e0f497c 100644 --- a/docs/tutorials/transforming-data.md +++ b/docs/tutorials/transforming-data.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tutorials/transforming-data.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Transforming Data There are some cases where you may want to modify data as it's fetched from WPGraphQL but before it's stored in Gatsby. This source plugin does that quite a bit itself for html transformations and image processing. Because it's such a common need for implementing advanced use cases like automatic image optimization and building transformer plugins, we have a built in API for this (`options.type.[typename].beforeChangeNode`). This API is called before any node is created, updated, or deleted. diff --git a/docs/tutorials/using-advanced-custom-fields.md b/docs/tutorials/using-advanced-custom-fields.md index d200a61a..4c6d52de 100644 --- a/docs/tutorials/using-advanced-custom-fields.md +++ b/docs/tutorials/using-advanced-custom-fields.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tutorials/using-advanced-custom-fields.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Using Advanced Custom Fields with Gatsby This tutorial assumes that you already have a [Gatsby site running](https://github.com/gatsbyjs/gatsby-source-wordpress-experimental/blob/master/docs/getting-started.md) diff --git a/docs/tutorials/using-self-signed-certificates.md b/docs/tutorials/using-self-signed-certificates.md index 60225dda..90f6bd67 100644 --- a/docs/tutorials/using-self-signed-certificates.md +++ b/docs/tutorials/using-self-signed-certificates.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tutorials/using-self-signed-certificates.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + ### Self-signed certificates When running locally, or in other situations that may involve self-signed certificates, you may run into the error: `The request failed with error code "DEPTH_ZERO_SELF_SIGNED_CERT"`. diff --git a/docs/tutorials/using-wordpress-menus.md b/docs/tutorials/using-wordpress-menus.md index 4b0d7c14..5004ea77 100644 --- a/docs/tutorials/using-wordpress-menus.md +++ b/docs/tutorials/using-wordpress-menus.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/tutorials/using-wordpress-menus.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Using WordPress Nav Menus with Gatsby This tutorial assumes that you already have a [Gatsby site running](https://github.com/gatsbyjs/gatsby-source-wordpress-experimental/blob/master/docs/getting-started.md) diff --git a/docs/usage-with-popular-wp-graphql-extensions.md b/docs/usage-with-popular-wp-graphql-extensions.md index 18b38d80..540d78a7 100644 --- a/docs/usage-with-popular-wp-graphql-extensions.md +++ b/docs/usage-with-popular-wp-graphql-extensions.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/usage-with-popular-wp-graphql-extensions.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Usage with popular WPGraphQL extensions An ideal for this source plugin is for any WPGraphQL extension to become a Gatsby plugin. In practise we haven't yet had time to thoroughly test that all extensions work. diff --git a/docs/why-use-this-plugin.md b/docs/why-use-this-plugin.md index db683bcc..eb78dd67 100644 --- a/docs/why-use-this-plugin.md +++ b/docs/why-use-this-plugin.md @@ -1,3 +1,20 @@ +**This page has moved to the [Gatsby monorepo!](https://github.com/gatsbyjs/gatsby/tree/master/packages/gatsby-source-wordpress/docs/why-use-this-plugin.md)** + +Hi there! πŸ‘‹ thank you so much for being a beta/alpha tester of this plugin! +You've helped us bring a much more stable WordPress integration to Gatsby and we're very thankful for that! + +We've shipped this plugin as `gatsby-source-wordpress@4.0.0`. +`gatsby-source-wordpress-experimental` is now deprecated. +Please upgrade by npm/yarn installing the latest version of the stable plugin and updating your gatsby-config.js to include the stable plugin name. + +We've chosen this point to release this plugin as a stable release not because there are no bugs (all software has some bugs), but because this plugin is far more stable than the last major version of `gatsby-source-wordpress`. + +Note that we will continue fixing Github issues you've opened in the -experimental repo - those are not forgotten and will be transferred to the Gatsby monorepo. + +Thank you! πŸ’œ + + + # Why use this plugin? - [Why use this plugin?](#why-use-this-plugin)