>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #1964028. --> Reported by: [ben.denham](https://www.drupal.org/user/2459936) >>> <p>The Facebook Stream module aims to provide an easily customisable block for displaying posts from a Facebook page. It uses Facebook's Graph API to retrieve posts from the timeline of a particular Facebook page, and then filters the returned posts based on the module's settings, before rendering the final block with a template file.</p> <h4>The current settings available to customise the stream are:</h4> <ul> <li>The number of posts to display in the stream</li> <li>The types of posts to display in the stream</li> <li>Limiting posts to those created by the Facebook page itself</li> <li>The maximum number of requests to make to Facebook in order to retrieve the specified number of posts that meet your selection criteria</li> <li>The length of time to cache the stream data</li> </ul> <h4>The basic workflow for the module when the block is displayed is:</h4> <ol> <li>The module returns a cached version of the stream if there is one available.</li> <li>If there is no cached stream, the module makes a request to Facebook for an access token using the Facebook application ID and secret from the module's settings.</li> <li>The module uses the returned access token to make a Graph API request for the feed of the Facebook page with the page ID from the module's settings.</li> <li>The module loops through the posts returned by Facebook, processing posts that meet post type and poster configurations and adding them to a list of posts to display. When the set number of posts to display has been reached, the stream is cached and sent to the theme template for rendering.</li> <li>If the module finishes processing the posts returned by Facebook without reaching the number of posts to display, then it makes another request to Facebook for more posts, and continues to process the new posts.</li> <li>The module will continue to make new requests to Facebook until it either reaches the set number of posts to display, or it reaches the maximum number of requests to make to Facebook. The maximum number of requests defaults to 1, so by default the module will only make 2 requests to Facebook: one for the access token, and one for the posts.</li> </ol> <h3>Similar Modules:</h3> <p><a href="http://drupal.org/project/facebook_pull">Facebook Pull</a> also provides a block to display Facebook posts, but it does not provide options for filtering the posts that are displayed. Also, while Facebook Pull has a limit for the number of posts to display, Facebook Stream can be configured to make multiple requests in order to display the number of posts set on the settings page.</p> <h3>My Background:</h3> <p>I have had a part time job developing Drupal websites for almost 2 years, including working on modules and themes.</p> <h3>Links:</h3> <p>Project page: <a href="http://drupal.org/sandbox/ben.denham/1959688">http://drupal.org/sandbox/ben.denham/1959688</a></p> <p>Git repository: <code>git clone --branch 7.x-1.x http://git.drupal.org/sandbox/ben.denham/1959688.git facebook_stream</code></p>