Twitter - Revision history

Cmora: /* Troubleshooting */

2010-08-16T19:29:17Z

‎Troubleshooting

Cmora at 20:28, 13 August 2010

2010-08-13T20:28:22Z

Cmora at 20:24, 13 August 2010

2010-08-13T20:24:37Z

Cmora: Created page with '== About Twitter App == The Twitter application is built in the Application Development Framework (ADF). == Overview == The Twitter ADF App provides the ability to …'

2010-08-13T19:54:40Z

Created page with '== About Twitter App == The Twitter application is built in the Application Development Framework (ADF). == Overview == The Twitter ADF App provides the ability to …'

New page

== About Twitter App ==
The Twitter application is built in the [[Overview|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 ==
[[Overview|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 [[Overview|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]].
# [[ADF Configuration for the Twitter App]].
# [[Site Configuration]].
# [[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.

[[Category:Project]]
[[Category:Twitter]]

@@ Line 49: / Line 49: @@
 == 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.
+Don't forget to add your Twitter @Anywhere Consumer Key and Consumer Secret values to the twitter.xml configuration file. Also add your Bit.ly login and key to this same file.
 == Known Issues/Bugs ==

@@ Line 36: / Line 36: @@
 # [[Extract the Twitter Application]].
-# [[Site Configuration]].
+# [[Twitter_Site_Configuration|Site Configuration]].
 # [[ADF Configuration for the Twitter App]].
-# [[Import Elements]].
+# [[Twitter_Import_Elements|Import Elements]].
 == 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 ==
@@ Line 52: / Line 52: @@
 == 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:Twitter]]