Mục lục
Yêu cầu kỹ thuật Craft CMS
Bản dịch tự động nơ-ron được sử dụng với Craft CMS sẽ yêu cầu sử dụng tập lệnh PHP (có thể tải xuống bên dưới). Để cài đặt tập lệnh Linguise , bạn cần có các yêu cầu sau:
- Chạy PHP 7+
- Máy chủ Apache, LiteSpeed, NGINX, IIS
- Đảm bảo tính năng viết lại URL được kích hoạt trên máy chủ của bạn
- Craft CMS 3 hoặc 4 trở lên
- Thông thường, thư mục gốc của Craft CMS /web ”.
1. Tạo khóa API
bảng điều khiển Linguise của bạn , trước tiên, bạn cần thiết lập miền mới và lưu cài đặt của miền đó để lấy Khóa API.
Chỉ cần chọn nền tảng Craft CMS để nhận liên kết thích hợp tới tài liệu này cũng như ngôn ngữ nguồn và ngôn ngữ đích.
Sau đó, bạn sẽ nhận được:
- Khóa API xác thực tư cách thành viên của bạn
- Liên kết đến tập lệnh Linguise cho trình chuyển đổi ngôn ngữ
Khóa API là thứ cần thiết để kích hoạt bản dịch trên trang web Craft CMS của bạn. Về cơ bản, khóa API sẽ kiểm tra ngôn ngữ nào được kích hoạt trên miền của bạn và cho phép dịch nội dung tự động.
Hiện tại, bạn có thể sao chép Khóa API và giữ nó trong khay nhớ tạm của mình.
2. Tải lên và kết nối tập lệnh dịch Linguise
Tập lệnh dịch Linguise cần được tải lên trên máy chủ của bạn nơi cài đặt Craft CMS :
Sau khi tập lệnh được tải xuống, hãy giải nén nó và tải nó lên thư mục gốc nơi cài đặt Craft CMS .
- Đảm bảo nó ở cấp độ gốc của trang web của bạn (nơi Craft CMS , theo mặc định, nó nằm trong /web )
- Đảm bảo rằng thư mục giữ tên mặc định “ linguise ”
Khóa Linguise sẽ cần được sao chép vào Configuration.php mà bạn đã tải lên máy chủ của mình, chỉnh sửa tệp và sao chép Khóa API của bạn giữa các dấu ngoặc kép đơn giản, thay thế văn bản REPLACE_BY_TOUR TOKEN.
3. Thiết lập viết lại URL Craft CMS
Theo mặc định, việc viết lại URL đang hoạt động trong Craft CMS . Nếu không phải như vậy, bạn có thể kích hoạt nó từ nhà cung cấp dịch vụ lưu trữ của mình.
URL theo ngôn ngữ cần được định cấu hình trong .htaccess. Chỉ cần sao chép mã bên dưới sau mã “ RewriteEngine on ” có sẵn trong Craft CMS .htaccess.
RewriteEngine On
RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
Cuối cùng, Craft CMS .htaccess của bạn sẽ trông giống như thế này:
RewriteEngine On
RewriteRule ^(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ linguise/linguise.php?linguise_language=$1&original_url=$2 [L,QSA]
# Send would-be 404 requests to Craft
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_URI} !^/(favicon\.ico|apple-touch-icon.*\.png)$ [NC]
RewriteRule (.+) index.php?p=$1 [QSA,L]
Bây giờ bạn có thể tải tất cả các trang đã dịch của mình bằng URL, ví dụ: www.shop.com /fr/
Bây giờ hãy tải trình chuyển đổi ngôn ngữ.
4. Kích hoạt trình chuyển đổi ngôn ngữ
4.1 Tải tập lệnh Linguise JS
Liên kết tập lệnh Linguise JS cần được tải trên tất cả các trang Craft CMS của bạn để hiển thị trình chuyển đổi ngôn ngữ với các cờ và URL thay thế trong tiêu đề HTML của bạn (cho mục đích SEO).
Để sao chép liên kết tập lệnh, từ bảng điều khiển Linguise , hãy chuyển đến cài đặt miền và sao chép liên kết tập lệnh.
Cách dễ nhất để tải mã này trong craft CMS là thêm nó vào chỉ mục mẫu của bạn. Mở thư mục /template và chỉnh sửa tệp chỉ mục để đưa liên kết tập lệnh vào phần tiêu đề.
Trình chuyển đổi ngôn ngữ là cửa sổ bật lên gắn cờ để chọn ngôn ngữ bạn muốn. Để tải nó, bạn cần sao chép mã được cung cấp ở cuối cấu hình trang web vào phần đầu trang HTML của bạn. Trình chuyển đổi ngôn ngữ cờ sau đó sẽ được tải tự động.
Trình chuyển đổi ngôn ngữ sẽ được hiển thị theo mặc định ở vị trí nổi trên cùng bên phải trên trang web của bạn. Bạn có thể tùy chỉnh nó như được giải thích trong chương tiếp theo.
Lưu ý quan trọng về SEO: Số lượng ngôn ngữ bạn thiết lập có ảnh hưởng lớn đến SEO. Khi bạn thiết lập ngôn ngữ dịch, nếu bạn có một số lượng lớn các trang được lập chỉ mục (>500), công cụ tìm kiếm có thể mất nhiều thời gian để xử lý chúng. Nó có thể ảnh hưởng đến SEO của bạn bằng ngôn ngữ gốc của bạn. Đó là lý do tại sao chúng tôi khuyên bạn nên thêm tối đa 5 ngôn ngữ lúc đầu, sau đó khi nó được lập chỉ mục, bạn có thể thêm các ngôn ngữ theo đợt 3 ngôn ngữ mỗi tháng.
Thiết lập trình chuyển đổi ngôn ngữ
Trình chuyển đổi ngôn ngữ có thể được tùy chỉnh từ bảng điều khiển Linguise > Cài đặt > Hiển thị cờ ngôn ngữ. Mọi sửa đổi ở đây sẽ được phản ánh trên trang web.
Ở bên phải màn hình, bạn có bản xem trước của trình chuyển đổi ngôn ngữ. Dưới đây là các yếu tố bạn có thể thiết lập:
- 3 bố cục: cạnh nhau, thả xuống hoặc bật lên
- Vị trí chuyển đổi ngôn ngữ
- Nội dung trình chuyển đổi ngôn ngữ
- Tên ngôn ngữ bằng tiếng Anh hoặc tiếng mẹ đẻ
- Cờ hình dạng và kích thước
- Màu sắc và bóng hộp
Tải trình chuyển đổi ngôn ngữ trong nội dung Craft CMS
Để hiển thị bộ chuyển đổi Ngôn ngữ tại một vị trí cụ thể, trong Craft CMS , bạn nên đặt vị trí là “Tại chỗ”.
Khi bạn đã đặt vị trí trong Linguise , bạn có thể thêm mã ngắn bên dưới để đưa nó vào. Nhấp vào mã bên dưới để đặt nó vào clipboard của bạn.
Sau khi được thêm vào, trên giao diện người dùng, bạn sẽ thấy cờ và tên ngôn ngữ được hiển thị trong vùng HTML mà bạn đã thêm mã.
Kích hoạt tùy chọn hệ thống bộ nhớ cache cục bộ
Như một tùy chọn, bạn có thể kích hoạt hệ thống bộ nhớ cache cục bộ lưu trữ URL và nội dung đa ngôn ngữ liên quan của nó để phân phát các trang nhanh hơn. Bộ nhớ cache cục bộ sẽ lưu một số dữ liệu truyền giữa máy chủ Linguise và máy chủ trang web của bạn. Bộ đệm chỉ được sử dụng khi một trang đã được dịch và chưa được cập nhật. Bộ nhớ đệm được giữ ở mức ưu tiên sẽ là bộ nhớ đệm từ các trang đa ngôn ngữ được xem nhiều nhất.
Để bổ sung cho điều đó, bạn có thể xác định dung lượng bộ đệm được lưu trữ bằng MB. Trong ví dụ sau, bộ nhớ đệm được kích hoạt và dung lượng bộ nhớ đệm cần giữ là 500 MB.
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Dịch tự động trên máy chủ Windows IIS
Thêm dòng tương ứng với trình tạo trang web của bạn vào tệp Web.config.
Nó phải được đặt trước bất kỳ chuyển hướng nào khác, đặc biệt là chuyển hướng đến tệp chính PHP của bạn:
Dịch tự động trên máy chủ NGINX
rewrite ^/(af|sq|am|ar|hy|az|eu|be|bn|bs|bg|ca|ceb|ny|zh-cn|zh-tw|co|hr|cs|da|nl|en|eo|et|tl|fi|fr|fy|gl|ka|de|el|gu|ht|ha|haw|iw|hi|hmn|hu|is|ig|id|ga|it|ja|jw|kn|kk|km|ko|ku|ky|lo|la|lv|lt|lb|mk|mg|ms|ml|mt|mi|mr|mn|my|ne|no|ps|fa|pl|pt|pa|ro|ru|sm|gd|sr|st|sn|sd|si|sk|sl|so|es|su|sw|sv|tg|ta|te|th|tr|uk|ur|uz|vi|cy|xh|yi|yo|zu|zz-zz)(?:$|/)(.*)$ /linguise/linguise.php?linguise_language=$1&original_url=$2 last;