Introduzione Versione 2.8 / Ultimo aggiornamento: 30.09.2025
Benvenuto nel manuale di conword.
In questa pagina troverai le risposte alle domande più frequenti e tutto ciò che ti serve per installare e utilizzare conword sul
o sul sito web del tuo cliente.
Lingue disponibili
L'elenco delle lingue attualmente disponibili e i relativi codici linguistici ("en", "fr", "de", ...) sono disponibili qui: https://conword.io/sprachen/
Prerequisiti
Il frontend di conword è scritto in semplice javascript, 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.
Riassunto:
Conword funziona con ogni CMS su ogni server.
Installazione
Per eseguire conword, è necessario includere la configurazione javascript di base, come indicato nella sezione successiva. Quando il JavaScript di base viene caricato, saranno disponibili diverse funzioni e oggetti.
Impostazione di base
Incorporare il codice JS nell'HTML
Conword funziona sul vostro sito web con questa singola riga di codice:
Per utilizzare conword è necessario disporre di una licenza valida per il proprio dominio. Se il vostro dominio non è inserito nella whitelist, conword non funzionerà sul vostro sito web.
Opzioni di configurazione
Se desideri configurare le impostazioni di Conword, puoi utilizzare l'oggetto javascript "conword_config" per trasferire le tue impostazioni all'istanza conword.
Conword funziona sul vostro sito web con questa singola riga di codice:
Disabilita l'attributo rtl nel <html> tag, se viene utilizzata una lingua con funzione rtl (ad esempio l'arabo). Conword imposta automaticamente <html lang="rtl"> se questa opzione non è impostata su false.</html></html>
falso
vero, falso
disabilita_selettore_lingua
Se installi conword, nell'angolo in basso a sinistra apparirà un menu a tendina per selezionare la lingua. Impostando disable_language_switcher su true, il menu a tendina scomparirà.
falso
vero, falso
Nota
È possibile utilizzare Conword senza l'oggetto di configurazione.
Esempio: disattivazione del widget standard per il cambio 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 rielaborare la funzionalità conword nel tuo progetto, puoi utilizzare l'API Javascript Conword. Per utilizzare l'API, è sufficiente integrare conword.js nella tua pagina. Vedi Impostazione di base
Punto finale 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 chiamato anche 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 dinamicamente alla pagina. Sebbene Conword ne sia ben consapevole e osservi le modifiche, a volte si verificano dei problemi e le traduzioni devono essere riattivate.
Il metodo retranslate tenta 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(chiave_lingua)
Questo metodo salva la lingua dell'utente nella memoria locale. Viene richiamato automaticamente quando viene attivato 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 di archiviazione dell'utente su spagnolo:
Conword.set_user_language('es');
Conword.unset_user_language()
Annulla (dimentica) la configurazione della lingua dell'utente.
Esempio:
Conword.unset_user_language();
Conword.get_current_language()
Questo metodo restituisce la chiave della lingua corrente (ad esempio "en", "es" o "fr").
Esempio:
var current_langauge = Conword.get_current_language();
Conword.get_available_languages()
Questo metodo restituisce l'oggetto linguaggio javascript (vedi Oggetto linguistico).
var language_data = Conword.get_available_languages();
Eventi personalizzati
Conword genera eventi personalizzati, che possono essere ascoltati utilizzando un EventLister personalizzato.
document.addEventListener("Conword:ready", function(){
/* your code here */
});
Elenco di eventi personalizzati
"Conword:ready": viene attivato quando Conword viene caricato e inizializzato.
"Conword:translation_started" - viene attivato quando Conword inizia a tradurre.
"Conword:translation_done": viene attivato quando Conword ha terminato una traduzione.
"Conword:translation_failed" - verrà attivato quando un tentativo di traduzione fallisce.
Oggetto linguistico
L'API Conword fornisce un oggetto che contiene tutte le lingue disponibili e i loro metadati. L'oggetto può essere recuperato in questo modo:
let languages=Conword.get_available_languages();
L'oggetto si presenta così:
(a seconda delle lingue disponibili con la 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."
}
}
Escluso il contenuto
Moduli
Gli input dell'utente nei campi 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à questo elemento e tutti i suoi 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 contenenti 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, non caricando conword. Questo dovrebbe essere fatto 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 vostra 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, con css
<style>
body .cnw_translationbox {
right: 30px;
left: auto;
}
</style>
Impedisci la traduzione di tutti i link "mailto:", utilizzando js 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++){
mailto_links[i].classList.add('cnw_skip_translation');
}
});
Tracciamento
Per tenere traccia delle richieste Conword, si consiglia di avvolgere la chiamata di traduzione javascript.
Esempio di script per tracciare le traduzioni con Matomo (Piwik):
In alternativa, il tracciamento può essere effettuato utilizzando gli eventi personalizzati di Conword. Ecco un esempio di come tracciare le traduzioni di Conword con Piwik (Matomo):