def avatar(context, user, size, service_id=None):
"""Render the user's avatar to HTML.
When the ``service_id`` argument is not provided, or the specified service
is not registered or is not enabled, the default avatar service will be
used for rendering instead.
Args:
context (django.template.Context):
The template rendering context.
user (django.contrib.auth.models.User):
The user whose avatar is to be rendered.
size (int):
The height and width of the avatar, in pixels.
service_id (unicode, optional):
The unique identifier of the avatar service to use. If this is
omitted, or the specified service is not registered and enabled,
the default avatar service will be used.
Returns:
django.utils.safestring.SafeText:
The user's avatar rendered to HTML, or an empty string if no avatar
service could be found.
"""
service = avatar_services.get_or_default(service_id)
if service is None:
logging.error('Could not get a suitable avatar service for user %s.',
user)
return mark_safe('')
return service.render(request=context['request'], user=user, size=size)
def avatar(context, user, size, service_id=None):
"""Render the user's avatar to HTML.
When the ``service_id`` argument is not provided, or the specified service
is not registered or is not enabled, the default avatar service will be
used for rendering instead.
Args:
context (django.template.Context):
The template rendering context.
user (django.contrib.auth.models.User):
The user whose avatar is to be rendered.
size (int):
The height and width of the avatar, in pixels.
service_id (unicode, optional):
The unique identifier of the avatar service to use. If this is
omitted, or the specified service is not registered and enabled,
the default avatar service will be used.
Returns:
django.utils.safestring.SafeText:
The user's avatar rendered to HTML, or an empty string if no avatar
service could be found.
"""
service = avatar_services.get_or_default(service_id)
if service is None:
logging.error('Could not get a suitable avatar service for user %s.',
user)
return mark_safe('')
return service.render(request=context['request'], user=user, size=size)
def avatar_service(self):
"""The avatar service the user has selected.
Returns:
djblets.avatars.services.base.AvatarService:
The avatar service.
"""
service_id = self.settings.get('avatars', {}).get('avatar_service_id')
return avatar_services.get_or_default(service_id)
def avatar_service(self):
"""The avatar service the user has selected.
Returns:
djblets.avatars.services.base.AvatarService:
The avatar service.
"""
service_id = self.settings.get('avatars', {}).get('avatar_service_id')
return avatar_services.get_or_default(service_id)
def avatar_url(context, user, size, resolution='1x', service_id=None):
"""Return the URL of the requested avatar.
Args:
context (django.template.Context):
The template rendering context.
user (django.contrib.auth.models.User):
The user whose avatar is to be rendered.
size (int):
The height and width of the avatar, in pixels.
resolution (unicode, optional):
The resolution of the avatar. This should be one of ``'1x'``, for
normal DPI, or ``'2x'``, for high DPI. This defaults to normal DPI.
service_id (unicode, optional):
The unique identifier of the avatar service to use. If this is
omitted, or the specified service is not registered and enabled,
the default avatar service will be used.
Returns:
django.utils.safestring.SafeText:
The URL of the requested avatar, or an empty string if no avatar
service could be found.
"""
if resolution not in ('1x', '2x'):
raise ValueError('resolution should be "1x" or "2x", not %r.'
% resolution)
service = avatar_services.get_or_default(service_id)
if service is None:
logging.error('Could not get a suitable avatar service for user %s.',
user)
return mark_safe('')
urls = service.get_avatar_urls(request=context['request'],
user=user,
size=size)
return urls[resolution]
def avatar_url(context, user, size, resolution='1x', service_id=None):
"""Return the URL of the requested avatar.
Args:
context (django.template.Context):
The template rendering context.
user (django.contrib.auth.models.User):
The user whose avatar is to be rendered.
size (int):
The height and width of the avatar, in pixels.
resolution (unicode, optional):
The resolution of the avatar. This should be one of ``'1x'``, for
normal DPI, or ``'2x'``, for high DPI. This defaults to normal DPI.
service_id (unicode, optional):
The unique identifier of the avatar service to use. If this is
omitted, or the specified service is not registered and enabled,
the default avatar service will be used.
Returns:
django.utils.safestring.SafeText:
The URL of the requested avatar, or an empty string if no avatar
service could be found.
"""
if resolution not in ('1x', '2x'):
raise ValueError('resolution should be "1x" or "2x", not %r.' %
resolution)
service = avatar_services.get_or_default(service_id)
if service is None:
logging.error('Could not get a suitable avatar service for user %s.',
user)
return mark_safe('')
urls = service.get_avatar_urls(request=context['request'],
user=user,
size=size)
return urls[resolution]