Cài đặt dịch tự động Linguise trên OpenCart

Mục lục

Yêu cầu kỹ thuật OpenCart

Bản 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 có các yêu cầu sau:

  • Chạy PHP 7+
  • Máy chủ Apache, LiteSpeed, NGINX, IIS
  • Kích hoạt tính năng viết lại URL thông qua cấu hình PrestaShop

Cách cài đặt dịch OpenCart

1. Tạo Khóa API để kích hoạt dịch

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 OpenCart . 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 thần kinh.

Sao chép Khóa API và giữ nó trong khay nhớ tạm của bạn.

Hình ảnh quá trình cài đặt khóa API Lingui.se. Ảnh chụp màn hình của khóa API khi kết thúc cài đặt.

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.

Một ảnh chụp màn hình của giao diện tập lệnh cài đặt LinguiSE .

2. Tải lên và kết nối tập lệnh Linguise với OpenCart

Tập lệnh dịch Linguise cần được tải lên trên máy chủ của bạn nơi cài đặt OpenCart :

Sau khi tập lệnh được tải xuống, hãy giải nén và tải nó lên thư mục gốc nơi CMS được cài đặt.

  • Đảm bảo nó ở cấp độ gốc của trang web của bạn (nơi chứa các tệp OpenCart
  • Đảm bảo rằng thư mục giữ tên mặc định là " linguise "
Một ảnh chụp màn hình của một thư mục danh sách tệp trên nền tảng Linguise . Tổ chức các tập tin và thư mục.

Làm thế nào để truy cập giao diện tập lệnh Linguise ?

Sau khi hoàn thành 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 với định dạng URL sau:
https://www.domain.com/ linguise

Thay đổi địa chỉ miền theo địa chỉ trang web của bạn*
Đảm bảo Linguise có quyền đọc và ghi đúng cách*

Thiết lập mật khẩu và kết nối cơ sở dữ liệu

Khi bạn truy cập giao diện tập lệnh, bạn sẽ được trình bày với 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 ưa thích của mình.

Bạn có thể:

  • Đặt mật khẩu, sẽ được yêu cầu để truy cập trong tương lai vào giao diện này.
  • Chọn loại cơ sở dữ liệu của bạn - MySQL hoặc SQLite, tùy thuộc vào thiết lập và sở thích của bạn.

Thiết lập ban đầu này đảm bảo truy cập an toàn và cho phép bạn định cấu hình tập lệnh theo môi trường của bạn.

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ẽ xuất hiện để yêu cầu các chi tiết kết nối sau của các trường cấu hình MySQL bên dưới:

Đảm bảo thông tin là 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 vs sqlite - sự khác biệt là gì?
Cả MySQL và SQLite đều là các 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ố khác biệt chính:

Tính năngSqliteMysql
Cài đặtRất dễ dàng (yêu cầu cài đặt sqlite)Yêu cầu thiết lập máy chủ
KhoTệp đơnĐược quản lý bởi máy chủ MySQL
Hiệu suấtTuyệt vời cho các ứng dụng quy mô nhỏTốt hơn cho các hệ thống lớn, 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 Linguise , trước đây chỉ có sẵn cho Joomla và WordPress, hiện mở rộng hỗ trợ cho PHP và các nền tảng bổ sung. Bản cập nhật này cho phép người dùng định cấu hình trực tiếp các cài đặt ngôn ngữ, ví dụ như các tùy chọn hiển thị, kiểu cờ và tùy chỉnh ngoại hình, trực tiếp từ giao diện thống nhất, bất kể CMS hay khung của họ.

API giao diện

Quản trị viên có thể quản lý các cài đặt Linguise hiệu quả hơn, với các tính năng nhất quán như các cửa sổ bật lên lựa 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 giữ lại 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 các môi trường web khác nhau.

Hiển thị giao diện
Xuất hiện giao diện
CHÚNG TÔI HIỂU RẰNG CẤU HÌNH URL VÀ CHUYỂN ĐỔI NGÔN NGỮ LÀ MỘT BIT KỸ THUẬT ĐỂ CẤU HÌNH; NHƯNG TIN TỐT! CHÚNG TÔI CUNG CẤP LẮP ĐẶT MIỄN PHÍ

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 cho mục đích SEO trên OpenCart. Việc viết lại URL đang sử dụng tệp .htaccess có sẵn ở thư mục gốc máy chủ của bạn.

Một ảnh chụp màn hình của các tập tin OpenCart .

Từ 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ủ

Ảnh chụp màn hình trang OpenCart Cài đặt. Định cấu hình cài đặt cửa hàng.

URL theo ngôn ngữ cần được định cấu hình trong .htaccess. Chỉ cần sao chép mã này sau mã “RewriteBase /” có sẵn trong OpenCart .htaccess mặc định.

				
					<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>
				
			

Đảm bảo rằng đường dẫn ngôn ngữ /linguise.php giống nhau trên máy chủ của bạn, / linguiselinguiselà tên mặc định khi bạn giải nén tập lệnh.

CHÚNG TÔI HIỂU RẰNG CẤU HÌNH URL VÀ CHUYỂN ĐỔI NGÔN NGỮ LÀ MỘT BIT KỸ THUẬT ĐỂ CẤU HÌNH; NHƯNG TIN TỐT! CHÚNG TÔI CUNG CẤP LẮP ĐẶT MIỄN PHÍ

4. Kích hoạt trình chuyển đổi ngôn ngữ

Bây giờ bạn có thể tải tất cả các trang đã dịch của mình bằng URL, ví dụ: www.domain.com/fr/

Giao diện Frontend OpenCart , Thiết kế trang web thương mại điện tử

Trình chuyển đổi ngôn ngữ là cửa sổ bật lên gắn cờ để chọn ngôn ngữ bạn muốn. Để tải nó, bạn cần sao chép liên kết tới Linguise được cung cấp trong OpenCart của tất cả các trang của bạn. Trình chuyển đổi ngôn ngữ cờ sau đó sẽ được tải tự động. Đây là liên kết tập lệnh bạn có thể tìm thấy tại:

bảng điều khiển.linguise.com > Cài đặt

Ảnh chụp màn hình của liên kết tập lệnh trong trang Cài đặt. Một hình ảnh hướng dẫn.

Sau đó, để thêm nó vào OpenCart , hãy đi tới Thiết kế > Trình chỉnh sửa chủ đề và chỉnh sửa mặc định/tiêu đề của mẫu.

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 đã sẵn sàng tùy chỉnh nó từ bảng điều khiển Linguise trong bước tiếp theo.

Tiện ích chuyển đổi ngôn ngữ trên một trang web

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ừ 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.

Một thanh menu trang web với tùy chọn Trình chuyển đổi ngôn ngữ. Tính năng đa ngôn ngữ.

Ở 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 OpenCart

cờ-vị trí tại chỗ

Để hiển thị Bộ chuyển đổi ngôn ngữ tại một vị trí cụ thể, trong nội dung CMS, bạn nên đặt vị trí là “Tại chỗ”.
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 khay nhớ tạm của bạn.

				
					<div>&#091;linguise&#093;</div>
				
			

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ã.

Kích hoạt hệ thống bộ nhớ cache cục bộ dịch

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.

Quá trình kích hoạt bộ đệm

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 OpenCart CMS

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. 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 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 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ủ 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:

				
					<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}&amp;original_url={R:2}" appendQueryString="true" />
</rule>
				
			

Dịch tự động trên máy chủ NGINX

Thêm dòng tương ứng với CMS của bạn trong khối cấu hình máy chủ NGINX của bạn.
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 trong tệp chính PHP của bạn.
				
					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;