Inhaltsverzeichnis
WvdS Audit Plugin
Versione: 1.0
Autore: Wolfgang van der Stille zeljko.petrusic@outlook.de
Licenza: GPL 2
Descrizione
Il plugin wvdsaudit consente l'incorporamento di badge di audit nelle pagine wiki con calcolo automatico dello stato basato sulla sintassi delle checkbox.
Funzionalità:
- Calcolo automatico dello stato (passed/issues/critical)
- Le sezioni critiche possono essere contrassegnate
- Override manuale possibile
- Schema colori Fluent Design (compatibile con Note plugin)
- Multilingue (DE, EN, SL, HR, IT)
Sintassi
Variante 1: Sezioni esplicite
<wvds:audit stack="stack-name" title="Titolo-modulo"> <wvds:audit:result value="passed|issues|critical" /> <!-- Opzionale: Override --> <wvds:section title="Titolo-sezione" ref="wiki:link" critical="true"> [x] Superato [ ] Non superato [-] Non applicabile </wvds:section> </wvds:audit>
Variante 2: Include (consigliato)
Carica automaticamente il titolo della sezione dalla pagina wiki referenziata:
<wvds:audit stack="vsix" title="FPC Solution Explorer 2"> <!-- Con testo completo --> <wvds:include ref="code:qualitaet" critical="true"> [ ] Nessun commento TODO (22 trovati) [x] Nessuna funzione stub </wvds:include> <!-- Modalità template: orizzontale (compatta) --> <wvds:include ref="stacks:vscode-extension">[x][x][ ][x][x]</wvds:include> <!-- Modalità template: verticale --> <wvds:include ref="sicherheit:kritis"> [x] [x] [-] </wvds:include> </wvds:audit>
Vantaggi Include:
- Il titolo della sezione viene caricato automaticamente dalla pagina checklist
- Il link alla checklist viene impostato automaticamente
- Sintassi più breve, meno soggetta a errori
- Multilingue: il titolo viene caricato dalla pagina specifica per lingua
- Modalità template: Testi degli elementi dalle pagine di revisione (solo lo stato è indicato)
Attributi
<wvds:audit>
| Attributo | Obbligatorio | Descrizione |
|---|---|---|
stack | No | Identificatore stack (vsix, doku, fpc, ecc.) |
title | Sì | Titolo visualizzato dell'audit |
<wvds:audit:result>
| Attributo | Descrizione |
|---|---|
value | Override: passed, issues, critical o auto |
<wvds:section>
| Attributo | Obbligatorio | Descrizione |
|---|---|---|
title | Sì | Titolo della sezione |
ref | No | Link wiki alla checklist (senza prefisso lingua) |
critical | No | Se true, [ ] risulta in CRITICAL invece di ISSUES |
<wvds:include> (NUOVO)
| Attributo | Obbligatorio | Descrizione |
|---|---|---|
ref | Sì | Link wiki alla checklist (es. code:qualitaet, stacks:vscode-extension) |
critical | No | Se true, [ ] risulta in CRITICAL invece di ISSUES |
Nota: Il titolo della sezione viene caricato automaticamente dal primo heading (====== Titolo ======) della pagina referenziata.
Sintassi checkbox
| Sintassi | Stato | Significato |
|---|---|---|
[x] | passed | Punto di controllo superato |
[ ] | failed | Punto di controllo non superato |
[-] | na | Non applicabile (ignorato) |
Calcolo stato
| Condizione | Stato | Colore |
|---|---|---|
Tutti [x] | passed | Verde (#dff6dd) |
Almeno un [ ] (non critico) | issues | Arancione (#fff4ce) |
[ ] in sezione critical=„true“ | critical | Rosso (#fde7e9) |
Esempi
Tutto superato (Verde)
Modulo perfettoAudit bestanden • 2026-03-30▾
Qualità codice
- ✓ Nessun commento TODO
- ✓ Nessun commento FIXME
Con problemi (Arancione)
Modulo con problemiAudit: Anmerkungen • 2026-03-30▾
Documentazione
- ✓ README presente
- ✗ API documentata
Critico (Rosso)
Modulo criticoAudit: Kritisch • 2026-03-30▾
File
lib/plugins/wvdsaudit/
├── plugin.info.txt # Metadati plugin
├── syntax.php # Parser sintassi
├── helper.php # Calcolo stato e rendering
├── style.css # Stile Fluent Design
├── conf/
│ ├── default.php # Impostazioni predefinite
│ └── metadata.php # UI Admin
└── lang/
├── de/lang.php # Tedesco
├── en/lang.php # Inglese
├── sl/lang.php # Sloveno
├── hr/lang.php # Croato
└── it/lang.php # Italiano
Classi CSS
| Classe | Descrizione |
|---|---|
.wvds-audit | Container |
.wvds-audit-passed | Stato verde |
.wvds-audit-issues | Stato arancione |
.wvds-audit-critical | Stato rosso |
.wvds-audit-header | Area header |
.wvds-audit-body | Body con sezioni |
.wvds-audit-section | Singola sezione |
.wvds-audit-item-passed | Elemento superato |
.wvds-audit-item-failed | Elemento non superato |
.wvds-audit-item-na | Elemento N/A |
Vedi anche
wvdsaudit PluginAudit bestanden • 2026-03-30▾
Zuletzt geändert: il 29/01/2026 alle 20:09