Mục lục
Yêu cầu kỹ thuật PyroCMS
Bản dịch tự động nơ-ron được sử dụng với PyroCMS 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
- PyroCMS 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 PyroCMS 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 PyroCMS :
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 PyroCMS .
- Đảm bảo nó ở cấp độ gốc của trang web của bạn (nơi chứa các tệp PyroCMS theo mặc định, nó nằm trong /public folder )
- Đảm bảo rằng thư mục giữ tên mặc định “ linguise ”
Vui lòng cho chúng tôi biết Liên hệ với chúng tôi .
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 PyroCMS
Theo mặc định, tính năng ghi lại URL đang hoạt động trong PyroCMS . 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 PyroCMS .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, PyroCMS .htaccess của bạn sẽ trông giống như thế này:
Options -MultiViews
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]
RewriteBase /
# Redirect trailing slashes
RewriteRule ^(.*)/$ /$1 [L,R=301]
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 PyroCMS 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 PyroCMS là thêm nó vào tiêu đề trang web của bạn hoặc mã số. PyroCMS đi kèm với một môi trường đặc biệt và nó có một tệp cụ thể để thêm tập lệnh vào tiêu đề.
Nó nằm trong scripts.twig mà bạn có thể tìm thấy bằng cách điều hướng trong thư mục cài đặt CMS tại đây:
nhà cung cấp/ pyrocms /*YOUR_THEME*/resources/views/partials/scripts.twig . Theo mặc định, PyroCMS là chủ đề khởi đầu.
Chỉnh sửa tệp tập lệnh để đưa liên kết tập lệnh vào phần tiêu đề như bên dưới.
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ữ trong PyroCMS
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 PyroCMS
Để hiển thị bộ chuyển đổi Ngôn ngữ tại một vị trí cụ thể, trong PyroCMS , 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ủ 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;