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:

<script id="conword-root" charset="utf-8" src="https://static.conword.io/js/v2/[client-id]/conword.js"></script>

Nota

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:

<script>
	var conword_config={
		disable_rtl_attribute:false,
		disable_language_switcher:false
	};
</script>

<script id="conword-root" charset="utf-8" src="https://static.conword.io/js/v2/[client-id]/conword.js"></script>
Impostazioni disponibili
Nome dell'opzione Descrizione Valore predefinito Valori possibili
disabilita_attributo_rtl 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:

<img src="bild_de.jpg" data-conword-src-de="bild_de.jpg" data-conword-src-en="image_en.jpg" data-conword-src-fr="fr.jpg" class="image_with_different_sources">

Il codice JavaScript rileva i cambiamenti di lingua e sostituisce l'attributo src dell'immagine con il valore dell'attributo.

document.addEventListener("Conword:translation_done", function(){
	current_language=Conword.get_current_language();
	images_with_different_sources = document.querySelectorAll('.image_with_different_sources'); // or select [data-conword-src-de]
	images_with_different_sources= [...images_with_different_sources]; // convert list to array
	images_with_different_sources.forEach(img => {
		img.src=img.getAttribute('data-conword-src-'+current_language); // change src
	});
});

Monitoraggio

Per monitorare le richieste di Conword, consigliamo di racchiudere la chiamata di traduzione JavaScript.

Script di esempio per monitorare le traduzioni con Matomo (Piwik):

<a href="javascript:custom_start_translation('en');">English</a>

<script>

	function custom_start_translation(languagekey){
		Conword.translate(language);
		matomo_track( 'Translation '+languagekey, location.href);

	}

	function matomo_track(category,action){
		if(typeof _paq !== 'undefined') {
			_paq.push(['trackEvent', category, action, 1]);
			return true;
		}
		return false
	}

</script>

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):

<script>

	function matomo_track(category,action){
		if(typeof _paq !== 'undefined') {
			_paq.push(['trackEvent', category, action, 1]);
			return true;
		}
		return false
	}

	document.addEventListener("Conword:translation_started", function(){
		matomo_track( 'Translation '+Conword.get_current_language(), location.href);
	});

</script>

L'esempio seguente mostra come monitorare le traduzioni di Conword con Google Analytics:

<script>

	document.addEventListener("Conword:translation_started", function(){
		gtag('event', 'translation', {
			'url': location.href,
			'language': Conword.get_current_language()
		});
	});

</script>

Hai qualche domanda?

Scrivici. Saremo lieti di aiutarti.