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:
<IfModule mod_rewrite.c>
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]
</IfModule>
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:
<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>
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;