3 * Name: Gravatar Support
4 * Description: If there is no avatar image for a new user or contact this addon will look for one at Gravatar.
6 * Author: Klaus Weidenbach <http://friendica.dszdw.net/profile/klaus>
10 use Friendica\BaseModule;
11 use Friendica\Core\Addon;
12 use Friendica\Core\Config;
13 use Friendica\Core\L10n;
14 use Friendica\Database\DBA;
15 use Friendica\Util\Security;
18 * Installs the addon hook
20 function gravatar_install() {
21 Addon::registerHook('load_config', 'addon/gravatar/gravatar.php', 'gravatar_load_config');
22 Addon::registerHook('avatar_lookup', 'addon/gravatar/gravatar.php', 'gravatar_lookup');
24 logger("registered gravatar in avatar_lookup hook");
28 * Removes the addon hook
30 function gravatar_uninstall() {
31 Addon::unregisterHook('load_config', 'addon/gravatar/gravatar.php', 'gravatar_load_config');
32 Addon::unregisterHook('avatar_lookup', 'addon/gravatar/gravatar.php', 'gravatar_lookup');
34 logger("unregistered gravatar in avatar_lookup hook");
37 function gravatar_load_config(App $a)
39 $a->loadConfigFile(__DIR__. '/config/gravatar.ini.php');
43 * Looks up the avatar at gravatar.com and returns the URL.
48 function gravatar_lookup($a, &$b) {
49 $default_avatar = Config::get('gravatar', 'default_avatar');
50 $rating = Config::get('gravatar', 'rating');
52 // setting default value if nothing configured
54 $default_avatar = 'identicon'; // default image will be a random pattern
56 $rating = 'g'; // suitable for display on all websites with any audience type
58 $hash = md5(trim(strtolower($b['email'])));
60 $url = 'https://secure.gravatar.com/avatar/' .$hash .'.jpg';
61 $url .= '?s=' .$b['size'] .'&r=' .$rating;
62 if ($default_avatar != "gravatar")
63 $url .= '&d=' .$default_avatar;
70 * Display admin settings for this addon
72 function gravatar_addon_admin (&$a, &$o) {
73 $t = get_markup_template( "admin.tpl", "addon/gravatar/" );
75 $default_avatar = Config::get('gravatar', 'default_avatar');
76 $rating = Config::get('gravatar', 'rating');
78 // set default values for first configuration
80 $default_avatar = 'identicon'; // pseudo-random geometric pattern based on email hash
82 $rating = 'g'; // suitable for display on all websites with any audience type
84 // Available options for the select boxes
86 'mm' => L10n::t('generic profile image'),
87 'identicon' => L10n::t('random geometric pattern'),
88 'monsterid' => L10n::t('monster face'),
89 'wavatar' => L10n::t('computer generated face'),
90 'retro' => L10n::t('retro arcade style face'),
99 // Check if Libravatar is enabled and show warning
100 $r = q("SELECT * FROM `addon` WHERE `name` = '%s' and `installed` = 1",
101 DBA::escape('libravatar')
104 $o = '<h5>' .L10n::t('Information') .'</h5><p>' .L10n::t('Libravatar addon is installed, too. Please disable Libravatar addon or this Gravatar addon.<br>The Libravatar addon will fall back to Gravatar if nothing was found at Libravatar.') .'</p><br><br>';
107 // output Gravatar settings
108 $o .= '<input type="hidden" name="form_security_token" value="' . BaseModule::getFormSecurityToken("gravatarsave") .'">';
109 $o .= replace_macros( $t, [
110 '$submit' => L10n::t('Save Settings'),
111 '$default_avatar' => ['avatar', L10n::t('Default avatar image'), $default_avatar, L10n::t('Select default avatar image if none was found at Gravatar. See README'), $default_avatars],
112 '$rating' => ['rating', L10n::t('Rating of images'), $rating, L10n::t('Select the appropriate avatar rating for your site. See README'), $ratings],
117 * Save admin settings
119 function gravatar_addon_admin_post (&$a) {
120 BaseModule::checkFormSecurityToken('gravatarsave');
122 $default_avatar = ((x($_POST, 'avatar')) ? notags(trim($_POST['avatar'])) : 'identicon');
123 $rating = ((x($_POST, 'rating')) ? notags(trim($_POST['rating'])) : 'g');
124 Config::set('gravatar', 'default_avatar', $default_avatar);
125 Config::set('gravatar', 'rating', $rating);
126 info(L10n::t('Gravatar settings updated.') .EOL);