Mục lục
Yêu cầu kỹ thuật OpenCart
Hệ thống dịch tự động thần kinh được sử dụng với OpenCart 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 Linguise , bạn cần đáp ứng các yêu cầu sau:
- Chạy PHP 7 trở lên
- Apache, LiteSpeed, NGINX, máy chủ IIS
- Kích hoạt tính năng viết lại URL thông qua cấu hình PrestaShop
Hướng dẫn cài đặt bản dịch OpenCart
1. Tạo khóa API để kích hoạt tính năng dịch thuật
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 OpenCart . 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 thần kinh.
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 Linguise với OpenCart
Bạn cần tải tập lệnh dịch Linguise lên máy chủ nơi cài đặt OpenCart :
Sau khi tải xuống tập lệnh, hãy giải nén và tải lên thư mục gốc nơi CMS được cài đặt.
- Hãy đảm bảo rằng nó nằm ở thư mục gốc chứa các tệp OpenCart của bạn
- Hãy đảm bảo thư mục giữ nguyên tên mặc định là “ linguise ”.
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ữ trong OpenCart
Việc viết lại URL thường được kích hoạt vì mục đích SEO trên OpenCart. Quá trình viết lại URL sử dụng tệp .htaccess nằm ở thư mục gốc của máy chủ.
Trong OpenCart , hãy kiểm tra xem tính năng viết lại URL đã được kích hoạt chưa. Sử dụng OpenCart :
Hệ thống > Cài đặt > Mặc định > Máy chủ
Bạn cần cấu hình URL theo ngôn ngữ trong tệp .htaccess. Chỉ cần sao chép đoạn mã này vào sau đoạn mã “RewriteBase /” có sẵn trong tệp .htaccess mặc định của OpenCart .
<IfModule mod_rewrite.c>
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]
</IfModule>
Hãy đảm bảo đường dẫn linguise/linguisegiống với đường dẫn trên máy chủ của bạn, /linguise/ là tên mặc định khi bạn giải nén tập lệnh.
4. Kích hoạt bộ chuyển đổi ngôn ngữ
Giờ đây, bạn có thể tải tất cả các trang đã dịch bằng URL, ví dụ: www.domain.com/fr/
Bộ chuyển đổi ngôn ngữ là cửa sổ bật lên hình cờ để chọn ngôn ngữ bạn muốn. Để tải nó, bạn cần sao chép liên kết đến Linguise được cung cấp trong OpenCart của tất cả các trang của bạn. Sau đó, bộ chuyển đổi ngôn ngữ hình cờ sẽ được tải tự động. Đây là liên kết đến tập lệnh bạn có thể tìm thấy tại:
linguise> Cài đặt
Sau đó, để thêm nó vào OpenCart , hãy vào Thiết kế > Trình chỉnh sửa giao diện và chỉnh sửa phần mặc định/tiêu đề của mẫu.
Theo mặc định, công cụ 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ó từ bảng điều khiển Linguise ở bước tiếp theo.
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ừ 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 bố cục: cạnh nhau, trình đơn thả xuống hoặc cửa sổ bật lên
- Vị trí của công tắc 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ữ vào nội dung OpenCart
Để hiển thị bộ chuyển đổi ngôn ngữ tại vị trí cụ thể trong nội dung CMS, bạn cần đặt vị trí là “Tại chỗ”.
Sau khi đã đặ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 để 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ã.
Kích hoạt hệ thống bộ nhớ đệm cục bộ của bản dịch
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 hệ thống quản lý OpenCart CMS
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. 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 nó để sử dụng một số thiết lập đặc biệt.
Đây là đoạn mã cần thêm cho OpenCart , đâ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 = 'opencart';
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 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ủ 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;