PHPackages                             i-lateral/silverstripe-socialnav - 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. i-lateral/silverstripe-socialnav

Abandoned → [dft/silverstripe-socialnav](/?search=dft%2Fsilverstripe-socialnav)Silverstripe-vendormodule

i-lateral/silverstripe-socialnav
================================

Adds a list of social media services that generates a list of links in a template

2.0.2(7y ago)24.7k44BSD-3-ClausePHPCI failing

Since Mar 26Pushed 1y ago4 watchersCompare

[ Source](https://github.com/i-lateral/silverstripe-socialnav)[ Packagist](https://packagist.org/packages/i-lateral/silverstripe-socialnav)[ Docs](http://github.com/i-lateral/silverstripe-socialnav)[ RSS](/packages/i-lateral-silverstripe-socialnav/feed)WikiDiscussions 3 Synced 1mo ago

READMEChangelogDependencies (1)Versions (10)Used By (4)

Silverstripe Socialnav Module
=============================

[](#silverstripe-socialnav-module)

Silverstripe module that adds a social navigation field to the CMS and uses that to generate a HTML list from a template (loading in relevent icons via Fontawesome).

The stock install includes Fontawsome 6 brand icons and is pre-configured to render them into the template and include relevent CSS and fonts.

The stock templates also support the Bootstrap v4 & v5 frameworks (if you are either) and will render as a `navbar` and `nav-items`.

Install
-------

[](#install)

Install via composer:

`composer require dft/silverstripe-socialnav`

Usage
-----

[](#usage)

This module adds a `ToggleCompositeField` ("Social Nav") to `SiteConfig`. You can add links by visiting the SilverStripe admin > Settings (left hand menu) > Main Tab, then clicking "Social Nav".

You can now add links to your social nav. If you are using an icon library (such as FontAwesome), you can add custom classes to each link.

Rendering in templates
----------------------

[](#rendering-in-templates)

Rendering the nav in your template is make pretty easy, you simply have to add `$SocialNav.Rendered` to your templates, where you want the nav to appear.

If you want to loop through Specific menu items (to access them individually in a template), you can call them via:

``

Customising the template
------------------------

[](#customising-the-template)

If you want to customise the template, simply copy the following template into your theme: `DFT\\SilverStripe\\SocialNav\\SocialNav.ss

"Services"
----------

[](#services)

By default, this module includes a comprehensive list of services like:

- Facebook
- Instagram
- X
- YouTube
- Pinterest
- LinkedIn
- More

This module also allows selection of other third party sites, such as:

- ebay
- Etsy
- Shopify
- Spotify

### Adding custom services

[](#adding-custom-services)

If there is a service you would like to add, this can be done via YML config by updating the service name and class maps as follows:

```
DFT\SilverStripe\SocialNav\SocialNav:
    service_names:
        CustomService: "My Custom Service"
    service_classes:
        CustomService: "fa-service-class"
```

### Changing the class prefix

[](#changing-the-class-prefix)

By default, this module adds `fa-brands fa-xl` to all links generated. This can be overwritten using the following YML config:

```
DFT\SilverStripe\SocialNav\SocialNav:
    service_class_prefix: "my-custom-css-prefix"
```

Disabling default CSS and Fonts
-------------------------------

[](#disabling-default-css-and-fonts)

By default, this module requires custom CSS and the Fontawesome brands webfont. If you are using Fontawesome in your project already and don't require these, you can disable these items being included via YML config:

```
DFT\SilverStripe\SocialNav\SocialNav:
    require_css: false
```

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 92.7% 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 ~213 days

Recently: every ~163 days

Total

9

Last Release

2358d ago

Major Versions

1.0.x-dev → 2.0.02018-02-12

### Community

Maintainers

![](https://www.gravatar.com/avatar/c7d4998767cb41bf0048a65158559384fbab33751b26c996d6367019c68c4f8b?d=identicon)[DFT](/maintainers/DFT)

---

Top Contributors

[![mlewis-everley](https://avatars.githubusercontent.com/u/687143?v=4)](https://github.com/mlewis-everley "mlewis-everley (38 commits)")[![Makreig](https://avatars.githubusercontent.com/u/6011781?v=4)](https://github.com/Makreig "Makreig (3 commits)")

---

Tags

facebooksilverstripetwittersociallinked ingoogle plusyou tube

### Embed Badge

![Health badge](/badges/i-lateral-silverstripe-socialnav/health.svg)

```
[![Health](https://phpackages.com/badges/i-lateral-silverstripe-socialnav/health.svg)](https://phpackages.com/packages/i-lateral-silverstripe-socialnav)
```

###  Alternatives

[hybridauth/hybridauth

PHP Social Authentication Library

3.4k8.5M94](/packages/hybridauth-hybridauth)[social-links/social-links

PHP library to generate share buttons

112338.6k2](/packages/social-links-social-links)[kartik-v/yii2-social

Module containing useful widgets for Yii Framework 2.0 that integrates social functionalities from DISQUS, Facebook, Google etc.

91256.5k8](/packages/kartik-v-yii2-social)[pdir/social-feed-bundle

Social feed extension for Contao CMS

1414.8k](/packages/pdir-social-feed-bundle)[ryannielson/shareable

A Laravel 4 package to make it easy to add social sharing buttons to your application.

222.8k](/packages/ryannielson-shareable)[quinninteractive/silverstripe-seo

An all-in-one SEO module for SilverStripe

3328.2k](/packages/quinninteractive-silverstripe-seo)

PHPackages © 2026

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