Admin Control Panel
The control functions such as connecting to a Twitter account and storing information on the tweets/blogs, can be accessed through the “Twitter Control” GUI in the WordPress admin panel.
Any changes in the currently active Twitter account tweets can be immediately updated by clicking on the “Update Blogs” button.
Order, Prioritisation and PM Filtering
The application will display the latest tweet from all of the active accounts and then displays those latest tweets in date order. So the newest tweet across all of the accounts will always be shown first. It is also possible to switch between allowing/disallowing PM (Private Message) tweets to be included in the display.
Separate All Tweets Page
If a user has applied restrictions on the amount of Tweets displayed in the application then they can create a separate WordPress page to hold the entire tweet output of all the active Twitter accounts.
Running the relevant Twitter API function calls can sometimes a few minutes to fully execute. All information is stored in a cache data held locally, so that it minimises the chance of performance loss on web pages.
If users wish to have regular/automatic updates of their Twitter account tweets, then that is achievable through creating a crontab entry, or similar automation mechanism, to execute the supplied “runTwitterScript.php” file.
Specific styling using CSS
A CSS file is supplied to provide a starting point for displaying the tweets, but changes can be made to suit individual preference.
All files, both PHP and CSS, can be found within the main extracted plugin folder.
Within the folder “twitter-feed” you should find the following 13 files:-
- twitterScript.php – the file that will interface with the Twitter API (required)
- twitterPlugin.php – the display file that WordPress will interface with (required)
- inlcudeTwitter.php – used for commonly used PHP variables and functions (required)
- runTwitterScript.php – used for cron or other photo data update automation control (optional usage but recommended)
- twitterStyle.css – used for styling the presentation of the tweets (required, but can be modified)
- arrow_down.gif – used to expand the main application
- arrow_up.gif – used to collapse the main application
- twitterImage.gif – used in the header
- twitterpageheader.gif – used in the header
- screenshot-1.png – image of the application running on a WordPress front page
- screenshot-2.png – image of the Twitter Control Panel in WordPress
- readme.txt – this information file
- COPYING – a copy of the license terms for this release
For further support or information please visit: http://community.plus.net/opensource/
Extract the “twitter-feed” folder from the downloaded file and put it in your WordPress “/wp-content/plugins/” folder so that the resulting path is “/wp-content/plugins/twitter-feed/”.
The plugin should now be viewable in the WordPress admin panel under the “Plugins -> Plugins” menu option. The plugin is entitled “Twitter Feed” and can be activated in the normal way by clicking “Activate” in the far right column.
First, click on the “Twitter Control” option found within the main “Plugin” menu, and you will be directed to the Twitter Control panel. From here you should be able to select which Twitter accounts to use, how many tweets you want to display, and various other options.
If you are restricting the amount of tweets on the front page, you can have a separate WordPress page displaying all the tweets from currently active accounts. To do this simply create a new page, give it a title/content etc and then add
exactly as it is written above including the square brackets, to add the Twitter application to the page. You will also need to select the page from the drop down menu in the admin panel, so that the plugin knows which page to link to.
Depending on how you use and implement WordPress/your website, you may have to use the widget control menu to position where the Twitter application will appear and be utilised. To do this simply visit the “Presentation -> Widgets” menu option, and position the plugin where ever you like. In some cases it will be necessary to perform this task for the plugin to appear on your web page.
- How does the plugin connect to Twitter?
It uses the PHP cURL library to connect to Twitter’s API.
- Can the supplied plugin be re-styled?
Yes, as mentioned previously, a CSS style sheet is provided to give a basic layout for the plugin. Please feel free to modify this to your heart’s content to get the presentation you are after. However, this may require you to have some prior knowledge of HTML and CSS.
- Is it possible to automate the tweet updates?
Yes, we have provided a PHP file called “runTwitterScript.php” that is the file that should be run if you want to run an automated/scheduled update of your tweetss. Essentially it performs the same task as clicking the “Update Blogs” button but automatically. This process is recommended for the best results with this plugin.
- Will I experience any permission issues with the data cache storage/usage?
No, the plugin has been designed to automatically save the data cache to the WordPress database, this should prevent any file/folder permission issues.