Mục lục
Yêu cầu kỹ thuật của Zen Cart CMS
Hệ thống dịch tự động nơ-ron được sử dụng với Zen Cart CMS 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 đáp ứng các yêu cầu sau:
- Chạy PHP 7 trở lên
- Apache, NGINX
- Hãy đảm bảo rằng tính năng viết lại URL đã được kích hoạt trên máy chủ của bạn
- Zen Cart CMS phiên bản 1.5.x trở lên
1. Tạo khóa API
Sau khi kết nối hoặc đăng ký vào 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.
Bạn có thể chọn nền tảng “PHP khác” để tiếp tục đăng ký tên miền Linguise , giống như tài liệu này và các ngôn ngữ nguồn và đí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 kịch bản Linguise dành cho bộ chuyển đổi ngôn ngữ
Khóa API là thứ cần thiết để kích hoạt tính năng dịch thuật trên trang web Zen Cart 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 tê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à lưu vào bộ nhớ tạm.
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ủ nơi cài đặt Zen Cart CMS. 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 cài đặt Zen Cart CMS.
- Hãy đảm bảo rằng nó được đặt ở thư mục gốc chứa các tệp CMS Zen Cart của bạn
- Hãy đảm bảo thư mục vẫn 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 tính năng viết lại URL cho Zen Cart CMS
Theo mặc định, tính năng viết lại URL được kích hoạt trong Zen Cart CMS. Nếu không, bạn có thể kích hoạt tính năng này từ nhà cung cấp dịch vụ lưu trữ của mình.
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ã bên dưới vào sau đoạn mã “ RewriteEngine on ” có sẵn trong tệp .htaccess mặc định của Zen Cart CMS .
<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>
Giờ đây, 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ờ chúng ta hãy tải trình chuyển đổi ngôn ngữ.
4. Kích hoạt bộ chuyển đổi ngôn ngữ
4.1 Tải tập lệnh Linguise JS
Bạn cần tải liên kết script Linguise JS trên tất cả các trang Zen Cart CMS của mình để hiển thị bộ chuyển đổi ngôn ngữ với cờ và URL thay thế trong phần tiêu đề HTML (nhằm 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 vào cài đặt tên miền và sao chép liên kết tập lệnh.
Cách dễ nhất để tải đoạn mã này vào Zen Cart CMS là thêm nó vào phần tiêu đề (heading) của trang web hoặc Mã nguồn. Zen Cart CMS đi kèm với một mẫu có phần dành cho tiêu đề, và nó có một tệp cụ thể để tải Linguise vào phần tiêu đề đó.
Nó nằm trong tệp tpl_header.php , bạn có thể tìm thấy nó bằng cách điều hướng đến thư mục cài đặt CMS của mình như bên dưới. Trong ví dụ này, đó là mẫu CMS mặc định Zen Cart có tên là responsive_classic:
/includes/template/*MẪU CỦA BẠN*/common/tpl_header.php.
Chỉnh sửa tệp kịch bản để thêm liên kết kịch bản vào phần tiêu đề như bên dưới.
Theo mặc định, công cụ chuyển đổi ngôn ngữ sẽ được hiển thị ở vị trí nổi phía dưới bên phải 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ó 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 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 trình chuyển đổi ngôn ngữ trong nội dung Zen Cart
Để hiển thị bộ chuyển đổi ngôn ngữ tại vị trí cụ thể trong Zen Cart , 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 tùy chọn hệ thống bộ nhớ đệm cục bộ
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ổ sung cho điều đó, bạn có thể 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à 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;
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 = '';