=== NextGEN Facebook - Complete Meta Tags for FB, Google, Pinterest, Twitter, LinkedIn & More ===
Plugin Name: NextGEN Facebook (NGFB)
Plugin Slug: nextgen-facebook
Text Domain: nextgen-facebook
Domain Path: /languages
Contributors: jsmoriss
Donate Link: https://surniaulula.com/extend/plugins/nextgen-facebook/
Tags: attached, bbPress, buddypress, buttons, e-commerce, easy digital downloads, edd, Facebook, featured, g+, gallery, google, google plus, hashtags, imagebrowser, jetpack, JSON-LD, knowledge graph, Like, linkedin, marketpress, meta-tags, multilingual, multisite, nextgen gallery, nggalbum, nggallery, object cache, open graph, photon, pinterest, player card, polylang, rich pins, schema, seo, Share, shortcode, singlepic, slideshare, social, stumbleupon, Summary Card, transient cache, tumblr, twitter, twitter cards, vimeo, widget, wistia, woocommerce, wp_cache, youtube, yotpo
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl.txt
Requires At Least: 3.1
Tested Up To: 4.4
Stable Tag: 8.20.1.2

Display your content in the best possible way on Facebook, Google+, Twitter, Pinterest, etc. - no matter how your webpage is shared!

== Description ==

<p><img src="https://surniaulula.github.io/nextgen-facebook/assets/icon-256x256.png" style="width:33%;min-width:128px;max-width:256px;float:left;margin:10px 60px 40px 0;" /><strong>Make sure social websites present your content in the best possible way, no matter <em>how</em> your webpage is shared</strong> &mdash; from sharing buttons on the webpage, browser add-ons / extensions, or URLs pasted directly on timelines and private messages (PM) &mdash; the NextGEN Facebook (NGFB) plugin has you covered.</p>

**A solid social meta tag plugin is the foundation of any good social strategy** &mdash; NextGEN Facebook (NGFB) gives you total control over all the information [social website crawlers](https://developers.facebook.com/docs/sharing/webmasters/crawler) need, improving Google Search ranking, social engagement, and click-through-rates on Facebook, Google+, Twitter, Pinterest, LinkedIn, StumbleUpon, Tumblr and and many more &mdash; along with offering many of the most popular social sharing buttons!

**NGFB automatically retrieves and uses information from a wide range or sources**, including All in One SEO Pack, bbPress, BuddyPress, Easy Digital Downloads, HeadSpace2 SEO, JetPack Photon, NextGEN Gallery, MarketPress - WordPress eCommerce, Polylang, WooCommerce, Yoast SEO (aka WordPress SEO), WP e-Commerce, Gravatar, Slideshare, Vimeo, Wistia, YouTube, extends the WordPress REST API v2, and much more.

= Available in Multiple Languages =

* English (US)
* French (France)
* More to come...

<blockquote>
<p><strong>September 14, 2015 - WPSSO Replaces NextGEN Facebook (NGFB)</strong></p>
<p>NextGEN Facebook (NGFB) is being replaced by the <a href="https://wordpress.org/plugins/wpsso/">WordPress Social Sharing Optimization</a> (WPSSO) plugin. WPSSO is a fork / child of NGFB &mdash; they have the same author, the same core features and code-base, but WPSSO is distributed without the sharing buttons and their related features (making WPSSO about 25% smaller than NGFB). Additional extension plugins are also available for WPSSO, including two different sharing button extensions:
<ul>
<li><a href="https://wordpress.org/plugins/wpsso-am/">WPSSO Mobile App Meta</a></li>
<li><a href="https://wordpress.org/plugins/wpsso-plm/">WPSSO Place and Location Meta</a></li>
<li><a href="https://wordpress.org/plugins/wpsso-rrssb/">WPSSO Ridiculously Responsive Social Sharing Buttons</a></li>
<li><a href="https://wordpress.org/plugins/wpsso-ssb/">WPSSO Social Sharing Buttons</a></li>
</ul></p>
</blockquote>

= Quick List of Features =

**NGFB Free / Basic Features**

* Adds Open Graph / Rich Pin meta tags (Facebook, Google+, Pinterest, LinkedIn, etc.).
* Twitter Card meta tags:
	* [App Card](https://dev.twitter.com/cards/types/app) (requires the [WPSSO](https://wordpress.org/plugins/wpsso/) plugin and [WPSSO Mobile App Meta](https://wordpress.org/plugins/wpsso-am/) extension)
	* [Summary Card with Large Image](https://dev.twitter.com/cards/types/summary-large-image)
	* [Summary Card](https://dev.twitter.com/cards/types/summary)
	* [Player Card](https://dev.twitter.com/cards/types/player) is provided with the Pro version (as it requires video discovery modules available only in the Pro version).
	* [Photo Card](https://dev.twitter.com/cards/types/photo), [Gallery Card](https://dev.twitter.com/cards/types/gallery), and [Product Card](https://dev.twitter.com/cards/types/product) were deprecated by Twitter on July 3rd, 2015 and are no longer supported. 
* Configurable image sizes for Open Graph (Facebook, LinkedIn, etc.) and Pinterest.
* Customizable image dimensions for each Twitter Card type.
* Optional fallback to a default image and video for index and search webpages.
* Support for featured, attached, gallery shortcode, and/or HTML image tags in content.
* Fallback to image alt values if the content and except do not include any text.
* Validates image dimensions and aspect ratios for reliable sharing results.
* Auto-regeneration of inaccurate / missing WordPress image sizes.
* Fully renders content (including shortcodes) for accurate description texts.
* Support of WordPress and/or SEO titles for Posts and Pages.
* Configurable title separator character (hyphen by default).
* Configurable title and description lengths for different contexts (Open Graph, Twitter Card, SEO).
* Includes author and publisher profile URLs and markup for Facebook and Google Search.
* Includes hashtags from Post and Page WordPress tags.
* Includes the author's name for Pinterest Rich Pins.
* Includes a Google / SEO description meta tag, if a known SEO plugin is not detected.
* Includes <a href="https://developers.google.com/structured-data/customize/social-profiles">author (Person) and publisher (Organization) social profiles</a>, <a href="https://developers.google.com/structured-data/customize/logos">publisher (Organization) logo</a>, and <a href="https://developers.google.com/structured-data/site-name">WebSite Site Name</a> in schema.org JSON-LD format for Google Search and their <em>Knowledge Graph</em>.
* Configurable website / business social accounts for JSON-LD markup:
	* Facebook Business Page URL
	* Google+ Business Page URL
	* Pinterest Company Page URL
	* Twitter Business @username
	* Instagram Business URL
	* LinkedIn Company Page URL
	* MySpace Business (Brand) URL
* User profile contact fields for Open Graph, Twitter Card, and JSON-LD markup:
	* Facebook URL
	* Google+ URL
	* Instagram URL
	* LinkedIn URL
	* MySpace URL
	* Pinterest URL
	* Skype Username
	* Tumblr URL
	* Twitter @username
	* YouTube Channel URL
* Validation tools, social preview, and meta tag value tabs on admin editing pages.
* Customizable *multilingual* Site Title and Site Description texts.
* Contextual help for *every* plugin option and [comprehensive online documentation](http://surniaulula.com/codex/plugins/nextgen-facebook/).
* Uses object and transient caches to provide incredibly fast execution speeds.
* Default stylesheets for each social sharing button location.
* Social sharing buttons for the content, excerpt, in a widget, as a shortcode, floating sidebar, and/or PHP function.
	* Buffer
	* Facebook
	* Google+
	* LinkedIn
	* ManageWP
	* Pinterest
	* Reddit
	* StumbleUpon
	* Tumblr
	* Twitter

<blockquote>
<p>Download the Free version from <a href="http://surniaulula.github.io/nextgen-facebook/">GitHub</a> or <a href="https://wordpress.org/plugins/nextgen-facebook/">WordPress.org</a>.</p>
</blockquote>

<div style="clear:both;"></div>
<div style="width:40%;min-width:256px;max-width:1200px;height:auto;float:right;margin:10px 0 40px 60px;">
<p><img src="https://surniaulula.github.io/nextgen-facebook/images/social/twitter-player-card-single.png" width="100%" height="100%"/></p>
</div>

= Quick List of Features (Continued) =

**NGFB Pro / Power-User Features**

* A "Social Settings" metabox for Post, Page, custom post type, user profile, and taxonomy (category and tag) editing pages &mdash; the "Social Settings" metbox allows you to customize the article topic, the shared title, the Open Graph / Facebook / Rich Pin, Google Search, and Twitter Card descriptions, along with the shared image and/or video.
* Support for embedded videos in content text ("iframe" and "object" HTML markup).
* Additional Open Graph / Rich Pin meta tags for videos and e-commerce products.
* Twitter [Player Card](https://dev.twitter.com/cards/types/player) markup for embedded videos from Slideshare, Vimeo, Wistia, and/or Youtube.
* Configurable user profile contact field names and labels for customized theme / SEO plugin integration.
* Include or exclude individual Google / SEO, Open Graph, Twitter Card, and Schema meta tags from webpage headers.
* File caching for social sharing button images and JavaScript, maximizing performance on VPS and dedicated hardware hosting platforms.
* A stylesheets editor for each social sharing button locations (content, excerpt, shortcode, widget, etc.).
* Dynamic button language switching based on the current WordPress locale.
* URL shortening with Bitly or Google for URLs in Tweet texts.
* Ability to include / exclude sharing buttons by post type.
* Selection of preset button options by location (content, excerpt, shortcode, widget, etc.).
* Integrates with **3rd party plugins and services** for additional image, video, product, and content information (see [About Pro Modules](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/modules/) and [Integration Notes](http://surniaulula.com/codex/plugins/nextgen-facebook/installation/integration/) for details). The following modules are included with the Pro version, and are automatically loaded if/when the supported plugins and/or services are detected.
	* **Supported 3rd Party Plugins**
		* All in One SEO Pack
		* bbPress
		* BuddyPress
		* Easy Digital Downloads
		* HeadSpace2 SEO
		* JetPack Photon
		* NextGEN Gallery
		* MarketPress - WordPress eCommerce
		* Polylang
		* <a href="https://wordpress.org/plugins/woocommerce/">WooCommerce v1 and v2</a>
		* WP e-Commerce
		* <a href="https://wordpress.org/plugins/rest-api/">WordPress REST API v2</a>
		* Yoast SEO (aka WordPress SEO)
		* Yotpo Social Reviews for WooCommerce
	* **Supported Service APIs**
		* Gravatar Images
		* Bitly Shortener
		* Google Shortener
		* Slideshare Presentations
		* Vimeo Videos
		* Wistia Videos
		* Youtube Videos and Playlists

<blockquote>
<p><a href="http://wpsso.com/extend/plugins/wpsso/">Purchase the Pro version</a> (includes a <em>No Risk 30 Day Refund Policy</em>).</p>
</blockquote>

<div style="clear:both;"></div>
<div style="width:40%;min-width:256px;max-width:1200px;height:auto;float:right;margin:10px 0 40px 60px;">
<p><img src="https://surniaulula.github.io/nextgen-facebook/images/settings/ngfb-social-sharing-buttons.png" width="100%" height="100%"/></p>
</div>

= Social Sharing Buttons =

NGFB comes with several sharing buttons, that you can optionally include on Post / Page editing pages, above / below your content or excerpt, [bbPress](https://wordpress.org/plugins/bbpress/) single pages, [BuddyPress](https://wordpress.org/plugins/buddypress/) activity entries, as a sidebar, widget, shortcode, or even call a function from your theme template(s). Each of the following sharing buttons can be enabled, configured, and styled individually:

* **Buffer**
* **Facebook** (Like, Send, and Share)
* **Google+**
* **LinkedIn**
* **ManageWP**
* **Pinterest**
* **Reddit**
* **StumbleUpon**
* **Tumblr** (Links, Quotes, Images, Videos)
* **Twitter**

The Facebook, Google+ and Twitter sharing buttons support *multiple languages*. A default language can be chosen in the NGFB settings, and the [Pro version](http://surniaulula.com/extend/plugins/nextgen-facebook/) switches the sharing button language with the webpage language / WordPress locale. NGFB can also include hashtags from WordPress and NextGEN Gallery tag names in the Open Graph (Facebook) and Pinterest Rich Pin descriptions, Tweet text, and other social captions.

<div style="clear:both;"></div>
<div style="width:40%;min-width:256px;max-width:1200px;height:auto;float:right;margin:10px 0 40px 60px;">
<p><img src="https://surniaulula.github.io/nextgen-facebook/images/social/google-social-profiles-search-results.png" width="100%" height="100%"/></p>
</div>

= Social Profiles for Google Search =

NGFB provides <a href="https://developers.google.com/structured-data/customize/social-profiles">author (Person) and publisher (Organization) social profiles</a>, <a href="https://developers.google.com/structured-data/customize/logos">publisher (Organization) logo</a>, and <a href="https://developers.google.com/structured-data/site-name">WebSite Site Name</a> in schema.org JSON-LD format for Google Search and their <em>Knowledge Graph</em>. The author (Person) markup includes the author's website URL, their profile social sharing image, and all listed contact URLs from their user profile. The publisher (Organization) markup includes the website URL, a corporate logo, a default image, and the publisher Facebook, Google+, LinkedIn, Pinterest, and Twitter business pages.

<div style="clear:both;"></div>

= User Profile Social Contacts =

NGFB allows you to customize (Pro version) the field names, label, and add / remove the following contacts from the user profile page:

* AIM
* Facebook URL
* Google+ URL
* Instagram URL
* Jabber / Google Talk
* LinkedIn URL
* MySpace URL
* Pinterest URL
* Skype Username
* Tumblr URL
* Twitter @username
* Yahoo IM
* YouTube Channel URL

= Complete Social Meta Tags =

NGFB adds [Open Graph](http://ogp.me/) (Facebook), [Pinterest Rich Pins](http://developers.pinterest.com/rich_pins/), [Twitter Cards](https://dev.twitter.com/docs/cards), and [Search Engine Optimization](http://en.wikipedia.org/wiki/Search_engine_optimization) meta tags to the head section of webpages. These meta tags are used by Google Search and all social websites to describe and display your content correctly (title, description, hashtags, images, videos, product, author profile / authorship, publisher, etc.). NGFB is a complete social sharing solution that uses the *existing* content of your webpages to build HTML meta tags &mdash; There's no need to manually enter / configure any additional values or settings (although many settings and options *are* available). <a href="http://surniaulula.com/extend/plugins/nextgen-facebook/screenshots/">See examples from Google Search, Google+, Facebook, Twitter, Pinterest, StumbleUpon, Tumblr, etc.</a> &mdash; along with screenshots of the NGFB settings pages.

NGFB provides the [Summary](https://dev.twitter.com/cards/types/summary), [Summary with Large Image](https://dev.twitter.com/cards/types/summary-large-image), and [Player](https://dev.twitter.com/cards/types/player) Twitter Cards &mdash; *including configurable image sizes for each card type*. The [Photo](https://dev.twitter.com/cards/types/photo), [Gallery](https://dev.twitter.com/cards/types/gallery), and [Product](https://dev.twitter.com/cards/types/product) Twitter Cards were deprecated by Twitter on July 3rd, 2015.

= 3rd Party Integration (Pro version) =

Aside from the additional support for Twitter Cards, the main difference between the NGFB Free and Pro versions is the integration of 3rd party plugins and services.

<div style="clear:both;"></div>
<div style="width:40%;min-width:256px;max-width:1200px;height:auto;float:right;margin:10px 0 40px 60px;">
<p><img src="https://surniaulula.github.io/nextgen-facebook/images/social/twitter-large-image-summary-single.png" width="100%" height="100%"/></p>
</div>

**Images and Videos**

NGFB detects and uses all images - associated or included in your content - including the WordPress image gallery and NextGEN Gallery shortcodes. WordPress Media Library images (and NextGEN Gallery in the Pro version) are resized according to their intended audience (Facebook, Twitter, Pinterest, etc). The Pro version also detects embedded videos from Slideshare, Vimeo, Wistia, and Youtube (including their preview images).

NGFB (Pro version) also includes support for [JetPack Photon](http://jetpack.me/support/photon/) and [NextGEN Gallery v1 and v2](https://wordpress.org/plugins/nextgen-gallery/) albums, galleries and images (shortcodes, image tags, album / gallery preview images, etc.).

**Enhanced SEO**

NGFB (Pro version) integrates with [Yoast SEO](https://wordpress.org/plugins/wordpress-seo/), [All in One SEO Pack](https://wordpress.org/plugins/all-in-one-seo-pack/), and [HeadSpace2 SEO](https://wordpress.org/plugins/headspace2/) &mdash; making sure your custom SEO settings are reflected in the Open Graph, Rich Pin, and Twitter Card meta tags.

<div style="clear:both;"></div>
<div style="width:40%;min-width:256px;max-width:1200px;height:auto;float:right;margin:10px 0 40px 60px;">
<p><img src="https://surniaulula.github.io/nextgen-facebook/images/social/twitter-product-ngfb-single.png" width="100%" height="100%"/></p>
</div>

**eCommerce Products**

NGFB (Pro version) also supports [Easy Digital Downloads](https://wordpress.org/plugins/easy-digital-downloads/), [MarketPress - WordPress eCommerce](https://wordpress.org/plugins/wordpress-ecommerce/), [WooCommerce v1 and v2](https://wordpress.org/plugins/woocommerce/), and [WP e-Commerce](https://wordpress.org/plugins/wp-e-commerce/) product pages, creating appropriate meta tags for [Facebook Products](https://developers.facebook.com/docs/payments/product/), [Twitter Product Cards](https://dev.twitter.com/docs/cards/types/product-card) and [Pinterest Rich Pins](http://developers.pinterest.com/rich_pins/), including variations and additional / custom images.

**Forums and Social**

NGFB (Pro version) supports [bbPress](https://wordpress.org/plugins/bbpress/) and [BuddyPress](https://wordpress.org/plugins/buddypress/) (see the [BuddyPress Integration Notes](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/buddypress-integration/)), making sure your meta tags reflect the page content, including appropriate titles, descriptions, images, etc. Social sharing buttons can also be added to [bbPress](https://wordpress.org/plugins/bbpress/) single template pages and [BuddyPress](https://wordpress.org/plugins/buddypress/) activities.

= Proven Performance =

NGFB is *fast and coded for performance*, making full use of all available caching techniques (persistent / non-persistent object and disk caching). NGFB loads only the library files and object classes it needs, keeping it small, fast, and yet still able to support a wide range of 3rd party integration features.

= Professional Support =

NGFB support and development is on-going. You can review the [FAQ](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/) and [Notes](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/) pages for additional setup information. If you have any suggestions or comments, post them to the [WordPress support forum](https://wordpress.org/support/plugin/nextgen-facebook) or the [Pro version support website](http://nextgen-facebook.support.surniaulula.com/).

Follow Surnia Ulula on [Google+](https://plus.google.com/+SurniaUlula/?rel=author), [Facebook](https://www.facebook.com/SurniaUlulaCom), [Twitter](https://twitter.com/surniaululacom), and [YouTube](http://www.youtube.com/user/SurniaUlulaCom).

== Installation ==

= Install and Uninstall =

* [Install the Plugin](http://surniaulula.com/codex/plugins/nextgen-facebook/installation-to/install-the-plugin/)
* [Integration Notes](http://surniaulula.com/codex/plugins/nextgen-facebook/installation/integration/)
	* [BuddyPress Integration](http://surniaulula.com/codex/plugins/nextgen-facebook/installation/integration/buddypress-integration/)
* [Uninstall the Plugin](http://surniaulula.com/codex/plugins/nextgen-facebook/installation/uninstall-the-plugin/)
* [Debugging and Problem Solving](http://surniaulula.com/codex/plugins/nextgen-facebook/installation/debugging-and-problem-solving/)
* [Developer Special – Buy one, Get one Free](http://surniaulula.com/codex/plugins/nextgen-facebook/installation/developer-special-buy-one-get-one-free/)

= Plugin Setup =

* [A Setup Guide for NGFB](http://surniaulula.com/codex/plugins/nextgen-facebook/installation/a-setup-guide/)

== Frequently Asked Questions ==

= Frequently Asked Questions =

* [Can I use the Pro version on multiple websites?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/can-i-use-the-pro-version-on-multiple-websites/)
* [Does LinkedIn read the Open Graph meta tags?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/does-linkedin-read-the-open-graph-meta-tags/)
* [Doesn’t an SEO plugin cover that?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/doesnt-an-seo-plugin-cover-that/)
* [How can I exclude / ignore certain parts of the content text?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-can-i-exclude-certain-parts-of-the-content-text/)
* [How can I fix a ERR_TOO_MANY_REDIRECTS error?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-can-i-fix-a-err_too_many_redirects-error/)
* [How can I fix an “HTTP error” when uploading images?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-can-i-fix-an-http-error-when-uploading-images/)
* [How can I have smaller dimensions for the default image?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-can-i-have-smaller-dimensions-for-the-default-image/)
* [How can I see what the Facebook crawler sees?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-can-i-see-what-the-facebook-crawler-sees/)
* [How can I share a single NextGEN Gallery image?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-can-i-share-a-single-nextgen-gallery-image/)
* [How do I attach an image without showing it on the webpage?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-do-i-attach-an-image-without-showing-it-on-the-webpage/)
* [How do I fix my theme’s front page pagination?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-do-i-fix-my-themes-front-page-pagination/)
* [How do I install the Pro version?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-do-i-install-the-pro-version/)
* [How does NGFB find / detect / select images?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/how-does-ngfb-find-detect-select-images/)
* [Social Sharing Buttons](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/social-sharing-buttons/)
	* [Can I share a single image on a webpage?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/social-sharing-buttons/can-i-share-a-single-image-on-a-webpage/)
	* [Can I use other social sharing buttons?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/social-sharing-buttons/can-i-use-other-social-sharing-buttons/)
	* [How do I turn on Social Sharing Buttons for a page?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/social-sharing-buttons/how-do-i-turn-on-social-sharing-buttons-for-a-page/)
	* [Why are the buttons showing the wrong language?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/social-sharing-buttons/why-are-the-buttons-showing-the-wrong-language/)
	* [Why does the Facebook “Like” button flyout get clipped?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/social-sharing-buttons/why-does-the-facebook-like-button-flyout-get-clipped/)
	* [Why doesn’t the Pinterest button show?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/social-sharing-buttons/why-doesnt-the-pinterest-button-show/)
	* [Why doesn’t the Twitter count increase?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/social-sharing-buttons/why-doesnt-the-twitter-count-increase/)
* [W3C says “there is no attribute ‘property’”](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/w3c-says-there-is-no-attribute-property/)
* [What about Google Search and Google Plus?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/what-about-google-search-and-google-plus/)
* [What features of NextGEN Gallery are supported?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/what-features-of-nextgen-gallery-are-supported/)
* [What is the difference between NGFB and WPSSO?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/what-is-the-difference-between-ngfb-and-wpsso/)
* [What is the difference between the Free and Pro versions?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/what-is-the-difference-between-the-free-and-pro-versions/)
* [Why aren’t Pins from my website posting Rich?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/why-arent-pins-from-my-website-posting-rich/)
* [Why do my Facebook shares have small images?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/why-do-my-facebook-shares-have-small-images/)
* [Why does Facebook play videos instead of linking them?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/why-does-facebook-play-videos-instead-of-linking-them/)
* [Why does Facebook show the wrong image / text?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/why-does-facebook-show-the-wrong-image-text/)
* [Why does Google Structured Data Testing Tool show errors?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/why-does-google-structured-data-testing-tool-show-errors/)
* [Why does the plugin ignore some &lt;img/&gt; HTML tags?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/why-does-the-plugin-ignore-some-img-html-tags/)
* [Why don’t my Twitter Cards show on Twitter?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/why-dont-my-twitter-cards-show-on-twitter/)
* [Why is the Open Graph title the same for every webpage?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/why-is-the-open-graph-title-the-same-for-every-webpage/)
* [Why is the page blank or its components misaligned?](http://surniaulula.com/codex/plugins/nextgen-facebook/faq/why-is-the-page-blank-or-its-components-misaligned/)

== Other Notes ==

= Additional Documentation =

* [About Pro Modules](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/modules/)
	* [Author Gravatar](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/modules/author-gravatar/)
	* [Easy Digital Downloads](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/modules/easy-digital-downloads/)
	* [HeadSpace2 SEO](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/modules/headspace2-seo/)
	* [Jetpack Photon](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/modules/jetpack-photon/)
	* [Slideshare, Vimeo, Wistia, Youtube APIs](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/modules/videos-apis/)
	* [WooCommerce](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/modules/woocommerce/)
	* [WordPress REST API v2](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/modules/wordpress-rest-api-v2/)
* [Contact Information and Feeds](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/contact-information/)
* [Developer Resources](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/)
	* [Constants](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/constants/)
		* [Disable the Open Graph Meta Tags](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/constants/disable-the-open-graph-meta-tags/)
	* [Filters](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/)
		* [Examples](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/examples/)
			* [Detect YouTube URL Links as Videos](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/examples/detect-youtube-url-links-as-videos/)
			* [Modify Shortcode Attributes (URL)](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/examples/modify-shortcode-attributes-url/)
			* [Modify the article:tag Keywords / Names](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/examples/modify-the-articletag-keywords-names/)
			* [Modify the Default Topics List](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/examples/modify-the-default-topics-list/)
			* [Modify the Home Page Title for Facebook / Open Graph](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/examples/modify-the-home-page-title-for-facebook-open-graph/)
		* [Filters by Category](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/by-category/)
			* [Head Filters](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/by-category/head/)
			* [Media Filters](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/by-category/media/)
			* [Open Graph Filters](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/by-category/open-graph/)
			* [Twitter Card Filters](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/by-category/twitter-card/)
			* [Webpage Filters](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/by-category/webpage/)
		* [Filters by Name](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/by-name/)
		* [Other Filters](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/filters/other/)
	* [Sharing Buttons Function](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/developer/sharing-buttons-function/)
* [Inline Variables](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/inline-variables/)
* [Multisite / Network Support](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/multisite-network-support/)
* [NGFB Shortcode for Sharing Buttons](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/ngfb-shortcode/)
* [Performance Tuning](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/performance-tuning/)
* [Styling Social Buttons](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/styling-social-buttons/)
* [Working with Image Attachments](http://surniaulula.com/codex/plugins/nextgen-facebook/notes/working-with-image-attachments/)

== Screenshots ==

01. NGFB General Settings Page &mdash; Includes options for Open Graph (All Publishers) site information, titles, descriptions, images, videos, and authors. There is also a Publisher Specific section for Facebook, Google (G+ and Search), LinkedIn, Pinterest Rich Pins, and Twitter Cards.
02. NGFB Advanced Settings Page &mdash; Allows you to fine-tune some advanced plugin settings, the use of various content filters, custom post meta fields, caching techniques, user profile contacts, and enable / disable a long list of meta tags.
03. NGFB Social Settings on Posts and Pages &mdash; The Social Settings metabox allows you to modify the default title, description, and image values, preview an example social share, preview all meta tags, and validate the current webpage with various online tools.
04. NGFB "Social Image" and "Social Description" preview columns (available on posts, pages, tags, and custom taxonomy editing pages).
05. Example Pinterest Product Pin (Zoomed).
06. Example Facebook Link Share.
07. Example Facebook Video Share.
08. Example Twitter 'Summary' Card.
09. Example Twitter 'Large Image Summary' Card.
10. Example Twitter 'Photo' Card (The [Photo](https://dev.twitter.com/cards/types/photo) Card was deprecated by Twitter on July 3rd, 2015).
11. Example Twitter 'Gallery' Card (The [Gallery](https://dev.twitter.com/cards/types/gallery) Card was deprecated by Twitter on July 3rd, 2015).
12. Example Twitter 'Product' Card (The [Product](https://dev.twitter.com/cards/types/product) Card was deprecated by Twitter on July 3rd, 2015).
13. Example Twitter 'Player' Card.
14. Example Social Profiles in Google Search &mdash; NGFB includes author (Person) and publisher (Organization) social profiles in schema.org JSON-LD format for Google Search and their Knowledge Graph.
15. Example Showing All Social Sharing Buttons Enabled.

== Changelog ==

<blockquote id="changelog_top_info">
<p>New versions of the plugin are released approximately every week (more or less). 
New features are added, tested, and released incrementally, instead of grouping them together in a major version release. 
When minor bugs fixes and/or code improvements are applied, new versions are also released.
This release schedule keeps the code stable and reliable, at the cost of more frequent updates.</p>
</blockquote>

= Free / Basic Version Repository =

* [GitHub](https://github.com/SurniaUlula/nextgen-facebook)
* [WordPress.org](https://wordpress.org/plugins/nextgen-facebook/developers/)

= Version 8.20.1.2 (2015/12/29) =

Official announcement: N/A

* **New Features**
	* *None*
* **Improvements**
	* *None*
* **Bugfixes**
	* Fixed an Open Graph image size definition issue on the front-end.
* **Developer Notes**
	* *None*

= Version 8.20.1.1 (2015/12/27) =

Official announcement: N/A

* **New Features**
	* Added a "Copy to clipboard" icon for the sharing and short URLs under the Social Preview tab in the Social Settings metabox.
* **Improvements**
	* Added an information notice when checking the post/page for duplicate meta tags.
* **Bugfixes**
	* Fixed the `get_admin_url()` method, which returned empty URLs, when only hash / query fragments were passed as arguments.
* **Developer Notes**
	* Renamed and updated the share/lib/cacert.pem file to share/lib/ca-bundle.crt.
	* Moved `NgfbSharing::$cf['opt']['preset']` to `NgfbConfig::$cf['opt']['preset']`.
	* Moved `NgfbSharing::$cf['sharing']` to `NgfbConfig::$cf['sharing']`.

= Version 8.20.0 (2015/12/24) =

Official announcement: N/A

* **New Features**
	* Added a new "Your Social Settings" menu page with the user profile Social Settings metabox (and removed it from the "Your Profile" page).
* **Improvements**
	* Cleaned-up the side metaboxes on settings pages by selectively adding them certain pages and simplifying their content.
	* Added disabled and internal meta tags to the "Head Tags" list in the Social Settings metabox (shown as gray on gray).
* **Bugfixes**
	* Fixed the Tweet button text with additional encoding for emoji characters.
	* Fixed the 'article:published_time' and 'article:modified_time' values on post editing pages.
* **Developer Notes**
	* Added a call to `wp_encode_emoji()` for all encoded string values.
	* Added a new `$this->menu_lib` property to all setting pages (value passed to constructor).
	* Renamed the `NGFB_ADD_SETTINGS_PRIORITY` constant to `NGFB_ADD_SUBMENU_PRIORITY`.
	* Renamed the website class `$id` and `$name` properties to `$website_id` and `$website_name`.
	* Moved image size definitions from the 'admin_init' hook to 'current_screen'.
	* Moved `load_meta_page()` methods from the 'admin_head' hook to 'current_screen'.
	* Refactored the `add_plugin_image_sizes()` method to handle a variety of WP object classes.

= Version 8.19.2 (2015/12/16) =

Official announcement: N/A

* **New Features**
	* *None*
* **Improvements**
	* Updated the Setup Guide.
	* Added a new "Essential Settings" page to combine all essential / basic General and Advanced options on one page.
	* Added encoding of special / foreign characters in URL meta tag values.
* **Bugfixes**
	* *None*
* **Developer Notes**
	* *None*

= Version 8.19.1 (2015/12/14) =

Official announcement: N/A

* **New Features**
	* *None*
* **Improvements**
	* *None*
* **Bugfixes**
	* Fixed an incorrect CSS class name for the shortcode buttons.
* **Developer Notes**
	* *None*

= Version 8.19.0 (2015/12/13) =

Official announcement: N/A

* **New Features**
	* Added a new "Author Name Format" option under the Google / Schema tab on the General settings page.
	* Added a schema ImageObject with URL, width, and height information for JSON and noscript meta tags.
* **Improvements**
	* *None*
* **Bugfixes**
	* *None*
* **Developer Notes**
	* Added new filter hooks for the LD+JSON schema scripts:
		* 'ngfb_json_http_schema_org_organization'
		* 'ngfb_json_http_schema_org_person'
		* 'ngfb_json_http_schema_org_website'
		* 'ngfb_json_http_schema_org_{item_type}'
	* Renamed the NgfbUser `get_article_author()` method to `get_author_profile_url()`.
	* Refactored the NgfbSchema class and JSON related sections of the NgfbUser class.
	* Added a call to `getimagesize()` when saving options to retrieve image dimensions from URLs (default image URL, schema logo URL, etc.).

= Version 8.18.1 (2015/12/11) =

Official announcement: N/A

* **New Features**
	* *None*
* **Improvements**
	* Enabled all fields in the Social Settings metabox when editing a non-auto-draft Post / Page (previously, some fields were only enabled for published Posts / Pages).
* **Bugfixes**
	* *None*
* **Developer Notes**
	* *None*

= Version 8.18.0 (2015/12/09) =

Official announcement: N/A

* **New Features**
	* Added a new "Schema Item Type by Post Type" option to select the Schema item type for each post type.
* **Improvements**
	* Checks for head HTML elements without attribute filters - along with its template update process - are now done on all header templates, not just the header.php file.
* **Bugfixes**
	* *None*
* **Developer Notes**
	* Added a new `Sucom::sanitize_key()` method (returns a lower case string with alpha-numeric, hypens, and underscores).
	* Refactored the post, user, and taxonomy meta code to support action hooks for URL query arguments, and improve loading / parsing of head meta tags.
	* Renamed the NgfbOptions method `push_add_to_options()` to `add_ptns_to_opts()` and changed its arguments (breaking change - not backwards compatible).
	* Changed the NgfbUtil `get_post_types()` arguments as well (breaking change - not backwards compatible).
	* Renamed several NgfbAmin methods:
		* `load_form_page()` to `load_setting_page()`.
		* `show_form_page()` to `show_setting_page()`
		* `head_attr_filter_check()` to `check_tmpl_head_elements()`
		* `head_attr_filter_update()` to `modify_tmpl_head_elements()`

= Version 8.17.0 (2015/12/06) =

Official announcement: http://surniaulula.com/2015/12/06/ngfb-wpsso-update-improvements-video-autoplay/

* **New Features**
	* Added a new "Force Autoplay when Possible" option on the General settings page to force autoplay of Vimeo and Wistia videos when possible (Pro version).
	* Added a new "Show Tabs in Social Settings Metabox" option on the Advanced settings page to include/exclude the Social Preview, Head Tags, and Validate tabs (Pro version).
* **Improvements**
	* Refactored the All in One SEO Pack integration module to improved post object detection (Pro version).
	* Refactored the video integration modules to improve code quality (Pro version).
	* Moved several Advanced options under the "WP / Theme Integration" tab.
	* Improved the Head Tags listing in the Social Settings metabox to include JSON and additional Schema markup HTML blocks.
* **Bugfixes**
	* Added a check for HTTPS when defining the social buttons transient cache object, allowing for differences in sharing URLs when using HTTP and HTTPS.
* **Developer Notes**
	* Added `sanitize_classname()` and `sanitize_hookname()` static methods in the SucomUtil class.
	* Added a check for the required mbstring PHP extension.

= Version 8.16.0 (2015/11/27) =

Official announcement: http://surniaulula.com/2015/11/28/ngfb-wpsso-update-new-head_attributes-filter/

* **New Features**
	* *None*
* **Improvements**
	* The default "&lt;head&gt; Attributes Filter Hook" option value has been changed from "language_attributes" to "head_attributes".
	* Added a check on theme activation / update for a standard &lt;head&gt; element (without an attribute filter) in the header.php theme template. If found, a warning will be displayed with a feature to modify the &lt;head&gt; element in order to include the new "head_attributes" filter.
* **Bugfixes**
	* *None*
* **Developer Notes**
	* *None*

== Upgrade Notice ==

= 8.20.1.2 =

2015/12/29 - Important update: Fixed an Open Graph image size definition issue on the front-end.

= 8.20.1.1 =

2015/12/27 - Added a "Copy to clipboard" icon for sharing and short URLs under the Social Preview tab, added an information notice when checking for duplicate meta tags. Fixed action button URLs on NGFB settings pages.

= 8.20.0 =

2015/12/24 - Added a new "Your Social Settings" menu page, fixed 'article:published_time' and 'article:modified_time' values on post editing pages, added a call to wp_encode_emoji() for all encoded strings.

