Mục lục
Yêu cầu kỹ thuật PrestaShop
Hệ thống dịch tự động thần kinh được sử dụng với PrestaShop 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 8 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 cho PrestaShop
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 PrestaShop 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ủ nơi cài đặt PrestaShop :
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 PrestaShop 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ữ
Chức năng viết lại URL thường được kích hoạt mặc định trong PrestaShop vì mục đích SEO. Nếu không, bạn có thể tìm thấy cài đặt này trong Tham số cửa hàng > Lưu lượng truy cập và SEO > URL thân thiện. Thông tin chi tiết hơn có trong tài liệu chính thức PrestaShop
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ã “ RewriteEngine on ” có sẵn trong PrestaShop .htaccess:
<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>
Cuối cùng, tệp .htaccess của PrestaShop của bạn sẽ trông giống như thế này:
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 của mình bằng URL, ví dụ: www.shop.com/fr/
Bộ chuyển đổi ngôn ngữ là cửa sổ bật lên có biểu tượng cờ để chọn ngôn ngữ bạn muốn sử dụng. Để tải nó, bạn cần sao chép đoạn mã được cung cấp ở cuối phần cấu hình trang web vào phần <head> của trang HTML. Sau đó, bộ chuyển đổi ngôn ngữ sẽ được tải tự động.
Bạn cần tải đoạn mã này vào phần tiêu đề trang (heading) của mình. Trong Prestashop , bạn có thể sao chép mã vào thư mục: …/themes/your-theme/templates/_partials/head.tpl
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ộ 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 PrestaShop
Để 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ộ
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
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;