strangerstudios / basic-user-avatars

39 stars 35 forks source link
avatar wordpress wordpress-plugin

=== Basic User Avatars === Contributors: strangerstudios, jaredatch Tags: avatar, gravatar, user profile, users, profile Requires at least: 5.2 Tested up to: 6.7 Stable tag: 1.0.9

Add an avatar upload field on frontend pages and Edit Profile screen so users can add a custom profile picture.

== Description ==

= Add an avatar upload field on frontend pages and Edit Profile screen so users can add a custom profile picture. =

Community and Membership sites on WordPress use this plugin as a lightweight solution for custom user avatars. The plugin is compatible with bbPress, as well as many popular plugins with frontend user registration and profile management features.

Admins can upload a user's avatar on the Edit User admin screen.

Basic User Avatars also supports front-end avatar management for sites that want to keep users out of the dashboard. To use this feature, add the shortcode [basic-user-avatars] to any page in your WordPress site. We recommended placing this shortcode on another logged-in account type page, such as the WooCommerce My Account page, the Membership Account page, or any other front-end profile edit form.

The Avatar Upload form is automatically added to the bbPress User Profile > Edit frontend page.

If you do not want your users to be able to update their avatar, navigate to Settings > Discussion and locate the "Local Avatar Permissions" setting. Check this box to only allow users with file upload capabilities to upload local avatars (Author role and above).

= Seamlessly Migrate from WP User Avatar Plugin =

Version 1.0.5 includes a feature to automatically convert avatars formerly loaded through the WP User Avatar plugin. This means that you can disable WP User Avatar, activate Basic User Avatars, and have a seamless transition for existing avatars in your site. Be sure to update any avatar upload form that used the [avatar_upload] shortcode to use the shortcode: [basic-user-avatars].

== Installation ==

  1. Upload basic-user-avatars to your /wp-content/plugins/ directory or download through the Plugins page.
  2. Activate the plugin through the 'Plugins' menu in WordPress.
  3. If you only want users with file upload capabilities to upload avatars, check the applicable option under Settings > Discussion.
  4. Navigate to Users > Edit User to upload a custom avatar for your users.
  5. Add the [basic-user-avatars] shortcode to a page in your WordPress site to allow front-end avatar upload for your users.

bbPress support is added automatically if bbPress is activated.

Note: This plugin is a fork of Simple Local Avatars v1.3.1 by Jake Goldman and 10up. Check out Simple Local Avatars to compare their latest release to this plugin.

== Frequently Asked Questions ==

= I'm still having problems =

While this plugin has been tested with common server setups, some enviroments could cause an issue.

If you are having a problem deactivate all plugins other than this one and then switch your theme to TwentyTweleve (or similar). If things work, then the issue is with a 3rd party theme or plugin.

== Screenshots ==

  1. Frontend avatar upload form without a custom profile picture.
  2. Avatar upload field on the Edit User screen in the WordPress admin.

== Changelog ==

= 1.0.9 - 2024-11-13 =

= 1.0.8 - 2024-01-23 =

= 1.0.7 =

= 1.0.6 =

= 1.0.5 - 2021-05-19 =

= 1.0.4 - 2020-01-12 =

= 1.0.3 - 2015-08-05 =

= 1.0.2 - 2015-04-17 =

= 1.0.1 - 2015-03-17 =

= 1.0.0 =