Questa guida fornisce un processo passo passo per migrare il contenuto del tuo sito WordPress verso il Sonata Extra Bundle.
Fase 1: Importazione dei contenuti
Iniziate importando il vostro contenuto WordPress utilizzando il seguente comando
bin/console sonata-extra:wordpress-importer --url https://www.domain.com --user wordpressUser --token "[APPLICATION_PASSWORD]"
Per istruzioni dettagliate su questo comando, consulta la guida dedicata: Importazione di WordPress
Dopo aver eseguito questo comando, le vostre categorie, etichette e articoli di WordPress dovrebbero essere importati con successo.
Fase 2: Consultazione degli articoli
Ora potete consultare i vostri articoli utilizzando le rotte del blog fornite da Sonata.
Fase 3: Configurazione della traduzione
Per tradurre contenuti in più lingue, seguite questi passaggi:
- Configura il tuo account OpenAI :
Fare riferimento a Documentazione dell'API di traduzione per configurare il tuo account OpenAI. In alternativa, puoi utilizzare il tuo fornitore personalizzato o scegliere di non utilizzare alcuna API di traduzione.
- Configurazione dell'API :
Aggiorna la configurazione del pacchetto Sonata Extra per includere le impostazioni della tua API di traduzione:
partitech_sonata_extra:
translation_api:
translate_on_create_page: true
translate_on_create_translation: true
default_provider: open_ai
providers:
open_ai:
class: Partitech\SonataExtra\Translation\Provider\OpenAiProvider
api_key: '%open_ai_api_key%'
model: '%open_ai_api_model%'
max_token_per_request: 200
Definisci open_ai_api_key e open_ai_api_model nel vostro file .env.
Scegliete un modello supportato dal fornitore configurato, quindi verificate la qualità, il costo e la dimensione massima delle richieste su un campione rappresentativo. Evitate di bloccare nel manuale un nome di modello che potrebbe scomparire.
Attivare la traduzione automatica:
Aggiungere l'attributo #[Translatable] e importare Partitech\SonataExtra\Attribute\Translatable nelle proprietà della tua entità per la traduzione automatica.
Fase 4: Traduzione del contenuto
Eseguite i seguenti comandi per tradurre il vostro contenuto (potreste voler aggiungere i vostri servizi) :
bin/console sonata:extra:translate-content --site=2,3,4,5 --reference-site=1 --service="sonata.classification.admin.category"
bin/console sonata:extra:translate-content --site=2,3,4,5 --reference-site=1 --service="sonata.classification.admin.tag"
bin/console sonata:extra:translate-content --site=2,3,4,5 --reference-site=1 --service="Partitech\SonataExtra\Admin\ArticleAdmin"
bin/console sonata:extra:translate-content --site=2,3,4,5 --reference-site=1 --service="Partitech\SonataExtra\Admin\EditorAdmin"
bin/console sonata:extra:translate-content --site=2,3,4,5 --reference-site=1 --service="sonata.page.admin.page"
Nota: Se il processo di traduzione si blocca, basta rilanciare il processo, e riprenderà da dove si era interrotto.
Fase 5: configurazione del menu
Se non avete ancora configurato il vostro menu, è consigliabile duplicare prima il menu predefinito.
-
Duplicare il menu: Duplica manualmente il menu predefinito. Nota che la struttura ad albero non sarà mantenuta e deve essere riorganizzata manualmente.
-
Correzione degli URL del menu :
Eseguite il comando seguente per correggere gli URL degli elementi del menu:
bin/console sonata:extra:fix-menu-url --menu=6
Questo comando regolerà gli URL per corrispondere alle pagine localizzate in SonataPage.
Fase 6: Creazione di snapshot
Infine, create degli istantanee delle vostre pagine con il comando:
bin/console sonata:page:create-snapshots
Mettere in sicurezza la bilancia
Blocca una finestra di contenuto, riesegui l’importazione su una copia recente e prepara una tabella di reindirizzamenti tra vecchi e nuovi URL. La procedura deve coprire i volumi, i media, gli autori, i metadati SEO e i link interni prima del passaggio del DNS.