Difference between revisions of "Twitter"
| Line 36: | Line 36: | ||
# [[Extract the Twitter Application]]. | # [[Extract the Twitter Application]]. | ||
| − | # [[Site Configuration]]. | + | # [[Twitter_Site_Configuration|Site Configuration]]. |
# [[ADF Configuration for the Twitter App]]. | # [[ADF Configuration for the Twitter App]]. | ||
| − | # [[Import Elements]]. | + | # [[Twitter_Import_Elements|Import Elements]]. |
== Features == | == Features == | ||
The Twitter application provides the following features: | The Twitter application provides the following features: | ||
| − | * [[Follow Button Element]]. | + | * [[Twitter_App_Follow_Button_Element|Follow Button Element]]. |
| − | * [[Tweet Box Element]]. | + | * [[Twitter_App_Tweet_Box_Element|Tweet Box Element]]. |
| − | * [[Tweet Button Element]]. | + | * [[Twitter_App_Tweet_Button_Element|Tweet Button Element]]. |
| − | * [[AddHovercards Function]]. | + | * [[Twitter_App_AddHovercards_Function|AddHovercards Function]]. |
| − | * [[ShortenURL Function]]. | + | * [[Twitter_App_ShortenURL_Function|ShortenURL Function]]. |
== Troubleshooting == | == Troubleshooting == | ||
| Line 52: | Line 52: | ||
== Known Issues/Bugs == | == Known Issues/Bugs == | ||
| − | Found a bug? View the [[Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed. | + | Found a bug? View the [[Twitter_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed. |
[[Category:Project]] | [[Category:Project]] | ||
[[Category:Twitter]] | [[Category:Twitter]] | ||
Revision as of 20:28, 13 August 2010
Contents
About Twitter App
The Twitter application is built in the Application Development Framework (ADF).
Overview
The Twitter ADF App provides the ability to use Twitter's @Anywhere framework to add the following features to your site:
- Hovercards: The Hovercard functionality is implemented as a function in the ADF app which any developer can add to a template or page to enable the feature.
- Follow Buttons: This Custom Element adds a Follow Button to any page. Developers can also add Follow Buttons programmatically by calling a function in the ADF application.
- Tweet Box: This Custom Element adds a Tweet Box on a page, you have the option of pre-populating the box with text and even with a link to the page the element is on. If you want to include the link, it is shortened using Bit.ly via their API. The Tweet Box allows your site visitors to tweet directly from your site.
- TweetMeme Tweet Button: This is another option for allowing users to tweet directly from your site, it uses TweetMeme.com’s own API to provide a "Tweet this" button on a page. The functionality overlaps a little with the Tweet Box, but unlike that feature, this button is much smaller on a page and it includes a count of how many times the page's link has been tweeted.
- Bit.ly URL Shortening: The same ADF function that the Tweet Box Custom Element uses is available to any developer, it takes a normal URL and returns a shortened version of it using Bit.ly's API.
Requirements
ADF Library components that are required for the Twitter App:
- scripts_1_0
ADF must be configured correctly for your site. Site Configuration (ADF.cfc) has instructions for configuration.
Contents
The Twitter App contains the following:
- Custom Coding - various components and scripts.
- Custom Elements:
- Follow Button - Custom Element.
- Tweet Box - Custom Element.
- Tweet Button - Custom Element.
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types
Pre-installation Considerations
Application Development Framework (ADF) must be setup and configured on the server for the site that will be implementing the Twitter application. For detailed instructions, see the Application Development Framework (ADF) wiki page for Site Configurations.
This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above. Before the installation of the Twitter App, remove any Custom Elements/Metadata Forms with the names contained in the "Contents" section above. (If you do not remove existing elements with these names, you may have difficulties during the installation.)
Installation/Setup
Each of the following steps should be completed fully and in the order presented:
- Extract the Twitter Application.
- Site Configuration.
- ADF Configuration for the Twitter App.
- Import Elements.
Features
The Twitter application provides the following features:
- Follow Button Element.
- Tweet Box Element.
- Tweet Button Element.
- AddHovercards Function.
- ShortenURL Function.
Troubleshooting
Don't forget to add your Twitter @Anywhere Consumer Key and Consumer Secret values to the papertweet.xml configuration file. Also add your Bit.ly login and key to this same file.
Known Issues/Bugs
Found a bug? View the Known Issues/Bugs wiki page. Your issue not on the list? Post it so the issue can be addressed.
