ianm/boring-avatars

Replace default Flarum avatars with Boring Avatars.

Fund package maintenance!
www.buymeacoffee.com/ianm1

Installs: 2 965

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 2

Type:flarum-extension

1.0.1 2024-11-03 14:34 UTC

This package is auto-updated.

Last update: 2024-11-03 14:34:53 UTC


README

License Latest Stable Version Total Downloads

A Flarum extension. Replace default Flarum avatars with Boring Avatars.

About

Utilize generated "Boring Avatars" on your Flarum forum, without compromising your user privacy. It is a PHP port of the React based Boring Avatars

Features

  • Choose from 6 themes + plus an exclusive animated version of the "ring" theme
  • Customize the color palette used
  • Completely self contained, no external calls are required
  • Multiple identifier configuration (Select from ID, username or email address to generate unique avatars)
  • SVG avatars, which are directly included in the user object - no additional network requests to retrieve avatars
  • Automatically updates the avatar if the identifier changes
  • Supports GDPR export, anonymization, deletion

Screenshots

Bauhaus

bauhaus

Beam

beam

Marble

marble

Pixel

pixel

Ring

ring

Sunset

sunset

Settings

settings

Usage

When first enabled, a background task will be dispatched which will begin generating avatars for all of your users. Needless to say, if you have 100's of thousands of users, this could take a few minutes!

Want to make changes to the generation settings? No problem, once the settings are changed, another background task will run to update the avatars.

This extension is best used alongside a queue, especially when the forum has a large number of users.

An API endpoint is also available to directly retrieve the avatar for a user:

/api/users/[id]/boring-avatar

this will return the SVG image file for the given user.

Installation

Install with composer:

composer require ianm/boring-avatars:"*"

Updating

composer update ianm/boring-avatars:"*"
php flarum migrate
php flarum cache:clear

Links

Support

Please consider supporting my extension development and maintenance work.

Buy Me A Coffee