Wymagania techniczne ProcessWire CMS
Automatyczne tłumaczenie neuronowe, które będzie używane z ProcessWire CMS, będzie wymagało użycia skryptu PHP (do pobrania poniżej). Aby zainstalować skrypt Linguise , musisz spełnić następujące wymagania:
- Uruchom PHP 7+
- Serwer Apache, LiteSpeed, NGINX, IIS
- Upewnij się, że na Twoim serwerze jest włączona funkcja przepisywania adresów URL
- ProcessWire CMS 2.x lub 3 i nowsze
1. Wygeneruj klucz API
Po połączeniu się lub zarejestrowaniu w Linguise panelumusisz najpierw skonfigurować nową domenę i zapisać jej ustawienia, aby uzyskać klucz API.
Możesz wybrać platformę „Inna platforma PHP”, aby kontynuować rejestrację domeny Linguise , podobnie jak niniejsza dokumentacja oraz języki źródłowy i docelowy.
Potem otrzymasz:
- Klucz API potwierdzający Twoje członkostwo
- Link do skryptu Linguise dla przełącznika języka
Klucz API jest wymagany do aktywacji tłumaczenia na Twojej stronie internetowej ProcessWire CMS. Zasadniczo klucz API sprawdza, jaki język jest aktywny w Twojej domenie i umożliwia automatyczne tłumaczenie treści.
Na razie możesz skopiować klucz API i zachować go w schowku.
2. Prześlij i podłącz skrypt tłumaczenia Linguise
Skrypt tłumaczenia Linguise musi zostać przesłany na serwer, na którym zainstalowany jest ProcessWire CMS:
Po pobraniu skryptu rozpakuj go i prześlij do folderu głównego, w którym zainstalowano ProcessWire CMS.
- Upewnij się, że znajduje się on na poziomie głównym Twojej witryny (tam, gdzie ProcessWire znajdują się pliki
- Upewnij się, że folder zachowuje swoją domyślną nazwę „linguise”
Jak uzyskać dostęp do interfejsu skryptowego Linguise ?
Po zakończeniu Linguise możesz uzyskać dostęp do pulpitu nawigacyjnego, odwiedzając swoją witrynę za pomocą następującego formatu adresu URL
https://www.domena.com/linguiselinguise
Zmień adres domeny zgodnie z adresem swojej witryny internetowej*
Upewnij się, że Linguise ma odpowiednie uprawnienia do odczytu i zapisu*
Skonfiguruj hasło i połączenie z bazą danych
Po uzyskaniu dostępu do interfejsu skryptu zostanie wyświetlony ekran konfiguracji, na którym możesz utworzyć hasło i połączyć się z wybraną bazą danych.
Możesz:
- Ustaw hasło, które będzie wymagane w celu uzyskania dostępu do tego interfejsu w przyszłości.
- Wybierz typ bazy danych — MySQL lub SQLite, w zależności od konfiguracji i preferencji.
Ta początkowa konfiguracja zapewnia bezpieczny dostęp i umożliwia skonfigurowanie skryptu zgodnie ze środowiskiem, w którym pracujesz.
Połączenie z bazą danych MySQL
Jeśli wybierzesz MySQL, pojawi się inny interfejs, w którym należy podać następujące dane połączenia z polami konfiguracji MySQL poniżej:
Upewnij się, że informacje są poprawne, aby nawiązać połączenie z bazą danych MySQL.
MySQL a SQLite – jaka jest różnica?
Zarówno MySQL, jak i SQLite to popularne systemy baz danych służące do przechowywania i zarządzania danymi stron internetowych i aplikacji. Są one jednak przeznaczone do różnych zastosowań i różnią się kilkoma kluczowymi kwestiami:
| Funkcja | SQLite | MySQL |
|---|
| Konfiguracja | Bardzo łatwe (wymagana instalacja SQLite) | Wymaga konfiguracji serwera |
| Magazynowanie | Pojedynczy szereg | Zarządzane przez serwer MySQL |
| Wydajność | Świetnie nadaje się do aplikacji na małą skalę | Lepiej sprawdza się w dużych systemach o dużym natężeniu ruchu |
| Przypadek użycia | Aplikacje lokalne, testowanie, małe witryny | Aplikacje internetowe, eCommerce, systemy korporacyjne |
Interfejs skryptowy Linguise : konfiguracja dla platformy PHP
Panel tłumaczeń Linguise , wcześniej dostępny tylko dla Joomla i WordPress, rozszerza teraz obsługę PHP i innych platform. Ta aktualizacja umożliwia użytkownikom płynną konfigurację ustawień językowych – takich jak opcje wyświetlania, style flag i personalizacja wyglądu – bezpośrednio z poziomu ujednoliconego interfejsu, niezależnie od używanego systemu CMS lub frameworka.
Administratorzy mogą wydajniej zarządzać ustawieniami Linguise dzięki spójnym funkcjom, takim jak wyskakujące okienka wyboru języka, efekty cienia i warianty flag dla poszczególnych regionów. Panel zachowuje przyjazny dla użytkownika design, oferując jednocześnie szerszą kompatybilność z różnymi środowiskami internetowymi.
ROZUMIEMY, ŻE KONFIGURACJA ADRESÓW URL I PRZEŁĄCZNIK JĘZYKA SĄ TROCHĘ SKOMPLIKOWANE TECHNICZNIE, ALE MAMY DOBRĄ WIADOMOŚĆ! OFERUJEMY BEZPŁATNĄ INSTALACJĘ
3. Skonfiguruj przepisywanie adresów URL w systemie CMS ProcessWire
Domyślnie przepisywanie adresów URL jest aktywne w systemie ProcessWire CMS. Jeśli tak nie jest, możesz je aktywować u swojego dostawcy hostingu.
Adres URL dla języka musi zostać skonfigurowany w pliku .htaccess. Wystarczy skopiować poniższy kod po kodzie „RewriteEngine on” dostępnym w domyślnym ProcessWire CMS .
Na koniec Twój plik .htaccess ProcessWire CMS powinien wyglądać mniej więcej tak:
Teraz możesz załadować wszystkie przetłumaczone strony, korzystając z adresu URL, na przykład: www.shop.com/fr/
Załadujmy teraz przełącznik języka.
ROZUMIEMY, ŻE KONFIGURACJA ADRESÓW URL I PRZEŁĄCZNIK JĘZYKA SĄ TROCHĘ SKOMPLIKOWANE TECHNICZNIE, ALE MAMY DOBRĄ WIADOMOŚĆ! OFERUJEMY BEZPŁATNĄ INSTALACJĘ
4. Aktywuj przełącznik języka
4.1 Załaduj skrypt Linguise JS
Łącze skryptu Linguise JS musi zostać załadowane na wszystkich stronach ProcessWire CMS, aby wyświetlić przełącznik języka z flagami i alternatywnymi adresami URL w nagłówkach HTML (w celach SEO).
Aby skopiować link do skryptu, w panelu Linguise przejdź do ustawień domeny i skopiuj link do skryptu.
Najprostszym sposobem załadowania tego kodu w ProcessWire CMS jest dodanie go do nagłówka witryny lub <head> Sekcja. ProcessWire CMS zawiera specjalny plik służący do ładowania skryptu do nagłówka.
Znajduje się w pliku _main.php. Znajdziesz go, przechodząc do site/templates/_main.php. Edytuj plik skryptu, aby dodać link do skryptu w sekcji nagłówka.
Przełącznik języka z flagami powinien teraz załadować się automatycznie.
Przełącznik języka będzie domyślnie wyświetlany w pozycji pływającej w prawym górnym rogu Twojej witryny. Możesz go dostosować, jak wyjaśniono w następnym rozdziale.
Ważna uwaga dotycząca SEO: Liczba skonfigurowanych języków ma duży wpływ na SEO. Jeśli podczas konfiguracji języków tłumaczenia masz dużą liczbę zindeksowanych stron (>500), przetworzenie ich przez wyszukiwarkę może zająć dużo czasu. Może to wpłynąć na SEO w języku źródłowym. Dlatego zalecamy dodanie na początku maksymalnie 5 języków, a następnie, gdy strona zostanie zindeksowana, możesz dodawać języki partiami po 3 języki miesięcznie.
Ustaw przełącznik języka
Przełącznik języka można dostosować w panelu Linguise > Ustawienia > Wyświetlanie flag językowych. Każda zmiana wprowadzona w tym miejscu będzie widoczna na stronie internetowej.
Po prawej stronie ekranu znajduje się podgląd przełącznika języka. Oto elementy, które możesz skonfigurować:
- 3 układy: obok siebie, lista rozwijana lub wyskakujące okienko
- Pozycja przełącznika języka
- Zawartość przełącznika języka
- Nazwy języków w języku angielskim lub ojczystym
- Kształty i rozmiar flag
- Kolory i cień pudełka
Załaduj przełącznik języka w treści ProcessWire
Aby wyświetlić przełącznik języka w określonym miejscu w ProcessWire , należy ustawić pozycję „Na miejscu”.
Po ustawieniu pozycji w Linguise , możesz dodać poniższy kod. Kliknij poniższy kod, aby umieścić go w schowku.
Po dodaniu, na froncie, w obszarze HTML, do którego dodałeś kod, zostaną wyświetlone nazwy flag i języków.
Aktywuj opcję lokalnego systemu pamięci podręcznej
Opcjonalnie możesz aktywować lokalny system pamięci podręcznej, który przechowuje adresy URL i powiązane z nimi treści wielojęzyczne, aby szybciej serwować strony. Lokalny system pamięci podręcznej zmniejszy transfer 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. Priorytetem będzie pamięć podręczna najczęściej wyświetlanych stron wielojęzycznych.
Aby to uzupełnić, możesz zdefiniować ilość przechowywanej pamięci podręcznej w MB. W poniższym przykładzie pamięć podręczna jest aktywowana, a ilość pamięci podręcznej do zachowania wynosi 500 MB.
Automatyczne tłumaczenie na serwerach Windows IIS
Dodaj wiersz odpowiadający kreatorowi witryny w pliku Web.config.
Powinien on być ustawiony przed każdym innym przekierowaniem, zwłaszcza przekierowaniem do głównego pliku PHP:
Automatyczne tłumaczenie na serwerach NGINX
Dodaj wiersz odpowiadający Twojemu CMS-owi w bloku konfiguracji serwera NGINX.
Należy go ustawić przed każdym innym przekierowaniem, zwłaszcza przekierowaniem w głównym pliku PHP.
