Introduzione Versione 2.8 / Ultimo aggiornamento: 02/06/2026
Benvenuto nel manuale di Conword.
In questa pagina troverai le risposte alle domande più frequenti e tutto ciò che ti serve per configurare e rendere operativo Conword sul
o sul sito web del tuo cliente.
Lingue disponibili
L'elenco delle lingue attualmente disponibili e i relativi codici ('en', 'fr', 'de', ...) è disponibile qui: https://conword.io/sprachen/
Prerequisiti
Il frontend di Conword è scritto in JavaScript puro, quindi non si basa su alcun framework. Pur non dipendendo da codice di terze parti, funziona bene con jQuery e altri strumenti comunemente utilizzati.
Conword offre traduzioni in tempo reale senza memorizzare alcun dato sul server del cliente. Ciò rende Conword indipendente dal CMS sottostante.
In sintesi:
Conword funziona con qualsiasi CMS su qualsiasi server.
Installazione
Per eseguire Conword, è necessario includere la configurazione di base di JavaScript, come indicato nella sezione seguente. Una volta caricato il codice JavaScript di base, saranno disponibili diverse funzioni e oggetti.
Configurazione di base
Inserisci il codice JS nel tuo codice HTML
Conword funziona sul tuo sito web con questa singola riga di codice:
Per poter utilizzare Conword è necessario disporre di una licenza valida per il proprio dominio. Se il dominio non è presente nella lista bianca, Conword non funzionerà sul sito web.
Opzioni di configurazione
Se desideri configurare Conword, puoi utilizzare l'oggetto JavaScript "conword_config" per trasmettere le tue impostazioni all'istanza di Conword.
Conword funziona sul tuo sito web con questa singola riga di codice:
Disattiva l'attributo rtl nel <html> tag, se viene utilizzata una lingua con la funzione rtl (ad es. l'arabo). Conword imposta automaticamente <html lang="rtl"> se questa opzione non è impostata su false.</html></html>
false
vero, falso
disabilita_selettore_lingua
Se installi Conword, nell'angolo in basso a sinistra comparirà un menu a tendina per selezionare la lingua. Impostando `disable_language_switcher` su `true`, il menu a tendina scomparirà.
false
vero, falso
Voto
È possibile utilizzare Conword senza l'oggetto di configurazione.
Esempio: disattivazione del widget standard per la selezione della lingua
<script>
var conword_config={
disable_language_switcher:true
};
</script>
<script id="conword-root" charset="utf-8" src="https://static.conword.io/js/v2/[client-id]/conword.js"></script>
API JavaScript di Conword
Se desideri integrare la funzionalità di Conword nel tuo progetto, puoi utilizzare l'API JavaScript di Conword. Per utilizzare l'API, è sufficiente integrare il file conword.js nella tua pagina. Vedi Configurazione di base
Endpoint API
È possibile utilizzare l'oggetto JavaScript "Conword" per richiamare i metodi API. Per ulteriori informazioni, consultare il capitolo seguente.
Metodi API
Conword.translate(language_key)
Avvia il processo di traduzione.
Questa è probabilmente la funzione più importante di cui hai bisogno.
Nota: quando si chiama Conword.translate, viene richiamata anche la funzione Conword.set_user_language(), che salva automaticamente la lingua nella memoria locale.
L'esempio seguente traduce la pagina corrente in spagnolo:
Conword.translate('es');
Conword.retranslate()
Esistono alcuni siti web in cui i contenuti vengono aggiunti alla pagina in modo dinamico. Sebbene Conword ne sia ben consapevole e tenga conto delle modifiche, a volte si verificano dei problemi ed è necessario riavviare il processo di traduzione.
Il metodo «retranslate» cerca di tradurre nuovamente la pagina nella lingua selezionata.
Se la pagina non è stata tradotta in precedenza, questo metodo non avrà alcun effetto.
Esempio:
Conword.retranslate();
Conword.set_user_language(language_key)
Questo metodo salva la lingua dell'utente nella memoria locale. Viene richiamato automaticamente quando viene attivata la funzione Conword.translate().
Utilizza questa funzione solo se desideri salvare la lingua dell'utente senza tradurre la pagina.
Una volta impostata la lingua dell'utente, Conword tradurrà automaticamente la pagina al successivo caricamento.
L'esempio seguente imposta la lingua dell'interfaccia utente su spagnolo:
Conword.set_user_language('es');
Conword.unset_user_language()
Annulla (cancella) la configurazione della lingua dell'utente.
Esempio:
Conword.unset_user_language();
Conword.get_current_language()
Questo metodo restituisce la chiave della lingua corrente (ad es. «en», «es» o «fr»).
Esempio:
var current_langauge = Conword.get_current_language();
Conword.get_available_languages()
Questo metodo restituisce l'oggetto del linguaggio JavaScript (vedi Oggetto linguistico).
var language_data = Conword.get_available_languages();
Eventi personalizzati
Conword genera eventi personalizzati, che possono essere monitorati utilizzando un EventLister personalizzato.
document.addEventListener("Conword:ready", function(){
/* your code here */
});
Elenco degli eventi personalizzati
"Conword:ready" - verrà attivato quando Conword viene caricato e inizializzato.
"Conword:translation_started" - verrà attivato quando Conword inizia la traduzione.
"Conword:translation_done" - verrà attivato quando Conword avrà completato una traduzione.
"Conword:translation_failed" - viene generato quando un tentativo di traduzione fallisce.
Oggetto linguistico
L'API di Conword fornisce un oggetto che contiene tutte le lingue disponibili e i relativi metadati. L'oggetto può essere recuperato in questo modo:
let languages=Conword.get_available_languages();
L'oggetto ha questo aspetto:
(A seconda delle lingue disponibili con la tua licenza.)
{
"de": {
"name_en": "German",
"name_de": "Deutsch",
"name": "Deutsch",
"rtl": false,
"text_title": "Sprache wählen:",
"text_1": "Die Seite wird gerade übersetzt …",
"text_2": "Einen Moment bitte.",
"text_error": "Beim Übersetzen der Seite ist ein Fehler ist aufgetreten."
},
"en": {
"name_en": "English",
"name_de": "Englisch",
"name": "English",
"rtl": false,
"text_title": "Select language:",
"text_1": "The page is being translated ...",
"text_2": "One moment please.",
"text_error": "An error occurred while translating the page."
},
"tr": {
"name_en": "Turkish",
"name_de": "Türkisch",
"name": "Türkçe",
"rtl": false,
"text_title": "Dil seçin:",
"text_1": "Sayfa çevriliyor ...",
"text_2": "Bir dakika lütfen.",
"text_error": "Sayfa çevrilirken bir hata oluştu."
},
"it": {
"name_en": "Italian",
"name_de": "Italienisch",
"name": "Italiano",
"rtl": false,
"text_title": "Selezionare la lingua:",
"text_1": "La pagina è in corso di traduzione ...",
"text_2": "Un momento, per favore.",
"text_error": "Si è verificato un errore durante la traduzione della pagina."
}
}
Esclusi i contenuti
Moduli
I dati inseriti dall'utente nei campi del modulo come e
L'attributo "translate"
Se desideri che alcuni elementi non vengano tradotti, puoi utilizzare l'attributo «translate». Impostando il suo valore su «no», Conword ignorerà quell'elemento e tutti i suoi elementi figli.
Esempio:
<div>
<p>I will be translated</p>
<p translate="no">
I will NOT be translated.
<small>Me neither, since my parent element uses the transate attrube.</small>
</p>
I will be translated as well
</div>
La classe "cnw_skip_translation"
Conword ignorerà tutti i tag HTML che contengono la classe "cnw_skip_translation".
Esempio:
<div>
<p>I will be translated</p>
<p class="cnw_skip_translation">
I will NOT be translated.
<small>Me neither, since my parent element uses the cnw_skip_translation class.</small>
</p>
I will be translated as well
</div>
Nota: i tag vuoti verranno saltati automaticamente.
È possibile escludere intere pagine evitando di caricare Conword. Questa operazione deve essere eseguita dal programmatore che integra Conword nel sito web.
Esempi
Esempio: link HTML per avviare la traduzione della pagina in inglese
<a href="javascript:Conword.translate('en');">Translate to english</a>
Integrazione personalizzata di Conword nella tua pagina:
document.addEventListener("Conword:ready", function(){
my_languages=Conword.get_available_languages();
for (var langkey in my_languages) {
language_meta=my_languages[langkey];
// now you can make use of the language object - see the chapter above.
// eg: language_meta.name or language_meta.name_en ...
console.debug(language_meta.name,language_meta.name_en);
// to check if the langkey is the currently active language:
active=false;
if(Conword.get_current_language()==langkey) active=true;
// jquery example of adding menu items
$language_dropdown.append('<li><a class="'+active+'" href="javascript:start_conwordio_translation(\''+langkey+'\');" data-lang="'+langkey+'" data-langname="'+language_meta.name+'" title="Diese Seite auf \''+language_meta.name+'\' übersetzen">'+language_meta.name+'</a></li>');
}
});
// example of a wrapper to call multiple actions (translation, menu controls, tracking, ...) at the same time
function start_conwordio_translation(lang){
Conword.translate(lang);
hide_menu();
matomo_track('Translation',lang);
}
Spostare il selettore della lingua predefinita a destra, utilizzando i CSS
<style>
body .cnw_translationbox {
right: 30px;
left: auto;
}
</style>
Impedire la traduzione di tutti i link "mailto:" utilizzando JavaScript e la classe cnw_skip_translation
document.addEventListener("DOMContentLoaded", function() {
var mailto_links = document.querySelectorAll('a[href^="mailto:"]');
for(var i = 0; i < mailto_links.length; i++){
if(mailto_links[i].innerHTML.indexOf('@')>-1) mailto_links[i].classList.add('cnw_skip_translation');
}
});
Mostra immagini diverse (o altri contenuti) per ogni lingua
Per motivi di localizzazione, potrebbe essere necessario sostituire i contenuti del proprio sito web quando si cambia la lingua.
Esistono diversi modi per farlo: ad esempio tramite attributi HTML. Ecco un esempio di come sostituire le immagini.
Per prima cosa, crea un'immagine con attributi di dati come questa:
In alternativa, è possibile effettuare il monitoraggio utilizzando gli eventi personalizzati di Conword. Ecco un esempio di come monitorare le traduzioni di Conword con Piwik (Matomo):