=== Plugin Name ===
Contributors: Twitter, niallkennedy
Tags: twitter, embedded tweet, twitter moment, twitter video, twitter cards, tweet button, follow button, twitter analytics, twitter ads
Requires at least: 3.9
Tested up to: 4.3.1
Stable tag: 1.2.0
License: MIT
License URI: http://opensource.org/licenses/MIT

Official Twitter plugin for WordPress. Embed Twitter content and grow your audience on Twitter. Requires PHP 5.4 or greater.

== Description ==

The Twitter plugin for WordPress optimizes your website for a Twitter audience through easy to use sharing buttons, embedded Tweets, auto-generated markup indexed by Twitter, and Follow buttons to help grow your Twitter audience. All features are deeply integrated with WordPress APIs to make building your webpages and administrative features as easy as possible with the extensibility you expect from WordPress.

Requires PHP version 5.4 or greater.

* [Embedded Moment](https://dev.twitter.com/web/embedded-moments) - showcase multiple Tweets in a media rich grid layout
* [Embedded Tweet](https://dev.twitter.com/web/embedded-tweets) - customize backgrounds and color schemes to match your site's theme
* [Embedded Twitter video](https://dev.twitter.com/web/embedded-video) - showcase video uploaded to Twitter
* [Tweet button](https://dev.twitter.com/web/tweet-button) - simple sharing of your site's content on Twitter
* [Twitter Cards](https://dev.twitter.com/cards/overview) - highlight your site's content when shared on Twitter
* [Twitter Analytics](https://analytics.twitter.com/) - track impressions and top distributors of your site's content on Twitter
* [Follow button](https://dev.twitter.com/web/follow-button) - grow your Twitter audience
* [Twitter ads conversion tracking](https://support.twitter.com/articles/20170807-conversion-tracking-for-websites) - easily track actions on your WordPress site triggered by a Twitter ad or build a custom targeting audience

Contribute to the plugin, submit pull requests, or run test suites through the [Twitter plugin for WordPress GitHub repository](https://github.com/twitter/wordpress). View [Twitter for WordPress documentation](https://dev.twitter.com/web/wordpress) to learn more about customization through filters.

== Upgrade Notice ==

= 1.2.0 =
Support Twitter Moment embeds.

= 1.1.0 =
Shortcode improvements for ajax-loaded posts. Remove photo, gallery, and product Twitter Cards no longer supported by Twitter.

= 1.0.1 =
Display admin notice if current PHP version does not meet minimum requirements. Do not display Tweet button in auto-generated excerpt.

== Changelog ==

= 1.2.0 =
* Embed a Twitter Moment by simply pasting a URL
* Always load Twitter ads conversion tracking JavaScript over HTTPS

= 1.1.0 =
* Shortcodes now include inline asynchronous JavaScript loaders for improved compatibility with ajax-loaded content
* Twitter announced photo, gallery, and product Twitter Cards are [no longer supported](https://twittercommunity.com/t/deprecating-the-photo-gallery-and-product-cards/38961 "Twitter announcement: deprecation of photo, gallery, product cards"). Removed from plugin
* Add [Shortcake plugin](https://wordpress.org/plugins/shortcode-ui/ "Shortcake WordPress plugin") compatibility for form-based shortcode construction and previews
* Improved Twitter Card image compatibility

= 1.0.1 =
* Display admin notice if plugin is installed on a site not meeting minimum PHP requirement
* Disable Tweet button the_content wrapper when called during excerpt generation
* Tweet button: add support for via shortcode attribute
* Fix: save Follow button widget with no overrides

= 1.0.0 =
* Embedded Tweets
* Embedded video
* Tweet button
* Twitter Cards
* Follow button
* Advertising tracker

== Frequently Asked Questions ==

= How can I change an embedded Tweet's background and link colors to match my site's theme? =

The Twitter plugin for WordPress includes a settings page with options to customize the background color, link color, and border color used in Twitter embedded Tweets and embedded timelines.

= How do I include an embedded timeline in my page? =

Log in to Twitter.com and visit the [Twitter widgets settings page](https://twitter.com/settings/widgets) to create and manage [embedded timeline](https://dev.twitter.com/web/embedded-timelines) widgets for your account. Widget settings are saved to a widget identifier for the logged in account; you may want to create a widget from your site's account, not your personal account, for continuity and general organization.

Copy-and-paste the HTML generated by the Twitter widgets configuration tool into a new [WordPress text widget](http://codex.wordpress.org/WordPress_Widgets#Using_Text_Widgets).

= My custom link color and border color do not appear in embedded Tweets or timelines =

Your site may have a [Content Security Policy](https://developer.mozilla.org/docs/Web/Security/CSP/Introducing_Content_Security_Policy) blocking Twitter's JavaScript from inserting your custom styling into the widget.

You may have configured an embedded timeline widget with a non-default link color. Your widget configuration overrides your page / theme configuration.

= Does the Twitter plugin add additional tracking of my site's visitors? =

The Twitter plugin for WordPress makes it easier to explicitly include Twitter features and functionality on your WordPress site. No additional tracking is added as a result of our plugin code's execution on your server(s).

Twitter widgets and buttons load Twitter's widgets.js library through the WordPress JavaScript queue. Read more about [how Twitter for Websites widgets respect user privacy](https://dev.twitter.com/web/overview/privacy).

Twitter advertising trackers are only included on the page when invoked by the site using the `twitter_tracking` shortcode. Read more about [Twitter's policies for conversion tracking and tailored audiences products](https://support.twitter.com/articles/20171365-policies-for-conversion-tracking-and-tailored-audiences).

== Screenshots ==

1. Settings screen. Customize Tweet and Timeline color schemes including background, text colors, and borders. Attribute site content to a Twitter account. Automatically include Tweet buttons alongside your post content.
2. Post editor meta box. Define custom Tweet text, hashtags, and Twitter Card data.
3. Twitter widgets and buttons in action.

== Installation ==

1. Add the Twitter plugin to your WordPress installation
1. Activate the plugin through the 'Plugins' menu in WordPress