This is the documentation for the 6.x-3.x branch of the Facebook-style Statuses module, which provides each user with a microblog where they can write what they're doing, how they feel, or anything they want.
This also serves as the official documentation URL for Statuses for Drupal 7. While written for Facebook-style Statuses, most of the same information applies.
One block is provided by default: the Facebook-style Statuses block, which shows a form to create a new status message as well as (optionally) a view of the latest status updates.
Additionally, the default Views provided by the module add several blocks.
- Edit and delete pages are provided for users with permission to edit and delete statuses.
- Conversation pages are generated when users exchange status messages.
- There is a page for each status at
/statuses/SIDwhere SID is the Status ID.
- A page at the URL
/statuses/sharecontains a status update form which can be pre-filled with the "s" parameter in the URL, like
/statuses/share?s=test. Read more about the share-status page here.
/statuses/announcepage allows administrators to broadcast a status message to all users at once.
- Other pages listing status updates are available with the Views module installed.
Facebook-style Statuses integrates with a large number of modules. Many of these modules also integrate with other modules, creating a wide range of possibilities for what you can accomplish with Facebook-style Statuses.
Also check out the modules that extend FBSS.
- Users' statuses (and, if allowed, the status update form) appear on their (core) profiles.
- Views integration allows site administrators to make lists of status updates. Examples include User Status History, Friends' Statuses, or All Status Updates. You can learn more about Views integration here.
- Activity integration allows status updates to appear in a Facebook-style "mini-feed" of users' activity on your website. Works with Activity 2.x branch.
- Integration with the (core) trigger module is available so that various actions can be performed when statuses are updated. You may want to use the triggerunlock module to expose status actions to non-status-related triggers.
- Integration with the Rules module allows complex, pre-determined actions to occur when a user submits or deletes a status. Rules is basically a more powerful version of the core Trigger module. You can use rules to have FBSS integrate with even more other modules.
- User Relationships and Flag Friend
- If User Relationships is installed, FBSS provides a default view that shows a stream of a user's statuses and that user's friends' statuses. If you use Flag Friend, you can build an equivalent view yourself.
- The Flag module allows you to add features like Facebook's "Like" or a "Report" option. A "Like" flag is included by default, as well as a "Follow" flag that allows Twitter-style follow/follower action. Flag also integrates with Views, but there are no default FBSS views that use Flags.
- The Facebook-style Statuses Tags submodule allows using #hashtags to categorize posts. Tags are automatically added to a designated vocabulary.
- Integration with the Twitter module allows each individual user to set a Twitter account in their Drupal user account settings that can be used to post their statuses to Twitter. If the individual user has chosen an account to use, a checkbox will appear on the status update form allowing the status to be posted to Twitter.
- Userpoints awards users points for doing certain actions on a site. These points can be used like money in E-Commerce or just for fun (for example, to show rankings). With FBSS, users can earn points for posting statuses.
- Integration with the Services module allows third-party apps to securely create/read/update/delete statuses on your site.
- Integration with the Notifications framework lets users receive notifications via email (or other methods) about new status updates and comments.
- Pathauto automatically aliases pages on your website as soon as they are created. This allows you to provide alternative URLs for individual status pages.
- If the Context module is installed, it can be used to let administrators specify who the recipient of a status update should be on any given page instead of the default auto-detection.
- Author Pane
- The Author Pane module provides block/theme functions that developers can use to display information about a user. This allows you to add users' statuses to the author pane on forum posts built by the Advanced Forum module, among other things.
- Input Filters
- You can choose an input format to run on statuses when they are displayed. This allows integration with modules like wordfilter, inline, or smileys.
- Modal Frame
- The Modal Frame module allows links to be opened in modal dialogs so that the whole page doesn't have to be refreshed. FBSS allows the edit and delete links for statuses to be handled in this way; submitting the form will refresh the page with AJAX for a smooth experience for your users.
- Views Bulk Operations
- The Views Bulk Operations module allows executing processes upon multiple statuses at a time, using the Views module as its interface and Rule Sets for the processes. For example, you could use VBO to set up a page that would allow you to delete several statuses at once.
- FBSS provides a CTools content type that allows placing users' streams (including the status update form) into a Panel. Panels and CTools facilitate building complex layouts without writing any code.
- SMS Framework
- Integration with the SMS Framework module allows users to send texts to your site beginning with "s: " which will be saved as statuses.
- The Devel module provides several useful utilities to website developers. Integration with Devel (specifically, the Devel Generate sub-module) allows rapid creation or deletion of large numbers of random statuses for effective testing.
- Like the Activity module, Heartbeat provides a stream of users' recent activity on your site, including status postings.
- The Mollom module is designed to stop spam on your site with minimal work by administrators. Integration with Mollom can help stop spam status updates.
- Domain Access
- The Facebook-style Statuses Domain Access submodule allows you to only display status updates that were created on certain domains controlled by the Domain Access module.
- The Mentions module provides an alternative to the #hashtag and @mention functionality provided by the Facebook-style Statuses Tags submodule. It works by using an input filter, which means it can be used on nodes and comments as well as statuses.
- Shorten URLs
- If the Shorten URLs module is enabled along with Twitter integration and a status is too long to post to Twitter, the Shorten URLs module will be used to generate a link to the status update, and that link will be posted to Twitter along with the abbreviated status.
- The Quant module provides a chart plotting the number of statuses shared over time.
- The Timeago module turns the date statuses and status comments were created into dynamically updating "time ago" timestamps with graceful degradation.
- ImageCache Profiles
- FBSS can use ImageCache Profiles to display users' pictures at arbitrary sizes next to status updates or status comments.
A note about the 7.x-1.x branch (Statuses)
The Drupal 7 version of FBSS now lives at the Statuses project. Separate documentation will eventually be written for it, but if you're working with D7 you can use this documentation for now because the 7.x-1.x branch of Statuses is a straight port of the 6.x-3.x branch of FBSS.
There is one major difference to note for developers: functions that previously began with "facebook_status_" now begin with "statuses_". There are also some changes to the Drupal 7 theming system that change the way you should call and override theme functions, though these are otherwise the same.
Additionally, some of the integrations with other modules haven't been ported to Drupal 7 yet; consult the issue queue for more.