This is an old revision of the document!
The Twitter Feed addon allows your site's users to enter their Twitter username during the listing placement process. If they do so, their most recent Tweets will appear in a customizable module that you can place anywhere on the listing details page, by inserting the addon tag {addon author='geo_addons' addon='twitter_feed' tag='show_feed'} into your classified and/or auctions details template. Beginning with Geo 5.2.0, this addon tag will be in the appropriate templates by default. If you're upgrading from a version earlier than that, you will need to insert it yourself to properly use the addon.
There are a number of settings available in the Admin for the Twitter Feed, found at Addons > Twitter Feed > Settings. The rest of this page will explain how these settings affect the feed's display.
The Default option will cause a seller's tweets to be loaded one at a time and automatically scroll through the feed display. The Alternate option loads all of the tweets to be shown at once, and adds a scrollbar for the user to scroll between them at will.
This setting is only used when Scroll Behavior is set to Default. It controls the time in seconds between each individual tweet being loaded
This setting controls the maximum number of unique tweets that will be shown in the feed at a single time. Note: the number of tweets that physically appear on the page is a function of the height setting. This setting is the "total" number of tweets that may be scrolled through.
If you enter a valid Twitter username here, that user's tweets will be shown when a seller does not enter a specific username for a listing. In other words, if you have a Twitter account for your site, you could use this to have it appear in listings where the listing's seller doesn't have a Twitter account of his own. If you leave this field blank, and the seller does not enter a username during the listing placement process, the twitter feed will not appear at all for that listing.
Binary toggles to determine whether these elements will be shown in incoming tweets. You can choose to show or not show any of the following elements in tweets in your feed.
One-word descriptors sometimes added by a Twitter user to the end of a tweet, usually to provide aggregation with other users on the Twitter site, e.g., given a tweet that says: Our tree has lots of lights this year. #Christmas, #Christmas is a hashtag, used to provide context to why a tree might have lights, and to associate that tweet with other yuletide-themed tweets.
The text added to a tweet in the feed display that says how long ago the tweet was written. E.g., "less than an hour ago"
The user-specific image that appears to the left of each tweet.
Controls the height and width, in pixels, of the feed display. You can optionally select the 'auto-detect' box for width, which will cause the feed to stretch horizontally to fully take up its parent HTML element's width.
HTML color codes used to set colors on the feed display. Note that you must use hexadecimal HTML color codes: FF0000 is valid, but red is not. For more information on HTML color codes, and examples of common color choices, see this page. Note that, in the Twitter Feed addon, the "#" sign is already included for you.