Documentation
Table of Contents
3 ²Ñ¨°»å³Ü±ôs d'interf¨ªcie
Vista general
?s possible millorar la funcionalitat frontal de Áú»¢¶Ä²© afegint m¨°duls de tercers o desenvolupant els vostres propis m¨°duls sense haver de modificar el codi font de Áú»¢¶Ä²©.
Tingueu en compte que el codi del m¨°dul s'executar¨¤ amb els mateixos privilegis que el codi font de Áú»¢¶Ä²©. Aix¨° vol dir:
- Els m¨°duls de tercers poden ser perillosos. Heu de confiar en els m¨°duls que instal¡¤leu;
- Els errors en el codi d'un m¨°dul de tercers poden provocar que la interf¨ªcie es bloquegi. Si aix¨° passa, simplement traieu el codi del m¨°dul de la interf¨ªcie. Tan bon punt torneu a carregar la interf¨ªcie Áú»¢¶Ä²©, veureu una nota que manquen alguns m¨°duls. Aneu a ´¡»å³¾¾±²Ô¾±²õ³Ù°ù²¹³¦¾±¨® de m¨°duls (a ´¡»å³¾¾±²Ô¾±²õ³Ù°ù²¹³¦¾±¨® ¡ú General ¡ú ²Ñ¨°»å³Ü±ôs) i torneu a fer clic a Escanejar el directori per esborrar els m¨°duls inexistents de la base de dades.
±õ²Ô²õ³Ù²¹±ô¡¤±ô²¹³¦¾±¨®
Si us plau, llegiu sempre el manual d'instal¡¤laci¨® d'un m¨°dul concret. Es recomana instal¡¤lar nous m¨°duls un per un per detectar f¨¤cilment els errors.
Just abans d'instal¡¤lar un m¨°dul:
- Assegureu-vos que heu descarregat el m¨°dul d'una font de confian?a. La instal¡¤laci¨® de codi nociu pot tindre conseq¨¹¨¨ncies, com ara p¨¨rdua de dades
- Es poden instal¡¤lar diferents versions del mateix m¨°dul (mateix ID) en paral¡¤lel, per¨° nom¨¦s es pot habilitar una ¨²nica versi¨® alhora
Passes per instal¡¤lar un m¨°dul:
- Desempaqueteu el vostre m¨°dul dins de la seva pr¨°pia carpeta a la carpeta
modulesde la interf¨ªcie Áú»¢¶Ä²© - Assegureu-vos que la carpeta del m¨°dul contingui almenys el fitxer manifest.json
- Navegueu a ´¡»å³¾¾±²Ô¾±²õ³Ù°ù²¹³¦¾±¨® del m¨°dul i feu clic al bot¨® Escanejar el directori
- El nou m¨°dul apareixer¨¤ a la llista juntament amb la seva versi¨®, autor, descripci¨® i estat
- Habiliteu el m¨°dul fent clic al seu estat
Resoluci¨® de problemes:
| Problema | ³§´Ç±ô³Ü³¦¾±¨® |
|---|---|
| El m¨°dul no apareix a la llista | Assegureu-vos que el fitxer manifest.json existeix a la carpeta modules/your-module/ de la interf¨ªcie Áú»¢¶Ä²©. Si hi ¨¦s, vol dir que el m¨°dul no s'adapta a la versi¨® actual de Áú»¢¶Ä²©. Si el fitxer manifest.json no hi ¨¦s, ¨¦s probable que h¨¤giu desempaquetat al directori incorrecte. |
| Frontend erroni | El codi del m¨°dul no ¨¦s compatible amb la versi¨® actual de Áú»¢¶Ä²© o la configuraci¨® del servidor. Si us plau, esborreu els fitxers del m¨°dul i torneu a carregar la interf¨ªcie. Veureu un av¨ªs en qu¨¨ alguns m¨°duls s¨®n absents. Aneu a ´¡»å³¾¾±²Ô¾±²õ³Ù°ù²¹³¦¾±¨® de m¨°duls i feu clic de nou a Escanejar el directori per esborrar m¨°duls inexistents de la base de dades. |
| Apareix un missatge d'error sobre espai de noms, ID o accions id¨¨ntiques | El nou m¨°dul ha intentat registrar un espai de noms, ID o accions que ja s¨®n registrades per altres m¨°duls habilitats. Desactiveu el m¨°dul conflictiu (esmentat al missatge d'error) abans d'habilitar el nou. |
| Apareixen missatges d'error t¨¨cnic | Informaeu d'errors al desenvolupador del m¨°dul. |
Desenvolupament de m¨°duls
Per obtindre informaci¨® sobre el desenvolupament de m¨°duls personalitzats, veieu Centre de desenvolupadors.