Mục lục
Yêu cầu kỹ thuật
Để chạy tập lệnh dịch Linguise , bạn cần có những thứ sau:
- Chạy PHP 7+ và Laravel
- Máy chủ Apache, LiteSpeed, NGINX, IIS
- Kích hoạt tính năng ghi lại URL trong cấu hình máy chủ của bạn
- Thư mục gốc của Laravel public ”, hãy đảm bảo cài đặt Linguise trong thư mục này
1. Tạo khóa API
Sau khi kết nối với trang tổng Linguise , bạn cần thiết lập một miền mới và lưu cài đặt của miền đó để nhận Khóa API.
Khóa API là thứ cần thiết để kích hoạt bản dịch trên trang web 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 nào và sẽ cho phép tạo các trang dịch nơ-ron.
Sao chép Khóa API và giữ nó trong khay nhớ tạm của bạn.
Sau đó, bằng cách nhấp vào tab “Script PHP”, bạn sẽ nhận được hướng dẫn cài đặt mà chúng tôi sẽ làm theo chi tiết tại đây.
2. Tải lên và kết nối tập lệnh dịch Linguise
Kịch bản dịch Linguise cần được tải lên máy chủ của bạn, trong thư mục cài đặt Laravel , bạn có thể tải xuống tại đây:
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 Laravel .
- Hãy chắc chắn rằng nó ở cấp độ gốc của Laravel (thường Laravel đặt gốc trên thư mục “ public ” bạn có thể cài đặt Linguise ở đó)
- Đảm bảo rằng thư mục được gọi là " linguise " (tên mặc định khi thư mục được giải nén)
Khóa Linguise sẽ cần được sao chép vào thư mục: …/ linguise /Configuration.php tệp 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 URL ngôn ngữ
URL theo ngôn ngữ cần được định cấu hình trong tệp .htaccess, nếu bạn có “RewriteBase /” trong tệp của mình, chỉ cần sao chép sau đó tất cả mã sau:
RewriteEngine On
RewriteRule ^linguise/linguise.php$ - [L]
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]
4. Kích hoạt trình chuyển đổi ngôn ngữ trên Laravel
Trình chuyển đổi ngôn ngữ là cửa sổ bật lê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 (bảng điều khiển Linguise ).
Tập lệnh phải được tải vào phần đầu của trang HTML do Laravel xử lý. 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ó theo ý muốn với CSS.
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 Laravel
Để hiển thị Language switcher tại một vị trí cụ thể, trong Laravel 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ã.
Hệ thống bộ đệm cục bộ cho các trang Laravel
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.
Là một tùy chọn, bạn có thể xác định dung lượng bộ đệm được lưu trữ bằng MB. Trong ví dụ sau, bộ đệm được kích hoạt và dung lượng bộ đệm cần giữ là 500 MB:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Cài đặt cụ thể cho Nền tảng Laravel
Trong tệp Configuration.php, chúng tôi cũng có một cài đặt cho phép chuyển một số cấu hình cụ thể cho CMS hoặc không phải CMS. Theo mặc định, nó là tự động nhưng nhóm hỗ trợ có thể yêu cầu bạn cá nhân hóa nó để sử dụng một số cài đặt đặc biệt.
Đây là mã để thêm cho Laravel , đây là tên CMS viết thường:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'laravel';
Từ SQLite đến MySQL
Vẫn trong Configuration.php có cài đặt buộc sử dụng MySQL thay vì SQLite, trong trường hợp SQLite không được cài đặt trên máy chủ.
Trong trường hợp này, bạn sẽ cần điền thông tin MySQL vào phần này của tệp Configuration.php:
/** Advanced database configuration **/
/*
* In case you don't want to use Sqlite, you can use MySQL
* To do so, you need to fill the following variables
* Linguise will create the tables for you
*/
public static $db_host = '';
public static $db_user = '';
public static $db_password = '';
public static $db_name = '';
public static $db_prefix = '';
Dịch tự động trên máy chủ Laravel + 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ủ Laravel + 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;