[VNXF] Auto Attach Images - Create Attachments from External Links 1.5.0

Giới thiệu​

VNXF - Auto Attach Images là add-on dành cho XenForo 2 giúp tự động tải ảnh từ link ngoài (external links) về server và chuyển đổi thành đính kèm (attachment) chính chủ. Phiên bản 1.5.0 bổ sung các tính năng ổn định và tối ưu hóa SEO.

Lợi ích chính​

• Link ảnh vĩnh viễn: Tránh lỗi ảnh "die" do host ngoài xóa hoặc chặn.
• Tốc độ: Tăng tốc tải trang do ảnh được lưu trên server của bạn.
• Quản lý: Dễ dàng kiểm soát dung lượng và nội dung ảnh ngay trong XenForo.
• SEO: Tự động đổi tên ảnh theo tiêu đề bài viết.
• Tương thích tốt với S3.

Tính năng nổi bật (v1.5.0)​

1. Tự động chuyển đổi: Quét bài viết mới/sửa, tìm thẻ IMG, tải ảnh về và thay bằng ATTACH.
2. SEO Friendly Naming: Tên file đính kèm được đặt lại theo format slug-bai-viet-index.ext (VD: huong-dan-xenforo-0.jpg), giúp tối ưu tìm kiếm hình ảnh.
3. Hỗ trợ đa dạng: Xử lý tốt các định dạng .jpg, .png, .gif, .webp và các biến thể thẻ IMG.
4. Cơ chế Job ngầm: Chạy ngầm (background job) nên không làm chậm thao tác đăng bài của thành viên.
5. Extensibility: Hỗ trợ Developer can thiệp thông qua Code Event vnxf_aai_process_image (để đóng dấu ảnh, resize...).

Yêu cầu hệ thống​

• XenForo 2.1 trở lên (Khuyên dùng XenForo 2.2/2.3).
• PHP extension cURL và fileinfo.
• Server cho phép fopen URL ngoại mạng.
• Thư mục internal_data và data có quyền ghi (writable).

Hướng dẫn Cài đặt​

1. Tải xuống: Tải file VNXF-AutoAttachImages-1.5.0.zip.
2. Upload: Giải nén và upload thư mục src/addons/VNXF/AutoAttachImages lên server (ngang hàng với thư mục src gốc của XenForo).
3. Cài đặt:
   • Truy cập AdminCP -> Add-ons.
   • Tìm VNXF - Auto Attach Images và nhấn Install.

Cấu hình (Options)​

Truy cập AdminCP -> Setup -> Options -> VNXF - Auto Attach Images:

• Only active when in User groups: Giới hạn nhóm thành viên được phép dùng tính năng (Ví dụ: chỉ Admin hoặc VIP). Để trống = Áp dụng tất cả.
• Only active when in Forums: Giới hạn chuyên mục (Node) được phép dùng. Để trống = Áp dụng tất cả.

Cách sử dụng​

Add-on hoạt động theo cơ chế "Cài đặt và Quên đi" (Set and Forget).

• Khi thành viên đăng bài hoặc sửa bài có chứa link ảnh ngoài
• Mã:

  [IMG]http://site-khac.com/anh.jpg[/IMG].

• Add-on sẽ tạo một Job chạy ngầm.
• Sau vài giây, ảnh sẽ được tải về và link trong bài viết tự động chuyển thành
• Mã:

  [ATTACH]...[/ATTACH].

Kiểm tra lỗi (Troubleshooting)​

Nếu ảnh không tải về được:

1. Kiểm tra Server Error Log trong AdminCP để xem thông báo lỗi chi tiết.
2. Lỗi thường gặp:
   • Host chặn kết nối ra ngoài (liên hệ nhà cung cấp host).
   • Link ảnh bị chặn (hotlink protection) từ nguồn.
   • Thời gian phản hồi trang nguồn quá lâu (timeout).