-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
180 lines (126 loc) · 6.57 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
=== Letter Avatars ===
Contributors: seebeen
Donate link: https://sgi.io/donate
Tags: letter, avatars, custom-avatar, gravatar, comment, comments, buddypress-avatar, buddypress, letter-avatar, wp-user-avatar
Requires at least: 4.8
Tested up to: 5.3.2
Requires PHP: 7.0.0
Stable tag: 3.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Sets custom avatars for users without gravatar. Avatars will be replaced by first letter of usename (or e-mail) on a colorful background
== Description ==
Letter Avatars **enables custom avatars for users without gravatar**. Avatar will be replaced with the first letter of username or e-mail.
Letter Avatars does not use any images, scripts, or font-icons. All letters will be rendered by your theme font (or Optionally via a Google font).
**Features**
* Works anywhere - Plugin hooks into pre_get_avatar function, so the avatar size is preserved
* Highly customizable - You can change colors, letter font, as well as the font size
* Stylish - You can change the background and letter colors or you can randomize them for all the avatars
* Lightweight - Plugin does not use any external stylesheet, image, or js files. It only adds a small inline css in your header
* Highly compatible - You don't have to edit your theme / plugin files, it works automatically and plays nice with other plugins
* **Works with BuddyPress** - Users and groups without gravatar / local avatar will use Letter Avatars
* **Works with YITH Reviews for WooCommerce** - Avatars in reviews support Letter Avatars
* **Works with WP User Avatar** - Users with Custom Avatar will use those, users without avatar will default to Letter Avatar
== Installation ==
1. Upload letter-avatars.zip to plugins via WordPress admin panel, or upload unzipped folder to your plugins folder
2. Activate the plugin through the "Plugins" menu in WordPress
3. Go to Settings->Letter Avatars to manage the options
== Frequently Asked Questions ==
= Can I disable gravatars and use Letter Avatars for all comments? =
Yes you can. By default, Letter Avatars are used only for users without gravatar, but you can change that in plugin settings.
= Does this plugin work with WP User Avatar =
Yes it does, since version 3.0
= Can I change the font for my Avatars? =
By default, Letter Avatars will be displayed in your theme font, but you can change that in plugin settings.
= Does this plugin work with BuddyPress? =
Yes it does, since version 2.5
= Does this plugin work with bbPress / wpDiscuz =
At the moment, no. This feature is planned for versions 3.1 and 3.2. coming out soon
= What does the user lock-in option do? =
If you enable user lock-in (when random colors are enabled), each user will have his own unique color which will be used for all the comments.
= How does the Font Auto Size option work?
If you enable the auto size functionality, letter size will be 75% of the avatar size.
I.E. If the avatar size is 100px, font size will be 75px.
== Screenshots ==
1. Gravatars displayed alongside letter avatars
2. Plugin settings page
3. Random colored avatars with user lock-in
== Changelog ==
= 3.1.0 =
* Improvement: Full PSR-12 compliance
* Bugfix: Fixed various errors and notices in certain scenarios
= 3.0.1 =
* Bugfix: Fixed fatal error in certain scenarios
= 3.0 =
* Breaking: Minimum WP Version has been bumped to 4.8
* Breaking: Minimum PHP Version has been bumped to 7.0
* New Feature: Added support for WP User Avatar plugin
* Improvement: Reworked admin settings for better performance
* Improvement: Complete refactor of the codebase - Moving on to full PSR-12 Compliance
* Improvement: Improved performance using PHP 7.0 specific tweaks
* Improvement: Fixed plugin styles
* Improvement: Reworked plugin CSS to use CSS variables
* Bugfix: Improved user / e-mail detection in various scenarios
* Bugfix: Fixed Google Font list not showing in plugin settings
* Bugfix: Fixed transient caching not working properly on some hosting confgurations
* Bugfix: Various minor tweaks and changes
= 2.8 =
* New feature: Select avatar shape, square or round
* New feature: Load font CSS without loading Google font
* Improvement: Better avatar checking
= 2.7 =
* New Feature: **YITH Reviews for WooCommerce support**
* Improvement: Works for comments fetched via ajax
= 2.6.2 =
* Bugfix: Removed all PHP Notices and Warnings
* Improvement: Fine-tuned gravatar detection code
= 2.6.1 =
* Bugfix: Fixed PHP Warning in certain scenarios
= 2.6 =
* Improvement: Added caching mechanism for gravatar checks
* Improvement: Fine-tuned gravatar checking mechanism
= 2.5 =
* New Feature: **BuddyPress support**
* New Feature: Automatic font size - Option to calculate font size automatically by avatar size
* Improvement: Optimized gravatar detection and CSS processing
* Improvement: Optimized performance on posts with many comments
= 2.4 =
* Internal beta version
= 2.3 =
* Internal alpha version
= 2.2 =
* New Feature: Load Google Font CSS without loading google font
* Improvement: Moved to select2 library for Google Font selection
* Improvement: Google Fonts selection is now cached, improving wp-admin speed
* Bugfix: Fixed the display of Letter Avatars in admin-bar
* Bugfix: Fixed Avatars not displaying properly in some scenarios
* Bugfix: Fixed Font list not showing up randomly in admin settings
= 2.1.2 =
* Bugfix: Fixed WP-Admin issues in WordPress versions 4.9.x
= 2.1.1 =
* Bugfix: Fixed Synthax Error on servers running PHP 5.3.x
= 2.1 =
* New Feature: Colors are now calculated from e-mail hash
* Improvement: Improved color randomization functions
= 2.0 =
* **Fully reworked codebase**
* New Feature: Same color for repeated comments by same author
* Improvement: Moved settings to separate page
* Improvement: Revamped settings system
* Improvement: Reworked avatar hookin process - better performance
* Improvement: Reworked gravatar detection - works in all scenarios
* Improvement: Better color randomization - each avatar has a unique color
* Bugfix: Improved option handling
* Bugfix: Better google font handling
* Many more performance and stability fixes
= 1.1 =
* Improvement: Added hook for style loading
* Improvement: Added hook for plugin options
* Improvement: Better Gravatar detection
* Improvement: Better Theme / Plugin compatibility
* Improvement: Much better performance
* Improvement: Added PHPDoc to all classes / functions
= 1.0 =
* Initial release
== Upgrade Notice ==
You will need to resave your settings after updating plugin