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. [Templating & Views](/categories/templating)
4. /
5. i-lateral/silverstripe-socialnav

Abandoned → [dft/silverstripe-socialnav](/?search=dft%2Fsilverstripe-socialnav)Silverstripe-vendormodule[Templating & Views](/categories/templating)

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.8k44BSD-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 2d 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

38

—

LowBetter than 83% of packages

Maintenance31

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

2411d 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

[unclecheese/bootstrap-forms

Allows you to create forms in SilverStripe that are compatible with Twitter Bootstrap.

5739.4k1](/packages/unclecheese-bootstrap-forms)[silverstripe/login-forms

A collection of templates for the CMS login screens

191.4M30](/packages/silverstripe-login-forms)[pdir/social-feed-bundle

Social feed extension for Contao CMS

1615.7k](/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)

PHPackages © 2026

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