Table of Contents
- Navigate to Control Panel > System Administration > Site Administration > Site Configuration > Manage Plugin Modules.
- Locate the Twitter Activity plugin.
- Click the check box beside it and click Save.
This configuration only needs to be done once by the administrator or community manager, not by community members.
- Navigate to https://dev.twitter.com/apps to set up a new application.
- Click Create a new application.
- In Username, enter your Twitter user name. Enter your password, and click Log in. The Application Details dialog box appears.
- Fill in the following details for the application:
- In Name (required), enter a name that is globally unique to Twitter. It is shown to the authenticating user when authenticating against Twitter.
- In Description (required), enter some data.
- In Website (required) enter the site's URL from the perspective of the user. The service does not actually connect to this URL, so it can be a local alias (however, not "localhost.")
- In Callback URL, enter any URL you like. Zimbra Community provides its own callback URL, so set a URL that will let you know immediately if this is not occurring (example, http://www.google.com).
- Accept the terms and answer the Captcha test question.
- Click Create your Twitter application.
- Copy the Consumer Key and Consumer Secret.
- In Control Panel > System Administration > Site Administration > Site Configuration > Manage Plugins, click Configure beside Twitter Activity. The Twitter Activity dialog box appears.
- Paste your Twitter Consumer Key and Twitter Consumer Secret into the appropriate fields of the dialog box.
- Enter the Zimbra Community username of the user the posts will be attributed to within Zimbra Community (for example, "user"). This user is the only community member associated with the feed setup. (Tweeters are not community members.) A member of the registered user role is fine for this field. This user is not visible anywhere in Zimbra Community (although it will be visible if you do a "View source" in the page HTML). Note that if you subsequently change this user, only tweets from that point on will be attributed to the user. The display of the tweet includes the original tweeter as part of the tweet.
If desired, enter term(s) or hashtags you want to use in filtering the Twitter feed. If you enter terms, enter them separately with no comma, following the operator hints summarized below. If you want to enter a hashtag, use the hashtag symbol in front of the term (#term). The Twitter Search Query field supports whatever can be searched for when using http://search.twitter.com. Note that this page also links to the operators that can be used. For your convenience, they are listed below.
|Search Operator||Finds tweets...|
|termx termy||containing the words "termx" and "termy." This is the default operator.|
|"community member"||containing the exact phrase "community member."|
|love OR hate||containing either the word "love" or "hate" or both words.|
|member -tall||contaiing the word "member" but not "tall."|
|#community||containing the hashtag "community."|
|from:zimbra||sent from the person "zimbra."|
|to:zimbra||sent to the person "zimbra."|
|@zimbra||referencing the person "zimbra."|
|"gaming community" near:Dallas||containing the exact phrase "gaming community" and sent near Dallas.|
|near:DFW within:25 mi||sent within 25 miles of "DFW."|
|"community member" since:2010-12-31||containing the phrase "community member" and sent since date 2010-12-31 (year month day).|
|winning until:2012-12-31||containing the word "winning" and sent until 2012-12-31 (year month day).|
|game -super :)||containing the word "game" but not "super," with a smile emoticon.|
|game :(||containing the word "game" with a frown emoticon|
|laptop ?||containing the word "laptop" and asking a question.|
|paranormal filter:links||containing the word "paranormal" and linking to URLs.|
|news source:twitterfeed||containing the word "news" and entered via the Twitter feed.|
- For Render as an Embedded Tweet, click the check box. This enables Zimbra Community to use the Twitter-like interface. Disabling this option will result in the tweets resembling regular activity stories.
- Enable Verbose logging does not normally need to be checked. It logs a lot more messages in the Event Logs regarding the plugin's integration with the Twitter API, and for normal operation these are not necessary to have.
- Click Save in the dialog box.
- Click Save on the Manage Plugins page.
- Allow approximately a minute for the Twitter job to run. To check progress, you can monitor the Event Logs. You should start to see tweets populating the stream or tab you created.
The Twitter feed only works if the Activity Story Stream widget is scoped to the entire community. You cannot scope the Twitter feed to a group or user, but you can place the widget on the site, group or user home page if you scope it to the site.
- Either add the Activity Story Stream widget and open its configuration in Edit Page mode, or open the widget's configuration. The Configure the Activity Story Stream dialog box appears.
- Under Activity Stream Mode, select Site (all site activity).
- If you want to include the Twitter feed in the main activity stream, click Filter 1. If you want to put it on a separate filter tab from the activity stream, click Filter 2.
If you are configuring a separate tab for Twitter, enter a name for the tab in Filter Name.
- Locate Twitter Statuses and select Include all users' activity.
- Click Save in the widget configuration.
- Click Save Page. You have now enabled the plugin, configured the plugin, configured a filter, and configured the Activity Story Stream to receive tweets.