=== WP Native Articles === Contributors: ozthegreat Donate link: https://wp-native-articles.com Tags: facebook, instant articles, mobile, speed, optimize, performance Requires at least: 3.0.1 Tested up to: 4.6.1 Stable tag: 1.0.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Easy Facebook Instant Articles for your WordPress site with better content parsing and advanced features. == Description == A better implementation of Facebook Instant Articles for WordPress. Only available in the Facebook mobile app, Instant Articles are a pre-loaded, super fast, and optimized version of your regular articles. Boasting some impressive stats (10x faster, 20% more reads, 70% less abandonment) they have quickly become a must for every publisher. **How it works** After installation and setup this plugin auto generates an instant article version for each of your WordPress articles. The article's regular HTML is parsed and converted to correct Facebook Instant Article markup which is then submitted to Facebook via a RSS feed. When your article is viewed using the Facebook mobile app it will now load the fast, optimized instant article version directly in the app. When the article is shared or posted its instant status will also be denoted by the lightening symbol in the corner. [Read more about Instant Articles from the official documentation](https://developers.facebook.com/docs/instant-articles) **Content Parsing** A large part of the complexity of integrating Facebook Instant Articles is the rigorous content structure imposed. Due to the WYSIWYG editor and the plethora of plugins and themes available, WordPress content tends to be rather unstructured. Most of the current Facebook Instant Article plugins don't really take account of this and either produce invalid content or strip parts out. This plugin is a concentrated effort to correctly format any WordPress content it could possibly come across. You can read more about the challenges and solutions in [this blog post](https://wp-native-articles.com/blog/formatting-wordpress-html-content-instant-articles/?utm_source=fplugin&utm_medium=readme). > **PRO Version** > > [WP Native Articles Pro](https://wp-native-articles.com/?utm_source=fplugin&utm_medium=readme-a) comes with full [Facebook Instant Articles API](https://wp-native-articles.com/?utm_source=fplugin&utm_medium=readme-b#features) integration and has > advanced features such as: > > * **Full API integration** > * **Manage Articles** Publish, unpublish and manage Instant Articles directly from the WordPress post page. > * **Live Sync** Instant Articles synced instantly from WordPress, no waiting for FaceBook to scrape the RSS feed. > * **Article Status** Errors & import status for your Instant Articles displayed live in every article. > * **Instant Articles Analytics** Individual and aggregated site overview. > * **Premium support** > > Check out the Pro version at [https://wp-native-articles.com/](https://wp-native-articles.com/?utm_source=fplugin&utm_medium=readme-c). **Future** Features planned for the near future. * Image options manager * Embed manager (ads, related articles, anything) * WP Comments * Advanced stats & weekly roundup * CLI & API integration == Installation == 1. Upload `wp-native-articles` to the `/wp-content/plugins/` directory 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Go to `Native Articles` in the admin sidebar to manage settings 4. When you're ready submit your feed to Facebook. [Full instructions](https://developers.facebook.com/docs/instant-articles/publishing/setup-rss-feed) == Upgrade Notice == Intentionally left blank == Frequently Asked Questions == = Where can I find the support documentation? = All documentation is available at [docs.wp-native-articles.com](http://docs.wp-native-articles.com). It is a work in progress so please bear with us. = Does it support Branded Content? = Yes. Individual articles can be setup as branded. The author details are used and displayed on the Instant Article. = Does it support Ads & Analytics? = Yes. Both can be added on a global level or overridden for individual articles. = I use ACF or Meta Fields to display some content. Are these supported? = They won't automatically be added to the Instant Articles unfortunately. However, they should be easy enough to add as not only are there hooks galore in the plugin but the Instant Article templates can be overridden in your own theme or plugin. = Does it play well with other plugins? = Yes, extremely well. We've tested loads of popular plugins that embed content and built in support for Yoast, Co-Authors-Plus and Playbuzz to name a few. If you find any that don't work or that we've missed please let us know and we'll be sure to fix them. = Is there a road map? = Yep. It can be found on our [instant articles roadmap page](https://wp-native-articles.com/roadmap/?utm_source=fplugin&utm_medium=readme-d). = Does it support WordPress Multisite? = Yes it does. There's a management panel in the Network Admin sidebar menu. It can be used to copy settings from one blog to another and set a default blog to inherit settings from when new blogs are created. = Is it multilingual compatible? = Yes. All text strings use the WordPress i18n translation functions. If you'd like to help translate the plugin we'd love to hear from you! = I've found a bug? I have a feature request? = Excellent. We'd love to hear from you. All support for the free plugin is done through the WordPress support forum found on the Plugin download page. == Screenshots == 1. Default options page. 2. Default options page (cont). 3. Feed specific options. 4. Post options overrides box. 5. Multisite options page. == Changelog == = 1.0.2 = * Fix for images using HTML5 markup * Take account of captions when removing images * 'Premium' page * Readme corrections = 1.0.1 = * Readme corrections = 1.0.0 = * Plugin released