Introduzione Versione 2.8 / Ultimo aggiornamento: 22/06/2026
Benvenuti nel manuale di Conword.
In questa pagina troverete le risposte alle domande più frequenti e tutte le informazioni necessarie per configurare e rendere operativo Conword sul
vostro sito web o su quello del vostro cliente.
Lingue disponibili
L'elenco delle lingue attualmente disponibili e i relativi codici lingua ('en', 'fr', 'de', ...) è disponibile 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.
In sintesi:
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 Conword, puoi utilizzare l'oggetto JavaScript "conword_config" per trasmettere le tue impostazioni all'istanza di Conword.
Conword funziona sul vostro sito web con questa singola riga di codice:
Disattiva l'attributo rtl nel <html> tag, se viene utilizzata una lingua con la funzionalità rtl (ad es. l'arabo). Conword imposta automaticamente <html lang="rtl"> se questa opzione non è impostata su false.</html></html>
falso
vero, falso
disabilita_selettore_lingua
Se si installa Conword, nell'angolo in basso a sinistra apparirà un menu a tendina per selezionare e cambiare la lingua. Impostando `disable_language_switcher` su `true`, il menu a tendina verrà rimosso.
falso
vero, falso
Nota
È possibile utilizzare Conword senza l'oggetto di configurazione.
Esempio: disattivazione del widget standard per il cambio di 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 Impostazione di base
Punto finale API
È possibile utilizzare l'oggetto JavaScript "Conword" per richiamare i metodi dell'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 chiamata 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 traccia 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 di visualizzazione 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 esempio '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 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 non va a buon fine.
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
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". Impostandone il 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 oppure utilizzando la funzione conword.lock(), disponibile nelle versioni più recenti di Conword.
Esempi
Esclusione dinamica dei contenuti con il nome di classe ".formular_zusammenfassung"
document.addEventListener("DOMContentLoaded", function() {
var formular_zusammenfassungen = document.querySelectorAll('.formular_zusammenfassung');
for(var i = 0; i < formular_zusammenfassungen.length; i++){
formular_zusammenfassungen[i].classList.add('cnw_skip_translation');
}
});
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 verso destra, con 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, potresti voler sostituire i contenuti del tuo sito web quando cambi la lingua.
Esistono diversi modi per gestire questa operazione: 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, il monitoraggio può essere effettuato utilizzando gli eventi personalizzati di Conword. Ecco un esempio di come monitorare le traduzioni di Conword con Piwik (Matomo):