PHPackages                             riclep/social-graces - 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. [Image &amp; Media](/categories/media)
4. /
5. riclep/social-graces

ActiveLibrary[Image &amp; Media](/categories/media)

riclep/social-graces
====================

A wrapper around SidecarBrowsershot for managing dynamic social images - OGP, Twitter etc

0.0.6(11mo ago)586MITPHP

Since Dec 14Pushed 11mo ago1 watchersCompare

[ Source](https://github.com/RicLeP/social-graces)[ Packagist](https://packagist.org/packages/riclep/social-graces)[ Docs](https://github.com/riclep/social-graces)[ RSS](/packages/riclep-social-graces/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (5)Versions (8)Used By (0)

Social Graces; a polite way to create dymanic social share images
=================================================================

[](#social-graces-a-polite-way-to-create-dymanic-social-share-images)

[![Latest Version on Packagist](https://camo.githubusercontent.com/bfe63007121735fbc7a1264f29165d074904599b429c34f3a02e25744031a7db/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7269636c65702f736f6369616c2d6772616365732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/riclep/social-graces)[![Total Downloads](https://camo.githubusercontent.com/82b4bfd53ed177697e13bcad31c70eca78e1e8b258667d872089806fc4251df3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7269636c65702f736f6369616c2d6772616365732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/riclep/social-graces)

This package allows you to create dynamic social sharing images in your Laravel apps. It uses [Spatie’s Browsershot](https://github.com/spatie/browsershot) to screenshot special pages that represent the image you wish to use. Create any view, using any content from your site and it’ll become the image used when your page is shared on Twitter, Facebook and elsewhere.

You can either create different images for each network using Manners or use the same Balde view with CSS breakpoints to to vary your images based on the size needed for each network.

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

[](#installation)

You can install the package via composer:

```
composer require riclep/social-graces
```

Usage
-----

[](#usage)

No docs yet, but check the tests and code. It’s a pretty small package.

### Browsershot Requirements

[](#browsershot-requirements)

This package wraps Spatie’s Browsershot that requires Puppeteer, Chromium, Node etc. on your server.

I can’t support installing these on your own server, but here is what I needed to do.

**Use at your own risk!**

```
apt update -y

sudo apt-get install -y nodejs gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgbm1 libgcc1 libgconf-2-4 libgdk-pixbuf2.0-0 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget libgbm-dev libxshmfence-dev

export PHANTOM_JS='phantomjs-2.1.1-linux-x86_64'; wget -N https://bitbucket.org/ariya/phantomjs/downloads/$PHANTOM_JS.tar.bz2 ; tar xvjf $PHANTOM_JS.tar.bz2; mv $PHANTOM_JS /usr/local/share; ln -sf /usr/local/share/$PHANTOM_JS/bin/phantomjs /usr/local/bin; phantomjs --version

sudo npm install --global --unsafe-perm puppeteer

chmod -R o+rx /usr/local/lib/node_modules/puppeteer/.local-chromium

```

### Testing

[](#testing)

```
composer test
```

### Changelog

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Richard Le Poidein](https://github.com/riclep)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

Laravel Package Boilerplate
---------------------------

[](#laravel-package-boilerplate)

This package was generated using the [Laravel Package Boilerplate](https://laravelpackageboilerplate.com).

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance52

Moderate activity, may be stable

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity44

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~253 days

Recently: every ~300 days

Total

6

Last Release

339d ago

PHP version history (2 changes)0.0.1-betaPHP ^7.4|^8.0

0.0.3PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/8cc0947c5075928ca6160ab3c81f608db980edaefafd50fd904d060ba5c40817?d=identicon)[ric@sirric.co.uk](/maintainers/ric@sirric.co.uk)

---

Top Contributors

[![RicLeP](https://avatars.githubusercontent.com/u/19726976?v=4)](https://github.com/RicLeP "RicLeP (19 commits)")

---

Tags

facebooktwittersharingogpriclepopen-graph-protocolsocial-imagessocial-graces

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/riclep-social-graces/health.svg)

```
[![Health](https://phpackages.com/badges/riclep-social-graces/health.svg)](https://phpackages.com/packages/riclep-social-graces)
```

###  Alternatives

[chojnicki/video-platforms-parser

Easy to use SDK with grabber for multiple platforms at once like YouTube, Dailymotion, Facebook and more.

22226.4k](/packages/chojnicki-video-platforms-parser)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)[pdir/social-feed-bundle

Social feed extension for Contao CMS

1414.8k](/packages/pdir-social-feed-bundle)[org_heigl/hybridauth

Lightweight Authentication Module for Zend-Framework 2 using the hybridauth-library

211.9k](/packages/org-heigl-hybridauth)

PHPackages © 2026

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