philvdb / avatar-bundle
允许上传和管理Contao成员和用户的头像(个人照片)
2.0.5
2023-05-16 11:12 UTC
Requires
- php: ^8.0
- ext-gd: *
- contao-components/dropzone: ^5.9
- contao/core-bundle: ^4.9
README
简介
Avatar Contao扩展允许(前端)成员和(后端)用户拥有与他们关联的头像图像,这些图像可以由用户自己以及授权的后端用户进行管理。
技术信息
此包是从terminal42/contao-avatar分叉的,它已经大部分重写并更新,以支持Contao > 4.9和PHP > 8.0。
它应该与原始扩展创建的现有头像文件夹兼容,并且保留了现有标签的插入标签语法。
原始扩展的大多数设置已被删除,Contao中要完成的所有设置只有成员和用户的头像图像调整大小以及缺失头像的默认图像选择。
头像的调整大小现在在客户端浏览器中发生,服务器端的职责已经大大减少。尽管如此,jQuery也不再需要。此扩展现在依赖于Dropzone(Contao Core已经捆绑了它)和Croppie。与原始扩展相反,头像现在在上传时立即保存(覆盖),不再有临时文件的概念,直到表单提交。
使用方法
可以通过将头像字段添加到个人数据模块来在前端上传头像。在后端,头像在成员/用户设置中进行管理。
使用插入标签在前端获取头像
{{avatar::member_current}} - current member
{{avatar::member_current::100x100}} - current member 100x100
{{avatar::member::ID}} - member ID
{{avatar::member::ID::100x100}} - member ID 100x100
{{avatar::user::ID}} - user ID
{{avatar::user::ID::100x100}} - user ID 100x100.
{{avatar_url::xx}} - return URL to asset image only
{{avatar_url_nodefault::xx}} - return empty string instead of default image if no personal avatar available
为开发者提供的粗略概念
- MemberAvatarService和UserAvatarService处理作为输入和输出的文件,有关公共方法的列表,请参阅AbstractAvatarService。
- AvatarController将处理上传和删除请求,并在提供文件(通常来自AvatarService)时提供渲染的HTML。