Mục lục
Yêu cầu kỹ thuật
Để chạy tập lệnh dịch Linguise , bạn cần những thứ sau:
- Hỗ trợ PHP 7 trở lên và Laravel
- Apache, LiteSpeed, NGINX, máy chủ IIS
- Kích hoạt tính năng viết lại URL trong cấu hình máy chủ của bạn
- Thư mục gốc của Laravel public ”, vì vậy 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 bảng điều khiển Linguise trước tiên bạn cần thiết lập một tên miền mới và lưu cài đặt của nó để nhận Khóa API.
Khóa API là thứ cần thiết để kích hoạt tính năng 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 tên miền nào và cho phép tạo ra các trang dịch thuật nơ-ron.
Sao chép Khóa API và lưu vào bộ nhớ tạm.
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 chi tiết mà chúng ta sẽ làm theo ở đây.
2. Tải lên và kết nối tập lệnh dịch Linguise
Bạn cần tải tập lệnh dịch Linguise lên máy chủ của mình, vào thư mục nơi Laravel được cài đặt. Bạn có thể tải xuống tại đây:
Sau khi tải xuống tập lệnh, hãy giải nén và tải nó lên thư mục gốc nơi Laravel được cài đặt.
- Hãy đảm bảo rằng nó nằm ở thư mục gốc của Laravel (thường thì Laravel đặt thư mục gốc ở thư mục “ public ”, bạn có thể cài đặt Linguise ở đó).
- Hãy đảm bảo thư mục được đặt tên là “ linguise ” (tên mặc định khi thư mục được giải nén).
Làm thế nào để truy cập giao diện kịch bản Linguise ?
Sau khi hoàn tất Linguise , bạn có thể truy cập bảng điều khiển bằng cách truy cập trang web của mình theo định dạng URL sau
linguise https://www.domain.com/linguise
Thay đổi địa chỉ tên miền cho phù hợp với địa chỉ trang web của bạn*
Đảm bảo Linguise có quyền đọc và ghi hợp lệ*
Thiết lập mật khẩu và kết nối cơ sở dữ liệu
Sau khi truy cập vào giao diện kịch bản, bạn sẽ thấy màn hình thiết lập nơi bạn có thể tạo mật khẩu và kết nối với cơ sở dữ liệu mà bạn muốn sử dụng.
Bạn có thể:
- Hãy đặt mật khẩu, mật khẩu này sẽ cần thiết cho việc truy cập vào giao diện này trong tương lai.
- Hãy chọn loại cơ sở dữ liệu bạn muốn sử dụng — MySQL hoặc SQLite, tùy thuộc vào cấu hình và sở thích của bạn.
Quá trình thiết lập ban đầu này đảm bảo quyền truy cập an toàn và cho phép bạn cấu hình tập lệnh theo môi trường của mình.
Kết nối cơ sở dữ liệu MySQL
Nếu bạn chọn MySQL, một giao diện khác sẽ hiện ra yêu cầu bạn nhập các thông tin kết nối sau vào các trường cấu hình MySQL bên dưới:
Hãy đảm bảo thông tin chính xác để thiết lập kết nối thành công với cơ sở dữ liệu MySQL của bạn.
MySQL so với SQLite – Sự khác biệt là gì?
Cả MySQL và SQLite đều là những hệ thống cơ sở dữ liệu phổ biến được sử dụng để lưu trữ và quản lý dữ liệu cho các trang web và ứng dụng. Tuy nhiên, chúng được thiết kế cho các trường hợp sử dụng khác nhau và có một số điểm khác biệt chính:
| Tính năng | SQLite | MySQL |
|---|---|---|
| Cài đặt | Rất dễ (cần cài đặt SQLite) | Yêu cầu thiết lập máy chủ |
| Lưu trữ | Hàng đơn | Được quản lý bởi máy chủ MySQL |
| Hiệu suất | Tuyệt vời cho các ứng dụng quy mô nhỏ | Thích hợp hơn cho các hệ thống lớn, có lưu lượng truy cập cao |
| Trường hợp sử dụng | Ứng dụng địa phương, thử nghiệm, trang web nhỏ | Ứng dụng web, thương mại điện tử, hệ thống doanh nghiệp |
Giao diện kịch bản Linguise : Thiết lập cho nền tảng PHP
Bảng điều khiển dịch thuật Linguise , trước đây chỉ khả dụng cho Joomla và WordPress, nay đã mở rộng hỗ trợ sang PHP và các nền tảng khác. Bản cập nhật này cho phép người dùng dễ dàng cấu hình các cài đặt ngôn ngữ—như tùy chọn hiển thị, kiểu cờ và tùy chỉnh giao diện—trực tiếp từ một giao diện thống nhất, bất kể họ đang sử dụng CMS hay framework nào.
Quản trị viên có thể quản lý cài đặt Linguise hiệu quả hơn, với các tính năng nhất quán như cửa sổ bật lên chọn ngôn ngữ, hiệu ứng đổ bóng và các biến thể lựa chọn cờ theo khu vực. Bảng điều khiển vẫn giữ thiết kế thân thiện với người dùng trong khi cung cấp khả năng tương thích rộng hơn cho nhiều môi trường web khác nhau.
3. Thiết lập URL ngôn ngữ
Bạn cần cấu hình URL theo ngôn ngữ trong tệp .htaccess. Nếu tệp của bạn có dòng “RewriteBase /”, hãy sao chép toàn bộ đoạn mã sau vào sau dòng đó:
<IfModule mod_rewrite.c>
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]
</IfModule>
4. Kích hoạt trình chuyển đổi ngôn ngữ trên Laravel
Công cụ chuyển đổi ngôn ngữ là cửa sổ bật lên để chọn ngôn ngữ bạn muốn sử dụng. Để tải công cụ này, bạn cần sao chép đoạn mã được cung cấp ở cuối phần cấu hình trang web (bảng điều khiểnLinguise ).
Đoạn mã này cần được tải trong phần head của các trang HTML do Laravelxử lý. Sau đó, bộ chuyển đổi ngôn ngữ sẽ được tải tự động.
Theo mặc định, bộ chuyển đổi ngôn ngữ sẽ được hiển thị ở vị trí nổi phía trên bên phải trang web của bạn. Bạn có thể tùy chỉnh nó theo ý muốn bằng CSS.
Lưu ý quan trọng về SEO: Số lượng ngôn ngữ bạn thiết lập có tác động rất lớn đến SEO. Khi bạn thiết lập các ngôn ngữ dịch, nếu bạn có số lượng trang được lập chỉ mục lớn (>500), công cụ tìm kiếm có thể mất nhiều thời gian để xử lý chúng. Điều này có thể ảnh hưởng đến SEO của bạn ở ngôn ngữ gốc. Đó 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ữ trước, sau đó khi các trang đã được lập chỉ mục, bạn có thể thêm ngôn ngữ theo từng đợt 3 ngôn ngữ mỗi tháng.
Thiết lập công tắc ngôn ngữ
Bạn có thể tùy chỉnh bộ chuyển đổi ngôn ngữ từ bảng điều khiển Linguise > Cài đặt > Hiển thị cờ ngôn ngữ. Mọi thay đổi ở đây sẽ được phản ánh trên trang web.
Ở phía bên phải màn hình, bạn sẽ thấy bản xem trước của bộ chuyển đổi ngôn ngữ. Dưới đây là các yếu tố bạn có thể thiết lập:
- 3 kiểu bố cục: cạnh nhau, menu thả xuống hoặc cửa sổ bật lên
- Vị trí chuyển đổi ngôn ngữ
- Nội dung chuyển đổi ngôn ngữ
- Tên ngôn ngữ bằng tiếng Anh hoặc tiếng bản địa
- Hình dạng và kích thước của cờ
- Màu sắc và bóng đổ
Tải bộ chuyển đổi ngôn ngữ trong nội dung Laravel
Để hiển thị bộ chuyển đổi ngôn ngữ tại vị trí cụ thể trong Laravel , bạn cần đặt vị trí là “Tại chỗ”.
Sau khi đã thiết lập 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 để sao chép vào clipboard của bạn.
<div>[linguise]</div>
Sau khi thêm vào, trên giao diện người dùng, bạn sẽ thấy tên quốc kỳ và ngôn ngữ được hiển thị trong vùng HTML mà bạn đã thêm mã.
Hệ thống bộ nhớ đệ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ớ đệm cục bộ để lưu trữ URL và nội dung đa ngôn ngữ liên quan nhằm tải trang nhanh hơn. Bộ nhớ đệm cục bộ sẽ tiết kiệm một phần dung lượng truyền tải dữ liệu giữa máy chủ Linguise và máy chủ trang web của bạn. Bộ nhớ đệ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 ưu tiên giữ lại sẽ là bộ nhớ đệm của các trang đa ngôn ngữ được xem nhiều nhất.
Bạn có thể tùy chọn xác định dung lượng bộ nhớ đệm được lưu trữ tính 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à 500MB:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Các thiết lập cụ thể cho Laravel Platform
Trong file Configuration.php, chúng ta cũng có một thiết lập cho phép truyền một số cấu hình cụ thể cho CMS hoặc hệ thống không phải CMS. Theo mặc định, nó ở chế độ tự động, nhưng nhóm hỗ trợ có thể yêu cầu bạn tùy chỉnh để sử dụng một số thiết lập đặc biệt.
Đây là đoạn mã cần thêm vào 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 tệp Configuration.php có một thiết lập để buộc sử dụng MySQL thay vì SQLite, trong trường hợp SQLite chưa được cài đặt trên máy chủ.
Trong trường hợp này, bạn 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 Laravel + 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.
Dòng này cần được thiết lập trước bất kỳ lệnh chuyển hướng nào khác, đặc biệt là lệnh chuyển hướng đến tệp PHP chính của bạn:
<rule name="Linguise" stopProcessing="true">
<match url="^(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)(?:$|/)(.*)$" ignoreCase="false" />
<conditions logicalGrouping="MatchAll" trackAllCaptures="false" />
<action type="Rewrite" url="linguise/linguise.php?linguise_language={R:1}&original_url={R:2}" appendQueryString="true" />
</rule>
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;