Come segnalare bug e problemi

From Joomla! Documentation

This page is a translated version of the page Filing bugs and issues and the translation is 99% complete.

Other languages:
català • ‎English • ‎español • ‎français • ‎Bahasa Indonesia • ‎italiano • ‎Nederlands • ‎português • ‎русский • ‎svenska • ‎Türkçe • ‎中文(台灣)‎

Per segnalare un problema nel Joomla! bug tracker, è necessario aprire una segnalazione. Una volta che la segnalazione è stata aperta, gli sviluppatori ne verificheranno la validità e agiranno di conseguenza. Se si desidera aiutare nei test delle patch Joomla, segui questo link con le istruzioni dettagliate su come fare.

Segnalazione bug

Registra un account su GitHub

E' necessario registrare un account su GitHub; Joomla! Issue Tracker utilizza gli account di GitHub per l'autenticazione.

Accedi al Joomla! issue tracker.

Controlla per vedere se il bug è già stato segnalato.

Ci sono molti filtri per visualizzare gli elementi del Tracker, si possono utilizzare facendo clic sul pulsante "Strumenti di ricerca" nella parte superiore della lista. Passa il Mouse sul titolo degli elementi del tracker per verificarne il contenuto. Se il problema riscontrato non è già riportato, cliccare sul pulsante "Nuovo elemento" nell'area di navigazione principale.

Apparirà una nuova schermata in cui più informazioni si forniscono, più sarà facile per gli sviluppatori.

Compila quanti più dati possibile. È possibile abilitare suggerimenti per ogni campo commutando l'interruttore "View Mode" sul lato destro dello schermo da Pro a Help.

  • Priorità : Utilizza il valore predefinito di "Medium", tranne se conosci il codice abbastanza per fare un'altra scelta.
  • Costruzione : Scrivi qui la versione/i affetta/e dal problema.
  • Categorie: Questo è più difficile. Utilizzare "Amministrazione", se non si conosce meglio.
  • Titolo : Una breve sintesi del problema.
  • Descrizione : Dettagli del problema. Vedi la sezione seguente per ulteriori informazioni.
  • Upload : gli utenti potranno caricare le immagini relative al problema. Le informazioni sui requisiti sono elencate nel modulo report.

Fornisci una sintesi

Descrivi in poche parole i problemi che si verificano. E ' generalmente una buona idea utilizzare i tracker esistenti come esempi, se questa è la prima volta che apri una segnalazione.

Esempi:

  • Front-end: Avviso così e così.
  • Back-end: Impossibile salvare articolo quando "nome del plug-in" è pubblicato.

Nota: Fare attenzione a essere descrittivo nel riepilogo in quanto questa è la prima cosa che gli sviluppatori vedranno quando controllano il tracker in cerca di qualcosa da risolvere.

Fornisci ulteriori dettagli sui bug

Per fornire più informazioni possibili, il tracker popola il campo descrizione con un modello con cinque sotto-sezioni:

  • I passaggi per riprodurre il problema: I passaggi dettagliati su come un'altra persona può riprodurre il problema.
  • Risultato atteso: Cosa credi che dovrebbe accadere quando si esegue la procedura descritta sopra.
  • Risultato effettivo: Che cosa è realmente accaduto durante l'esecuzione delle operazioni di cui sopra
  • Informazioni di sistema: Informazioni relative a come è configurato il tuo sistema. Questo potrebbe includere il browser che si sta utilizzando, la versione di PHP del server o il tipo di database che si sta usando. Per ottenere risultati ottimali, è possibile reperire questi dati dalla vista System Information del tuo sito quando si accede nella sezione amministratore.
  • Ulteriori commenti: Ogni informazione aggiuntiva non prevista in precedenza che sarebbe utile per risolvere il problema.

Il formato generale dovrebbe essere qualcosa del tipo:

  1. "Questo è esattamente quello che ho fatto."
  2. "Questo è quello che è successo."
  3. "Questo è quello che penso sarebbe dovuto succedere."
  4. "Altre informazioni, possibile soluzione, proposta di codice patch."

Più dettagli ci sono meglio è. Inoltre, è importante riprodurre l'errore utilizzando un esempio di sito web con istruzioni semplici e chiare su come configurarlo. Ricordate che gli altri non avranno accesso al database del sito, quindi è necessario essere in grado di dire a qualcuno come vedere il bug con i dati facilmente disponibili -- il sito di esempio.

Esempio A

Quello che ho fatto
Ho iniziato con il sito e i dati di esempio. Tutto era ok. Abilito "nome-del-plugin". Tento di salvare un articolo dal back-end.
Quello che è successo
E' uscita una schermata vuota e l'articolo non è stato salvato.
Cosa sarebbe dovuto succedere
L'articolo si sarebbe dovuto salvare correttamente.
Altre informazioni
Questi sono i plugin abilitati. SEF è on (o Off). Il mio sito è in una sottocartella. Inoltre segnalo che... ecc. I file fatti così e così hanno generano il problema IMHO (se si sa cosa si sta parlando).

Esempio B

Quello che ho fatto 
Accedere al Back-end. Fare click sul menu "menu_name".
Quello che è successo
Si è aperta una pagina vuota.
Cosa sarebbe dovuto succedere
Il menu si sarebbe dovuto aprire correttamente.
Altre informazioni
Tutti gli altri menu funzionano correttamente. Ecc...

Esempio Reale

  • Quello che ho fatto
  1. Ho iniziato con i dati di esempio.
  2. Ho aggiunto un articolo non pubblicato dal back-end, con Sezione=FAQ, Categoria=Generale.
  3. Nei parametri avanzati per l'articolo, impostare Mostrare il Titolo su "No" e la Stampa, PDF, Icone Email su "Nascoste".
  4. Salvare l'articolo e passare al front-end. Autenticarsi sul front-end come admin e navigare le Pagine di Esempio -> Categoria Blog voce di menu.
  • Quello che è successo: L'articolo appena aggiunto si vede ma non c'è nessuna icona di modifica su cui fare clic per modificarlo.
  • Che cosa sarebbe dovuto accadere: L'icona di modifica si dovrebbe vedere, consentendo agli utenti del front-end di modificare l'articolo.
  • Altre informazioni: Questo accade solo con il template rhuk_milkyway. Modificando questo codice [codice proposto] nel file [nome e cartella del file], alla linea #, il problema sembra risolto con le mie impostazioni.

Emettere una richiesta di pull direttamente su repository GitHub di Joomla!

Se vuoi proporre una correzione fornendo direttamente il codice all'interno di Joomla!, puoi farlo inviando una "richiesta di pull" sul repository di Joomla! su GitHub.com, si trova qui: https://github.com/joomla/joomla-cms

Questo processo richiede un po' di conoscenze in materia di Controllo del codice Sorgente e del sistema di gestione Git. Se si sa che cosa è il Git SCM e come funziona, il processo è semplice.:

  • Registra un account gratuito su GitHub.com
  • Fork il repository Joomla!
  • Passa al breanch di "staging" se si vuole proporre una correzione per il ramo corrente Joomla! 3.x o per il ramo "3.x-dev" se si desidera proporre una correzione per il prossimo Joomla! Versione 3.x.
  • Aggiungi/aggiorna i relativi file in Joomla! nel branch e fare clic su "review & compare" - più info su questo qui https://help.github.com/articles/using-pull-requests - per avviare la "richiesta di pull".

Ulteriori consigli e suggerimenti

Le segnalazioni di bug ben scritte sono incredibilmente utili. Tuttavia, c'è una certa quantità di overhead di lavoro con qualsiasi sistema di bug tracking, così è molto apprezzato se mantenete il tracker dei ticket il più pulito possibile. In particolare:

  • Do read the FAQ to see if your issue might be a well-known question.
  • Effettuate una ricerca nel tracker per vedere se il problema è già stato segnalato.
  • Chiedi nel forum delle segnalazioni bug Joomla 3.x se non sei sicuro se quello che stai vedendo è un bug.
  • Scrivi segnalazioni di bug complete, riproducibili e precise. Includi quante più informazioni puoi, con frammenti di codice, casi di test, ecc... Un esempio minimo che illustri il bug in un bel banco di prova piccolo è la miglior segnalazione possibile.
  • Non utilizzare il sistema di tracker di porre domande di supporto. Utilizzare il Joomla! forum, o il canele IRC [IRC: //irc.freenode.net/joomla #joomla] su freenode.
  • Non utilizzare il tracker per fare richieste di funzionalità su larga scala. Ci piace discutere di eventuali grandi cambiamenti al core di Joomla! su developers forums prima di poter realmente lavorare su di esse.
  • Non riaprire segnalazioni che sono stati contrassegnate come "non è un errore". Questo marchio significa che è stato deciso che non possono o non si vogliono risolvere questi particolari problemi. Se non si è sicuri del perché, si prega di chiedere sul forum degli sviluppatori.
  • Non utilizzare il tracker per lunghe discussioni, perché possono perdersi. Se una particolare segnalazioni è controversa, si prega di spostare la discussione sul forum degli sviluppatori.

Segnalazione di problemi di sicurezza

Segnala i problemi di sicurezza a sicurezza [at] joomla [dot] org. Questa è una lista privata aperta solo a sviluppatori di lunga data altamente affidabili, gli archivi non sono leggibili pubblicamente.

Nel caso di una vulnerabilità confermata in Joomla! per sé, prenderemo le seguenti azioni:

  • Forniremo un riscontro a chi ha segnalato che abbiamo ricevuto la segnalazione e che una correzione è imminente. Daremo una timeline indicativa e chiediamo di tenere la questione confidenziale fino all'annunciamo ufficiale.
  • Bloccheremo tutto lo sviluppo per il tempo necessario per sviluppare una correzione, comprese le patch per le due versioni precedenti.
  • Stabiliremo una data per annunciare la vulnerabilità e la correzione. Per cercare di mitigare una possibile "corsa agli armamenti" tra quelli che devono applicare la patch e coloro che cercano di sfruttare il buco, non annunceremo immediatamente il problema di sicurezza.
  • Annunceremo pubblicamente la vulnerabilità e la correzione alla data prestabilita. Questo probabilmente significa una nuova versione di Joomla! ma in alcuni casi può essere semplicemente una patch alla release attuale.