PHPackages                             nathancox/silverstripe-social-feed - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. nathancox/silverstripe-social-feed

ActiveSilverstripe-vendormodule[Utility & Helpers](/categories/utility)

nathancox/silverstripe-social-feed
==================================

A social feed module for fetching content from Facebook and Twitter

2.15.3(7y ago)15923[2 PRs](https://github.com/nathancox/silverstripe-social-feed/pulls)BSD-3-ClausePHP

Since Jan 7Pushed 3y ago1 watchersCompare

[ Source](https://github.com/nathancox/silverstripe-social-feed)[ Packagist](https://packagist.org/packages/nathancox/silverstripe-social-feed)[ Docs](http://github.com/nathancox/silverstripe-social-feed)[ RSS](/packages/nathancox-silverstripe-social-feed/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (4)Versions (21)Used By (0)

SilverStripe Social Feed
========================

[](#silverstripe-social-feed)

Combine social media posts from Facebook, Twitter and Instagram into a single feed. Each feed is available separately also.

Installation
------------

[](#installation)

`composer require isaacrankin/silverstripe-social-feed`

Usage
-----

[](#usage)

``

Alternatively you can call the `SocialFeed` method directly like so:

```

					Type: $Type
					Created: $Created
					User: $UserName

					$Content

```

The posts are ordered from newest to oldest.

Within the `SocialFeed` control loop the following values are available:

- `$URL` - a URL for the social media post
- `$Type` - the type of post, either "facebook", "twitter" or "instagram"
- `$Created` - the creation/posted date of the post
- `$UserName` - the user who made the post
- `$Image` - the main image for the post
- `$Data` - all of the data for a single post in the original structure returned from the API's. Read documentation for the API's to see what's available.

Caching
-------

[](#caching)

All SocialMediaProvider::getFeed() calls are cached for 15 minutes and can be cleared either in the CMS or by appending **?socialfeedclearcache=1** in developer mode.

There is also a SocialFeedCacheTask that you can setup as a cronjob on your server to ensure that the end-user never has to wait for your server to make its API calls to Facebook, Twitter, etc and update the various social feed caches.

Alternatively, if you're using the [QueuedJobs](https://github.com/silverstripe-australia/silverstripe-queuedjobs) module, this process will be handled automatically for you, as a queued job is setup to update the cache every 10 minutes.

Requirements
------------

[](#requirements)

SilverStripe 4 or newer

Twitter
-------

[](#twitter)

The Twitter data is a collection of the most recent Tweets posted by the user. The following API endpoint is used `https://api.twitter.com/1.1/statuses/user_timeline.json?screen_name=twitterapi`

[Twitter API documentation for user timeline](https://dev.twitter.com/rest/reference/get/statuses/user_timeline)

### Credentials

[](#credentials)

You'll need to create a Twitter app here

Facebook
--------

[](#facebook)

The Facebook data returned is the most recent posts for a given Facebook Page. The following API endpoint is used `https://graph.facebook.com/PAGE_ID/feed?access_token=ACCESS_TOKEN`

[Facebook API documentation](https://developers.facebook.com/docs/graph-api/using-graph-api)

### Credentials

[](#credentials-1)

To get the necessary Facebook API credentials you'll need to [create a Facebook App](https://developers.facebook.com/apps).

Instagram
---------

[](#instagram)

The most recent media published for a user. The following API endpoint is used `https://api.instagram.com/v1/users/self/media/recent/?access_token=ACCESS_TOKEN`[Instagram API documentation for resent user media](https://www.instagram.com/developer/endpoints/users/#get_users_media_recent_self)

### Credentials

[](#credentials-2)

To get the necessary Instagram API credentials you'll need to [create an Instagram Client](https://www.instagram.com/developer/clients/manage/).

You'll need to add the correct redirect URI in the settings for the Instagram App, such as

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 59.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Recently: every ~11 days

Total

19

Last Release

2684d ago

Major Versions

1.0.0 → 2.82019-01-07

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/194315?v=4)[Nathan Cox](/maintainers/nathancox)[@nathancox](https://github.com/nathancox)

---

Top Contributors

[![isaacrankin](https://avatars.githubusercontent.com/u/838408?v=4)](https://github.com/isaacrankin "isaacrankin (16 commits)")[![nathancox](https://avatars.githubusercontent.com/u/194315?v=4)](https://github.com/nathancox "nathancox (10 commits)")[![jason-zz](https://avatars.githubusercontent.com/u/6354744?v=4)](https://github.com/jason-zz "jason-zz (1 commits)")

---

Tags

facebookinstagramsilverstripetwittersocial feed

### Embed Badge

![Health badge](/badges/nathancox-silverstripe-social-feed/health.svg)

```
[![Health](https://phpackages.com/badges/nathancox-silverstripe-social-feed/health.svg)](https://phpackages.com/packages/nathancox-silverstripe-social-feed)
```

###  Alternatives

[pdir/social-feed-bundle

Social feed extension for Contao CMS

1415.5k](/packages/pdir-social-feed-bundle)[tractorcow/silverstripe-opengraph

Implementation of the Facebook Open Graph protocol for SilverStripe

50144.8k6](/packages/tractorcow-silverstripe-opengraph)[jonom/silverstripe-share-care

Social media sharing previews and customisation for Silverstripe

2933.2k1](/packages/jonom-silverstripe-share-care)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)