The Facebook Instant Articles modules allow administrators to add content from a Drupal site to Facebook, to be viewed on mobile devices as Instant Articles.
Facebook has introductory information for publishers as well as in-depth documentation for developers.
Before installing this module or packaged sub-modules, there are two methods to choose from for how to add your content to Facebook as Instant Articles (either via a feed or Facebook's API), and then simple or advanced options for each.
On a basic Drupal site, with one or more article-like content types that you wish to post to Facebook as Instant Articles, the simplest way is to create a feed from your Drupal site and then have your Facebook page admin configure the Instant Articles options to point to your website to ingest the feed.
You'll need to configure which content types you want to be allowable as Instant Articles, then configure a view mode to specify which fields you want to map to which region of the Instant Article format, then you're all ready to create the feed.
To create the actual feed, there are two main options: a simple RSS feed, or a more advanced feed using the Views module.
If you enable the fb_instant_articles_rss.module you will have a feed created for you automatically. You will then have the option to either add all published content of one or more types to the feed, or else select individual pieces of content to be included in the feed.
Alternately, if you enable the fb_instant_articles_views.module you will be able to choose more advanced filtering rules for which content is included in the feed. Currently only a rendered view mode (not a fields view) is supported.
If you're a publisher who wants more control over exact timing of publishing - editing, modifying public access, or removing content from your Facebook Instant Articles library - the API approach allows for greater control.
If you're using the API you will need to determine under what conditions the API creates, edits or removes content from Facebook's Instant Articles library. This submodule adds actions (both Drupal core actions and Rules module actions) which can be triggered based on your chosen configurations. Alternately, If you do not choose to use this module to trigger API actions, you will want to trigger them some other way (via a custom module implementing entity CRUD hooks checking your own custom conditions in code, etc).
Optionally enable this module to give a report of API interactions, so that for example any content that fails Facebook Instant Article format validation will be easier to find and fix.
The Drupal Facebook Instant Articles modules have different dependencies, see "About Drupal integration" above to help choose which modules are right for you (see each module's README for it's dependencies).
- Facebook Instant Articles PHP SDK provides necessary support for ensuring Drupal content is added to facebook in the required format for Instant Articles.
- Composer Manager autoloads classes needed for the Facebook Instant Articles SDK, and downloads the SDK automatically when you enable the base module. Composer manager is not a literal dependency so that developers with custom Composer workflows can choose to manage dependencies and autoloading themselves (if this is the case you will need to include Composer's autoload file somewhere in your code, and set the variable 'fb_instant_articles_bypass_composer_manager' to TRUE).
Before installing the Drupal Facebook Instant Articles modules, see "About Drupal integration" above to help choose which modules are right for you. Then see "Dependencies" above. Then:
- Install the submodules you choose as you would normally install a contributed Drupal module. See Installing modules (Drupal 7) for further information.
See the README in your selected submodules for configuration help.
- Issues should be made in the project's issue queue on Drupal.org.
- All development is happening via PRs in GitHub.
This module is maintained by the Drupal community.