• Categorized avatar gallery under User CP → Change Avatar
  
• Automatic recursive image discovery
  
• Subdirectories become selectable collections
  
• Compact, scrollable avatar grid
  
• Configurable default collection and gallery paths
  
• Optional random avatar assignment for new registrations
  
• Randomize existing users through Admin CP
  
• Repair missing local or gallery avatar assignments
  
• Give random avatars to users without an avatar
  
• Replace a specific saved avatar path or URL
  
• Background processing for large forums
  
• Supports GIF, JPG, JPEG, JPE, BMP, PNG, and optional WebP
  
• Secure server-side path and image validation
  

• MyBB 1.8.x
  
• Avatar images stored in a web-accessible gallery directory
  

1. Upload the contents of the included Upload directory to your MyBB root.
   
2. Place avatar images inside:
   
   Code: 

   images/avatars
   

3. Create folders to organize avatars into collections:
   
   Code: 

   images/avatars/
   ├── general/
   ├── fantasy/
   ├── games/
   │   └── rpg/
   └── sci-fi/
   

4. Install and activate Avatar Gallery under Admin CP → Configuration → Plugins.
   
5. Review its settings under Admin CP → Configuration → Settings → Avatar Gallery.
   

images/avatars

gif,jpg,jpeg,jpe,bmp,png,webp

games/rpg

• Repair Broken Avatar: Replaces missing saved local or gallery avatars. This is useful after renaming, moving, or deleting gallery files and folders.
  
• Fix No Avatar: Assigns random gallery avatars to users who currently have no saved avatar.
  
• Randomize Existing: Replaces an exact saved avatar path or URL with random gallery avatars.
  

• Fixed HTTP 500 errors when saving gallery selections on strict MySQL or MariaDB installations.
  
• Added tools for repairing broken avatars, fixing users without avatars, and randomizing matching existing avatars.
  
• Added automatic immediate or background processing based on the number of affected users.
  
• Added queued-job progress reporting and duplicate-job protection.
  
• Added compatibility for gallery records created by earlier versions.
  

Avatar Gallery bổ sung một công cụ chọn avatar an toàn, được phân loại vào trang MyBB Change Avatar tiêu chuẩn. Quản trị viên tổ chức hình ảnh vào các thư mục, trong khi plugin tự động phát hiện và hiển thị chúng dưới dạng bộ sưu tập có thể chọn.

Tính năng

• Thư viện avatar được phân loại dưới User CP → Thay đổi Avatar
  
• Tự động phát hiện hình ảnh đệ quy
  
• Thư mục con trở thành các bộ sưu tập có thể chọn
  
• Lưới avatar nhỏ gọn, có thể cuộn
  
• Đường dẫn bộ sưu tập và thư viện mặc định có thể cấu hình
  
• Tùy chọn gán avatar ngẫu nhiên cho đăng ký mới
  
• Ngẫu nhiên hóa người dùng hiện có thông qua Admin CP
  
• Sửa lỗi gán avatar cục bộ hoặc thư viện bị thiếu
  
• Tặng avatar ngẫu nhiên cho người dùng không có avatar
  
• Thay thế đường dẫn hoặc URL avatar đã lưu cụ thể
  
• Xử lý nền cho các diễn đàn lớn
  
• Hỗ trợ GIF, JPG, JPEG, JPE, BMP, PNG và tùy chọn WebP
  
• Đường dẫn an toàn phía máy chủ và xác thực hình ảnh
  

• MyBB 1.8.x
  
• Hình ảnh avatar được lưu trữ trong thư mục thư viện truy cập web
  

1. Tải lên nội dung của các tài liệu đi kèmTải lênthư mục đến thư mục gốc MyBB của bạn.
   
2. Đặt hình ảnh avatar bên trong:
   
   Mã nguồn:

   Hình ảnh/avatar

3. Tạo thư mục để tổ chức avatar thành các bộ sưu tập:
   
   Mã nguồn:

   hình ảnh/avatar/ 
   ├── chung/ 
   ├── tưởng tượng/ 
   ├── trò chơi/ 
   │ └── RPG/ 
   └── Khoa học viễn tưởng/

4. Cài đặt và kích hoạtThư viện Avatardưới mục Quản trị CP → Cấu hình → Plugins.
   
5. Xem lại cài đặt của nó trong phần Quản trị CP → Cài đặt → Cài đặt → Avatar.
   

Người dùng có thể chọn hình ảnh trong thư viện dưới mục User CP → Change Avatar.

Bối cảnh

Thư mục thư viện Avatar

Thư mục hệ thống tập tin mà MyBB quét, tương đối so với gốc bo mạch. Mặc định:

Hình ảnh/avatar

Đường dẫn công khai được sử dụng để hiển thị các hình ảnh đó. Điều này thường khớp với thư mục thư viện thư viện.

Các phần mở rộng hình ảnh được phép

gif, jpg, jpeg, jpe, bmp, png, webp

WebP được hỗ trợ nhưng phải bật thủ công.

Bộ sưu tập mặc định

Kiểm soát bộ sưu tập nào xuất hiện đầu tiên. Đường dẫn lồng nhau như

Trò chơi/RPG

được hỗ trợ. Để trống để sử dụng bộ sưu tập được phát hiện đầu tiên.

Avatar ngẫu nhiên khi đăng ký

Gán một avatar thư viện ngẫu nhiên cho người dùng mới đăng ký, những người sẽ nhận avatar mặc định của MyBB.

Công cụ bảo trì Avatar

Mở:

Quản trị viên CP → Công cụ & Bảo trì → Sửa chữa Thư viện Avatar

Có ba hoạt động bảo trì:

• Sửa Avatar Bị Hỏng:Thay thế các avatar cục bộ hoặc thư viện đã lưu bị thiếu. Điều này hữu ích sau khi đổi tên, di chuyển hoặc xóa các tệp và thư mục trong thư viện.
  
• Sửa lỗi không có hình đại diện:Gán avatar thư viện ngẫu nhiên cho người dùng hiện chưa có avatar lưu.
  
• Ngẫu nhiên hóa các dữ liệu hiện có:Thay thế chính xác đường dẫn hoặc URL avatar đã lưu bằng các avatar trong thư viện ngẫu nhiên.
  

Các thao tác ảnh hưởng đến 500 người dùng hoặc ít hơn sẽ chạy ngay lập tức. Các thao tác lớn hơn được xếp hàng tự động và xử lý theo lô thông qua hệ thống tác vụ theo lịch của MyBB.

Trang hiển thị tiến trình công việc, ngăn chặn các công việc trùng lặp, yêu cầu xác nhận và ghi lại các thao tác trong nhật ký quản trị viên. URL avatar bên ngoài không bị thay đổi trừ khi được nhập rõ ràng dưới mục Ngẫu nhiên hóa hiện có.

Bảo mật

Mỗi lựa chọn thư viện đều được xác thực trên máy chủ. Plugin xác nhận rằng hình ảnh tồn tại bên trong thư viện đã cấu hình, sử dụng phần mở rộng được phép, và không sử dụng duyệt thư mục hoặc liên kết ký hiệu thoát ra.

Người dùng không thể gửi các đường dẫn hệ thống tệp hoặc URL tùy ý làm lựa chọn trong thư viện.

Nâng cấp

Tải lên các tệp mới lên trên các tệp plugin hiện có. Không cần cài đặt lại.

Sau khi nâng cấp, mở Sửa chữa Thư viện Hình Avatar một lần để đồng bộ hóa tác vụ đã lên lịch và các thành phần CP Quản trị. Các thiết lập hiện có và các gán avatar hợp lệ sẽ được giữ nguyên.

Thay đổi phiên bản 1.0.3

• Đã sửa lỗi HTTP 500 khi lưu các lựa chọn thư viện trên các cài đặt MySQL hoặc MariaDB nghiêm ngặt.
  
• Thêm công cụ sửa avatar bị hỏng, sửa người dùng không có avatar, và ngẫu nhiên hóa các avatar hiện có.
  
• Đã thêm xử lý tự động tức thì hoặc xử lý nền dựa trên số lượng người dùng bị ảnh hưởng.
  
• Thêm báo cáo tiến độ công việc trong hàng đợi và bảo vệ công việc trùng lặp.
  
• Thêm tính tương thích cho các bản ghi thư viện được tạo bởi các phiên bản trước.
  

Avatar Gallery được phát hành theo Giấy phép Công cộng GNU phiên bản 3.0.

Kho lưu trữ GitHub