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 Titolo visualizzato dell'audit

<wvds:audit:result>

Attributo Descrizione
value Override: passed, issues, critical o auto

<wvds:section>

Attributo Obbligatorio Descrizione
title 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 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
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

Zuletzt geändert: il 29/01/2026 alle 20:09