Mục lục
Yêu cầu kỹ thuật MODX CMS
Bản dịch tự động được sử dụng với Khung quản lý nội dung MODX 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
- MODX 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 MODX 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 MODX 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 MODX 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 MODX
- Đả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 MODX CMS
Theo mặc định, việc viết lại URL đã được kích hoạt trong MODX 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 MODX 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, MODX 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]
# Prevent rewrite the .well-known directory used by LetsEncrypt by rules below of this rule
RewriteRule "^\.well-known/" - [L]
# Prevent dot directories (hidden directories like .git) to be exposed to the public
# Except for the .well-known directory used by LetsEncrypt a.o
RewriteRule "/\.|^\.(?!well-known/)" - [F]
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 MODX 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 MODX CMS là thêm nó vào tiêu đề trang web của bạn hoặc mã số.
Để đạt được điều này, hãy mở MODX Manager. Sau đó vào Elements, Select BaseTemplate và cuộn xuống bạn sẽ hiển thị Mã mẫu (HTML), chỉnh sửa mã để đưa liên kết tập lệnh vào trong mã đầ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 MODX CMS
Để hiển thị bộ chuyển đổi ngôn ngữ tại một vị trí cụ thể, trong MODX 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ủ 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;