If you want to use Story Engine as a production tool we offer an alpha functionality Wordpress plugin. This will enable you to publish articles from Story Engine in your own Wordpress installation. The plugin will register a new endpoint in WP-API, that will be used by Story Engine to create, update and delete posts.
The plugin is in active development at https://github.com/KITMedia/wp-story-engine
Please note that current releases are to be considered to be in Alpha state.
Download latest tag/release as a zip archive and upload via wp-admin. Please note that you will have to keep track of updates manually (by visiting our support portal, or the GitHub page)
This way of installing will ensure that the latest version of this plugin will be available in your WP installation.
- Install WordPress GitHub Updater plugin from https://github.com/afragen/github-updater
- Install the plugin via wp-admin / GitHub Updater page. Use master branch for (more) stable versions.
- You will now be notified of new versions, just like any other installed plugin
Activate and setup
Activate the plugin and head over to Tools -> Story Engine in wp-admin. Here you will find the Post Endpoint needed in the next step when setting up the External Site in Story Engine.
If you need to reset the endpoint URL, click the Regenerate button. Remember to update your settings on the External Site as well!
Create an External Site under your Client. Contact the support team to set this up. Continue by adding the Post Endpoint URL:
Good to go!
Publish, update and delete Articles
Articles created in the External Site can be published to your Wordpress installation. Head over to the Publish section of Story Engine Create, where a channel for the external site will be available:
After updating an article in Story Engine Create, go to Publish and click “Update” to push your changes to the Wordpress installation.
To unpublish the external article, simply click “Unpublish”. The Wordpress post will then be deleted.
Category for an article in Story Engine will be imported to the WordPress installation upon publishing. If the Category already exists in WordPress (matched on the slug), the post will be published in that category.
Authors for an article in Story Engine will be imported to the WordPress installation upon publishing. If the author already exists in Wordpress (matched on author e-mail), the created post will be assigned to that author. Please note that only one Author will be exported (first one in the list in Story Engine Create) since Wordpress vanilla does not support more than one.
The featured image in Story Engine Create will be used as the featured image in Wordpress. Images in the body will be exported with correct WordPress classes, so make sure your theme supports aligning.
By default, the excerpt from Story Engine Create will be exported as both post_excerpt, and as the first paragraph in post_content. To change this behavior, go to Story Engine Settings in your Wordpress Installation.
Video and Image jobs
As of now, the Wordpress plugin only supports publishing Articles.
- Support for advanced Category mappings.
- All Story Engine articles to one Wordpress Category, set in plugin settings.
- Map Story Engine categories to Wordpress Categories in plugin settings.
- Support for mapping image sizes from Story Engine to WordPress image sizes.
- Support for adding Basic Authentication credentials in REST requests.
- Support for fetching article performance via Google Analytics.
- Support for mapping Story Engine authors to Wordpress Authors.
The latest version of the Roadmap will be available at the GitHub page: https://github.com/KITMedia/wp-story-engine#roadmap
Articles from Story Engine will have some extra elements that might require styling in your Wordpress theme. An example theme (a child theme to TwentySeventeen) with best practice is available here: https://github.com/KITMedia/wp-story-engine-theme
Pay extra attention to the file style.css where the actual CSS needed is present.