Boring Avatars

Replace default Flarum avatars with Boring Avatars.

Compatible with Flarum v1.8.5

Latest release 1.0.0

283 downloads

released on Jan 16, 2024

Boring Avatars

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

© 2024 Hyn by DaniĆ«l "Luceos" Klabbers. All rights reserved. · Extensions and extension information is provided by the respective (copyright holding) authors. · Extiverse is not affiliated to the Flarum project or Flarum foundation. · Images on Extiverse pages are from Unsplash.