Wymagania techniczne PyroCMS
Automatyczne tłumaczenie neuronowe, które będzie używane z PyroCMS 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
- PyroCMS 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 PyroCMS . 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 należy przesłać na serwer, na którym zainstalowany jest PyroCMS :
Po pobraniu skryptu rozpakuj go i prześlij do folderu głównego, w którym zainstalowano PyroCMS .
- Upewnij się, że znajduje się on na poziomie głównym witryny (tam, gdzie PyroCMS znajdują się pliki domyślnie znajdują się one w folderze /public)
- Upewnij się, że folder zachowuje swoją domyślną nazwę „linguise”
Prosimy pamiętać, że jeśli Twoja strona internetowa ma inną konfigurację, może być konieczna inna instalacja. Prosimy o kontakt.
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 |
|---|
| Organizować coś | Bardzo łatwe (wymagana instalacja SQLite) | Wymaga konfiguracji serwera |
| Składowanie | 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 PyroCMS
Domyślnie przepisywanie adresów URL jest aktywne w PyroCMS. 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 PyroCMS .
Na koniec Twój PyroCMS .htaccess 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 PyroCMS , 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 PyroCMS jest dodanie go w nagłówku witryny lub <head> kod. PyroCMS jest dostarczany ze specjalnym środowiskiem i zawiera specjalny plik, w którym można dodać skrypt do nagłówka.
Znajduje się on w pliku scripts.twig , który znajdziesz w folderze instalacyjnym CMS:
vendor/pyrocms/*TWÓJ_STEM*/resources/views/partials/scripts.twig. Domyślnie PyroCMS to motyw startowy.
Edytuj plik skryptu, dodając odnośnik do skryptu w sekcji nagłówka, jak poniżej.
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.
Skonfiguruj przełącznik języka w PyroCMS
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, rozwijany lub wyskakujący
- Pozycja przełącznika języka
- Zawartość przełącznika języków
- 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 PyroCMS
Aby wyświetlić przełącznik języka w określonym miejscu w PyroCMS , należy ustawić jego pozycję jako „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 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.
