Informar d'errors i problemes
From Joomla! Documentation
Per informar sobre una incidència al gestor d'incidències de Joomla!, necessitarà crear un element del gestor. Un cop l'element ha estat creat, els desenvolupadors comprovaran la seva validesa i actuaran en conseqüència.
Informant sobre errors
Registrar un compte a GitHub
Necessitareu registrar un compte a GitHub; el Gestor d'Incidències de Joomla! fa servir aquests comptes per autenticar-se en el sistema.
Accés al seguiment d'incidències de Joomla!.
Actiu
Comprovar si l'error que voleu informar ja ha estat informat.
Una sèrie de filtres mostren els elements del gestor als quals es pot accedir fent clic al botó "Eines de cerca" a la part superior de la llista. Passeu el ratolí sobre el títol dels elements del gestor per veure el seu contingut. Si el problema que està experimentant no ha estat comunicat encara, feu clic al botó "Nou element" a la zona principal de navegació.
Es mostrarà una nova pantalla i, un cop accedit, com més informació proporcioni més fàcil serà per als desenvolupadors.
Introdueixi tantes dades com pugui. Podeu activar els consells per a cada camp canviant el selector "Mode de vista" a la part dreta de la pantalla de Pro a Ajuda.
- Prioritat : Utilitzeu el nivell "Mitjà" per defecte, tret de que conegui el codi prou com per triar una altra manera.
- Construir: Escrigui aquí la(es) versió(ns) afectada(es) pel problema.
- Categories: Això és una mica més complicat. Utilitzeu "Administració" si no coneixen un de millor.
- Títol: un breu resum del problema.
- Descripció: Detalls del problema. Consulteu la secció següent per obtenir més informació.
- Pujades: Als usuaris se'ls permet pujar imatges als informes. La informació sobre els requisits de càrrega apareix al formulari de l'informe.
Proporcionar un resum
Descrigui en unes poques paraules els problemes que ha trobat. Normalment és una bona idea utilitzar elements existents del gestor com a exemple, si és la primera vegada que informa d'un error.
Exemples:
- Interfície públic: Advertint tal i tal.
- Interfície d'administració: no es pot guardar l'article quan "nomdelplugin" està publicat.
Avís: procuri ser descriptiu en el seu resum, doncs aquest serà el primer que els desenvolupadors veuran quan estiguin fullejant el gestor a la recerca d'alguna cosa que arreglar.
Proporcionar detalls sobre l'error
Per proporcionar la major informació possible, el gestor omple el camp de descripció amb una plantilla que conté 5 subseccions:
- Passos per reproduir la incidència: passos detallats sobre com una altra persona pot reproduir la seva incidència.
- Resultat esperat: el que creu que hauria de passar en realitzar els passos anteriors.
- Resultat real: el que realment passa en realitzar els passos anteriors
- Informació del sistema: informació sobre l'entorn en què està configurat el seu sistema. Això podria incloure el navegador que està utilitzant, la versió PHP del seu servidor o el tipus de base de dades que el seu lloc està utilitzant. Per obtenir resultats òptims, heu de copiar aquestes dades de la vista Informació del Sistema del seu lloc. Pot accedir a aquesta vista iniciant sessió en la part administrativa del lloc.
- Comentaris addicionals: qualsevol informació addicional no proporcionada anteriorment que podria ser beneficiosa per a la depuració i resolució del problema.
El format general ha de ser alguna cosa com:
- "Això és "exactament" el que vaig fer."
- "Això és el que va passar."
- "Això és el que crec que hauria d'haver passat".
- "Una altra informació, possible solució, pegat de codi proposat."
Com més detalls, millor. També, és important reproduir la incidència utilitzant les dades d'exemple de Joomla!, o amb instruccions clares i fàcils de com configurar-lo. Recordeu que els altres no tindran accés a la base de dades del seu lloc, de manera que haurà de ser capaç de dir-li a algú com veure la incidència amb les dades que ja estan disponibles en el lloc de mostra.
Exemple A
- El que vaig fer
- vaig començar amb el lloc de prova. Tot estava bé. Vaig activar "nomdeplugin". Vaig intentar guardar qualsevol article des de la interfície d'administració.
- El que va passar
- em surt una pantalla en blanc, i l'article no està guardat.
- El que hauria d'haver passat
- els articles s'haurien de guardar correctament.
- Informació addicional
- Aquests són els connectors habilitats al mateix temps. SEF està activat (o desactivat). El meu lloc està en una subcarpeta. També observo que ... etc. Crec que tals i tals arxius són el problema (si sap del que està parlant).
Exemple B
- El que vaig fer
- accedir a la interfície d'administració. Clic al menú "menu_name".
- El que va passar
- la pàgina que va obrir estava en blanc.
- El que hauria d'haver succeït
- El Menú la hauria d'haver obert correctament.
- Altra informació
- qualsevol altre menú funciona correctament, etc.
Exemple Real
- Què vaig fer
- Vaig començar amb el lloc web de mostra.
- Vaig afegir un article sense publicar des de la interfície d'administració, amb Secció=FAQ, Categoria=General
- En els paràmetres avançats de l'article, vaig establir Mostra Títol com "No", i els Icones Imprimeix, PDF i email com "Amaga".
- Vaig guardar l'article i vaig navegar a la interfície pública del lloc. Vaig iniciar sessió en la part pública com a administrador i vaig navegar a l'element de menú Pàgines de Exemple -> Categoria en format Bloc
- El que va passar: l'article recentment afegit és mostrat, però no hi ha icona d'editar en què fer clic a la interfície pública.
- El que hauria d'haver passat: la icona d'editar hauria de veure's, permetent a l'usuari final de la part pública editar aquest article.
- Altra informació: això només passa amb la plantilla rhuk_milkyway. Canviant aquest codi [codi proposat] a l'arxiu [nom i ruta de l'arxiu], línia(es) #, el problema sembla resoldre's am el meu sistema.
Proposar un pegat directament al repositori de Joomla! en GitHub
Si voleu proposar una solució oferint directament el codi dins de Joomla!, podeu fer-ho mitjançant l'emissió d'una "proposta de pegat" (pull request) al dipòsit de codi de Joomla! en GitHub.com, situat aquí: https://github.com/joomla/joomla-cms
Aquest procés requereix una mica de coneixement sobre els Sistemes de Control de Codi Font (SCM per les sigles en anglès) i de Git en particular. Si ja sap què és el SCM Git i com funciona, el procés és senzill:
- Registreu-vos per obtenir un compte gratuït a GitHub.com
- Bifurqui el repositori de Joomla!
Canvieu a la branca "staging" si vol proposar una solució per a la versió actual de Joomla! 3.x o a la branca "2.5.x" si vol proposar una solució per Joomla! 2.5.
- Afegiu/actualitzeu els arxius de Joomla! relacionats amb la branca adequada, i després feu clic al botó "revisar & comparar" - més informació sobre això aquí, https://help.github.com/articles/using-pull-requests - per iniciar el procés d'enviament de "pull request ".
Consells i trucs addicionals
Els informes d'incidències ben escrits són increïblement útils. No obstant això, treballar amb qualsevol sistema de seguiment d'incidències produeix una certa quantitat de sobrecàrrega de treball, per la qual cosa s'ha d'apreciar la seva ajuda en mantenir el nostre gestor de tiquets el més útil possible. en particular:
- Do read the FAQ to see if your issue might be a well-known question.
- Busqueu al gestor per veure si el seu problema ja ha estat comunicat.
Si no sabeu si el que està veient és un error, primer pregunti als fòrums de comunicació d'incidències de Joomla 3.x o de Joomla 2.5.
- Escriviu informes d'incidències específics, reproduïbles i complets. Inclogui tanta informació com li sigui possible, amb fragments de codi, casos pràctics, etc. Un exemple mínim que il·lustri la incidència amb un petit cas pràctic és el millor informe d'error possible.
No utilitzeu el sistema de seguiment per fer preguntes de suport. Utilitzeu per això els fòrums oficials de Joomla! O el canal IRC en freenode #joomla.
No utilitzar els gestors d'incidències per fer peticions de noves característiques a gran escala. Ens agrada parlar de grans canvis per al nucli de Joomla! als fòrums de desenvolupadors abans de posar-nos a treballar en ells.
No reobri problemes que han estat marcats com a "not a bug" (no és un error). Aquesta marca vol dir que s'ha pres la decisió que no podem o no volem solucionar aquest problema en particular. Si no està segur del perquè, si us plau pregunteu als fòrums de desenvolupadors.
No utilitzeu el gestor per a llargs debats, perquè són propensos a perdre's. Si un element en particular del gestor és controvertit, mogui la discussió a fòrums de desenvolupadors.
Notificació de problemes de seguretat
Informeu sobre problemes de seguretat en security [arroba] joomla [punt] org. Aquesta és una llista privada accessible únicament a desenvolupadors de confiança que porten molt de temps col·laborant amb el projecte, i els seus arxius no són accessibles públicament.
En el cas d'una vulnerabilitat confirmada a Joomla!, es realitzaran els següents accions:
- Acusar rebut, a l'informador, de la recepció de l'informe i que la solució està pròxima. Es donarà un calendari aproximat i se li demanarà a l'informador que mantingui el problema secret fins que es faci públic.
- Aturar qualsevol altre desenvolupament mentre sigui necessari per desenvolupar una solució, incloent pegats sobre la versió actual i les dues precedents.
- Determinar una data de publicació per anunciar la vulnerabilitat i la seva correcció. Per tractar de mitigar una possible "carrera armamentista" entre els que han d'aplicar el pegat i aquells que tracten d'explotar el forat, no anunciarem els problemes de seguretat immediatament.
- Anunciar públicament la vulnerabilitat i la correcció en la data acordada. Això probablement signifiqui una nova versió de Joomla!, encara que amb alguns casos pot tractar-se simplement de pegats per a les versions actuals.