Skip to content

A GatsbyJS starter template that leverages the WordPress API, ACF and more

License

Notifications You must be signed in to change notification settings

afridley/gatsby-starter-wordpress

 
 

Repository files navigation

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/

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 GatsbyCentral#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:

About

A GatsbyJS starter template that leverages the WordPress API, ACF and more

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 96.5%
  • CSS 3.5%