Mục lục
Yêu cầu kỹ thuật ProcessWire CMS
Bản dịch tự động nơ-ron được sử dụng với ProcessWire 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
- ProcessWire CMS 2.x hoặc 3 trở lên
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.
Bạn có thể chọn nền tảng “Other PHP” để tiếp tục với miền đăng ký Linguise , như 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 ProcessWire 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 ProcessWire 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 ProcessWire CMS.
- Đảm bảo nó ở cấp độ gốc của trang web của bạn (nơi chứa các tệp CMS ProcessWire
- Đả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ệc viết lại URL ProcessWire CMS
Theo mặc định, việc viết lại URL đang hoạt động trong ProcessWire 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 ProcessWire CMS .htaccess mặc định.
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, ProcessWire CMS .htaccess của bạn sẽ trông giống như thế này:
# 8. Enable Apache mod_rewrite (required)
# -----------------------------------------------------------------------------------------------
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]
# 8A. Optionally (O) set a rewrite base if rewrites are not working properly on your server.
# -----------------------------------------------------------------------------------------------
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 CMS ProcessWire 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 ProcessWire CMS là thêm nó vào tiêu đề trang web của bạn hoặc phần. ProcessWire CMS có một tệp cụ thể để tải tập lệnh vào tiêu đề.
Nó nằm ở _main.php , bạn có thể tìm thấy nó bằng cách điều hướng đến site/templates/_main.php . Chỉnh sửa tệp tập lệnh để bao gồm liên kết tập lệnh trong phần tiêu đề.
Trình chuyển đổi ngôn ngữ có cờ bây giờ 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 ProcessWire
Để hiển thị bộ chuyển đổi Ngôn ngữ ở vị trí cụ thể, trong ProcessWire , bạn nên đặt vị trí là “In place”.
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;