Single page applications provide a great user experience, but are notorious for their poor SEO. This plugin bridges that gap by integrating October with prerender.io. This allows websites like Google, Facebook, and Twitter to crawl your website perfectly, without sacrificing the experience of a SPA.
Install the plugin by running the following commands from your root October directory
git clone git@github.com:scottbedard/oc-prerender-plugin.git plugins/bedard/prerender
composer updateNext, configure your prerender token by adding the following to your .env file
PRERENDER_TOKEN=yoursecrettoken
If you are using a self-hosted service, add the server address to your .env file
PRERENDER_URL=http://example.com
You can disable the service by adding the following to your .env file
PRERENDER_ENABLE=false
This plugin exposes a bedard.prerender.recache event that can be used to recache URLs. For example, say you want to recache blog posts when the content is changes. You could add the following to your Plugin.php file achieve this.
public function boot()
{
\RainLab\Blog\Models\Post::extend(function ($model) {
$model->bindEvent('afterSave', function () use ($model) {
\Event::fire('bedard.prerender.recache', 'https://example.com/blog/' . $model->slug);
});
});
}Prerendering can be customized by adding the following to a configuration file at config/bedard/prerender/config.php. Check the October documentation for information on setting environment specific configuration. Click here to see the default configuration.
If a whitelist is supplied, only url's containing a whitelist path will be prerendered. An empty array means that all URIs will pass this filter. Note that this is the full request URI, so including starting slash and query parameter string.
'whitelist' => [
'/frontend/*' // only prerender pages starting with '/frontend/'
]If a blacklist is supplied, all url's will be prerendered except ones containing a blacklist path. By default, a set of asset extensions are included. Note that this is the full request URI, so including starting slash and query parameter string.
'blacklist' => [
'/api/*' // do not prerender pages starting with '/api/'
]Requests from crawlers that do not support _escaped_fragment_ will nevertheless be served with prerendered pages. You can customize the list of crawlers using the following config entry.
'crawler_user_agents' => [
'googlebot',
]If you're writing traditional themes using October's AJAX framework, then probably not. This plugin is designed for themes like Vuetober, where the majority of rendering is done on the client side.
Yes, but server-rendered applications bring with them a lot of baggage. For starters they often require a Node server, complicated build steps, and that you write "universal code". Prerendering achieves many of the benefits of SSR, with significantly fewer moving parts.
Start by checking out the prerender.io testing docs. To see how your site looks to different crawlers, try changing your user agent to something like "Googlebot". Click here to learn how to do this in Chrome.
Many thanks to jeroennoten for providing the middleware used in this plugin.