Skip to content

Latest commit

 

History

History
51 lines (34 loc) · 3.05 KB

README.md

File metadata and controls

51 lines (34 loc) · 3.05 KB

Gatsby v2 WordPress Starter

This starter is forked from the gatsby-starter-netlify-cms and modified to use WordPress instead of netlify-cms, using the gatsby-source-wordpress plugin as the data connector.

Demo: https://gatsby-starter-wordpress.netlify.com/

Looking for maintainer: If you're interested in taking over the maintenance of this starter, please reach out in an issue. We're not working with Gatsby any more (it got way too complicated, hello nextjs), and so we're not maintaining this.

Use It Now

gatsby new NAME https://github.com/GatsbyCentral/gatsby-starter-wordpress
  • Edit gatsby-config.js, change baseUrl
    • Make sure you have at least 1 post and 1 page on your WordPress site
    • Make sure at least 1 post has at least 1 tag
  • Ensure the permalink structure in your WordPress installation is set to Post Name instead of the deafult Plain, or else the gatsby-source-wordpress plugin won't be able to communicate with WordPress
  • Rejoice

Known Limitations

  • This is based on the netlify starter which uses bulma. This adds 150KB to every built page.
  • Your WordPress site must have at least 1 post with 1 tag, or the starter will crash
  • Nested pages / categories will not render with nested pages
    • A WordPress page like /about/team/ will render on Gatsby as /team/
    • Likewise for categories
    • Discussion here #24

CSS Processing

This plugin uses gatsby-plugin-purgecss and bulma. The bulma build would otherwise be ~170K which adds 170K to each of your built HTML pages. However, with purgecss this is reduced 90%.

WordPress Setup

Check the gatsby-source-wordpress plugin for more information. If you want to copy the demo content, you can grab the WordPress XML export here and import it into your WordPress site as a starting point.

Support

Please post support questions on StackOverflow or other similar sites. Please only post issues here if you have a bug to report with a reproduction. Unfortunately we're not able to provide support here.

Contributors

This starter was forked from the netlify starter by the GatsbyCentral crew. Additional contributions were gratefully received from the following folks: