Instant Articles for WP

Description

This plugin adds support for Instant Articles for Facebook, which is a new way for publishers to distribute fast, interactive stories on Facebook. Instant Articles are preloaded in the Facebook mobile app so they load instantly.

With the plugin active, a new menu will be available for you to connect to your Facebook Page and start publishing your Instant Articles. You’ll also see the status of each Instant Articles submission on the edit page of your posts.

A best effort is made to generate valid Instant Article markup from your posts’ content/metadata and publish it to Facebook. The plugin knows how to transform your posts’ markup from a set of rules which forms a mapping between elements in you source markup and the valid Instant Article components. We refer to this “glue” between the two as the Transformer Rules.

Built-in to the plugin are many pre-defined transformer rules which aims to cover standard WordPress installations. If your WordPress content contains elements which are not covered by the built-in ruleset, you can define your own additional rules to extend or override the defaults in the Settings of this plugin, under: Plugin Configuration > Publishing Settings > Custom transformer rules.

Feed submission to Facebook

Facebook has a review process where they verify that all Instant Articles are properly formatted, have content consistency with their mobile web counterparts, and adhere to their community standards and content policies. You will not be able to publish Instant Articles in Facebook until your feed has been approved.

It’s important to note that if you use meta fields to add extra text, images or videos to your Posts, Facebook will expect you to add these to your Instant Articles output too. This plugin includes hooks to help you do that.

See Facebook’s documentation for full details of the submission process.

Facebook requires a minimum number of articles in your feed before they will review it. Once your feed has been approved, new posts will automatically be taken live on Instant Articles, and existing posts will be taken live once you update them.

Screenshots

  • Customized transformer rules enabled on the main Settings page. The particular configuration shown here would cause <u> and <bold> tags in the source markup to be rendered in italics and bold, respectively, in the generated Instant Article.

Installation

From your WordPress dashboard

  • Visit ‘Plugins > Add New’
  • Search for ‘Facebook Instant Articles for WP’
  • Activate the plugin on your Plugins page

From WordPress.org

  • Download Facebook Instant Articles for WP
  • Upload the uncompressed directory to ‘/wp-content/plugins/’
  • Activate the plugin on your Plugins page

Once Activated

  • Click on the ‘Instant Articles’ menu and follow the instructions to activate the plugin

FAQ

Why is there content from my post missing in the generated Instant Article?

More likely than not, this is because there is markup in the body of your post that is not mapped to a recognized Instant Article component. On the “Edit Post” screen for your post, look for additional information about the transformed output shown within the Facebook Instant Articles module located at the bottom of the screen.

In the Instant Articles module for my post, what does the “This post was transformed into an Instant Article with some warnings” message mean?

When transforming your post into an Instant Article, this plugin will show warnings when it encounters content which might not be valid when published to Facebook. When you see this message, it is recommended to resolve each warning individually.

What does the “No rules defined for ____ in the context of ____” warning mean?

This plugin transforms your post into an Instant Article by matching markup in your content to one of the components available in Instant Articles markup. Although the plugin contains many built-in rules to handle common cases, there may be markup in your post which is not recognized by these existing rules. In this case, you may be required to define some of your own rules. See below for more details about where and how.

How do I define my own transformer rules so that content from my site is rendered appropriately in an Instant Article?

Your custom rules can be defined in the Settings of this plugin, under: Plugin Configuration > Publishing Settings > Custom transformer rules. More detailed instructions about all the options available is documented in the Custom Transformer Rules section of the Facebook Instant Articles SDK.

I know of a custom transformer rule which is pretty common in the community. How can it be included by default in the plugin?

You can propose popular transformer rules to be included in the plugin by suggesting it on GitHub.

How do I post articles to Instant Articles after plugin is installed?

You can re-publish existing articles (simply edit + save) or post new articles in order to submit them to Instant Articles. After you have 10 articles added, you will be able to submit them for review.

How do I change the feed slug/URL if I’m using the RSS integration?

To change the feed slug, set the constant INSTANT_ARTICLES_SLUG to whatever you like. If you do, remember to flush the rewrite rules afterwards.
By default it is set to instant-articles which usually will give you a feed URL set to /feed/instant-articles

How do I flush the rewrite rules after changing the feed slug?

Usually simply visiting the permalinks settings page in the WordPress dashboard will do the trick (/wp-admin/options-permalink.php)

Reviews

Your article is being submitted… (FOR ME TO)

Im not able to publish instant article instantly.. I don’t know what’s happening.
Everything was okay, last 3-4 days freeze on (Your article is being submitted…) maybie the post is published after 3-4 hours will convert to instant articles… please fix…

The latest version doesn’t work

This plugin has been great until this 3.3.3 version. The problem we are facing right now is the setting up part – we cannot choose the FB page that we want to use this plugin for. It just stuck and lead to nowhere.

Before that everything was working cool. Please help.

Works

There’s no problem with this plugin, it does the job and works fine

Read all 60 reviews

Contributors & Developers

“Instant Articles for WP” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

3.2

  • Adds development mode support to post meta box (props simonengelhardt)
  • Adds rule configuration for Instagram blockquotes (props everton-rosario)
  • Adds rules for galleries (props everton-rosario)
  • Migrates some unit tests (props everton-rosario)
  • Switches to Facebook Graph SDK (props everton-rosario)
  • Improves token invalidation flow (props everton-rosario)
  • Fixes use of the_title filter (props srtfisher)
  • Improves encoding handling (props yssk22)
  • Adds post type filter to the post meta box (props technosailor)
  • Adds Playbuzz support (props everton-rosario)
  • Rename SDK getter to avert apocalypse (props diegoquinteiro)
  • Wizard copy improvements (props demoive)
  • Fixes issue with captions (props everton-rosario)
  • Adds publication block for articles with transformation warnings (props everton-rosario)
  • Fix https src attribute on some scripts (props goldenapples)

3.1.3

  • Fix for expiring token issue
  • Fix missing icons
  • Fix for empty() array check
  • Fix for setup limbo

3.1

  • New on-boarding flow wizard
  • Automattic URL claiming
  • Submit for review from wizard
  • Improved transformation rules
  • Option to submit only articles without warnings
  • Jetpack compatibility
  • Added Jetpack carousel rules
  • Compatibility layer for Get The Image plugin
  • Fix for relative URL checking
  • Fix for missing subtitles
  • Fix for double call of wpautop
  • Fix for loadHTML warnings
  • Fix for get_cover_media function
  • Fix to prevent publishing of password protected posts

props diegoquinteiro everton-rosario gemedet jacobarriola menzow rinatkhaziev srtfisher

3.0.1

  • Fix overzealous escaping

3.0

  • Fix versioning – use WP style
  • Ignore hyperlinks with a #
  • Allow filtering of post types used in the feed
  • Use v2.6 of the Facebook API
  • Coding standards & whitespace fixes
  • Load Facebook SDK over HTTPS
  • Avoid crawling of 404s
  • Replace social embeds with interactives
  • Use submission ID to check status in the admin
  • Fix over-zealous escaping

props markbarnes, paulschreiber, diegoquinteiro, gemedet

2.1

  • Fixes compatibility with PHP 5.4+
  • Bug fixes

2.0

  • Using Facebook Instant Articles SDK for PHP
  • Added API integration

0.1

  • Initial version