Inline Tweet Sharer - Documentation

Here is the documentation for the Inline Tweet Sharer plugin.

Document Index

Installation
Options
Shortcode
CSS Modification
bit.ly integration
Further Support
Bug Fixes

1. Installation

Download the plugin here and upload inline-tweet-sharer folder to the /wp-content/plugins/ directory, or search for it in the Plugins > Add New repository.
Activate the plugin through the ‘Plugins’ menu in WordPress

2. Options

Before using the plugin for the first time, it’s recommended you head to the Inline Tweet Sharer Settings page, and set it up to your needs.

Screen Shot 2015-02-24 at 17.26.44

Here’s the options on this page, and what each option does:-

Default Twitter Handle – This allows you to set a default twitter handle to be included within the links. This handle will be included with a RT @______ at the beginning of your tweeted links. Can be overwritten by shortcode attributes, and removed entirely if a prefix is defined.
Mark Twitter Links – If ticked, the twitter links are styled differently to normal links, if not then no style is applied.
Use Dashicons – The default link uses an image for the twitter icon. If you are on WordPress 3.8 and above, Dashicons are included within the WordPress source. By ticking this box, you can use the Twitter Dashicon, rather than the standard image, appearing crisper and more scalable.
Disable Stylesheets (v2.4 onwards) – If ticked the stylesheets will not load.
Capitalise first letter of Tweet – If clicked, the first letter of the tweet will be capitalised. Useful if a lot of the tweets you could share are in the middle of sentences.
Added class for the Wrapper Div (advanced) – This adds the ability to add a class to the div that wraps around the tweetable link. This can give you more control if you wish.

Premium Options – Google Analytics

The next section is only available in the Premium version.

You can assign Google Analytics variables in the premium version, and by default it uses the values below. You can read more about Google Analytics’s Custom Campaigns on Google Analytics’ site.

Default Campaign Name – The Default Google Analytics Campaign that can be associated with all tweeted links.
Default Campaign Source – The Default Google Analytics Source that can be associated with all tweeted links.
Default Campaign Medium – The Default Google Analytics Medium that can be associated with all tweeted links.
Default Campaign Term – The Default Google Analytics Term that can be associated with all tweeted links.
Default Campaign Content – The Default Google Analytics Content that can be associated with all tweeted links.

Twitter Related Options

You can encourage users to follow related accounts in the premium version as well. This occurs after people tweet and can be encouraged to follow any account you wish.

Twitter Handle to Follow – The twitter handle (no Twitter URL or @ sign) of the user you want people to follow by default.
Description – This is a description to use to introduce your twitter follower. Use this to encourage those who already share your content to follow you.

3. Shortcode

Within any post/page you can make any text suitable for Inline Tweet Sharer by wrapping any text with [inlinetweet]][[/inlinetweet]. There are also a number of attributes:-

Prefix – Adds text before the highlighted text. If not present, the default is used (if set).
Tweeter – Adds a user before the highlighted text in the form of RT @______:, ignored if prefix is set. If not present, the default is used (if set).
Suffix – Adds a user after the highlighted text. If not present, the default is used (if set).
utmcampaign – Adds a UTM Campaign variable to the link (Premium Only)
utmsource – Adds a UTM Source variable to the link (Premium Only)
utmmedium– Adds a UTM Medium variable to the link (Premium Only)
utmterm – Adds a UTM Term variable to the link (Premium Only)
utmcontent – Adds a UTM Content variable to the link (Premium Only)
related – Include a twitter account handle here to encourage sharers to follow your account.
relateddesc – Include a description above the related twitter account, to encourage people to follow that account.
customurl – Replace the URL of the page you’re on with another url.

So for example, to create this Inline Tweet – read the Inline Tweet Sharer documentation , add this to your post:-

[inlinetweet prefix="click here to" tweeter="" suffix=" on @winwaruk"]]read the Inline Tweet Sharer documentation[[/inlinetweet]

Finally, if you’re using the visual editor, you can click on the Twitter button.

Tweetable Links for Inline Tweet Sharer

4. CSS Modification

The CSS classes for the plugin are the following:-

a.inline-twitter-link – style for the entire link.
a.inline-twitter-link span – style for the twitter logo at the end of the link.
a:hover.inline-twitter-link – style for the entire link with when hovered over it.
a:hover.inline-twitter-link span – style for the twitter logo at the end of the link when hovered.

5. bitly Integration

In version 2.5 you can integrate Inline Tweet Sharer with bit.ly, so you can track traffic from your Inline Tweet Sharer links. This feature was in 1.3 to 2.3 but removed when bitly v3 was discontinued.

To set this up, please do the following.

Go to https://bitly.com/
Click the hamburger menu in the top right hand corner to access your profile.
Click on your username/email that when the menu pops out.
Click on “Set Default API Group”
Click on “Generic Access Token”.
Re-enter your password and then click “Generate Token”.
Return to the Settings > Inline Tweet Sharer Page and paste in the access token generated into the box entitled “Your Generic Access Token”. And add your Bitly username in the box entitled “Your Bitly Username”.

Now whenever you tick the box “Enable bit.ly integration”, the links created will be tracked by bit.ly.

bitly-integration