WvdS Audit Plugin
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)
Con problemi (Arancione)
Critico (Rosso)
Sicurezza *- ✗ Validazione input
- ✓ Gestione errori
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