User Documentation Questo glossario definisce termini e formulazioni standardizzati utilizzati nella documentazione e nei tutorial, per mantenere coerenza terminologica e di scelta delle parole tra gli autori.
Accedi vs. Accesso
La regola: login (una parola) è un sostantivo o aggettivo; log in (due parole) è il verbo.
- Sostantivo/aggettivo: "the login screen," "the login button," "your login credentials," "a failed login" — ovunque identifichi un oggetto o descriva un altro sostantivo, è una sola parola.
- Verbo: "please log in," "log in with your email," "you need to log in first" — ovunque descriva l'azione di accedere, sono due parole.
Esempio: "Go to the login screen, then log in, then click the login button."
Lo stesso schema si applica a logout/log out: "the logout button" (sostantivo/aggettivo, una parola) contro "log out when you're done" (verbo, due parole).
Visualizza il sito
Usa "visualizza il sito" per indirizzare un utente che lavora nel backend ad aprire il frontend e verificare i risultati delle modifiche appena apportate.
L'azione utilizza il link Visualizza sito nell'intestazione del backend, che apre il frontend in una nuova scheda del browser. Questo stabilisce un flusso di lavoro a due schede: il backend in una scheda, il frontend in un'altra, con l'utente che passa dall'una all'altra per verificare i risultati. Introduci questo schema fin dall'inizio — nell'introduzione del tutorial — in modo che gli utenti si abituino a passare da una scheda all'altra nei tutorial successivi.
Esempio: "Nell'intestazione del backend, fai clic su Visualizza sito per aprire il frontend in una nuova scheda. Tieni entrambe le schede aperte e passa dall'una all'altra mentre procedi in questo tutorial."
Menu amministratore
Il menu di navigazione sul lato sinistro nell'area amministrativa del sito è chiamato Menu amministratore.
Frontend / Backend
Usa "frontend" per riferirti al sito web rivolto al pubblico, e "backend" per riferirti all'area amministrativa. Questi corrispondono a quanto la documentazione ufficiale di Joomla chiama rispettivamente "the Site" e "the Administrator".
Preferisci frontend/backend nelle istruzioni dei tutorial, specialmente quando indirizzi un lettore ad accedere all'uno o all'altro — si legge in modo più naturale come coppia contrastiva. Usa Site/Administrator solo quando fai riferimento alle impostazioni o alle etichette di menu ufficiali di Joomla, dove compaiono esattamente questi termini (ad es. Site Modules contro Administrator Modules).
Maniglia di trascinamento
Usa "maniglia di trascinamento" per l'icona (tre puntini verticali) che appare nelle viste a lista del backend per riordinare gli elementi — articoli, voci di menu, moduli, categorie e liste simili supportano tutte questa funzione. Appare dopo aver fatto clic sull'icona a freccia su/giù nell'intestazione della colonna pertinente, e solo quando la lista è filtrata o ordinata in modo tale da rendere possibile il riordino.
Il codice sorgente di Joomla si riferisce internamente a questo elemento come "sortable handler" (classe CSS sortable-handler, icona icon-menu), ma "maniglia di trascinamento" è il termine utilizzato nella documentazione e nei forum della comunità Joomla, ed è il termine più riconoscibile per i lettori.
Esempio: "Fai clic sulla maniglia di trascinamento accanto a Annuncio barra laterale e trascinala in cima alla lista."