Twools (Social Media Unleashed) Manual

Aug 12, 2013 | Publisher: iagdotme | Category: Technology |  

By Ian Anderson Gray | iag.me Contents What is Twools? ...................................................................................................................................................... 3 Why would you need this?...................................................................................................................................... 4 The History .............................................................................................................................................................. 5 Twitter Data in the Good Ol' Days ............................................................................................................... 5 Twitter Wants to Make Money ...................................................................................................................... 5 Twitter and the Cloud Some Confusion .................................................................................................... 6 RIP IFTTT Twitter Triggers ....................................................................................................................... 7 What do I need to Run Twools? The Requirements ............................................................................................... 8 Twools Walkthrough ............................................................................................................................................... 9 Twools Settings ........................................................................................................................................... 9 Twools Home ............................................................................................................................................. 10 Twools Streams ......................................................................................................................................... 11 Twools Feeds ............................................................................................................................................. 13 Spam Filter ................................................................................................................................................. 18 Sharing and Using Recipes ..................................................................................................................... 18 Twitter API Current Limits .................................................................................................................... 20 How To Install........................................................................................................................................................ 21 Acknowledgements ............................................................................................................................................... 23 Terms of Use ......................................................................................................................................................... 23 Change Log ............................................................................................................................................................ 24 Known Bugs ........................................................................................................................................................... 26 Future Development ............................................................................................................................................. 26 Contact .................................................................................................................................................................. 27 Page | 2 What is Twools? Twools started off as a way to get back RSS feeds from Twitter. Twitter retired version 1 of their API in June 2013 as well as retiring RSS feeds. As well as not having access to RSS feeds, you need to be authenticated to use the API which raises the bar for Twitter users and developers. Twools gives you back your Twitter data as RSS feeds as well as giving you powerful filters. Twools offers a number of RSS feeds from the Twitter API: Your home timeline User timeline (yours or another user's) Your mentions Your favorites List timeline (from a list that you own) Direct messages received (disabled by default) Direct messages Sent (disabled by default) Twitter Search New followers New friends You can filter the results from the Twitter API by only outputting tweets containing certain keywords, hashtags or screen names or even by the app used to send the Tweet. As well as that you can filter based on the user (currently their location and language). Finally, you can modify the data outputted in the RSS feed by removing URLs, screen names, hashtags etc or share your recipe with other folders. As well as an RSS feed generator, Twools has a basic direct message spam filter (experimental use at your own risk!) and a simple social media management tool (basically an HTML version of the RSS filters). You can also keep an eye on your API usage on the Status page. Page | 3 Why would you need this? Good question! According to Twitter, XML, Atom, and RSS are infrequently used today. Really? Well, instead of arguing the point too much here, I know I am not the only one who has been looking for a way to get their Twitter RSS feeds back. Probably one of the most sought after reason was to replace Twitter triggers in IFTTT which disappeared back in September 2012. There are other advantages too, such as backing up your tweets or cross posting with other apps. Please make sure sure you have a proper read of the Twitter API Rules of the Road and use Twools responsibly. With Twools, you could produce feeds that allow you to: Cross post to LinkedIn using the #li hashtag Bookmark or cross post your Twitter Faves: Add new followers from the a certain country or location to a Twitter list: Add articles that I tweet using a certain app to evernote. Get emailed when someone mentions your brand negatively. Get emailed when someone links to an article on your website even if they don't mention you. Add someone mentioning a keyword to a Twitter list Twools also does some powerful things with the output such as removing hashtags, screen names and urls. You can also remove hashtags from the end whilst keeping them in the main body of the tweet (but removing the #symbol. You can unshorten URLs too to get rid of those pesky short URLs and get the RSS feed item to link to the article instead of the tweet (good for posting to social networks such as LinkedIn and Twitter) As well as an RSS feed generator, Twools has a basic direct message spam filter (experimental use at your own risk!) and a simple social media management tool (basically an HTML version of the RSS filters). You can also keep an eye on your API usage on the Status page. Page | 4 The History Twitter Data in the Good Ol' Days It's hard to believe that Twitter started back in 2006. In the early days, it was very basic and despite early popularity it was mainly popular amongst geeks, developers and other tech people. I signed up back in November 2006 despite not really understanding what the fuss was about. Well these days I think we'd be hard pushed to find someone who hasn't heard of Twitter with 554 million users worldwide, 115 million active users every month, 135,000 new sign ups every day and 58 million tweets per day. How did Twitter become so popular? I think a big part of its growth has been due to the developer community coming up with ideas on how to use Twitter and building apps for it. Not long after Twitter opened its doors, they released a system that allowed developers to access Twitter's data including tweets and user information. That system was Twitter's API Application Programming Interface. An API helps a developer interact with an application sending and receiving information. In the early days it was incredibly easy to access your data it was just a case of getting a feed of your tweets or mentions which were available as RSS or XML feeds. You didn't need to be a programmer, because you could add that feed to another app such as an RSS feed reader, Yahoo Pipes or a few years later, IFTTT. Twitter Wants to Make Money Twitter is free for end users, but of course it has to make money somehow. That somehow of course is advertising, but how could Twitter properly develop its advertising platform when it didn't have control of the way its data was being presented? Twitter started buying up Twitter clients left, right and centre TweetDeck being the most famous. They also started to lock down their API, meaning it was no longer possible for just anyone to access the data you needed to be logged in or authenticated and that raised the bar of access. Page | 5 RSS & Authentication - Apparently, RSS Feeds "are infrequently used today" When the latest version of the Twitter API (version 1.1) was launched, they announced that they were retiring RSS feeds. According to Twitter, XML, Atom, and RSS are infrequently used today. I completely disagree with that. I think the real reason why Twitter have retired RSS feeds was mainly due to the fact that they were not able to control access to their API. With the new version of the API everyone has limits on how many calls they can make every 15 minutes with your authenticated app. With RSS, because you aren't authenticated, there is no limit. I appreciate Twitter has to keep a lid on their API as allowing anyone to access their API with unlimited calls would be impossible. However it is sad that the only way to access your Twitter data in the way it used to be is now firmly in the hands of developers. If you don't know how to code and build an app that connects to the API you are out of luck. Twitter and the Cloud Some Confusion With version 1.1 of Twitter's API there were new "Rules of the Road Twitter's terms and conditions of use. Most of the terms make sense and it is important for Twitter to make it clear how their data should be used. However there is one line in particular that has caused a lot of confusion in 1.4.a.iii: "You may prov ide spreadsheet or PDF files or other export functionality v ia non- programmatic means, such as using a "sav e as" button, for up to 100,000 public Tw eets and/or User Objects per user per day . Exporting Tw itter Content to a datastore as a serv ice or other cloud based serv ice, how ev er, is not permitted." - From the Twitter API Rules of the Road So, we are all allowed to copy up to 100,000 public tweets every day as long as it is not via an app (I am assuming that is what it means by "via non-programmatic means"). However what does "Exporting Twitter Content to a datastore as a service or other cloud based service" actually mean? It's very vague! Does that mean we aren't allowed to archive our tweets? That can't be true, since Twitter offer their own archiving service where we can download all our tweets to our computers. There is no doubt, however, that it was this clause which caused the app IFTTT to remove their Twitter Triggers Page | 6 RIP IFTTT Twitter Triggers If you're a regular reader of my blog, you'll already know that I am a huge fan of the service IFTTT (If This Then That). IFTTT allows you to connect lots of different apps and services together (Twitter, LinkedIn, Flickr, Instagram, Facebook and even switches at home). A "Trigger" was something that would cause IFTTT to do something. For example "If you post a new Flickr Photo" would be a "Trigger". An "Action" is something that IFTTT does as a result of an IFTTT Trigger. For example "then post a Tweet". A full example of a Trigger and an Action could be "IF you post a new Flickr Photo THEN send a Tweet" In September 2012, IFTTT made an announcement that they they were removing Twitter Triggers. They were finally removed on September 27 and there were a lot of upset people. The reason for this, according to IFTTT was that "Tw itter announced policy changes that w ill a ffect how applications and users like y ourself can interact w ith Tw itter's data ." I later wrote an article on how you could Get Your Twitter Triggers back using RSS. This worked by using the RSS feed for your Twitter timeline as an action in IFTTT. Unfortunately this now does not work. We knew it was coming, but in June 2013, Twitter retired version 1 of their API together with the retirement of RSS, XML and Atom feeds. Now, once you've built an app that authenticates with the Twitter API, you will be given the data in JSON format. Whilst JSON is great for developers in that it is rich in data, it is not so helpful for everyone else. With so many people wanting to get their RSS feeds back, I decided to build my own solution. Twools A Solution to a Problem Twools is my attempt at bringing back RSS feeds and so freeing your data. I have tried my best to make this as easy as possible for everyone to use. That's quite a task, because Twitter don't make it easy! You install Twools on your own website. The advantage of this is that you control the way it works and it is not very difficult to do. You just download Twools either as a WordPress plugin or a standalone PHP app and add your Twitter App information. It's that easy. Of course, you have to have a website and it has to run PHP (if you have WordPress you will be running PHP). That may be a deal breaker for you. However there are a huge number of websites that use PHP WordPress is an example so hopefully you'll be fine. Page | 7 What do I need to Run Twools? The Requirements Firstly, you need to decide which version of Twools you want to run. There is a WordPress plugin version and a standalone version. I would highly recommend running the WordPress version as it is much easier to use. For both versions you need a website with PHP. As Twools is written in PHP, you will need to check that your website has PHP installed. If your website uses WordPress then this will definitely be the case. I have tested it using PHP 5.2 an above. If you want to use the standalone version of Twools then you will need to edit a few lines in the config file and uploading it to your website. Page | 8 Twools Walkthrough Twools Settings If you are using the standalone version of Twools, you need to edit the config.php file to add your Twools settings. Everything is a whole lot easier if you are using the WordPress version where you can add the settings in the WordPress dashboard menu for Twools. For further information, see installation. Page | 9 Twools Home Once you are logged into Twools, you will be presented with the Home screen. This gives a brief intro, the version number and links to all the tools. You can also log out of Twools by clicking the button at the bottom. Page | 10 Twools Streams Twools Streams is a basic social media management tool for Twitter using the same filters as the RSS tool. Think about it like a super basic version of Tweetdeck or Hootsuite. It is simple in that it only gives you one stream at a time (at least in the current version of Twools) and it doesn't auto-refresh. However, it is powerful in that it has the same powerful filters has Twools Feeds. I won't go through all the options in the screenshot above fully because most of these options are the same in the next tool, Twools Feeds. Page | 11 First of all you need to choose what Input Feed you want to retrieve from Twitter. This could be your timeline, mentions or even a Twitter search. Some feeds require more information (such as Twitter search or lists). Once you've chosen the feed, you then need to choose how many results you want to work with. Remember, once you run filters on these results, you may be left with less than this number, so it is best to choose a higher number. You can then run filters on these results. For example you could choose to only return tweets containing the hashtag #socialmedia or tweets from @iagdotme posted using Buffer. Click on the Update button and you will see your results. If you want to see multiple streams, then you can always open another instance in another tab. Page | 12 Twools Feeds Twools feeds gives you RSS feeds from the Twitter API and was the main reason I built Twools. It is similar to Twools Streams in that you choose an input and various filters, but it is more powerful and outputs as an RSS feed instead of HTML Please note the RSS feed output is NOT password protected and potentially public. Do keep your RSS feeds private, especially as they will use up your API limits. In future versions of Twools I hope to introduce caching which will reduce this. Twools does offer RSS feeds of your direct messages, but this is disabled by default. Offering public RSS feeds of your direct messages is probably something you would want to think twice about. 1. Input First of all you will need to choose which input feed you want to retrieve from Twitter. You have the following choices: Your home timeline User timeline (yours or another user's) Your mentions Your favorites List timeline (from a list that you own) Direct messages received (disabled by default) Direct messages Sent (disabled by default) Twitter Search New followers New friends For user timeline you have the option to give the screen name of another user so that you can retrieve the tweets of another use. For list timelines you must select which list you want to retrieve the tweets for. Currently the list of your Twitter lists is not cached. For Twitter Search, you must enter the search query. For more information see the examples on the Using Search page in the Twitter API documentation. You can then choose how many results you want to retrieve. You can select between 10 and 200 results. Please note that if you filter these results using the Twools filters, you will end up with less than this number. This is just the number of results that Twools is going to work with. Currently you can only select up to 100 results when you output screen names (for example to view your new followers or friends). Page | 13 Page | 14 2. Filters Once we've retrieved the results from the Twitter API, you can then run several filters on them so that you can only return certain results. The filters are either on the tweets themselves or the user that sent them. Filters on Tweets Containing any keyword, #hashtag or @screen_name: You can filter by a single keyword, hashtag or screen name in this field. For example if you wanted to return only tweets containing the hashtag #socialmedia, you would enter that here. Or you could put a screen name (for example @iagdotme) to only return tweets that mention that user. Containing all keywords, #hashtags or @screen_names: You can filter by multiple keywords, hashtags or screen names in this field. This is similar to the previous field except that you can add multiple keywords, hashtags or screen names by separating them by a comma. For example you could enter "#socialmedia, @iagdotme" to only return tweets containing the hashtag #socialmedia and mentioning @iagdotme Containing none keywords, #hashtags or @screen_names: You can filter by multiple keywords, hashtags or screen names in this field. This is similar to the previous field except only tweets that DO NOT contain any of these keywords, hashtags or screen names will be displayed. Containing single #hashtag: Identical to the first field except that this specific hashtag can be removed from the feed output if selected in the final option. From: Only tweets from these users will be returned Not From: Only tweets not from these users will be returned Using Apps: You can filter by the app used to send the tweet. You can select multiple app names by separating by a comma. For example, to return tweets posted with either Hootsuite or Buffer you could enter "Hootsuite, Buffer" here. Not Using Apps: Similar to the previous field but here you can return tweets that were posted not using these apps. You can select multiple app names by separating by a comma. For example, to return tweets that were NOT posted using either Hootsuite or Buffer you could enter "Hootsuite, Buffer" here. Exclude Scheduling Apps: By checking this box you can exclude a variety of scheduling apps (such as Buffer, IFTTT, Social Oomph and Triberr) from the results. You can edit the list by editing the config file (see later). Page | 15 Exclude RTs: By checking this box you can exclude RTs from the results. This uses Twitters own API to only return non retweets, but also searches for RT in the tweets. Been Favorited: Only return tweets that have been favorited. Been Retweeted: Only return tweets that have been retweeted. Filters on Tweets In Location: You can filter by the location of the person who tweeted the tweet. This filter looks at the location string the users' profile. In Bio: You can filter a keyword from the user's profile. Writes in Language: You can filter by the language that person who tweeted the tweet writes in. 3. Output Now that we've returned the results from Twitter and filtered out the ones we don't want, we can output the RSS feed. However, there are still quite a few things we can do to make the feed the way we want it to be. Remove specified Hashtag: If you entered a hashtag in the 'Containing single #hashtag' field above, you can remove this from the output. This is particularly useful if you want to use for cross posting. For example if you want to retrieve tweets with the #li hashtag to cross post to LinkedIn, you won't want the #li hashtag to appear in the feed. Remove all Hashtags: This is fairly brutal it removes all hashtags including inline ones. Remove all hashtags from end, but only remove '#' elsewhere: This is probably more useful than the previous hashtag filter. It removes all hashtags from the end of the tweet. However it keeps hashtags in the main body of the tweet but removes the "#" symbol. This is useful when people use hashtags inline where removing would lose the sense of the tweet. For example "Great #twitter app gives you back your #rss feeds #socialmedia #twittertools" would become "Great twitter app gives you back your rss feeds". Remove all screen names (including 'via @screenname'): This removes all screen names from the tweet. Useful for cross posting and cleaning up tweets. Link to 1st URL contained in tweet (if available): The RSS feed usually links to each tweet, but if you check this option, Twools will link to the Page | 16 first URL contained in each tweet. This is very useful if you want to bookmark articles from tweets, or cross post to LinkedIn or Facebook linking to the article contained in the tweet. Unshorten URL (if "Linked to 1st URL contained in tweet" is selected) SLOW: Twools attempts to unshorten the URL contained in the tweet by finding out where it redirects to. This can be very slow as Twools has to go through eachURL individually. This can be useful when you want to link to clean URLs. It is hoped to cache these URLs in future versions of Twools. Remove all URLs: Removes all URLs from the tweet. This is particularly useful if you have selected "link to 1st URL contained in Tweet". Show screen name of sender instead of tweet.: If you want to return the screen name of the person who sent the tweet, select this option. This is useful if you want to find out info on your followers or people who mentioned you. You could use this information to follow, unfollow or add them to a list. Sharing If you would like to share your recipe with other Twools users, then select "Output recipe string instead of RSS feed". Twools is very powerful, but a lot of people will find it helpful to see practical examples of its use. I'd love it if you could share your examples in the comments below by adding the recipe string. Output Feed Once you've entered all your filters and selected your output requirements, it is time to generate your feed. Click the big blue button to do that. You can the copy the URL to use later. Please note that each time you view a different feed you will be requesting data from the Twitter API and using up part of your limit. Each feed is cached for 1 hour (although you can change this default in Twools settings). Keep an eye on your API limit using the built in Limits page. Keep your RSS feeds private. Twools appends a special secret string to each RSS feed URL which is unique. Page | 17 Spam Filter This is very experimental, so only use if you know what you are doing. Like the rest of Twools (but this feature in particular) I cannot be held responsible for any loss of data! The warning out the way, this tool allows you to quickly clear your direct messages of spam. To use, you will need to allow Twools to access your direct messages as well as allow your Twitter app to do so. You can add your own key phrases but currently this has to be done by editing the config.php or config- wp.php file. The spam filter then scans your direct messages and if it finds a match it will delete it. I got so fed up with my direct messages being spammed with useless messages that I built this into Twools. You could set this up on a schedule (say once every hour) to purge your inbox of spam. As well as editing the config.php file (for the standalone version of Twools) or the config-wp.php file (for the WordPress plugin version of Twools) with your keywords you will also have to change $allowDMs to TRUE and give your Twitter app full permissions to access your direct messages Sharing and Using Recipes As I said above, you can share your feed recipe with others by selecting "Output recipe string instead of RSS feed" in Twools Feeds. Once you do this, you will be given a recipe string that you can share with others (share yours in the comments). As well as that you can use a recipe that someone else has shared. By entering it in the box, you can then have a check to see if you want to go ahead and then generate the feed based on that recipe. Example Recipes You can share feed recipes from other Twools users as well as saving and sharing some of your own. These recipes allow you to generate RSS feeds which you can then use in other apps. Basically you're just sharing the query string for the feed generator, but the idea is to make it as easy as possible to share and have fun. However you must make sure you have a proper read of the Twitter API Rules of the Road. Here are some examples: Page | 18 Articles I post on Twitter using Triberr You could use this to add articles that you tweet from Triberr (or another app) to Evernote. This retrieves your tweets posted via Triberr. It removed URLs &screen names from the tweets. As well as this, it removes hashtags from end (and removing '#' from the rest). It extracts the URL and unshortens it and puts in link field. inputType=timeline&count=50&appname=Triberr&filterscreennames=1&extracturl=1&deshortifyurl =1&filterurls=1 Return anyone who uses the hashtag #socialmedia You could use this feed with IFTTT to automatically add someone who uses this hashtag to a list. inputType=search&search=%23socialmedia&count=20&showscreenname=1 Tweets from your timeline that use the #li hashtag Could be used to cross post to LinkedIn when using the #li hashtag inputType=timeline&count=50&hashtag=%23li&filterspecifiedhashtag=1&filterhashtagsend=1&fil terscreennames=1&extracturl=1&deshortifyurl=1&filterurls=1 Your Twitter favorites All URLs, screen names and hashtags have been removed. URL extracted and de-shortified. Could be used for Bookmarking or cross post your Twitter Faves inputType=favorites&count=10&filterhashtagsend=1&filterscreennames=1&extracturl=1&deshorti fyurl=1&filterurls=1 Recent followers from the UK Retrieves the screen names of all your recent followers with the keyword "UK" in their location. You could use this to automatically add your latest followers from the UK to a Twitter list using IFTTT. inputType=followersnew&count=50&location=UK&filterhashtagsend=1 Page | 19 Twitter API Current Limits Twools connects to the Twitter API via the Twitter app you registered. Depending on the type of call you make, you have a certain number of calls allowed every 15 minutes. If you use these up, you will have to wait until the next 15 minute window starts. You will receive an error message in Twools if this happens.RSS feeds will send a "temporary unavailable" header so that feed readers will try again when the limits are reset. You can monitor your API usage within Twools by going to the Limits section. This shows your limit and remaining calls for every API stream. Twools doesn't make use of every stream type listed, but it can be a helpful way of monitoring your usage. Page | 20 How To Install Installation for Twools for WordPress Download the ZIP file (if you haven't already got the ZIP file, sign up for Twools above) Go to the WordPress dashboard for the website you wish to install Twools on Go to plugins->add new and click on "upload" at the above. browse to the ZIP file you downloaded and click install now Activate Plugin You should now be taken to the Twools menu page. You will need to create a Twitter app at dev.twitter.com. I've written in depth instructions on how to do this in an article on my website- How to Create a Twitter App in 8 Easy Steps. Enter the access tokens from your Twitter app on to the Twools menu page. Click generate string to generate random secret string. If you want to use your own list of excluded apps, you can enter them. These need to be comma separated. For example IFTTT,Buffer,Social Oomph Click update and then click on the "Launch Twools" button to begin! Page | 21 Installation for Twools (Standalone Version) If you don't have a WordPress based website to install Twools on, you will have to use the standalone version. This does require a little more work and you will need to edit some code. But fear not, I have tried to make it as easy as possible! Download the ZIP file Go to dev.twitter.com and register your Twitter app (instructions below). Edit the config file in /incs/config.php and fill in the keys from your new Twitter app as well as your Twitter username and the username and password you want to protect Twools. Upload Twools to your website and visit it on your site That should be it! You will need to create a Twitter app at dev.twitter.com. I've written in depth instructions on how to do this in an article on my website How to Create a Twitter App in 8 Easy Steps. To use Twools, you will have to edit a PHP file. If that scares you, don't worry I have tried to make it as easy as possible. You do not have to know PHP, be a developer or a coder I promise!. Open up the config.php file in the "incs" folder and edit the bits as follows. Firstly, you will need to set the username and password you want to secure Twools (replace "demo" and "demo" with your new username and password): 1. // Set username and password to protect access to Twools (RSS feeds will still not be password protected). 2. // Put some jibberish on the padding string for extra protection 3. $config['username'] = "demo"; 4. $config['password'] = "demo"; 5. $padding = "g`0*Y;6VOx`AIb+WBE>uKU1w;_cV-`&Y[ZgUDeZ3~jmdx]u7DGKUVN1W9~~W;kbk"; Once you've done that, enter those access tokens here: 1. /** Set access tokens here - see: https://dev.twitter.com/apps/ **/ 2. $settings = array( 3. 'oauth_access_token' => "", 4. 'oauth_access_token_secret' => "", 5. 'consumer_key' => "", 6. 'consumer_secret' => "" 7. ); As well as this, you should enter your Twitter username by entering it within the quotes for each item: Page | 22 1. // Replace by setting the default Twitter username (exclude the @ symbol) 2. $defaultUser = "iagdotme"; If you want to expand on the app filters, then please add more in the config.php file. I've added some myself, such as SocialOomph, Buffer, JustRetweet and more. These apps are great, but it's just that sometimes you want to declutter your feed: 1. // If you want to exclude apps in the app filter, add some more here.... 2. $excludeApps = array("IFTTT","Buffer","Paper.li","Triberr","SocialOomph","TweetAdder", "JustRetweet","dlvr.it","WPTweetily","Twuffer","twitterfeed","Tweet Old Post"); If you really want Twools to access your direct messages, then you will need to set $allowDMs to TRUE. As well as this, you will need to give your Twitter app full access permissions: 1. // Allow RSS feeds of Direct Messages? Allowing this will effectively make your direct messages publicly viewable via the RSS feed. Use at your own risk. To switch on change "FALSE" to "TRUE" 2. $allowDMs = TRUE; You can also edit the $spamFilter array if you plan on using the experimental spam filter. Just edit the phrases to the way you want. Only use this at your own risk! Once you've done this, you need to upload everything and run from your website. That's it! Acknowledgements A huge thanks to James Mallison for explaining how to build a simple Twitter app using v1.1 of the API and for building a fantastic PHP Twitter wrapper. This little app wouldn't work without it! This app also uses the Twitter Bootstrap framework for its HTML, CSS and Javascript. It means it is fully responsive and uses the latest in HTML5 and CSS3 Terms of Use Please use Twools responsibly and make sure sure you have a proper read of the Twitter API Rules of the Road. You may use it for personal and commercial use. However you must not sell Twools. Page | 23 Change Log v0.10 Twools is now a WordPress plugin, but can also be used as a standalone PHP app WordPress version uses a different config file config-wp.php WordPress version uses WordPress login (you need to be logged into WP to use Twools) API request for lists is cached. The default is 1 hour, but can be changed in the WP settings menu or the config.php file (if using the standalone app) All API requests for the RSS feed generator are now cached. The default is 1 hour, but this can be changed in the WP settings menu or the config.php file (if using the standalone app) Added screen names to author tag in RSS feeds Secret string can be automatically generated in WP Settings menu The secret string that is appended to feed URLs is a an encrypted version of the recipe appended to the secret string. This means every RSS feed will have a different secret string and so much more secure The excluded apps can be added in the WP settings menu. If this isn't set, the default list is used. Example recipes can now be used in the share recipe section Fixed Notice Errors for unset variables Moved functions from config.php file to a new functions.php to keep config.php only for editable data Sanitised query string for safety and fixed recipe bug in feeds.php by using htmlspecialchars($_SERVER['QUERY_STRING']) Updated TwitterAPIExchange.php to latest version (fixed disable SSL peer verification) v0.09 2013-07-05 Added Not From filter to show tweets not from one or more users From filter now accepts multiple users Added biography filter to search for tweets from users with a keyword in their user biography v0.08 2013-07-04 Added filter to only show tweets that have been favorited Added filter to only show tweets that have been retweeted v0.07 2013-07-04 UI enhancementes Updated About/Help Page Update Checker Page | 24 v0.06 2013-07-03 Added "containing none" keywords, "NOT using app", "remove all URLs" etc feeds to streams. Added "from" filter to feeds and streams. v0.05 2013-06-28 Added "Containing none" keywords filter Added "NOT using app" filter Added "Remove all URLs" output feature Added Unshorten URL (if "Linked to 1st URL contained in tweet" is selected). This can be SLOW Added Show screen name of sender instead of tweet. Great for producing an RSS feed of Twitter usernames to be able to add them to lists in IFTTT "Share Query" is now "Share Recipe". Users can share their recipe feeds or use ones from other Twools users. Now uses a simple HTML form with cookies for password protection as HTTP didn't work in all PHP installations v0.04 2013-06-26 Improved UI Bug fixes for spam filter Added "remove all hashtags" filter (useful in cross posting to another network where hash tags are not used) Added "remove all screen names" filter (useful in cross posting to another network where screen names are not used) Added "link to URL in tweet". Normally the item in the RSS feed links to the URL of the tweet. Checking this will link the link in the tweet (if available) and will fall back to the link of the tweet if there is no link. Keywords and app name fields now accepts multiple keywords (comma separated) Added "all keywords" field so that all keywords (comma separated) have to be contained in the tweet. Added "Remove specified Hashtag" feature Added "Remove all Hashtags" feature Added "Remove all hashtags from end, but only remove '#' elsewhere" feature Added "Remove all screen names" feature Added "Link to 1st URL contained in tweet (if available)" feature Added "share query" feature so that it is easier to share recipes with other Twools users. v0.03 2013-06-24 Page | 25 Added language filter (for filtering language set in users' profile) Changed keyword description to include hashtags and screen names Added home page for intro and easy links to rest of app Added help page for future development v0.02 2013-06-23 Fixed HTML issues with Twitter Bootstrap (thanks @DZAMAGE) Improved look and feel Fixed incorrect links in nav bar (now relative not hard coded) Added Javascript "magic" to hide unneeded fields in form. Form cannot send without required fields. Fetches lists for list timeline. Now appears as a dropdown on the left. This requires an API call for every page load. Probably needds to be cached in future. Added password protection (basic HTTP). RSS fields are exempt and are available without authentication. The option for displaying direct messages as an RSS feed is now disabled by default. This is because many users will not want their private messages displayed in a public RSS feed. Users can switch this on in the config file Added sent direct message feed. v0.01 2013-06-21 First Version Known Bugs No known at the moment. Please submit a bug report if you find any. Future Development WordPress plugin version Caching of API requests Option to return full articles (with titles) of the URLs in tweets Multiple Twitter account support Provide a GUI for the config file to make it easier for people to use. Possible store the info in an XML file. In Twitter HTML stream highlight which tweets have been responded to In RSS and HTML streams add filter for tweets that have been responded to Page | 26 Allow returning of more results by doing multiple API requests Pagination for RSS and HTML feeds (including an offset dropdown) Checkboxes to follow/unfollow individual people on page Improve interactivity (retweets/faves/replies) in Streams Save popular streams for re-use. Allow multiple columns in streams (similar to TweetDeck/Hootsuite) Other possible ideas In RSS and HTML streams add filter for tweets that contain a link or a Twitter card (possibly video or photo) Add user to list app add a user to a list automatically based on an app, search or mention Automatically block followers who mention a keyword Add an option to spam blocker to block user as well as delete direct message Option to follow all people on page. Option to unfollow all people on a page Clone List tool (Add all members to a list from another list, remove all members who aren't in) Follow from list tool (follow all people in a list) Unfollow from list tool (unfollow all people in a list) Block from list tool (block all people in a list) Add to list tool (add all people to a list) Follow latest friends/followers of another user Contact This app is provided "as is" and I can't be held responsible for any loss of data or other issues. Please use at your own risk. I'm very happy to help or answer questions and would love this to be improved and developed. Please get in touch. I am on Twitter @iagdotme and my email is ian [at] iag [dot] me. Page | 27

twools manual.pdf

About iagdotme

Social Media Consultant & trainer, web developer, partner of select performers internet solutions, freelance singer, husband and dad.

Comments

You must log in to comment

Intellicore Says:

Twools is a great brandable name, will have to check it out.

Dubai Escort Says:

Great info