http://community.paperthin.com/adf-docs/api.php?action=feedcontributions&user=Cmora&feedformat=atomADF Docs - User contributions [en]2024-03-29T05:16:17ZUser contributionsMediaWiki 1.29.0http://community.paperthin.com/adf-docs/index.php?title=Facebook_App_Post_to_FB_Page_CFT&diff=4128Facebook App Post to FB Page CFT2010-09-01T19:40:45Z<p>Cmora: Created page with '== Overview == The Post to Facebook Page Custom Field allows you to publish a message to a Facebook Page that you are an admin for, directly from CommonSpot. To accomplish this a…'</p>
<hr />
<div>== Overview ==<br />
The Post to Facebook Page Custom Field allows you to publish a message to a Facebook Page that you are an admin for, directly from CommonSpot. To accomplish this add this Custom Field Type to one of your Custom Elements and you'll be able to publish to your Facebook Page while editing the content of your Custom Element.<br />
<br />
== Setup ==<br />
1. Import the ''Post to Facebook Page'' custom field type. <br /> <br /><br />
'''Note:''' Verify the paths for the Property and Render modules point to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Post to Facebook Page custom field, follow these steps:<br />
# Create a new custom element and add a new field that has the ''Post to Facebook Page'' Custom Field Type as its type.<br />
#* '''Note:''' You may want to add this field in its own tab.<br />
# Add any other fields you want.<br />
# Create a new page and place your new element on the page. <br />
# Click the 'New Data' button.<br />
# If you're presented with a Facebook Login button click it and accept the link between your Facebook application and your Facebook account.<br />
#* '''Note:''' Even if you've already linked your account to the application, in order to be able to post to the page the app will request more privileges which you'll be ask to accept at this point. This will happen only once.<br />
# Once your account is linked to the app, you'll see a drop-down asking you to select a page.<br />
#* '''Important:''' You '''have to be an admin''' for at lease one Facebook Page in order to be able to use this feature. This feature '''does not''' post to your personal Facebook account.<br />
# Select a page and type in the message you want to post to Facebook.<br />
# Click Save and the Custom Element data will be saved and your message will be posted. You'll get a confirmation of the post.<br />
<br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4126Facebook2010-09-01T18:37:48Z<p>Cmora: /* Features */</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
* '''Post to Facebook Page''': Allows your contributors to post to a Facebook Page they are an admin for, directly from CommonSpot.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Facebook App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Facebook App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
* '''Custom Fields:'''<br />
** Post to Facebook Page.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[Overview|Application Development Framework (ADF)]] must be setup and configured on the server for the site that will be implementing the Facebook application. For detailed instructions, see the [[Overview|Application Development Framework (ADF)]] wiki page for Site Configurations.<br />
<br />
This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above. Before the installation of the Facebook App, remove any Custom Elements/Custom Field Types 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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
* [[Facebook_App_Post_to_FB_Page_CFT|Post to Facebook Page Custom Field]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4125Facebook2010-09-01T18:37:24Z<p>Cmora: /* Installation/Setup */</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
* '''Post to Facebook Page''': Allows your contributors to post to a Facebook Page they are an admin for, directly from CommonSpot.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Facebook App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Facebook App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
* '''Custom Fields:'''<br />
** Post to Facebook Page.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[Overview|Application Development Framework (ADF)]] must be setup and configured on the server for the site that will be implementing the Facebook application. For detailed instructions, see the [[Overview|Application Development Framework (ADF)]] wiki page for Site Configurations.<br />
<br />
This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above. Before the installation of the Facebook App, remove any Custom Elements/Custom Field Types 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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
* [[Facebook_App_Post_to_FB_Page_CFT|Post to Facebook Page Custom Field Type]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4124Facebook2010-09-01T18:36:32Z<p>Cmora: /* Contents */</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
* '''Post to Facebook Page''': Allows your contributors to post to a Facebook Page they are an admin for, directly from CommonSpot.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Facebook App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Facebook App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
* '''Custom Fields:'''<br />
** Post to Facebook Page.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[Overview|Application Development Framework (ADF)]] must be setup and configured on the server for the site that will be implementing the Facebook application. For detailed instructions, see the [[Overview|Application Development Framework (ADF)]] wiki page for Site Configurations.<br />
<br />
This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above. Before the installation of the Facebook App, remove any Custom Elements/Custom Field Types 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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
# [[Facebook_Import_CFTs|Import Custom Field Types]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
* [[Facebook_App_Post_to_FB_Page_CFT|Post to Facebook Page Custom Field Type]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4123Facebook2010-09-01T18:34:49Z<p>Cmora: /* Features */</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
* '''Post to Facebook Page''': Allows your contributors to post to a Facebook Page they are an admin for, directly from CommonSpot.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Facebook App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Facebook App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
* '''Custom Field Types:'''<br />
** [[Post to Facebook Page]] - Custom Field Type.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[Overview|Application Development Framework (ADF)]] must be setup and configured on the server for the site that will be implementing the Facebook application. For detailed instructions, see the [[Overview|Application Development Framework (ADF)]] wiki page for Site Configurations.<br />
<br />
This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above. Before the installation of the Facebook App, remove any Custom Elements/Custom Field Types 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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
# [[Facebook_Import_CFTs|Import Custom Field Types]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
* [[Facebook_App_Post_to_FB_Page_CFT|Post to Facebook Page Custom Field Type]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4122Facebook2010-09-01T18:34:02Z<p>Cmora: /* Installation/Setup */</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
* '''Post to Facebook Page''': Allows your contributors to post to a Facebook Page they are an admin for, directly from CommonSpot.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Facebook App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Facebook App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
* '''Custom Field Types:'''<br />
** [[Post to Facebook Page]] - Custom Field Type.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[Overview|Application Development Framework (ADF)]] must be setup and configured on the server for the site that will be implementing the Facebook application. For detailed instructions, see the [[Overview|Application Development Framework (ADF)]] wiki page for Site Configurations.<br />
<br />
This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above. Before the installation of the Facebook App, remove any Custom Elements/Custom Field Types 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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
# [[Facebook_Import_CFTs|Import Custom Field Types]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4121Facebook2010-09-01T18:32:46Z<p>Cmora: /* Pre-installation Considerations */</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
* '''Post to Facebook Page''': Allows your contributors to post to a Facebook Page they are an admin for, directly from CommonSpot.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Facebook App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Facebook App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
* '''Custom Field Types:'''<br />
** [[Post to Facebook Page]] - Custom Field Type.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[Overview|Application Development Framework (ADF)]] must be setup and configured on the server for the site that will be implementing the Facebook application. For detailed instructions, see the [[Overview|Application Development Framework (ADF)]] wiki page for Site Configurations.<br />
<br />
This installation guide assumes that you have no Custom Elements/Metadata Forms with the names above. Before the installation of the Facebook App, remove any Custom Elements/Custom Field Types 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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4120Facebook2010-09-01T18:32:01Z<p>Cmora: /* Requirements */</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
* '''Post to Facebook Page''': Allows your contributors to post to a Facebook Page they are an admin for, directly from CommonSpot.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Facebook App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Facebook App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
* '''Custom Field Types:'''<br />
** [[Post to Facebook Page]] - Custom Field Type.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[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.<br />
<br />
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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4119Facebook2010-09-01T18:31:29Z<p>Cmora: /* Contents */</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
* '''Post to Facebook Page''': Allows your contributors to post to a Facebook Page they are an admin for, directly from CommonSpot.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Twitter App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Facebook App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
* '''Custom Field Types:'''<br />
** [[Post to Facebook Page]] - Custom Field Type.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[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.<br />
<br />
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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4118Facebook2010-09-01T18:30:21Z<p>Cmora: /* Overview */</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
* '''Post to Facebook Page''': Allows your contributors to post to a Facebook Page they are an admin for, directly from CommonSpot.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Twitter App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Twitter App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[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.<br />
<br />
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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook_App_Known_Issues_Bugs&diff=4068Facebook App Known Issues Bugs2010-08-17T19:17:33Z<p>Cmora: Created page with '== Known Issues/Bugs == * There currently are no known issues or bugs, if you find one please report it here so it can be adressed. Category:Facebook[[Category:Known Issues]…'</p>
<hr />
<div>== Known Issues/Bugs ==<br />
* There currently are no known issues or bugs, if you find one please report it here so it can be adressed.<br />
<br />
[[Category:Facebook]][[Category:Known Issues]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook_App_Login_Friendpile_Element&diff=4067Facebook App Login Friendpile Element2010-08-17T19:15:17Z<p>Cmora: Created page with '== Overview == The Login/Friendpile Custom Element allows you to put a Facebook Login button on your site so that users can "connect" their Facebook accounts with it. Once the us…'</p>
<hr />
<div>== Overview ==<br />
The Login/Friendpile Custom Element allows you to put a Facebook Login button on your site so that users can "connect" their Facebook accounts with it. Once the user is connected and logged into Facebook, you can show a Friendpile of their friends who are also connected to your site. You also have the option of just adding the Friendpile without the login button<br />
<br />
== Setup ==<br />
1. Import the ''Login-Friendpile'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Login/Friendpile custom element, follow these steps:<br />
# Create a new page and place the ''Login/Friendpile'' element on the page. <br />
# Click the 'New Data' button.<br />
# Configure the Element by choosing its functionality.<br />
#* '''Note:''' At least one of the following radio buttons must be set to True.<br />
## Choose to show the Login button or not when the user is logged out of Facebook.<br />
## Now, chose to show the Facepile once the user is logged in or not.<br />
# Edit the rest of the custom element data to your liking (or just leave the defaults) and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook_App_Friendpile_Element&diff=4066Facebook App Friendpile Element2010-08-17T19:09:32Z<p>Cmora: Created page with '== Overview == The Friendpile Custom Element shows profile pictures of the user's friends who have already signed up for your site. == Setup == 1. Import the ''Friendpile'' cust…'</p>
<hr />
<div>== Overview ==<br />
The Friendpile Custom Element shows profile pictures of the user's friends who have already signed up for your site.<br />
<br />
== Setup ==<br />
1. Import the ''Friendpile'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Friendpile custom element, follow these steps:<br />
# Create a new page and place the ''Friendpile'' element on the page. <br />
# Click the 'New Data' button.<br />
# Edit the custom element data to your liking (or just leave the defaults) and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook_App_Like_Box_Element&diff=4065Facebook App Like Box Element2010-08-17T19:07:29Z<p>Cmora: </p>
<hr />
<div>== Overview ==<br />
The Like Box enables users to like your Facebook Page and view its stream directly from your website.<br />
<br />
== Setup ==<br />
1. Import the ''Like Box'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Like Box custom element, follow these steps:<br />
# Create a new page and place the ''Like Box'' element on the page. <br />
# Click the 'New Data' button.<br />
# Enter your Facebook Page's Page ID. If you don't know the ID for your Facebook Page, an easy way is to go to your Facebook Page and click on its profile picture. Once the page loads you'll see that the URL in the address bar ends with "id=xxxxxxxxxxxxxxxx", that number is your Facebook Page's Page ID.<br />
# Edit the rest of the custom element data to your liking (or just leave the defaults) and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook_App_Like_Box_Element&diff=4064Facebook App Like Box Element2010-08-17T18:59:55Z<p>Cmora: Created page with '== Overview == The Like Box enables users to like your Facebook Page and view its stream directly from your website. == Setup == 1. Import the ''Like Box'' custom element. <br /…'</p>
<hr />
<div>== Overview ==<br />
The Like Box enables users to like your Facebook Page and view its stream directly from your website.<br />
<br />
== Setup ==<br />
1. Import the ''Like Box'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Like Box custom element, follow these steps:<br />
# Create a new page and place the ''Like Box'' element on the page. <br />
# Click the 'New Data' button.<br />
# Edit the custom element data to your liking (or just leave the defaults) and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook_App_Activity_Feed_Element&diff=4063Facebook App Activity Feed Element2010-08-17T18:58:11Z<p>Cmora: /* Demo */</p>
<hr />
<div>== Overview ==<br />
A Activity Feed custom element was developed using Facebook's Social Plugins API. It is extremely easy to use.<br /><br /><br />
It displays the most interesting recent activity taking place on your site. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into your site. The activity feed displays stories both when users like content on your site and when users share content from your site back to Facebook.<br />
<br />
== Setup ==<br />
1. Import the ''Activity Feed'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Activity Feed custom element, follow these steps:<br />
# Create a new page and place the ''Activity Feed'' element on the page. <br />
# Click the 'New Data' button.<br />
# Edit the custom element data to your liking (or just leave the defaults) and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook_App_Comments_Box_Element&diff=4062Facebook App Comments Box Element2010-08-17T18:57:36Z<p>Cmora: Created page with '== Overview == The Comments Box easily enables your users to comment on your site's content — whether it's for a web page, article, photo, or other piece of content. Then the u…'</p>
<hr />
<div>== Overview ==<br />
The Comments Box easily enables your users to comment on your site's content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
<br />
== Setup ==<br />
1. Import the ''Comments Box'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Comments Box custom element, follow these steps:<br />
# Create a new page and place the ''Comments Box'' element on the page. <br />
# Click the 'New Data' button.<br />
# Edit the custom element data to your liking (or just leave the defaults) and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook_App_Activity_Feed_Element&diff=4061Facebook App Activity Feed Element2010-08-17T18:55:28Z<p>Cmora: Created page with '== Overview == A Activity Feed custom element was developed using Facebook's Social Plugins API. It is extremely easy to use.<br /><br /> It displays the most interesting recent …'</p>
<hr />
<div>== Overview ==<br />
A Activity Feed custom element was developed using Facebook's Social Plugins API. It is extremely easy to use.<br /><br /><br />
It displays the most interesting recent activity taking place on your site. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into your site. The activity feed displays stories both when users like content on your site and when users share content from your site back to Facebook.<br />
<br />
== Setup ==<br />
1. Import the ''Activity Feed'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
# Create a new page and place the ''Activity Feed'' element on the page. <br />
# Click the 'New Data' button.<br />
# Edit the custom element data to your liking (or just leave the defaults) and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_Site_Configuration&diff=4051Twitter Site Configuration2010-08-17T18:38:22Z<p>Cmora: /* Configuration Fields */</p>
<hr />
<div>== Overview ==<br />
The Twitter App uses an XML file to store site specific configurations. The Twitter App needs to know your Twitter @Anywhere account's Consumer Key and Consumer Secret, as well as your Bit.ly account's Login and Key.<br />
<br />
== Configuration Fields ==<br />
If you haven't created a Twitter @Anywhere app, go to [http://dev.twitter.com/anywhere Twitter's @Anywhere site] for more details. Read that page and hit [http://dev.twitter.com/apps/new this link] to register your Twitter application.<br />
Also [http://bit.ly/a/sign_up sign up for Bit.ly] to be able to take advantage of their free URL shortening service.<br />
<br />
Don't worry you will not have to write a single line of code to use these two API's, we just need to add those values to the configuration XML file in any text editor (like Notepad).<br />
<br />
There are four components in the configuration XML file:<br />
# '''consumerKey''' - You can find this in your Twitter @Anywhere app's properties.<br />
# '''consumerSecret''' - Also in your Twitter @Anywhere app's properties.<br />
# '''bitlyLogin''' - The username you just registered on Bit.ly's site.<br />
# '''bitlyKey''' - Bit.ly's API key.<br />
<br />
== Final Step ==<br />
Once your configuration XML file (twitter.xml) has been updated with the correct values from your Twitter App's and Bit.ly's registrations, '''move the XML file to the /cs_apps/config/ folder'''.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Login/Friendpile&diff=4049Login/Friendpile2010-08-17T18:32:09Z<p>Cmora: Created page with '== Overview == Login/Friendpile Custom Element. This element allows you to put a Facebook Login button on your site so that users can "connect" their Facebook accounts with it. O…'</p>
<hr />
<div>== Overview ==<br />
Login/Friendpile Custom Element. This element allows you to put a Facebook Login button on your site so that users can "connect" their Facebook accounts with it. Once the user is connected and logged into Facebook, you can show a Friendpile of their friends who are also connected to your site. You also have the option of just adding the Friendpile without the login button.<br />
<br />
== Fields ==<br />
<h3>Login/Friendpile</h3><br />
<table id="ce-fields"><br />
<tr class="header"><br />
<td>Field Name/Label</td><br />
<td>Field ID</td><br />
<td>Field Type</td><br />
<td>Required?</td><br />
<td>Properties</td><br />
</tr><br />
<tr><br />
<td>Show Login Button</td><br />
<td>showLogin</td><br />
<td>Radio button</td><br />
<td>Yes</td><br />
<td>None</td><br />
</tr><br />
<tr><br />
<td>Show Faces</td><br />
<td>showFaces</td><br />
<td>Radio button</td><br />
<td>No</td><br />
<td>None</td><br />
</tr><br />
<tr><br />
<td>Rows</td><br />
<td>max_rows</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>Degault Value: 1</td><br />
</tr><br />
<tr><br />
<td>Width</td><br />
<td>width</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>Degault Value: 200</td><br />
</tr><br />
</table><br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Like_Button&diff=4048Like Button2010-08-17T18:26:36Z<p>Cmora: Created page with '== Overview == Like Button Custom Element which adds Facebook's Like button to a page, allows users to share interesting pages on Facebook. == Fields == <h3>Like Button</h3> <ta…'</p>
<hr />
<div>== Overview ==<br />
Like Button Custom Element which adds Facebook's Like button to a page, allows users to share interesting pages on Facebook.<br />
<br />
== Fields ==<br />
<h3>Like Button</h3><br />
<table id="ce-fields"><br />
<tr class="header"><br />
<td>Field Name/Label</td><br />
<td>Field ID</td><br />
<td>Field Type</td><br />
<td>Required?</td><br />
<td>Properties</td><br />
</tr><br />
<tr><br />
<td>Action</td><br />
<td>action</td><br />
<td>Selection List</td><br />
<td>No</td><br />
<td>Options: Like, Recommend</td><br />
</tr><br />
<tr><br />
<td>Layout</td><br />
<td>layout</td><br />
<td>Selection List</td><br />
<td>No</td><br />
<td>Options: Standard, Button_Count</td><br />
</tr><br />
<tr><br />
<td>Show Faces</td><br />
<td>showFaces</td><br />
<td>Radio button</td><br />
<td>No</td><br />
<td>Default value: True</td><br />
</tr><br />
<tr><br />
<td>Color Scheme</td><br />
<td>colorScheme</td><br />
<td>Selection List</td><br />
<td>No</td><br />
<td>Options: Light, Dark</td><br />
</tr><br />
<tr><br />
<td>Font</td><br />
<td>font</td><br />
<td>Selection List</td><br />
<td>No</td><br />
<td>Options: Arial, Lucida Grande, Tahoma, Trebuchet MS, Verdana</td><br />
</tr><br />
<tr><br />
<td>Width</td><br />
<td>width</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>Degault Value: 400</td><br />
</tr><br />
</table><br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Like_Box&diff=4047Like Box2010-08-17T18:17:46Z<p>Cmora: Created page with '== Overview == Like Box Custom Element that enables users to like your Facebook Page and view its stream directly on your website. == Fields == <h3>Like Box Feed</h3> <table id=…'</p>
<hr />
<div>== Overview ==<br />
Like Box Custom Element that enables users to like your Facebook Page and view its stream directly on your website.<br />
<br />
== Fields ==<br />
<h3>Like Box Feed</h3><br />
<table id="ce-fields"><br />
<tr class="header"><br />
<td>Field Name/Label</td><br />
<td>Field ID</td><br />
<td>Field Type</td><br />
<td>Required?</td><br />
<td>Properties</td><br />
</tr><br />
<tr><br />
<td>Page ID</td><br />
<td>pageID</td><br />
<td>Number (integer)</td><br />
<td>Yes</td><br />
<td>None</td><br />
</tr><br />
<tr><br />
<td>Show Stream</td><br />
<td>stream</td><br />
<td>Checkbox</td><br />
<td>N/A</td><br />
<td>Checked by default</td><br />
</tr><br />
<tr><br />
<td>Show Header</td><br />
<td>header</td><br />
<td>Checkbox</td><br />
<td>N/A</td><br />
<td>Not checked by default</td><br />
</tr><br />
<tr><br />
<td>Width</td><br />
<td>width</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>None</td><br />
</tr><br />
<tr><br />
<td>Connections</td><br />
<td>connections</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>10</td><br />
</tr><br />
</table><br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Friendpile&diff=4046Friendpile2010-08-17T18:10:44Z<p>Cmora: Created page with '== Overview == Friendpile Custom Element that shows a collage of Facebook profile pictures of your site's fans. == Fields == <h3>Friendpile</h3> <table id="ce-fields"> <tr class…'</p>
<hr />
<div>== Overview ==<br />
Friendpile Custom Element that shows a collage of Facebook profile pictures of your site's fans.<br />
<br />
== Fields ==<br />
<h3>Friendpile</h3><br />
<table id="ce-fields"><br />
<tr class="header"><br />
<td>Field Name/Label</td><br />
<td>Field ID</td><br />
<td>Field Type</td><br />
<td>Required?</td><br />
<td>Properties</td><br />
</tr><br />
<tr><br />
<td>Rows</td><br />
<td>max_rows </td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>Default Value: 1</td><br />
</tr><br />
<tr><br />
<td>Width</td><br />
<td>width</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>Default Value: 200</td><br />
</tr><br />
</table><br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Activity_Feed&diff=4045Activity Feed2010-08-17T18:06:12Z<p>Cmora: /* Overview */</p>
<hr />
<div>== Overview ==<br />
Activity Feed Custom Element for allowing users to view what their friends are sharing on your site.<br />
<br />
== Fields ==<br />
<h3>Activity Feed</h3><br />
<table id="ce-fields"><br />
<tr class="header"><br />
<td>Field Name/Label</td><br />
<td>Field ID</td><br />
<td>Field Type</td><br />
<td>Required?</td><br />
<td>Properties</td><br />
</tr><br />
<tr><br />
<td>Show Header</td><br />
<td>header</td><br />
<td>Checkbox</td><br />
<td>N/A</td><br />
<td>Checked by default</td><br />
</tr><br />
<tr><br />
<td>Recommendations</td><br />
<td>recommendations</td><br />
<td>Checkbox</td><br />
<td>N/A</td><br />
<td>Not checked by default</td><br />
</tr><br />
<tr><br />
<td>Color Scheme</td><br />
<td>colorScheme</td><br />
<td>Selection List</td><br />
<td>No</td><br />
<td>Options: Light, Dark</td><br />
</tr><br />
<tr><br />
<td>Font</td><br />
<td>font</td><br />
<td>Selection List</td><br />
<td>No</td><br />
<td>Options: Arial, Lucida Grande, Tahoma, Trebuchet MS, Verdana</td><br />
</tr><br />
<tr><br />
<td>Height</td><br />
<td>height</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>None</td><br />
</tr><br />
<tr><br />
<td>Width</td><br />
<td>width</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>None</td><br />
</tr><br />
</table><br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Comments_Box&diff=4044Comments Box2010-08-17T18:05:32Z<p>Cmora: Created page with '== Overview == Comments Box Custom Element for allowing users to post comments on your site's pages and share those comments, along with a link to the page, with their friends on…'</p>
<hr />
<div>== Overview ==<br />
Comments Box Custom Element for allowing users to post comments on your site's pages and share those comments, along with a link to the page, with their friends on Facebook.<br />
<br />
== Fields ==<br />
<h3>Comments Box</h3><br />
<table id="ce-fields"><br />
<tr class="header"><br />
<td>Field Name/Label</td><br />
<td>Field ID</td><br />
<td>Field Type</td><br />
<td>Required?</td><br />
<td>Properties</td><br />
</tr><br />
<tr><br />
<td>Number of Comments</td><br />
<td>numPosts</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>Default Value: 10</td><br />
</tr><br />
<tr><br />
<td>Width</td><br />
<td>width</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>None</td><br />
</tr><br />
</table><br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Activity_Feed&diff=4041Activity Feed2010-08-17T18:00:38Z<p>Cmora: Created page with '== Overview == Activity Feed Custom Element for allowing users view what their friends are sharing on your site. == Fields == <h3>Activity Feed</h3> <table id="ce-fields"> <tr c…'</p>
<hr />
<div>== Overview ==<br />
Activity Feed Custom Element for allowing users view what their friends are sharing on your site.<br />
<br />
== Fields ==<br />
<h3>Activity Feed</h3><br />
<table id="ce-fields"><br />
<tr class="header"><br />
<td>Field Name/Label</td><br />
<td>Field ID</td><br />
<td>Field Type</td><br />
<td>Required?</td><br />
<td>Properties</td><br />
</tr><br />
<tr><br />
<td>Show Header</td><br />
<td>header</td><br />
<td>Checkbox</td><br />
<td>N/A</td><br />
<td>Checked by default</td><br />
</tr><br />
<tr><br />
<td>Recommendations</td><br />
<td>recommendations</td><br />
<td>Checkbox</td><br />
<td>N/A</td><br />
<td>Not checked by default</td><br />
</tr><br />
<tr><br />
<td>Color Scheme</td><br />
<td>colorScheme</td><br />
<td>Selection List</td><br />
<td>No</td><br />
<td>Options: Light, Dark</td><br />
</tr><br />
<tr><br />
<td>Font</td><br />
<td>font</td><br />
<td>Selection List</td><br />
<td>No</td><br />
<td>Options: Arial, Lucida Grande, Tahoma, Trebuchet MS, Verdana</td><br />
</tr><br />
<tr><br />
<td>Height</td><br />
<td>height</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>None</td><br />
</tr><br />
<tr><br />
<td>Width</td><br />
<td>width</td><br />
<td>Number (integer)</td><br />
<td>No</td><br />
<td>None</td><br />
</tr><br />
</table><br />
<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Facebook&diff=4039Facebook2010-08-17T17:49:01Z<p>Cmora: Created page with '== About the Facebook App == The Facebook application is an update to the old Paperbook application. Both were built in the Application Development Framework (ADF). …'</p>
<hr />
<div>== About the Facebook App ==<br />
The Facebook application is an update to the old Paperbook application. Both were built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Facebook ADF App provides the ability to use Facebook's new Social Plugins APIs to add the following features to your site:<br />
<br />
* '''Activity Feed''': It displays the most interesting recent activity taking place on the site, as determined by Facebook's algorithms. Since the content is hosted by Facebook, the plugin can display personalized content whether or not the user has logged into (connected to) the site. The activity feed displays stories both when users like content on the site and when users share content from the site back to Facebook.<br />
* '''Commnets Box''': It enables visitors to the site to comment on its content — whether it's for a web page, article, photo, or other piece of content. Then the user can share the comment on Facebook on their Wall and in their friends' streams.<br />
* '''Friend Pile''': It shows profile pictures of the user's friends who have already signed up for the site via a Login Button.<br />
* '''Like Button''': Allows users to share interesting pages from the site on Facebook.<br />
* '''Like Box''': Enables users to like your Facebook Page and view its stream directly from the website.<br />
* '''Log in Button''': Allows users to "connect" their Facebook accounts with your site.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Twitter App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Twitter App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Activity Feed]] - Custom Element.<br />
** [[Comments Box]] - Custom Element.<br />
** [[Friendpile]] - Custom Element.<br />
** [[Like Box]] - Custom Element.<br />
** [[Like Button]] - Custom Element.<br />
** [[Login/Friendpile]] - Custom Element.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[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.<br />
<br />
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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Facebook Application]].<br />
# [[Facebook_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Facebook App]].<br />
# [[Facebook_Import_Elements|Import Elements]].<br />
<br />
== Features ==<br />
The Facebook application provides the following features:<br />
* [[Facebook_App_Activity_Feed_Element|Activity Feed Element]].<br />
* [[Facebook_App_Comments_Box_Element|Comments Box Element]].<br />
* [[Facebook_App_Friendpile_Element|Friendpile Element]].<br />
* [[Facebook_App_Like_Box_Element|Like Box Element]].<br />
* [[Facebook_App_Login_Friendpile_Element|Login/Friendpile Element]].<br />
<br />
== Troubleshooting ==<br />
Don't forget to add your Facebook application's Application ID and Application Secret values to the facebook.xml configuration file.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Facebook_App_Known_Issues_Bugs|Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Facebook]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_ShortenURL_Function&diff=4005Twitter App ShortenURL Function2010-08-16T19:34:17Z<p>Cmora: </p>
<hr />
<div>== Overview ==<br />
The twitterService component contains a few functions you can take advantage off in your custom scritps. One of these functions is the shortenURL function. <br />
<br />
== Setup ==<br />
1. It is installed as part of the Twitter application's installation.<br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
* Create a new CFM file inside one of your subsite's customcf folder.<br />
* In this file add the following code:<br />
<source lang="java"><br />
<cfoutput><br />
#application.twitter.twitterService.shortenURL('http://something.com/some/long/url.html')#<br />
</cfoutput><br />
</source><br />
* Create a new page and place a ''Custom Script'' element on the page.<br />
* Click the 'Edit' button.<br />
* Select or type in the path to your new custom script.<br />
* Submit the changes to the page.<br />
* On the page you'll see the shortened URL, something like this:<br />
<source lang="java"><br />
http://bit.ly/abcdefg1234<br />
</source><br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_AddHovercards_Function&diff=4004Twitter App AddHovercards Function2010-08-16T19:33:44Z<p>Cmora: </p>
<hr />
<div>== Overview ==<br />
The twitterService component contains a few functions you can take advantage off in your custom scritps. One of these functions is the addHovercards function. <br />
<br />
== Setup ==<br />
1. It is installed as part of the Twitter application's installation.<br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
* Create a new CFM file inside one of your subsite's customcf folder.<br />
* In this file add the following code:<br />
<source lang="cfm"><br />
<cfoutput><br />
<div id="hovercards"><br />
<h3>Hovercards</h3><br />
Hover the mouse over my Twitter screen name @cvmora and the hovercard will pop up over it.<br />
The hovercards show the twitter pic and a button that allows you to follow me,<br />
or @commonspot.<br />
<br />
#application.twitter.twitterService.addHovercards('##hovercards')#<br />
</div><br />
</cfoutput><br />
</source><br />
* Note the '''##hovercards''' argument sent into the function:<br />
**If specified, it limits the scraping to the region identified by the CSS selector passed in. It can be a Class (.selectorName) or an ID (##selectorName).<br />
**If left blank the hovercard function scrapes the whole page for twitter usernames.<br />
* Create a new page and place a ''Custom Script'' element on the page.<br />
* Click the 'Edit' button.<br />
* Select or type in the path to your new custom script.<br />
* Submit the changes to the page.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_Follow_Button_Element&diff=4003Twitter App Follow Button Element2010-08-16T19:32:40Z<p>Cmora: /* Alternate Method */</p>
<hr />
<div>== Overview ==<br />
A Follow Button custom element was developed using Twitter's @Anywhere API. It is extremely easy to use. <br />
<br />
== Setup ==<br />
1. Import the ''Follow Button'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
# Create a new page and place the ''Follow Button'' element on the page. <br />
# Click the 'New Data' button.<br />
# Type in the Twitter username for the button and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
== Alternate Method ==<br />
You can also add Follow Buttons programatically inside a Custom Script like this:<br />
<source lang="cfm"><br />
<cfoutput><br />
Follow buttons can be placed anywhere, like this one to follow CommonSpot:<br />
#application.twitter.twitterService.followButton('commonspot')#. <br /><br />
Notice that the button changes when it knows you are already following someone.<br />
</cfoutput><br />
</source><br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_Import_Elements&diff=4002Twitter Import Elements2010-08-16T19:32:09Z<p>Cmora: </p>
<hr />
<div>== Overview ==<br />
The Twitter Application has three Custom Components defined within CommonSpot. The components have been exported and are available in the app's "exported-objects" folder located at the root of the Twitter application directory (e.g. /ADF/apps/twitter/exported-objects/).<br />
<br />
Optional: You may want to create a new category within the CommonSpot Element Gallery for 'Twitter Elements'.<br />
<br />
To import these objects, you will need to be an administrator for your site. If you are not a site administrator, consult your Server administrator for more information.<br />
<br />
== Import ==<br />
Follow these steps to import the Custom Elements: <br />
<br />
# Go to your site's admin.cfm (CommonSpot's Site Administrator).<br />
# Expand the 'Elements & Forms' tab and click on 'Elements'.<br />
# In the Manage Elements screen click on 'Manage Categories'.<br />
# Now click the 'Add New Category' link and create a 'Twitter Elements' category.<br />
# Close the 'Manage Element Categories' screen.<br />
# Back in the 'Manage Elements' screen click on the 'Import Custom Element' link.<br />
# Now click on 'Browse...' and go to the /ADF/apps/twitter/exported-objects/ folder<br />
# Click on one of the ZIP files to import that custom element.<br />
# Be sure to choose your new 'Twitter Elements' category<br />
# Click Next.<br />
# Repeat steps 7-10 for other custom elements in the exported-objects folder.<br />
<br />
== Verify Imports ==<br />
The imported components' render handlers must be verified. During the import process, the render handler paths may have been changed to reflect the current site's path. <br />
<br />
Review and update these paths to reference the ADF path. In most cases, this will just require to be unlocked and a change in the path from the site name to 'ADF'.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=ADF_Configuration_for_the_Twitter_App&diff=4001ADF Configuration for the Twitter App2010-08-16T19:31:33Z<p>Cmora: /* Steps */</p>
<hr />
<div>== Overview ==<br />
The Twitter Application is built within the ADF. The ADF must be installed in the site to run the Twitter App, follow the ADF [[Installation]] instructions.<br />
<br />
== Steps ==<br />
* Make sure the ADF is setup and running on the site. If the ADF is not setup, then follow the instructions for ADF [[Installation]].<br />
* Open the sites 'ADF.cfc' ([[Site Configuration (ADF.cfc)|See Site Configuration (ADF.cfc) for more info]]) file (located in your site's /_cs_apps/ directory) in a text editor. Locate the ''Load the ADF Application into application space'' comment in the file. Add (or uncomment) the following command under the comment section:<br />
<source lang="java"><br />
loadApp("twitter");<br />
</source><br />
* [[Reset ADF|Reset the ADF]] for the server and site.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_Site_Configuration&diff=4000Twitter Site Configuration2010-08-16T19:31:00Z<p>Cmora: /* Final Step */</p>
<hr />
<div>== Overview ==<br />
The Twitter App uses an XML file to store site specific configurations. The Twitter App needs to know your Twitter @Anywhere account's Consumer Key and Consumer Secret, as well as your Bit.ly account's Login and Key.<br />
<br />
== Configuration Fields ==<br />
If you haven't created a Twitter @Anywhere app, go to this link for more details visit [http://dev.twitter.com/anywhere Twitter's @Anywhere site]. Read that page and hit [http://dev.twitter.com/apps/new this link] to register your Twitter application.<br />
Also [http://bit.ly/a/sign_up sign up for Bit.ly] to be able to take advantage of their free URL shortening service.<br />
<br />
Don't worry you will not have to write a single line of code to use these two API's, we just need to add those values to the configuration XML file in any text editor (like Notepad).<br />
<br />
There are four components in the configuration XML file:<br />
# '''consumerKey''' - You can find this in your Twitter @Anywhere app's properties.<br />
# '''consumerSecret''' - Also in your Twitter @Anywhere app's properties.<br />
# '''bitlyLogin''' - The username you just registered on Bit.ly's site.<br />
# '''bitlyKey''' - Bit.ly's API key.<br />
<br />
== Final Step ==<br />
Once your configuration XML file (twitter.xml) has been updated with the correct values from your Twitter App's and Bit.ly's registrations, '''move the XML file to the /cs_apps/config/ folder'''.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Extract_the_Twitter_Application&diff=3999Extract the Twitter Application2010-08-16T19:30:27Z<p>Cmora: </p>
<hr />
<div>Download the Twitter Application from the Community Site or from the SVN Repository. <br />
<br />
Extract the zip file into your '''/ADF/apps/''' folder. A subfolder called twitter will be created and will include all the code and the custom elements ready to be imported from the /ADF/apps/twitter/exported-objects/ folder. <br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter&diff=3998Twitter2010-08-16T19:29:17Z<p>Cmora: /* Troubleshooting */</p>
<hr />
<div>== About Twitter App ==<br />
The Twitter application is built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Twitter ADF App provides the ability to use Twitter's @Anywhere framework to add the following features to your site:<br />
<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Twitter App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Twitter App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Follow Button]] - Custom Element.<br />
** [[Tweet Box]] - Custom Element.<br />
** [[Tweet Button]] - Custom Element.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[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.<br />
<br />
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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Twitter Application]].<br />
# [[Twitter_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Twitter App]].<br />
# [[Twitter_Import_Elements|Import Elements]].<br />
<br />
== Features ==<br />
The Twitter application provides the following features:<br />
* [[Twitter_App_Follow_Button_Element|Follow Button Element]].<br />
* [[Twitter_App_Tweet_Box_Element|Tweet Box Element]].<br />
* [[Twitter_App_Tweet_Button_Element|Tweet Button Element]].<br />
* [[Twitter_App_AddHovercards_Function|AddHovercards Function]].<br />
* [[Twitter_App_ShortenURL_Function|ShortenURL Function]].<br />
<br />
== Troubleshooting ==<br />
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.<br />
<br />
== Known Issues/Bugs ==<br />
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.<br />
<br />
[[Category:Project]]<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=View_All&diff=3993View All2010-08-13T22:02:01Z<p>Cmora: /* All Projects */</p>
<hr />
<div>==All Projects==<br />
*[[Blogs|Blogs]]<br />
*[[CCAPI|CCAPI]]<br />
*[[PT_Forum_Overview|Forums]]<br />
*[[Import Content|Import Content]]<br />
*[[Multimedia|Multimedia]]<br />
*[[OHSU_Navigation|OHSU Navigation]]<br />
*[[Photo_Gallery|Photo Gallery]]<br />
*[[Portlet|Portlet]]<br />
*[[Profiles|Profiles]]<br />
*[[Starter Application]]<br />
*[[Calendar|Calendar]]<br />
*[[Twitter|Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_Known_Issues_Bugs&diff=3992Twitter App Known Issues Bugs2010-08-13T21:51:33Z<p>Cmora: Created page with '== Known Issues/Bugs == * [6.0] When in 6.0's CommonSpot Dashboard the Twitter @Anywhere elements disappear. This is a conflict with CommonSpot's UI and won't affect the site whe…'</p>
<hr />
<div>== Known Issues/Bugs ==<br />
* [6.0] When in 6.0's CommonSpot Dashboard the Twitter @Anywhere elements disappear. This is a conflict with CommonSpot's UI and won't affect the site when viewed directly.<br />
<br />
[[Category:Twitter]][[Category:Known Issues]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_ShortenURL_Function&diff=3991Twitter App ShortenURL Function2010-08-13T21:47:49Z<p>Cmora: Created page with '== Overview == The papertweetService component contains a few functions you can take advantage off in your custom scritps. One of these functions is the shortenURL function. ==…'</p>
<hr />
<div>== Overview ==<br />
The papertweetService component contains a few functions you can take advantage off in your custom scritps. One of these functions is the shortenURL function. <br />
<br />
== Setup ==<br />
1. It is installed as part of the Twitter application's installation.<br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
* Create a new CFM file inside one of your subsite's customcf folder.<br />
* In this file add the following code:<br />
<source lang="java"><br />
<cfoutput><br />
#application.papertweet.twitterService.shortenURL('http://something.com/some/long/url.html')#<br />
</cfoutput><br />
</source><br />
* Create a new page and place a ''Custom Script'' element on the page.<br />
* Click the 'Edit' button.<br />
* Select or type in the path to your new custom script.<br />
* Submit the changes to the page.<br />
* On the page you'll see the shortened URL, something like this:<br />
<source lang="java"><br />
http://bit.ly/abcdefg1234<br />
</source><br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_AddHovercards_Function&diff=3989Twitter App AddHovercards Function2010-08-13T21:42:24Z<p>Cmora: Created page with '== Overview == The papertweetService component contains a few functions you can take advantage off in your custom scritps. One of these functions is the addHovercards function. …'</p>
<hr />
<div>== Overview ==<br />
The papertweetService component contains a few functions you can take advantage off in your custom scritps. One of these functions is the addHovercards function. <br />
<br />
== Setup ==<br />
1. It is installed as part of the Twitter application's installation.<br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
* Create a new CFM file inside one of your subsite's customcf folder.<br />
* In this file add the following code:<br />
<source lang="cfm"><br />
<cfoutput><br />
<div id="hovercards"><br />
<h3>Hovercards</h3><br />
Hover the mouse over my Twitter screen name @cvmora and the hovercard will pop up over it.<br />
The hovercards show the twitter pic and a button that allows you to follow me,<br />
or @commonspot.<br />
<br />
#application.papertweet.twitterService.addHovercards('##hovercards')#<br />
</div><br />
</cfoutput><br />
</source><br />
* Note the '''##hovercards''' argument sent into the function:<br />
**If specified, it limits the scraping to the region identified by the CSS selector passed in. It can be a Class (.selectorName) or an ID (##selectorName).<br />
**If left blank the hovercard function scrapes the whole page for twitter usernames.<br />
* Create a new page and place a ''Custom Script'' element on the page.<br />
* Click the 'Edit' button.<br />
* Select or type in the path to your new custom script.<br />
* Submit the changes to the page.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_Tweet_Box_Element&diff=3980Twitter App Tweet Box Element2010-08-13T21:27:38Z<p>Cmora: </p>
<hr />
<div>== Overview ==<br />
The Tweet Box custom element was developed using Twitter's @Anywhere API. It is extremely easy to use. <br />
<br />
== Setup ==<br />
1. Import the ''Tweet Box'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Tweet Box custom element, follow these steps:<br />
# Create a new page and place the ''Tweet Box'' element on the page. <br />
# Click the 'New Data' button.<br />
# Customize the settings, or leave as is and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_Tweet_Button_Element&diff=3979Twitter App Tweet Button Element2010-08-13T21:26:48Z<p>Cmora: Created page with '== Overview == The Tweet Button custom element was developed using TweetMeme's API. It differs from the Tweet Box in that it is much smaller on the page, moving the text area for…'</p>
<hr />
<div>== Overview ==<br />
The Tweet Button custom element was developed using TweetMeme's API. It differs from the Tweet Box in that it is much smaller on the page, moving the text area for the tweet on to a popup window. It also features a counter of how many times the page has been retweeted. <br />
<br />
== Setup ==<br />
1. Import the ''Tweet Button'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
# Create a new page and place the ''Tweet Button'' element on the page. <br />
# Click the 'New Data' button.<br />
# Customize the settings, or leave as is and click '''Save'''. If you type a username in the field, the tweet box that pops up will be pre-populated with @''username'' so you can track these retweets thru Twitter.<br />
# Submit the changes to the page.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_Tweet_Box_Element&diff=3975Twitter App Tweet Box Element2010-08-13T21:21:57Z<p>Cmora: Created page with '== Overview == The Tweet Box custom element was developed using Twitter's @Anywhere API. It is extremely easy to use. == Setup == 1. Import the ''Tweet Box'' custom element. <b…'</p>
<hr />
<div>== Overview ==<br />
The Tweet Box custom element was developed using Twitter's @Anywhere API. It is extremely easy to use. <br />
<br />
== Setup ==<br />
1. Import the ''Tweet Box'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
# Create a new page and place the ''Follow Button'' element on the page. <br />
# Click the 'New Data' button.<br />
# Customize the settings, or leave as is and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_Follow_Button_Element&diff=3972Twitter App Follow Button Element2010-08-13T21:18:52Z<p>Cmora: </p>
<hr />
<div>== Overview ==<br />
A Follow Button custom element was developed using Twitter's @Anywhere API. It is extremely easy to use. <br />
<br />
== Setup ==<br />
1. Import the ''Follow Button'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
# Create a new page and place the ''Follow Button'' element on the page. <br />
# Click the 'New Data' button.<br />
# Type in the Twitter username for the button and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
== Alternate Method ==<br />
You can also add Follow Buttons programatically inside a Custom Script like this:<br />
<source lang="cfm"><br />
<cfoutput><br />
Follow buttons can be placed anywhere, like this one to follow CommonSpot:<br />
#application.papertweet.twitterService.followButton('commonspot')#. <br /><br />
Notice that the button changes when it knows you are already following someone.<br />
</cfoutput><br />
</source><br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_Follow_Button_Element&diff=3971Twitter App Follow Button Element2010-08-13T21:18:10Z<p>Cmora: </p>
<hr />
<div>== Overview ==<br />
A Follow Button custom element was developed using Twitter's @Anywhere API. It is extremely easy to use. <br />
<br />
== Setup ==<br />
1. Import the ''Follow Button'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br /><br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
# Create a new page and place the ''Follow Button'' element on the page. <br />
# Click the 'New Data' button.<br />
# Type in the Twitter username for the button and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
== Alternate Method ==<br />
You can also add Follow Buttons programatically inside a Custom Script like this:<br />
<source lang="cfm"><br />
<cfoutput><br />
Follow buttons can be placed anywhere, like this one to follow CommonSpot:<br />
#application.papertweet.twitterService.followButton('commonspot')#. <br /><br />
Notice that the button changes when it knows you are already following someone.<br />
</cfoutput><br />
</source><br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_App_Follow_Button_Element&diff=3970Twitter App Follow Button Element2010-08-13T21:17:20Z<p>Cmora: Created page with '== Overview == A Follow Button custom element was developed using Twitter's @Anywhere API. It is extremely easy to use. == Setup == 1. Import the ''Follow Button'' custom eleme…'</p>
<hr />
<div>== Overview ==<br />
A Follow Button custom element was developed using Twitter's @Anywhere API. It is extremely easy to use. <br />
<br />
== Setup ==<br />
1. Import the ''Follow Button'' custom element. <br /> <br /><br />
'''Note:''' Verify the path for the render handler points to the ''ADF'' mapping, not the current site's mapping.<br /><br /><br />
<br />
== Demo ==<br />
To set up a demo of the Follow Button custom element, follow these steps:<br />
# Create a new page and place the ''Follow Button'' element on the page. <br />
# Click the 'New Data' button.<br />
# Type in the Twitter username for the button and click '''Save'''.<br />
# Submit the changes to the page.<br />
<br />
== Alternate Method ==<br />
You can also add Follow Buttons programatically inside a Custom Script like this:<br />
<source lang="cfm"><br />
<cfoutput><br />
Follow buttons can be placed anywhere, like this one to follow me:<br />
#application.papertweet.twitterService.followButton('cvmora')#. <br /><br />
Notice that the button changes when it knows you are already following someone.<br />
</cfoutput><br />
</source><br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_Import_Elements&diff=3968Twitter Import Elements2010-08-13T20:56:48Z<p>Cmora: Created page with '== Overview == The Twitter Application has three Custom Components defined within CommonSpot. The components have been exported and are available in the app's "exported-objects" …'</p>
<hr />
<div>== Overview ==<br />
The Twitter Application has three Custom Components defined within CommonSpot. The components have been exported and are available in the app's "exported-objects" folder located at the root of the Twitter application directory (e.g. /ADF/apps/papertweet/exported-objects/).<br />
<br />
Optional: You may want to create a new category within the CommonSpot Element Gallery for 'Twitter Elements'.<br />
<br />
To import these objects, you will need to be an administrator for your site. If you are not a site administrator, consult your Server administrator for more information.<br />
<br />
== Import ==<br />
Follow these steps to import the Custom Elements: <br />
<br />
# Go to your site's admin.cfm (CommonSpot's Site Administrator).<br />
# Expand the 'Elements & Forms' tab and click on 'Elements'.<br />
# In the Manage Elements screen click on 'Manage Categories'.<br />
# Now click the 'Add New Category' link and create a 'Twitter Elements' category.<br />
# Close the 'Manage Element Categories' screen.<br />
# Back in the 'Manage Elements' screen click on the 'Import Custom Element' link.<br />
# Now click on 'Browse...' and go to the /ADF/apps/papertweet/exported-objects/ folder<br />
# Click on one of the ZIP files to import that custom element.<br />
# Be sure to choose your new 'Twitter Elements' category<br />
# Click Next.<br />
# Repeat steps 7-10 for other custom elements in the exported-objects folder.<br />
<br />
== Verify Imports ==<br />
The imported components' render handlers must be verified. During the import process, the render handler paths may have been changed to reflect the current site's path. <br />
<br />
Review and update these paths to reference the ADF path. In most cases, this will just require to be unlocked and a change in the path from the site name to 'ADF'.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter_Site_Configuration&diff=3966Twitter Site Configuration2010-08-13T20:49:13Z<p>Cmora: Created page with '== Overview == The Twitter App uses an XML file to store site specific configurations. The Twitter App needs to know your Twitter @Anywhere account's Consumer Key and Consumer Se…'</p>
<hr />
<div>== Overview ==<br />
The Twitter App uses an XML file to store site specific configurations. The Twitter App needs to know your Twitter @Anywhere account's Consumer Key and Consumer Secret, as well as your Bit.ly account's Login and Key.<br />
<br />
== Configuration Fields ==<br />
If you haven't created a Twitter @Anywhere app, go to this link for more details visit [http://dev.twitter.com/anywhere Twitter's @Anywhere site]. Read that page and hit [http://dev.twitter.com/apps/new this link] to register your Twitter application.<br />
Also [http://bit.ly/a/sign_up sign up for Bit.ly] to be able to take advantage of their free URL shortening service.<br />
<br />
Don't worry you will not have to write a single line of code to use these two API's, we just need to add those values to the configuration XML file in any text editor (like Notepad).<br />
<br />
There are four components in the configuration XML file:<br />
# '''consumerKey''' - You can find this in your Twitter @Anywhere app's properties.<br />
# '''consumerSecret''' - Also in your Twitter @Anywhere app's properties.<br />
# '''bitlyLogin''' - The username you just registered on Bit.ly's site.<br />
# '''bitlyKey''' - Bit.ly's API key.<br />
<br />
== Final Step ==<br />
Once your configuration XML file (papertweet.xml) has been updated with the correct values from your Twitter App's and Bit.ly's registrations, '''move the XML file to the /cs_apps/config/ folder'''.<br />
<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter&diff=3953Twitter2010-08-13T20:28:22Z<p>Cmora: </p>
<hr />
<div>== About Twitter App ==<br />
The Twitter application is built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Twitter ADF App provides the ability to use Twitter's @Anywhere framework to add the following features to your site:<br />
<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Twitter App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Twitter App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Follow Button]] - Custom Element.<br />
** [[Tweet Box]] - Custom Element.<br />
** [[Tweet Button]] - Custom Element.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[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.<br />
<br />
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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Twitter Application]].<br />
# [[Twitter_Site_Configuration|Site Configuration]].<br />
# [[ADF Configuration for the Twitter App]].<br />
# [[Twitter_Import_Elements|Import Elements]].<br />
<br />
== Features ==<br />
The Twitter application provides the following features:<br />
* [[Twitter_App_Follow_Button_Element|Follow Button Element]].<br />
* [[Twitter_App_Tweet_Box_Element|Tweet Box Element]].<br />
* [[Twitter_App_Tweet_Button_Element|Tweet Button Element]].<br />
* [[Twitter_App_AddHovercards_Function|AddHovercards Function]].<br />
* [[Twitter_App_ShortenURL_Function|ShortenURL Function]].<br />
<br />
== Troubleshooting ==<br />
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.<br />
<br />
== Known Issues/Bugs ==<br />
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.<br />
<br />
[[Category:Project]]<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=Twitter&diff=3950Twitter2010-08-13T20:24:37Z<p>Cmora: </p>
<hr />
<div>== About Twitter App ==<br />
The Twitter application is built in the [[Overview|Application Development Framework (ADF)]].<br />
<br />
== Overview ==<br />
The Twitter ADF App provides the ability to use Twitter's @Anywhere framework to add the following features to your site:<br />
<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
* '''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.<br />
<br />
== Requirements ==<br />
ADF Library components that are required for the Twitter App:<br />
* scripts_1_0<br />
<br />
ADF must be configured correctly for your site. [[Site Configuration (ADF.cfc)]] has instructions for configuration.<br />
<br />
== Contents ==<br />
The Twitter App contains the following:<br />
* Custom Coding - various components and scripts.<br />
* '''Custom Elements:'''<br />
** [[Follow Button]] - Custom Element.<br />
** [[Tweet Box]] - Custom Element.<br />
** [[Tweet Button]] - Custom Element.<br />
<br />
Note: Elements may contain one or more: Render Handlers, Display Templates, or Custom Field Types<br />
<br />
== Pre-installation Considerations ==<br />
[[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.<br />
<br />
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.)<br />
<br />
== Installation/Setup ==<br />
Each of the following steps should be completed fully and in the order presented:<br />
<br />
# [[Extract the Twitter Application]].<br />
# [[Site Configuration]].<br />
# [[ADF Configuration for the Twitter App]].<br />
# [[Import Elements]].<br />
<br />
== Features ==<br />
The Twitter application provides the following features:<br />
* [[Follow Button Element]].<br />
* [[Tweet Box Element]].<br />
* [[Tweet Button Element]].<br />
* [[AddHovercards Function]].<br />
* [[ShortenURL Function]].<br />
<br />
== Troubleshooting ==<br />
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.<br />
<br />
== Known Issues/Bugs ==<br />
Found a bug? View the [[Known Issues/Bugs]] wiki page. Your issue not on the list? Post it so the issue can be addressed.<br />
<br />
[[Category:Project]]<br />
[[Category:Twitter]]</div>Cmorahttp://community.paperthin.com/adf-docs/index.php?title=ADF_Configuration_for_the_Twitter_App&diff=3947ADF Configuration for the Twitter App2010-08-13T20:23:04Z<p>Cmora: Created page with '== Overview == The Twitter Application is built within the ADF. The ADF must be installed in the site to run the Twitter App, follow the ADF Installation instructions. == S…'</p>
<hr />
<div>== Overview ==<br />
The Twitter Application is built within the ADF. The ADF must be installed in the site to run the Twitter App, follow the ADF [[Installation]] instructions.<br />
<br />
== Steps ==<br />
* Make sure the ADF is setup and running on the site. If the ADF is not setup, then follow the instructions for ADF [[Installation]].<br />
* Open the sites 'ADF.cfc' ([[Site Configuration (ADF.cfc)|See Site Configuration (ADF.cfc) for more info]]) file (located in your site's /_cs_apps/ directory) in a text editor. Locate the ''Load the ADF Application into application space'' comment in the file. Add (or uncomment) the following command under the comment section:<br />
<source lang="java"><br />
loadApp("papertweet");<br />
</source><br />
* [[Reset ADF|Reset the ADF]] for the server and site.<br />
<br />
[[Category:Twitter]]</div>Cmora