Tweet Wheel

1.Getting Started #

1.1.Requirements #

Tweet Wheel and Tweet Wheel Pro use modern coding standards therefore your website has to meet a few strict requirements before it can work with the plugin.

It’s best to contact your hosting company and/or developer to make sure everything is right.

Plugin requirements:

  • WordPress 4.4 or greater
  • PHP version 5.4 or greater
  • MySQL version 5.0 or greater
  • WP Cron enabled in your WordPress installation

1.2.Installation #

Tweet Wheel can be installed just like any other plugin via your WordPress administrator panel.

Download the plugin

Whether you are just trying out the free version or have purchased the pro, download the plugin ZIP file from a relevant source.

Install the plugin

Once you have the packaged plugin on your computer, log in to your WordPress administrator panel – usually http://yourdomain.com/wp-admin/

Go to Plugins > Add New

Screen Shot 2015-11-30 at 15.48.10

Then to Upload Plugin (at the top)

Screen Shot 2015-11-30 at 15.49.39

Then drag & drop the downloaded zip package into the upload form in the middle of your screen

Screen Shot 2015-11-30 at 15.51.47

Click “Install Now”

If you face any errors at this stage, make sure you meet the requirements.

Activate the plugin

When you successfully install the plugin, confirm it by clicking “Activate Plugin” link under the installation progress when it’s done.

Voilla!

1.3.Authorise with Twitter #

To let any Twitter third-party application tweet on your behalf, you need to create an application which purpose can be compared to a gatekeeper that lives by a rule to only allow authorised guests into the party.

It’s easy and these few steps below will take you right through the process. Let’s do it.

Heads up: Please make sure you have entered a mobile phone number in your Twitter account settings. It is necessary to create an application.

Log in to Twitter

Go to http://apps.twitter.com and log in with the account that you would like to send tweets to. Click “sign in” to start.

4481129499

Enter your account log in details and submit. You will be presented with the dashboard where all your applications are. See an empty space? Let’s fill it in!

Create an app

Click Create A New App button in the top right corner and fill the form that you will be presented with. On the screen shot below I pre-filled it with example values.

VERY IMPORTANT: MAKE SURE YOU ENTER ANY VALUE INTO THE “CALLBACK URL” FIELD! OTHERWISE YOUR APP WON’T BE GRANTED WRITE PERMISSIONS AND THE PLUGIN WON’T WORK! DON’T LEAVE THIS FIELD BLANK.

Scroll down, accept terms and conditions and submit.

Ensure permissions

If successful, you will be redirected to your first (or not) application with Twitter! Now we are ready to get off there values we need. Note: please double check that your application has “Read and Write Access”. If not, you must have left the callback URL field blank! In this case, re-create an app or modify the permissions.

Get required tokens

At the top switch a tab to Keys and Access Tokens. Scroll to the bottom and click “Generate Access Tokens”. When the page reloads, grab required values. I highlighted them for you below.

Authorise the plugin

Paste those values into their relating fields on the plugin’s authorisation page. Click authorise.

If the page reloads and the Queue screen shows up it means you have successfully authorised the plugin!

If any troubles, please do let us know and we will happily assist you with it.

1.4.Going through settings #

Tweet Wheel comes pre-configured however you might want to familiarise yourself with settings available at your disposal.

Visit Queues > Settings and let’s run through them all quickly.

Allowed post types

The plugin is made to work with all post types that are using the title and the slug fields. However only “posts” are enabled by default. Feel free to check those post types that you would like the plugin to have an access to.

Default tweet template

A value inserted in this field will be used as a backup for all posts that don’t have custom tweet templates created. Make sure it’s short and concise as not to exceed 140 characters.

User roles

By default plugin can only be accessed by administrators. However, if you would like to have other roles managing Tweet Wheel simply choose their roles, too. Please note you cannot unselect the Administrator from the list.

Keep plugin data

If you wish to keep plugin’s settings after uninstallation, leave this checkbox ticked. It’s useful when you have to reinstall it for some reason.

1.5.Create your first queue #

Tweet Wheel operates on queues, which contain all posts scheduled for tweeting. Each queue has it’s own independent settings. Pro users can create as many of them as they wish. Free users are limited to one queue and it’s created for them automatically. Therefore this article is aimed at paid users of the plugin.

When you install the plugin and successfully authorise it with your Twitter application head off to Queues page in your administrator menu. If it’s your first time with the plugin you will be presented with a single-field form to enter your brand new queue’s name! How exciting!

Screen Shot 2015-12-03 at 22.03.49

Enter a meaningful name for your queue. While there is no character limit, we suggest to keep it concise like “Daily News”, “Best Rated” or “Popular”…

Initially each new queue is put on hold until you are ready with all it’s settings. Therefore feel no pressure and take your time to set it up from back to back!

Screen Shot 2015-12-03 at 22.09.55

2.Queue Management #

2.1.Manage queued posts #

Managing posts within a queue hasn’t changed much since the overhaul. We have added a few UI improvements, but the overall approach and feel stay the same.

If you are new to the plugin, please read on. If you are a Tweet Wheel Pro veteran, feel free to jump down to the “Improvements” section.

We will assume you have just created a new queue that is empty. If you are a few steps ahead, find a relevant section below and join us.

Adding Content to a Queue

In latest major update we introduced more controlled way of adding posts. Various options are available from around your WordPress admin panel, so you can queue the content up conveniently from every corner. Below we walk you through all options.

Before going further with the tutorial, please make sure you allow for desired post types to be used by the plugin and that you have created a queue.

Queuing up from the all posts listing page

Navigate to “All Posts”, “All Pages” or any other main post type page where all entries are listed like so

Screen Shot 2015-12-23 at 14.52.48

From here we have a few methods to add content to any of your queues.

Multiple / bulk selection

To queue up many posts to all available queues you can simply check all boxes next to relevant items and choose the “Append to All Queues” action from the drop down. See screenshot below.

Screen Shot 2015-12-23 at 14.56.48

Individual selection

If you want to individually pick entries, hover over with your mouse the desired post and select “Manage Queues” link that will be revealed. You will be then presented with a pop-up with all your queues. Single click all of those that you want the post in.

Screen Shot 2015-12-23 at 14.59.59

Green colour means enqueued (or “already is in the queue”).

Enqueuing from the edit post page

Go ahead and edit one of your posts. In the main, wider column, you will find a box called “Tweet Settings” and “Queue Assignment” section within it (first at the top).

Screen Shot 2015-12-23 at 15.05.46

The same rule apply as in the “Manage Queues” case described in the section above. Simply click on the queue that you want the post to be in.

Enqueuing from the queue

Upon creating a queue or while managing an existing one, you will notice little “+” signs that reveal filling up form. They are available in between queued posts, so a new content can be “injected” at any place.

You can use the Search tab to insert a phrase to find posts and enter them one by one. Please note the search will only look for content within allowed post types.

Screen Shot 2015-12-23 at 15.14.33

You can also go full on and take advantage of the Bulk tab helping you to enqueue more posts at once using useful criteria.

Screen Shot 2015-12-23 at 15.15.50

Re-ordering posts

We fully understand you might not want posts to go out on your Twitter profile in the order that they are enqueued. Thus we developed a way to re-order them with a convenient drag & drop action. Additionally, we made it autosave itself, so the moment you shuffle an item it’s saved and ready to go.

To move things around search for the handle available to the left of every queued post, which looks like this 

This action is disabled on mobile screens for now.

2.2.Manage queue's settings #

Each queue allows independent settings, which are explained below.

Queue’s Name

Screen Shot 2015-12-23 at 14.29.23

Should you ever change your mind about queue’s name, you can easily rename it without deleting it and losing all queued posts. Just enter a new value and hit Save at the top.

Queue Status

Screen Shot 2015-12-23 at 14.29.34

Queue status controls it’s behaviour. It’s a convenient little option that helps you pause the queue at any time for as long as you want. Please find explanations of them all below.

Running – the queue is active and will be sending tweets as per schedule.

Paused – the queue remains inactive and won’t send any tweets even if schedule tells it to.

Frozen – the queue is disabled and will be hidden from other areas of your dashboard.

Looping

Screen Shot 2015-12-23 at 14.29.48

Posts that have been published can moved down to the bottom of the queue and wait for their next turn. We call it looping. It makes sure that a queue will never run out of posts to tweet about. However, if you don’t need looping you can always disable it by selecting “Remove from the queue” option.

Tweeting Order

Screen Shot 2015-12-23 at 14.29.58

Many users requested this feature, so we decided to add it in. You can now let the plugin pick up one of queued posts for tweeting. Please be aware that if an option to loop (or re-queue) post is selected, it will be ignored and posts will remain at their current position within the queue’s posts hierarchy.

E-mail Notifications

Screen Shot 2015-12-23 at 14.30.08

We often found ourselves in the situation where we were manually making sure the queue was performing just fine for peace of mind. It were taking up our precious time, so we decided to create a simple e-mail notification system that will let us know if anything goes wrong.

2.3.Set up a schedule #

The new version brings overhauled scheduling system, which allows for more customisations and precision.

So far, you have been used to a simple weekly schedule, where you could choose on which days and at what times the plugin should publish your content. However there was no timing settings for specific days – they all followed the same timetable.

It’s changed for better. Tweet Wheel now provides with advanced weekly and date-specific schedules.

Advanced Weekly Schedule

First type, and the most demanded, is the weekly schedule that has been moved over from the older version, but expanded.

schedule-weekly (2)_CLIPCHAMP_360p

Each day of the week now has an independent timetable that you can adjust to your needs.

Additionally, if you want the queue to run within a certain date range, feel free to use the Activity Date Span section to restrict tweeting time by dates.

Date-specific Schedule

Second type entails more precision involved. You can specify exact dates in the future that you want this particular queue to run.

ezgif.com-crop

On top of that, every specific date can also have it’s own timetable! Add as many tweeting times as you like for each selected date.

2.4.Reading logs #

This feature is only available in the pro version.

Each queue comes equipped with a useful log that will display all events, which occurred recently. Currently, there are two event types: notification and warning.

We decided not to introduce “error” one at this moment.

Some events have an extra information appended to them to give you a bit more insight. It’s very useful when there is a warning that needs addressing!

Notification events

Marked with pastel blue. Your log will consist of those most of the time.  Available statuses are listed below:

Post #ID has been published. Awesome!

The one you want to see every time. Means that everything went as expected and another piece of your website content has been shared! Well done!

Appended post #ID at the bottom of the queue.

Just to remind you whether you have the looping enabled or not. If yes, you will be let know that the post has been re-queued successfully.

Warning events

These are marked in a light yellow to distinguish better. They don’t necessarily mean there is a reason to panic. They are there to inform you about a possible issue with a particular tweet and advise you to investigate it.

Possible warnings:

Template for post #ID is longer than 140 characters.

The characters cap forced by Twitter is 140. Any links and images take 23 out of that limit, so make sure that all tweet’s media and text is below or equal to 140 characters.

Image for post #ID wasn’t accepted by Twitter.

There are many reason why this would happen. Expand this warning to read the exact cause and try to fix it.

Image for post #ID is too heavy. Maximum file size is 5MB.

Tweet Wheel will always use the full size of the featured image, so make sure it’s below 5MB.

Post #ID couldn’t be published.

Indicates that there is something wrong with your tweet. Expand the warning to get more human-friendly information.

Clearing Logs

If your logs have grown to a decent size, feel free to empty them. Most of messages are no use after a while and it’s good to have some spring cleaning done from time to time! The reason why we didn’t automated this is because you might find yourself in a need to stick to an error a bit longer why you investigate it.

3.Individual Post Settings #

3.2.Create tweet templates #

Tweet Wheel let’s you select as many tweet variations as you like. Every variation is called “template” and in this article we will learn how to add the very first template!

Before we start, make sure you have allowed a desired post type in plugin’s settings.

Edit a post

We will use the basic post for this guide, but the same steps apply to any type of content.

Click “Posts” in your WP admin navigation and enter the Edit screen for a selected entry.

Find “Tweet Templates”

Scroll down until you find a section titled “Tweet Templates” where you manage all of your custom tweet templates for a particular post.

Screen Shot 2015-12-10 at 20.16.54

Feel free to click “Learn more” on the right to remind yourself about tweet templates anytime!

Create templates

Go ahead and click “Add a Tweet Template”!

In the revealed text field enter your traffic-driving tweet template. Remember to insert the mandatory {{URL}} tag to include a direct link to your content! 

For example:

Fresh from the #blog: Is iPhone 6s+ the best selling #iphone ever? Read here {{URL}}

There is only one way to be a successful #entrepreneur. Don’t miss a chance and learn more here {{URL}}

Screen Shot 2015-12-10 at 20.30.51

Tips

  • Feel free to use another optional template tag {{TITLE}} which will be replaced with your post’s title!
  • Keep all templates below 140 characters limit, too!

Carry on with adding more templates before moving onto the next step.

Save changes

When you are ready, scroll to the very top and click Publish or Update button to save all changes. That’s it!

Validation Errors

Sorry, amigo. Maximum 140 characters.

Twitter accepts only 140 characters per tweet. Please remember that an image and any link takes 23 characters off the allowance.

Please add {{URL}} tag to your template.

{{URL}} tag is a mandatory and needs to be included in each template. It will be replaced with a direct link to your content.

This field is required.

A tweet template can’t be empty. If you don’t require any extra templates, just click the “X” icon to the left to delete it.

3.3.Manage tweet settings #

Tweet settings are individual to each post and they control a few important factors, which we will run through now.

Edit a post

We will use the basic post for this guide, but the same steps apply to any type of content.

Click “Posts” in your WP admin navigation and enter the Edit screen for a selected entry.

Find “Tweet Settings”

Scroll down until you find a section titled “Tweet Settings” where you control behaviour of tweets for this particular post.

Screen Shot 2015-12-11 at 11.57.43

Queue Assignment

Simply click on the name of any queues you want this post to be in. To reverse the action, click the name again and it will removed from the queue.

Green highlight means it’s already added.

If you don’t see any queues here it’s probably because you missed the step when we created them. Go back and read this article.

Feature image

There is only one option available at this section, but it may come useful if you don’t want to include an image along with your tweets.

By default, Tweet Wheel Pro will attach the feature image to all your tweets. Thus if you don’t this to happen for any reason, you must tick this box for an individual post to exclude such behaviour.

Templates Order

Sometimes you may want to leave the choice of your next tweet to a random selection. This way tweet templates will get picked randomly and your Twitter profile won’t sound as robotic as it could!

3.4.Tweet-On-Demand #

This feature is only available in the pro version.

Tweet-on-Demand or ToD is a feature build for those who need to announce their content right away. It allows you to generate and push a one-off tweet live from the post edit screen. It follows the same principle as the custom tweet templates.

Important: ToD metabox is only visible on published posts. 

Edit a post

Go ahead and open the edit screen for a post that you wish to tweet right away. Please make sure that this post type is allowed in settings. Otherwise you won’t see the necessary settings.

At the top of the right, narrower column you will find the Tweet-On-Demand box, like the one below:

Screen Shot 2015-12-16 at 13.40.34

Craft your tweet

To reveal all the options and tell WordPress that you want to send a tweet upon saving your post, tick the box “Yes, please!”. You will be shown a template text box where you can construct your tweet.

For your own convenience you can load an already created template from the drop down. Please note if you have just added a custom template, you will need to update the post first before it becomes available here.

All default functionalities apply such as hashtag analytics, characters counting, attaching a featured image etc.

Screen Shot 2015-12-16 at 13.45.55

Update the post

If you are ready, find the “Publish” box right below and hit that “Update” button. Your page will reload and the tweet will be sent out. Congratulations!

You might have noticed at this point that the Tweet-On-Demand box has returned to it’s default state. This is because the feature isn’t meant for regular tweeting. It’s only a one-off event, hence no saving happens.

4.Real-time widget #

4.1.Setup and usage #

This feature is available to the pro customers only.

The new Tweet Wheel Pro comes with a fully customisable and light-weight Twitter feed widget, which can be used in your sidebars and also displayed by a shortcode.

The Widget

If you have previous experience using widgets in WordPress you won’t struggle at all. We made sure it’s very intuitive and highly customisable.

Navigate to Appearance > Widgets and search for one titled TWP Twitter Feed. Drag it over to one of your sidebars and you are ready to go. You may also want to fiddle around with available settings.

Please note that the widget will use feed from an account that was authorised in the plugin.

The Shortcode

We didn’t want to limit availability of the Twitter feed just to sidebars, so we introduced a shortcode that can be placed anywhere on your website within pages or posts, but also in your theme’s code.

twp_widget
Available parameters

number_of_tweets
Integer. Number of tweets available in the feed. Default 0 for unlimited.

skip_replies
Integer. Whether to exclude replies from the feed. 1 for yes, 0 for no. Default 1.

skip_rts
Integer. Whether to exclude retweets from the feed. 1 for yes, 0 for no. Default 1.

title
String. The title displayed above the feed. Default Latest Tweets.

title_icon
Integer. Whether to display a Twitter icon next to the title. 1 for yes, 0 for no. Default 1.

title_link
Integer. Whether to link the title to user’s profile. 1 for yes, 0 for no. Default 1.

profile_link
Integer. Whether to display a link to user’s profile below the feed. 1 for yes, 0 for no. Default 1.

follow_button
Integer. Whether to display a follow button for user’s Twitter profile. 1 for yes, 0 for no. Default 1.

owner_thumbnail
Integer. Whether to display a profile image next to tweets sent from owner’s account. 1 for yes, 0 for no. Default 1.

others_thumbnail
Integer. Whether to display a profile image next to tweets of every one else. 1 for yes, 0 for no. Default 0.

links_clickable
Integer. Whether to make links within tweets clickable from the feed. 1 for yes, 0 for no. Default 1.

time
Integer. Whether to display the time of each tweet. 1 for yes, 0 for no. Default 1.

time_format
String. Controls the format that date is displayed in. Uses standard PHP date format. Default H:i jS M Y.

time_linked
Integer. Whether to link the time to a particular tweet on Twitter. 1 for yes, 0 for no. Default 1.

5.Updates & support #

5.1.Tweet Wheel Pro changelog #

2.0.6.5
  • Fixed – badge displayed next to the plugins in the wpadmin section, when there were no plugins to update
2.0.6.4
  • Fixed – templates weren’t rotating correctly when following the order
2.0.6.3
  • Fixed – uninstalling script typo, it will now properly remove plugin’s data from the options table
  • Fixed – prevented from plugin’s settings page links being rewritten
  • Fixed – JS conflict with Grandnews theme
  • Fixed – Undefined indexes on the settings page when WP_DEBUG mode is set to true
2.0.6.2
  • Fixed – header sent error on plugin activation
2.0.6.1 – 2nd November 2016
  • Added – an error message returned by Twitter should there be an issue with the authorisation
  • Added – attached images will no longer use up the character limit
  • Fixed – a broken post edit link in the logs screen
  • Fixed – a javascript error when selecting a template in the Tweet-on-Demand box
2.0.6
  • Eliminated a random redirection when attempting to edit a post, which doesn’t support excerpts
2.0.5.2
  • Added WP 4.6 compatibility
2.0.5.1
  • Removed hashtag analytics (more: http://nrdd.co/28UctzV)
  • Fixed {{EXCERPT}} tag causing JS to break on post edit screen
2.0.5
  • Fixed weekly schedule to correctly save and display created times for each day
  • Added compatiblity with WordPress 4.5
2.0.4.3 – 09.04.2016
  • Fixed: a vulnerability on the authorisation screen
  • Fixed: schedule on Sunday not saving / displaying tweeting times after refresh
2.0.4.2 – 03.03.2016
  • Fixed: a few bugs
  • Revised the code
2.0.4.1 – 24.02.2016
  • Fixed: A fatal error for new users upon the plugin activation
2.0.4 – 14/02/2016
  • Fixed: JS conflicts with Customiser
  • Fixed: Widget not reflecting settings on the front-end
  • Fixed: Broken link prompting to activate license key if user wanted to use hashtags analytics
  • Fixed: Slow loading of the Queues screen by replacing JavaScript tab switching with page reloading
  • Fixed: Broken widget layout after real-time refresh
  • Fixed: Widget not caching tweets after real-time refresh
  • Fixed: High usage of memory and other server resources resulting in slow admin panel
  • Fixed: Window not scrolling to invalid tweet templates on the post edit screen
  • Added: Ability to generate times at fixed intervals within the weekly schedule
    Added: Ability to copy times from other days within the weekly schedule
  • Added: Ability to clear times within the weekly schedule
  • Added: When adding a new queue, the user will be redirected to it on form submission
  • Added: WP Pointers showing new users next steps when using the plugin for the first time
  • Added: New template tag {{EXCERPT}} which will use the default Excerpt field
  • Added: Template tags such as {{TITLE}} and {{EXCERPT}} will refresh it’s values on-fly keeping character counters up-to-date
  • Added: Admin toolbar dropdown for easy access to queues
  • Other: Hid WP admin footer from plugin’s admin pages
  • Other: Centralised the authorisation form on the screen
  • Other: Code improvements
2.0.2 – 01/02/2016
  • Switched licensing system compatible with the new verification server
2.0.1 – 10/01/2016
  • Fixed an internal error ocurring when tweet template was too long causing entire queue to malfunction
  • Eliminated all notices and warnings in the debug mode
  • Tidied up code to avoid redundant assets
  • Fixed a couple of bugs which could have caused queue to post duplicated content on user’s Twitter wall
  • Added compatibility with PHP7
2.0 – 31/12/2015
  • Total plugin overhaul. Read plugin description to learn more or visit our help centre
1.4.1 – 19/11/2015
  • Switched the auto-updating system to our own meaning better stability and not interrupted service. Please make sure you update your plugins as always, because any further releases will be provided through the new channel.
1.4 – 13/11/2015
  • VERY IMPORTANT UPDATE: Changed from one-click authorisation to standard Twitter authorisation that requires an app created on user’s Twitter account. (PLEASE NOTE: You need to re-authorise your plugin with Twitter in order to keep using it)
1.3.10 – 04/11/2015
  • Bug fixes.
1.3.9.1 – 22/10/2015
  • Fixed template counter giving wrong number of characters when a foreign letters where used such as ä or ö.
1.3.9 – 06/10/2015
  • Added a setting to disable analytics, which cause high CPU load for some users.
1.3.8 – 02/09/2015
  • Fixed conflict with Customizer.
1.3.7.1 – 26/08/2015
  • Further bugs fixes.
1.3.7 – 25/08/2015
  • Fixed the issue where the plugin was tweeting same post over and over – usually the very top one. This fix may also help those who experience random anomalities with the queue looping only first 7-8 tweets.
1.3.6 – 06/08/2015
  • This update fixes major issue with analytics data growing into enormous size in your database. Installing this version will cause your stats to be purged for a short amount of time until the recurring task has been run again. Please wait patiently.
  • Increased interval between checking for new analytics data from 1 minute to 1 hour to decrease CPU load.
  • Changed the way plugin queries analytics from the database to speed up the page loading time, which was taking too long.
  • Added pagination to analytics. You will be able to browse analytics based on weeks.
1.3.5 – 02/08/2015
  • Fixed template characters counter, which was allowing to exceed 140 characters limit without showing an error.
  • Improved compatibility and precision of the Schedule in various timezones – plugin will now use your local time to control the timing.
1.3.4 – 29/07/2015
  • Featured images will be attached to all posts by default. Added an option to exclude featured images individually on the post edit screen.
1.3.3 – 24/07/2015
  • Forced WP Cron jobs to be setup by the plugin. Some users experienced troubles with tweets going out. This update should fix it.
  • Removed the “Save Changes” queue button. Now the Queue will save itself dynamically when the order has changed.
  • Improved compatibility with WooZone – WooCommerce Amazon Affiliates plugin.
1.3.2 – 17/07/2015
  • Fixed analytics not working for some users.
  • Fixed automatic updates. From this version up, you can update plugin from your WP dashboard.
1.3.1 – 16/07/2015
  • Fixed compatibility bug with the wpMandrill plugin
1.3 – 12/07/2015
  • Added “Tweet On-Save” feature which allows to send a tweet using any template on publish or update action.
  • Added responsive interface. You can use Tweet Wheel Pro on mobile devices now.
  • Fixed bug making “use as tweet’s image” checkbox to disappear when inserting a featured image to a post.
  • Fixed bug which was causing unpublished post being added to the queue.
  • Hid bulk actions from all list screens apart from “All” and “Published”.
1.2 – 09/07/2015
  • Added settings data importer from Tweet Wheel Lite to Tweet Wheel Pro. Includes things like authorisation details, post templates, settings, queue etc. The migration is now seamless.
  • Fixed a bug which prevented Tweet Wheel Pro from removing custom database table on uninstallation.
1.1.3 – 08/07/2015
  • Fixed a bug preventing some users from saving tweet templates
1.1.2 – 08/07/2015
  • Hid plugin’s metaboxes on edit screens from unauthorised users
  • Fixed PHP errors when saving a post without any templates in the debug mode
  • Revisited jQuery validation on post edit screens to increase compatiblity with other plugins
1.1.1 – 04/07/2015
  • Fixed post templates validation bug
  • Fixed hiding error notification when WP Cron is disabled
  • Internationalised plugin – beta
  • Translated plugin into Polish language – beta
1.1 – 18/06/2015
  • Fixed queue re-fill counter
  • Fixed issue with the “attached image” icon showing for all queued items
  • Added licensing
1.0 – 13/06/2015
  • Initial release

5.2.Tweet Wheel Changelog #

1.0.9
  • Fixed – templates weren’t rotating correctly when following the order
1.0.8
  • Eliminated redirection while attempt to edit a post, which doesn’t support excerpts
1.0.7
  • Bug fixes
1.0.6
  • Added compatibility with WP 4.6
1.0.5
  • “Tweet Now” error popup will now display a meaningful message returned from Twitter
1.0.4
  • Fixed weekly schedule to correctly save and display created times for each day
  • Added compatiblity with WordPress 4.5
1.0.3.3
  • Important vulnerability fix
1.0.3.2
  • Fixed a few bugs
  • Revised the code
1.0.3.1 – 24.02.2016
  • Fixed: A fatal error for new users upon the plugin activation
1.0.3 – 23.02.2016
  • Fixed: JS conflicts with Customiser
  • Fixed: Widget not reflecting settings on the front-end
  • Fixed: Slow loading of the Queues screen by replacing JavaScript tab switching with page reloading
  • Fixed: Broken widget layout after real-time refresh
  • Fixed: Widget not caching tweets after real-time refresh
  • Fixed: High usage of memory and other server resources resulting in slow admin panel
  • Fixed: Window not scrolling to invalid tweet templates on the post edit screen
  • Added: Ability to generate times at fixed intervals within the weekly schedule
  • Added: Ability to copy times from other days within the weekly schedule
  • Added: Ability to clear times within the weekly schedule
  • Added: WP Pointers showing new users next steps when using the plugin for the first time
  • Added: New template tag {{EXCERPT}} which will use the default Excerpt field
  • Added: Template tags such as {{TITLE}} and {{EXCERPT}} will refresh it’s values on-fly keeping character counters up-to-date
  • Added: Admin toolbar dropdown for easy access to queues
  • Other: Hid WP admin footer from plugin’s admin pages
  • Other: Centralised the authorisation form on the screen
  • Other: Code improvements
0.6.1
  • Fixed a bug where plugin was breaking the Customiser
0.6
  • VERY IMPORTANT UPDATE: Changed from one-click authorisation to standard Twitter authorisation that requires an app created on user’s Twitter account. (PLEASE NOTE: You need to re-authorise your plugin with Twitter in order to keep using it)
0.5.12
  • Increased increments of available minutes in the Schedule (every 15 minutes)
  • Increased interval between checking for new posts to tweet (up to 10 minutes)
  • Fix couple of bugs
  • This update will require re-authorisation with Twitter
0.5.11
  • Fixed the issue when plugin was looping just a few tweets from the top of the queue. Plugin will now correctly append latest tweeted post to the bottom of the queue letting other below to be published as well.
0.5.10
  • Fixed the counter providing incorrect template length when used foreign characters such as ä or ü.
0.5.9
  • Improved compatibility and precision of the Schedule in various timezones – plugin will now use your local time to control the timing.
  • Forced WP Cron jobs to be setup by the plugin. Some users experienced troubles with tweets going out. This update should fix it.
  • Improved compatibility with WooZone – WooCommerce Amazon Affiliates plugin.
0.5.8
  • Fixed compatibility issue with the wpMandrill plugin
0.5.7
  • Fixed a bug which caused all textareas being affected by autosize library using in the plugin
0.5.6
  • Hid plugin’s metaboxes on edit screens from unauthorised users
0.5.5
  • Fixed PHP errors when saving a post without any templates in the debug mode
  • Revisited jQuery validation on post edit screens to increase compatiblity with other plugins
0.5.4
  • Fixed post templates validation bug
  • Hid upgrade notifications from unauthorised users
0.5.3
  • Fixed bug regarding the cron error notice – now you can hide it
  • Hid settings framework errors visible in the debug mode
  • Otehr minor clean ups
0.5.2
  • Bug fixes
  • Added an option to upgrade
0.5.1
  • Fixed jQuery conflict with other plugins eg. MailPoet
0.5
  • Added support for custom post types
  • Ensured compatibility with latest WordPress to date (4.2)
  • Fixed bug which prevented to delete scheduled times
0.4
  • Added multi-templating for posts
  • Added precise scheduling of posts
  • Added health check page to verify settings of WordPress installation
  • Wrapped cron handling into it’s own class
  • Ditched used metabox framework
  • Replaced complex settings framework with Geczy’s for simplicity sake
  • Fixed bugs around scheduling plugin’s cron job
  • Plugin on uninstallation will now properly remove cron job and all options
  • Reduced cron time interval down to 1 minute for improved precision
  • Removed tweet template preview for time being
  • Improved text counter to exactly reflect Twitter’s one when adding a template
  • Added custom validation for tweet templates eg. you have to include {{URL}} tag
  • Fixed restoring previous state of the queue if saving new order failed for some reason
  • Improved styling, spacing and alignement for better user experience
  • Changed hundreds lines of code for better stability and security
0.3.2
  • Fixed a bug preventing Tweet Wheel cron job being added to the scheduler. It fixed your issues with tweets not being send out automatically.
0.3.1
  • Important security fix around AJAX functionality
0.3
  • Fixed the issue with saving the queue after removing posts (they were being readded regardless)
  • Improved code quality and removed a few bugs
  • Fixed option names inconsistency
  • Changed queue’s default state to paused (after fresh installation)
  • You can now queue and dequeue single post without reloading the post edit list screen
  • Introduced bulk actions: queue, dequeue and exclude multiple posts at once
  • Added uninstallation side of the plugin – leaves your WordPress website untouched (removes added database table and options)
  • Minor fixes and changes
0.2
  • Forced a tweet length to 140 characters and ditched anything after the limit
  • Fixed characters counter on the post edit screen – it now properly calculates a link length
  • Fixed pausing and resuming the queue
  • Prevented a queue item duplication after post’s title has changed
  • Replaced drag icon with an image to improve it’s displaying across all browsers
  • Fixed character encoding in the tweet preview on the post edit screen
  • Fixed character encoding for sent tweets
  • Wording has been amended in a few places
  • Decreased WP Cron interval from 1 hour to 15 minutes to improve accuracy
  • Added a preview of recently tweeted tweet at the top of the queue
  • Done some code cleanings
0.1
  • Initial release

5.3.Pro customers benefits #

Pro customers get many benefits that aren’t available to free users.

As a pro user you get many improvements to the plugin that can significantly increase traffic on your website:

  • Unlimited queues
  • New type of scheduling by specific date
  • Built-in live hashtag analytics
  • Attach featured images to your tweets with one click.
  • Use your favorite domain for shortening URLs (by Bit.ly).
  • Tweet on post publish or update.
  • E-mail notifications about ocurred events
  • History log telling you what was happening within a queue
  • User role management – restrict access to the plugin by a role
  • Enjoy the mobile-friendly interface.
  • Fill up the queue using filtering by date range, amount and post type.
  • Plenty minor improvements which generally boost user experience and easy of use.
  • Lifetime upgrades

Apart from that you will receive our excellent premium support that is always there for you.

5.4.Getting support #

Should you ever need help with using our product please refer to links below.

Free users should seek support on WordPress plugin’s page here.

Pro users should seek support at our premium help center here.

Please make sure you have latest version of the plugin before opening a ticket!

5.5.How to install a new update #

Both free and paid versions have an easy mechanism implemented, which will help you update Tweet Wheel.

Whether you are a user of the lite or the pro version, you should check for new release where all plugins live – in the Plugins section of your WordPress panel. However, the pro customers need to activate their license before they can update.

How do I know a new version is available?

If you visit the Plugins corner in your WP panel, try to locate Tweet Wheel entry. If an update is available to download, the plugin’s row will highlight in red and the “Update Now” option will pop out.

6.Troubleshooting #

6.1.Plugin doesn't tweet #

Sending tweets based on the Schedule is controlled by built-in WP Cron that came with your WordPress website. Usually it just works out of the box, but sometimes there can be third party plugins or themes causing it to malfunction. So… how to trace down the problem when plugin doesn’t send tweets at all?

Check if the WP Cron is enabled in your installation

To do so, simply open “Health Check” page under “Tweet Wheel Pro” and look out for “WP Cron” row. It should say, in green, “Enabled”.

If it doesn’t, you are faced with two options: let the plugin to attempt to fix the problem itself or activate the wp cron manually.

The first option is very simple. You should see “Try to fix” button next to the WP Cron line in the Health Check. Click it and wait for results.

Another way is to add the following line to your wp-config.php file that can be found in the main folder of your website:

define( ‘DISABLE_WP_CRON’, false );

or, in case it exists, remove this line entirely:

define( ‘DISABLE_WP_CRON’, true );

Check if the cURL module is installed on your web hosting

To do so, simply open “Health Check” page under “Tweet Wheel Pro” and look out for “cURL Module” row. It should say, in green, “Installed”.

If it doesn’t, please contact your hosting and request that they install it for you.

Check if the Schedule is set up properly

Navigate to Queues > One of your queues > Schedule tab to double check if it’s correct.

First, select the type of schedule – weekly or date specific – then add some times.

Save.

Check if the Queue isn’t paused

Navigate to one of your queues and open Settings tab and look out for the Queue’s Status option. If it says “Paused”, change it to “Resume”. Save.

Check if the Queue isn’t empty

Sounds silly, but from all those checks you might miss that one!

Check that your tweet templates aren’t longer than 140 characters

While custom templates have a very useful counter, default template doesn’t and can be easily missed as one of the reason Twitter doesn’t accept your tweets. Especially when you attach a featured image which takes out extra 22 characters.

By default, the Queue will loop through all the items in it until it finds one that is accepted by Twitter. In some cases, all your tweets might be rejected by Twitter hence you think the plugin doesn’t work.

Please double check all your tweets are within 140 characters limit (that includes text, link and featured image), especially when using a default tweet template.

If the plugin suddenly stopped tweeting, check if you aren’t tweeting too often

Twitter doesn’t accept duplicated content. The time period during, which a next tweet is considered a copy of one already published isn’t disclosed. Just make sure your tweets aren’t repeating a lot.

If all else fails

Try to diagnose any issues on the Twitter’s end. Open your Twitter Application dashboard at https://apps.twitter.com and look for any alerts or issues. You may want to regenerate application tokens and re-authorise Tweet Wheel using new values.

 

Suggest Edit