Spis treści
Wymagania techniczne
Aby uruchomić skrypt tłumaczenia Linguise , potrzebujesz:
- Uruchom PHP 7+ i Laravel
- Apache, LiteSpeed, NGINX, serwer IIS
- Aktywuj przepisywanie adresów URL w konfiguracji serwera
- Folder główny Laravela jest zwykle ustawiony na Laravel publiczny ”, pamiętaj o zainstalowaniu Linguise w tym folderze
1. Wygeneruj klucz API
Po połączeniu się z nawigacyjnym Linguise musisz najpierw skonfigurować nową domenę i zapisać jej ustawienia, aby uzyskać klucz API.
Klucz API jest tym, co jest wymagane do aktywacji tłumaczenia na Twojej stronie internetowej. Zasadniczo klucz API sprawdzi, jaki język jest aktywowany w jakiej domenie i pozwoli na wygenerowanie stron tłumaczenia neuronowego.
Skopiuj klucz API i przechowuj go w schowku.
Następnie, klikając zakładkę „Skrypt PHP”, otrzymasz instrukcje instalacji, które szczegółowo omówimy tutaj.
2. Prześlij i podłącz skrypt tłumaczenia Linguise
Skrypt tłumaczący Linguise należy wgrać na swój serwer, w folderze, w którym zainstalowany jest Laravel , można go pobrać tutaj:
Po pobraniu skryptu rozpakuj go i prześlij do folderu głównego, w którym zainstalowany jest Laravel .
- Upewnij się, że znajduje się on na poziomie głównym instalacji Laravel (zwykle Laravel ustawia katalog główny w folderze „ public ”, w którym możesz zainstalować Linguise )
- Upewnij się, że folder nazywa się „ linguise ” (nazwa domyślna po rozpakowaniu folderu)
Klucz Linguise będzie musiał zostać skopiowany do folderu: …/ linguise /Configuration.php , który przesłałeś na swój serwer, edytuj plik i skopiuj swój klucz API między prostymi cudzysłowami, zastępując tekst REPLACE_BY_TOUR TOKEN.
3. Skonfiguruj językowe adresy URL
Adres URL według języka musi być skonfigurowany w pliku .htaccess, jeśli masz „RewriteBase /” w swoim pliku, po prostu skopiuj cały następujący kod:
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]
4. Aktywuj przełącznik języka w Laravel
Przełącznik języka to wyskakujące okienko z flagą, aby wybrać żądany język. Aby go załadować, należy skopiować kod podany na końcu konfiguracji strony ( Linguise dashboard).
Skrypt musi zostać załadowany do nagłówka stron HTML obsługiwanych przez Laravel . Przełącznik języka flagi zostanie następnie załadowany automatycznie.
Przełącznik języka będzie domyślnie wyświetlany w prawym górnym rogu Twojej witryny. Możesz dostosować go do swoich potrzeb za pomocą CSS.
Ważna uwaga dotycząca SEO: liczba skonfigurowanych języków ma duży wpływ na SEO. Jeśli ustawisz języki tłumaczenia, jeśli masz dużą liczbę zindeksowanych stron (>500), wyszukiwarka może zająć dużo czasu, aby je przetworzyć. Może to mieć wpływ na SEO w Twoim oryginalnym języku. Dlatego zalecamy dodanie maksymalnie 5 języków, a po zindeksowaniu możesz dodawać języki partiami po 3 na miesiąc.
Ustaw przełącznik języka
Przełącznik języka można dostosować z pulpitu nawigacyjnego Linguise > Ustawienia > Wyświetl flagi językowe. Każda modyfikacja tutaj zostanie odzwierciedlona na stronie internetowej.
Po prawej stronie ekranu masz podgląd przełącznika języka. Oto elementy, które możesz skonfigurować:
- 3 układy: obok siebie, rozwijany lub wyskakujący
- Pozycja przełącznika języka
- Zawartość przełącznika języka
- Nazwy języków w języku angielskim lub ojczystym
- Kształty i rozmiary flag
- Kolory i cień pudełka
Załaduj przełącznik języka w treści Laravel
Aby wyświetlić przełącznik języka w konkretnym miejscu, w Laravel , należy ustawić pozycję na „In place”.
Po ustawieniu pozycji w Linguise możesz dodać poniższy krótki kod, aby ją uwzględnić. Kliknij poniższy kod, aby umieścić go w swoim schowku.
Po dodaniu na interfejsie zobaczysz flagę i nazwy języków wyświetlane w obszarze HTML, do którego dodano kod.
Lokalny system pamięci podręcznej dla stron Laravel
Opcjonalnie możesz aktywować lokalny system pamięci podręcznej, który przechowuje adresy URL i powiązaną z nimi wielojęzyczną treść, aby szybciej wyświetlać strony. Lokalna pamięć podręczna zaoszczędzi trochę transferu danych między serwerem Linguise a serwerem Twojej witryny. Pamięć podręczna jest używana tylko wtedy, gdy strona została już przetłumaczona i nie została zaktualizowana. Priorytetowa pamięć podręczna to pamięć podręczna z najczęściej oglądanych stron wielojęzycznych.
Opcjonalnie możesz zdefiniować ilość pamięci podręcznej przechowywanej w MB. W poniższym przykładzie pamięć podręczna jest aktywowana, a ilość pamięci podręcznej do zachowania wynosi 500 MB:
/** Basic configuration **/
public $cache_enabled = true;
public $cache_max_size = 500; // In megabyte
Specyficzne ustawienia dla platformy Laravel
W pliku Configuration.php mamy również ustawienie umożliwiające przekazanie określonej konfiguracji dla systemu CMS lub innego systemu. Domyślnie jest to automatyczne, ale zespół wsparcia może poprosić Cię o personalizację w celu użycia specjalnych ustawień.
Oto kod do dodania dla Laravel , to jest nazwa CMS zapisana małymi literami:
/** Basic configuration **/
/*
* Update the CMS value according to your CMS
* Available CMS are: laravel, prestashop
*/
public static $cms = 'laravel';
Od SQLite do MySQL
Nadal w pliku Configuration.php znajduje się ustawienie wymuszające użycie MySQL zamiast SQLite, w przypadku, gdy SQLite nie jest zainstalowany na serwerze.
W takim przypadku będziesz musiał wypełnić informacje MySQL w tej części pliku 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 = '';
Automatyczne tłumaczenie na serwerach Laravel + Windows IIS
Dodaj linię odpowiadającą narzędziu do tworzenia witryn w pliku Web.config.
Powinien być ustawiony przed jakimkolwiek innym przekierowaniem, zwłaszcza przekierowaniem do głównego pliku PHP:
Automatyczne tłumaczenie na serwerach 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;