Welcome Guest! Login? Checkout

Here is the documentation for the Inline Tweet Sharer plugin.

Document Index

  1. Installation
  2. Options
  3. Shortcode
  4. CSS Modification
  5. bit.ly integration
  6. Further Support
  7. Bug Fixes

1. Installation

  1. 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.
  2. 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.
  • 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.

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).

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

From version 1.3 onwards you can integrate Inline Tweet Sharer with bit.ly, so you can track traffic from your Inline Tweet Sharer links. To set this up, please do the following.

  1. Go to the OAuth App Creation Page on bit.ly at https://bitly.com/a/oauth_apps
  2. Click the “Get Registration Code” button to get a registration code emailed To You.
  3. Go to your email and click the link on the email sent to you.
  4. You will be sent to the bitly.com create application page. On this page, add the following:-
    • For Application Name, put your site name.
    • For Application Link, put your site URL.
    • For Redirect URIs, put your site URL.
    • Put anything you wish for the “Brief description of your application”.
  5. When created, on the Generate Access Token, confirm your password and click “Generate Token”.
  6. Return to the Settings > Inline Tweet Sharer Page and paste in the access token generated into the box entitled “Your Generic Access Token”. Now whenever you tick the box “Enable bit.ly integration”, the links created will be tracked by bit.ly.

6. Further Support

Support can be provided in one of two ways:-

7. Bug Fixes

If you have found any bug fixes, please let us know in the Github Repository, or by Contacting Us.