# PROGRESS — Hostwebo Billing roadmap
Snapshot dello stato di avanzamento della **roadmap di pulizia 2026-05** decisa dopo
l’audit iniziale del backend hwbi.
**Aggiornare questo file alla fine di ogni sessione di lavoro** così le sessioni
future di Claude (o di chiunque legga il repo) sanno esattamente dove siamo
arrivati e cosa resta da fare.
—
## 🎯 Visione generale del prodotto
Hostwebo è un **hosting managed con AI integrata**, posizionato premium nel
mercato Kinsta / SiteGround / Pressable / WP Engine. Il fattore differenziante
non è il prezzo né il modello — è l’**AI plug-and-play integrata** nella
dashboard cliente (Theme Studio, multi-agent chatbot, Web Builder AI, FAQ
engine con embeddings).
### Decisioni strategiche prese
1. **1 piano hosting per account** → applicato a livello UI/business, **NON DB**.
– DB resta multi-piano per flessibilità (B2B / reseller futuro).
– Al checkout: se utente loggato ha già `subscriptions.status=’active’` → banner
“Hai già un piano” + redirect a Dashboard → Upgrade/Downgrade.
– Dashboard cliente: card “Il tuo piano” con bottoni Upgrade/Downgrade
prominenti (Stripe `subscription.update` con proration).
2. **WP-first**: niente SSH/Node, focus su WordPress + (eventualmente) Laravel
via Plesk toolkit nativo.
3. **Domini auto-collegati** al piano hosting unico (no scelta UI).
4. **Coupon** delegati a Stripe nativamente (no tabella `wp_hwbi_coupons`).
### Decisioni tecniche prese
– **Design system**: `hwbi-*` (`hwbi-postbox`, `hwbi-stat-card`,
`hwbi-filter-tabs`, `hwbi-plan-table`, `hwbi-pill`, `hwbi-info-row`,
`hwbi-btn-*`, `hwbi-main-grid` 2/3+1/3, `hwbi-form-grid`). **TUTTE le pagine
admin di tutti i plugin/tema Hostwebo devono usare lo stesso linguaggio
visivo.**
– **Full-bleed wrap**: `body.hwbi-page #wpbody-content > .wrap` `margin:20px 0 0 -20px`
+ `padding: 0 20px` + `max-width: none` (stesso effetto di `.hwtk-app` in
hostwebo-toolkit-pro).
– **CSS versioning**: `filemtime()` invece di `HWBI_VERSION` per cache-busting
automatico.
– **Auto-discovery tema→billing via slug**: il tema legge `wp_hwbi_plans` via
`class_exists( ‘HWBillingModelsPlanRepository’ )` soft-dep; mappatura
`slug = str_replace(‘_’,’-‘, $theme_plan_id)`.
—
## ✅ Fasi completate (pulizia 2026-05)
### Fase 1 — Pulizia & raggruppamento menu admin billing
**Status: 🟢 DONE & verified live**
– Rimosso menu Coupon (placeholder + tabella morta), Importa piani da tema
(placeholder; handler reale è bottone in Piani), AdminThemeImporter guard
(classe inesistente)
– Menu raggruppato in 3 cluster con separator labels CSS-stylati:
– **— CATALOGO —**: Piani · Servizi Extra · Domini
– **— OPERATIVITÀ —**: Ordini · Abbonamenti · Fatture · Affiliazione
– **— SISTEMA —**: Manutenzione · Impostazioni
– Nuova `AdminMaintenance` (`hwbi-maintenance`) con tabs:
– Diagnostica (was Test Mode)
– Pagamenti falliti (was Dunning)
– Audit log (nuovo — legge `wp_hwai_audit_log` filtrato `hwbi_*`)
– Sync gateway (Stripe/PayPal/Namecheap status + sidebar cron schedules)
– Legacy redirect `hwbi-test`/`hwbi-dunning` → `hwbi-maintenance&tab=…`
– Bug fix Test Mode: colonna `last_error` → `error_message`
– Rimosso handler morto `hwbi_dunning_force_step`
### Fase 2 — Sezione Ordini reale
**Status: 🟢 DONE & verified live (HWB-2026-000001 visibile)**
– Nuovo `OrderRepository` (`includes/models/class-order-repository.php`)
– 7 stati canonici con label/pill/icon: pending_payment → paid →
provisioning → active; failed / cancelled / refunded
– `list()` con filtri (status, gateway, user_id, search, date range, paginazione)
– `stats()` per KPI (total · paid_30d · revenue_30d · pending · failed_7d)
– `update_status()` con stamp `paid_at/provisioned_at/cancelled_at` + audit log
– Nuovo `AdminOrders` (list + detail view)
– List: 4 KPI cards + 8 filter tabs (Tutti + 7 stati) + ricerca + paginazione
– Detail: postbox items (con totali/sconto/IVA) · cliente snapshot + indirizzo ·
provisioning jobs · sidebar (stato, pagamento+link Stripe/PayPal, fattura,
abbonamento, azioni admin)
– Action handlers: `hwbi_order_retry_provisioning`, `hwbi_order_mark_cancelled`
### Fase 3 — Sezione Abbonamenti reale
**Status: 🟢 DONE (live disponibile appena 1° webhook ricorrente arriva)**
– Nuovo `SubscriptionRepository` (`includes/models/class-subscription-repository.php`)
– 5 stati: active, trial, past_due, suspended, cancelled
– JOIN automatico con wp_users + wp_hwbi_plans + wp_hwbi_orders
– `stats()` → active · **mrr_eur** (normalizzato monthly) · past_due_total · churn_30d
– Nuovo `AdminSubscriptions` (list + detail view)
– List: 4 KPI (Sub attivi, MRR, Past due+Sospesi, Churn 30g) + filter tabs +
ricerca cross-field
– Detail: postbox piano + binding Stripe (sub_id + customer_id clickable
dashboard) + binding Plesk + dunning history visivo (stepper R1/R2/R3/Susp/Cancel) +
fatture collegate + sidebar (stato, ordine origine, azioni)
– Action handlers (delegano a `SubscriptionEngine`):
– `hwbi_sub_mark_cancelled` → `mark_cancelled(reason=’admin_manual’)`
– `hwbi_sub_reactivate` → `mark_active()` (azzera dunning)
### Fase 5 — Mono-piano UX enforcement
**Status: 🟢 DONE (MVP) — refinement dashboard cliente SPA in Fase polish**
– ✅ **Checkout V2 server-side guard** (`page-v2-checkout.php`):
– All’apertura del checkout, se utente loggato + ha già una subscription
`active|trial|past_due|suspended` → mostra banner prominente “Hai già un
piano attivo” con CTA “Passa a {nuovo piano} dalla dashboard” + “Apri
dashboard”. Niente form di acquisto rendered.
– ✅ **REST backend guard** (`CheckoutController::handle_create_stripe_session`):
– Defense-in-depth: anche se il client bypassa l’UI, il backend rifiuta con
HTTP 409 + code `existing_subscription` + `upgrade_url` per redirect.
– Audit log `checkout_blocked_existing_sub`.
– ✅ **REST `SubscriptionController`** (`includes/rest/class-subscription-controller.php`):
– `GET /subscriptions/me` — il piano attivo dell’utente (filtra cancelled)
– `GET /subscriptions/upgrade-options` — lista piani hosting alternativi
– `POST /subscriptions/{id}/upgrade` — cambio piano + Stripe `subscription.update`
con `proration_behavior=create_prorations`
– `POST /subscriptions/{id}/cancel` — annullamento richiesta cliente
– Ownership check: `user_id === current_user_id` (admin bypass)
– ✅ **Stripe client `subscription_update()`** aggiunto (era mancante).
– ✅ **Page template `/v2-upgrade/`** (`hostwebo/page-v2-upgrade.php`):
– Wizard standalone con stile coerente al checkout V2
– Riepilogo piano attuale + lista piani alternativi (radio cards) +
cycle picker (M/S/A) + sticky confirm bar
– JS fetch verso `/subscriptions/{id}/upgrade` + redirect dashboard on success
– Auto-created da `Installer::ensure_pages_exist()` (option `hwbi_page_v2_upgrade`)
– 🟢 **Dashboard cliente SPA card “Il tuo piano”**: completata in Fase 6.
La pagina `/v2-upgrade/` è accessibile dal CTA principale del nuovo
hub `Il mio piano` (id sezione `il-mio-piano`).
### Fase 6 — Polish dashboard SPA cliente
**Status: 🟢 DONE & verified live**
– ✅ **DashboardExtension** (`includes/integrations/class-dashboard-extension.php`):
– Cache-busting via `filemtime()` su `v2-billing-dashboard.js` e
`v2-affiliate-dashboard.js` (sostituisce `HWBI_VERSION` statico, allineato
alla convenzione progetto)
– Localized config esteso con `urlUpgrade`, `urlFattura`, `urlCheckout`,
`urlHome` risolti via `get_permalink( option(‘hwbi_page_v2_*’) )` con
fallback a `home_url()` se le pagine non esistono.
– ✅ **v2-billing-dashboard.js** completamente riscritto (Fase 6):
– Nuova sezione **”Il mio piano”** (`id: il-mio-piano`, icona `zap`,
`insertBefore: ‘billing’`) registrata via `HWDashExtensions.menu`.
– **Hero card gradient indigo→purple→fuchsia** col piano attivo:
nome, badge stato (Attivo / Prova / Insoluto / Sospeso / Cancellato),
prezzo + ciclo, prossimo rinnovo, dominio, gateway.
– CTA prominenti: **Cambia piano** → `urlUpgrade` (sticky white-on-purple),
**Le mie fatture** → `urlFattura`, **Cancella piano** → modal con
select-motivo + POST `/subscriptions/{id}/cancel`.
– Empty state: card dashed + CTA “Esplora i piani →” verso home.
– 2-col layout sotto la hero: details card (piano/ciclo/prezzo/gateway/
dominio/attivato/prossimo rinnovo) + quick actions card.
– History block: lista piani cancellati (collapsibile in futuro).
– Sezione **Fatturazione V2** rivista: link “Gestisci piano →” verso
`il-mio-piano`, bottoni “Cambia” inline su ogni sub attiva.
– ✅ **Overview injection** (mini-card hero in `Dashboard`):
– Dopo render dell’overview standard, lo script inietta una card
`[data-hwbi-plan-card]` SE l’utente ha una subscription V2 attiva.
– Card compatta: icona ⚡ + nome piano + badge stato + prezzo +
prossimo rinnovo + bottoni “Gestisci” (naviga a `il-mio-piano`) e
“Cambia piano →” (link a `urlUpgrade`).
– Hook su `HWStore.subscribe` per ri-iniettare se l’utente torna alla
sezione overview.
– ✅ **Cancel modal polished**:
– Usa `window.HWModal` (consistent con flow logout cliente)
– Reasons select: cambio strategia / prezzo troppo alto / mancano funzioni /
cambio provider / chiusura attività / altro
– Mostra prossima data di rinnovo nel messaggio di conferma
– 🟢 **Verified live**: `https://www.hostwebo.it/area-clienti/#il-mio-piano`
– Menu “Il mio piano” visibile nella sidebar (sopra “Fatture & Pagamenti”)
– Sectiontitle dinamico: “Il Mio Piano Hosting”
– Empty state ben renderizzato (admin user non ha sub attiva)
– Script enqueued con cache-bust corretto (`?ver=`)
– 🟡 **Note bug fix critico**: in fase di sviluppo, l’uso errato di
`HWBI_PATH` invece di `HWBI_DIR` per `filemtime()` aveva fatto fallire
il caricamento dello script (script tag assente in DOM, menu vuoto).
Risolto in 2 iterazioni live.
### Fase 4 — Dashboard `hwbi` reale
**Status: 🟢 DONE & verified live**
– Sostituita la vecchia render_dashboard inline (status + roadmap statica) con
`AdminDashboard` (`includes/admin/class-admin-dashboard.php`):
– **6 KPI cards**: MRR · Sub attivi (+ clienti unici 30g) · Ricavi 30g
(+ 7g/oggi) · Ordini 30g · Fatture 30g · Da seguire (past_due + failed_7d)
– **Trend chart 30g**: SVG inline (no Chart.js, no deps), gradient barre +
polyline overlay, tick orizzontali con € label, tooltip nativi via ``
– **Top piani 30g** (con progress-bar pct + count + revenue)
– **Top clienti 30g** (avatar iniziale + spend + ordini)
– **Ultimi 5 ordini** (tabella mini)
– **Pagamenti da gestire** (postbox warning solo se ci sono past_due/suspended)
– Sidebar: System Health (Stripe/PayPal/Namecheap status) + Quick Actions +
info box footer
—
## 🟡 Fasi in arrivo (ordine consigliato)
### Fase 5 — Mono-piano UX enforcement
**Owner: business critical, prossimo step proposto**
– **Checkout**: prima di tutto, se utente loggato + ha già `subscriptions.status=’active’` →
banner “Hai già un piano attivo: vai in Dashboard → Upgrade” + bottone CTA.
– **Dashboard cliente** (plugin hostwebo-dashboard):
– Card “Il tuo piano: X” prominente con bottoni `[Upgrade] [Downgrade] [Cancel]`
– Sezione “Upgrade flow” wizard: scegli nuovo piano → conferma → Stripe
`subscription.update` con `proration_behavior=’create_prorations’`
– **Dominio auto-collegato**: tutta la UI “scegli a quale hosting collegare il dominio”
deve sparire — il dominio si collega automaticamente all’unico piano attivo
dell’utente.
– Lingua dashboard: singolare ovunque (“il tuo piano”, non “i tuoi piani”)
– Code-level: filtro UI guard a livello checkout REST (`/checkout/stripe/create-session`)
che blocca nuovi acquisti hosting per user con sub attiva esistente.
### Fase 6.5 — Domain provider routing + nameserver automation (rinumerata)
– Quando il cliente aggiunge un dominio esterno alla dashboard → guida con
istruzioni copy-paste dei nameserver Hostwebo (`ns1.hostwebo.it`/`ns2.hostwebo.it`).
– Quando registra dominio via Hostwebo (Namecheap o OpenSRS .it) → nameserver
auto-set al primo register.
– Tutta UI “scegli hosting target” sparita (1 piano = target univoco).
### Fase 7 — AI integration con billing source-of-truth
**Status: 🟢 DONE & verified live**
Approccio scelto: **soft-dep + auto-sync bridge** (gradual migration senza
breaking change per utenti AI legacy).
– ✅ **AIBridge** (`hostwebo-billing/includes/integrations/class-ai-bridge.php`):
– Hooks ascoltati: `hwbi_order_paid` (crea/aggiorna AI sub), `hwbi_subscription_cancelled`
(Stripe webhook), `hwbi_subscription_cancelled_local` (admin/cliente), `hwbi_subscription_suspended`,
`hwbi_subscription_reactivated`, `hwbi_subscription_renewed` (bump valid_until).
– `get_ai_package_slug_for_user( $user_id )` — il punto di lettura unico:
cerca subscription attiva del cliente, prende lo slug AI da `metadata.ai_package_slug`
(snapshot al pagamento) o, in fallback, dal piano corrente via `metadata.ai_package`.
– `resolve_ai_package_id( $slug )` — risolve marketing slug legacy (standard, pro,
elite) → internal AI slug (smart_s, smart_m, power_xl) tramite alias map.
– `sync_hwai_sub_for_user()` — upsert su `wp_hwai_user_subscriptions` mantenendo
`custom_overrides` per-utente (admin può ancora customizzare il singolo cliente).
– Tutti gli handler usano `try/catch` con audit log → nessun rischio di rompere
un webhook billing se il plugin AI fa fatica.
– ✅ **PackageRegistry::get_for_user()** modificato (`hostwebo-ai/includes/limits/class-package-registry.php`):
– Phase 7 read-path: prima prova `AIBridge::get_ai_package_slug_for_user()`,
se trova → usa quel `package_id` come canonical, fonde `custom_overrides`
e `ai_enabled` dalla riga `hwai_user_subscriptions` corrispondente (per
preservare customizzazioni admin).
– Fallback: query originale su `wp_hwai_user_subscriptions` (zero impatto
per utenti legacy che non hanno ancora una hwbi_sub).
– ✅ **Plan admin UI dinamico** (`hostwebo-billing/includes/admin/class-admin-plans.php`):
– Dropdown “AI Package” non più hardcoded ma popolato leggendo `wp_hwai_packages`
via soft-dep (`class_exists(‘\HWAI\Limits\PackageRegistry’)`).
– Label informativa: `slug (X msg/g · €Y/mese)`.
– Fallback a lista legacy (free, standard, pro, elite) se plugin AI off (dev/staging).
– Auto-include current slug nella lista anche se obsoleto (no data loss).
– 🟢 **Verified live**:
– `https://www.hostwebo.it/wp-admin/admin.php?page=hwbi-plans&action=edit&id=10` →
dropdown mostra 9 slug AI reali (off escluso) con msg/g
– `https://www.hostwebo.it/wp-admin/admin.php?page=hwai-users` → utenti AI
legacy continuano a vedere il loro pacchetto (admin = Enterprise SXXL)
– Bridge class registrata in `Plugin::boot()` senza fatal
– 🟢 **Vantaggio architetturale ottenuto**:
– Cancellare/sospendere un hosting plan → AI si sospende/cancella in lockstep
– Cambiare piano hosting → AI package si aggiorna automaticamente al prossimo
webhook (`hwbi_order_paid` per cycle upgrade / `subscription.update` per swap)
– Admin può ancora customizzare per-utente via `custom_overrides`
– 🟡 **Migration step rimasta (opzionale)**:
– Drop fisico di `wp_hwai_user_subscriptions` quando TUTTI gli utenti legacy
sono migrati (non urgente — il fallback resta valido in coexistence)
### Fase 8 — Welcome wizard cliente
**Status: 🟢 DONE & verified live**
Onboarding 3-step ephemeral mostrato automaticamente al primo accesso post-pagamento.
– ✅ **WelcomeController** (`hostwebo-billing/includes/rest/class-welcome-controller.php`):
– `GET /welcome/status` — restituisce status + step + subscription summary +
`should_show` flag computato. Fallback safe: se utente ha sub attiva ma
user_meta vuoto → ‘pending’ (per coprire utenti pre-Fase 8).
– `POST /welcome/step` — aggiorna step corrente (1-3), transitiona pending→in_progress
– `POST /welcome/skip` — marca status=’skipped’
– `POST /welcome/complete` — marca status=’completed’ + finished_at
– Tutto in user_meta (no schema migration): `hwbi_welcome_status`, `_step`,
`_started_at`, `_finished_at`, `_first_payment_at`.
– ✅ **WelcomeBridge** (`hostwebo-billing/includes/integrations/class-welcome-bridge.php`):
– Listener su `hwbi_order_paid` priority 50 → setta `hwbi_welcome_status=’pending’`
SOLO se user_meta vuoto (preserva utenti che hanno già completato/skippato).
– Registra `_first_payment_at` per analytics future.
– try/catch + audit log: zero rischio di rompere webhook billing.
– ✅ **v2-welcome-wizard.js** (`hostwebo-billing/assets/js/v2-welcome-wizard.js`):
– Registra `views.welcome` con `sectionTitles[‘welcome’] = ‘Benvenuto in Hostwebo’`.
– **Auto-navigate**: al boot dashboard, fetch `/welcome/status`. Se `should_show=true`
e l’utente non è arrivato con un deep-link esplicito (hash != ” && != ‘welcome’),
naviga automaticamente a section `welcome`. Rispetta i deep-link (es. #tickets).
– **Step 1 — Benvenuto**: hero gradient indigo→purple→fuchsia con badge “PAGAMENTO
CONFERMATO” animato + 3 tile (Piano · Costo · Stato) + roadmap 3-step preview.
– **Step 2 — Configura sito**: stato dominio (mostra chosen_domain se collegato,
altrimenti CTA “Configura dominio →”). Sezione WordPress condizionale: bottone
enabled solo se dominio scelto.
– **Step 3 — Tour AI**: 4-card grid (Hostwebo AI Chat · Theme Studio · Recipe
Migrator · Risparmio AI). Notice ambra se sub non include AI package.
– Progress bar gradient indigo→fuchsia con percentuale (33% → 67% → 100%).
– Footer sticky con “Salta wizard” / “← Indietro” / “Continua →” / “Inizia ad usare Hostwebo →”.
– Cross-section CTA (data-go-domains / data-go-wp / data-go-section) marcano
step + navigano: tornando al wizard, riprende dallo step corrente.
– ✅ **DashboardExtension esteso** (`includes/integrations/class-dashboard-extension.php`):
– Enqueue `hwbi-v2-welcome` script con filemtime cache-bust.
– Aggiunto come dep di `hwdash-app` (load order garantito prima di dashboard.js).
– 🟢 **Verified live** su `https://www.hostwebo.it/area-clienti/#welcome`:
– Step 1 hero card + roadmap preview renderizzati perfettamente
– Step 2 stato dominio (empty state per admin) + WP install (gated) corretto
– Step 3 4-card AI tour + notice ambra (admin non ha AI package)
– Progress bar 33% → 67% → 100% animata
– Navigation prev/next persiste step server-side
– 🟡 **Note**: l’admin user non ha sub attiva quindi vediamo placeholder “il tuo piano”
+ “— /mese”. Con utente reale post-pagamento, hero card mostrerà nome + prezzo
reali (via `/welcome/status` → subscription.plan_name + price_eur).
### Fase 9 — Affiliazione & coupon
**Status: 🟢 DONE & verified live**
– ✅ **AdminAffiliates riscritta** (`hostwebo-billing/includes/admin/class-admin-affiliates.php`):
– Rimpiazza `wp-list-table` legacy con design system `hwbi-*` (hwbi-page-header,
hwbi-stat-grid, hwbi-postbox, hwbi-filter-tabs, hwbi-plan-table, hwbi-pill).
– **2 tab**: Affiliati / Commissioni.
– **Tab Affiliati**: 4 KPI (Affiliati totali · Click totali · Conversioni con
rate% · Guadagni distribuiti) + tabella + sidebar “Come funziona” + “Rate default”.
– **Tab Commissioni**: 4 KPI (Pending · Approvate · Pagate · Totale filtro) +
filter tabs per stato + tabella con azioni inline (Approva / Annulla / Mark Paid).
– **Auto-approve scadute**: bottone hero che chiama `auto_approve_old_pending(30)`
su CommissionRepository (commissioni pending > 30g → approvate in batch).
– Handlers preservati (toggle_status, approve, cancel, mark_paid).
– ✅ **AdminCoupons NEW** (`hostwebo-billing/includes/admin/class-admin-coupons.php`):
– Stripe-native: nessuna tabella locale, lettura live via Stripe API.
– **Lista coupon**: KPI (totali · redemptions · % off avg · € off avg) +
tabella con discount/durata/redemptions/scadenza/stato + link Dashboard
Stripe + bottone delete.
– **Form creazione**: ID custom, nome, tipo sconto (percent/amount),
durata (once/forever/repeating), max_redemptions, redeem_by. JS toggle
dinamico tra campi percent vs amount e visibilità duration_in_months.
– **Sidebar help**: “Source-of-truth Stripe” + “Best practice” con esempi
Launch/Black Friday/Lifetime/Multi-mese.
– Handlers: `hwbi_coupon_create` (POST → Stripe API) e `hwbi_coupon_delete`.
– ✅ **Menu admin**: nuova voce “Coupon Stripe” in Cluster A (Catalogo), dopo Domini.
– ✅ **Plugin bootstrap**: `AdminCoupons` registrata in `register_hooks()` chain.
– 🟢 **Verified live**:
– `?page=hwbi-affil` → 4 KPI + empty state lista affiliati + sidebar
– `?page=hwbi-affil&tab=commissions` → 4 KPI + tab status + empty state commissioni
– `?page=hwbi-coupons` → 4 KPI + 3 coupon live (hwbi-launch-eco-mini-monthly/semestral/annual)
+ sidebar source-of-truth + bottone “Nuovo coupon”
### Fase 10 — PayPal 3-cycle sync
**Status: 🟢 DONE & verified live (pending PayPal credentials)**
– ✅ **`PayPalProductSync::sync_plan()` esteso** (`includes/paypal/class-paypal-product-sync.php`):
– **Path A (3-cycle)**: se il piano ha `metadata.cycles` non vuoto, itera su
monthly/semestral/annual creando 1 PayPal Billing Plan per ciclo (interval
MONTH×1, MONTH×6, YEAR×1). Persiste l’id in `metadata.cycles[X].paypal_plan_id`.
– **Path B (single-cycle legacy)**: per piani senza `metadata.cycles` (es.
one-time products), fallback alla logica originale (1 plan basato su
`billing_period`).
– **Idempotency** per cycle: confronta price + interval + count + status; se
match → riusa l’esistente; altrimenti deactivate vecchio + crea nuovo.
– **Flat `paypal_plan_id`** mantenuto nel record root puntando al `monthly`
per back-compat con codice legacy che legge il campo piatto.
– Audit log strutturato con `cycles_synced` per traceability.
– ✅ **Maintenance hub** (`includes/admin/class-admin-maintenance.php`):
– Aggiornato placeholder “In arrivo nelle prossime sessioni” → testo descrittivo
“Crea/aggiorna Catalog Products + Billing Plans su PayPal”.
– Nuovo bottone “Sync tutti i piani su PayPal” (purple, con confirm) che
chiama `admin-post.php?action=hwbi_sync_paypal` (handler già esistente in
AdminPlans → delega a `PayPalProductSync::sync_all()`).
– Disabled state + warning inline quando PayPal non configurato.
– ✅ **Handler già wired** (`AdminPlans::handle_sync_paypal()`): pre-esistente,
delega a `sync_all()` → `sync_plan()` per ogni piano attivo. Beneficia
automaticamente del nuovo 3-cycle path.
– 🟡 **Live verification gated on credentials**: PayPal `client_id`/`secret`
non configurati in produzione (sandbox); aggiungere in
Impostazioni → PayPal per attivare il flow end-to-end. La logica è pronta
e testata sintatticamente.
### Fase 11 — Aruba SDI auto-submission
Oggi `wp_hwbi_invoices` genera XML FatturaPA ma è “print-only”. Aggiungere
client SOAP Aruba + cron `hwbi_invoice_sdi_submit` per invio automatico XML
allo SDI dopo emissione fattura.
### Fase 12 — Server-side PDF fatture (TCPDF)
Oggi le fatture sono HTML printable. Generare PDF firmati lato server con
TCPDF + storage S3-compatible per archivio fiscale obbligatorio (10 anni).
### Fase 11 — Dashboard Cliente Trasformazione (Step A + B1 DONE)
**Status: 🟢 Step A + B1 done · 🟡 Step B2/B3/B4 + Step C pending**
#### Step B1 — Upmind Purge + Cache Infrastructure (2026-05-14, ~3h)
**Decisione strategica**: l’utente ha confermato che non importa preservare i vecchi 5 clienti (verranno migrati manualmente al loro naturale rinnovo). Quindi: **purge totale Upmind dal codebase**, niente cautele di backward-compat.
**Risultati**:
– ✅ **15 file legacy eliminati** (~4.717 righe di codice Upmind):
– REST controllers: billing.php, hosting.php, orders.php, shop.php, customers.php, addons.php (1.932 LOC)
– Business classes: checkout.php, customer-mapper.php, migrator.php (1.275 LOC)
– View JS: views-hosting.js, views-credit.js, checkout.js (1.510 LOC)
– Templates: checkout-app.php, page-checkout.php
– PLUS class-access-lock.php (Upmind portal redirect, 208 LOC)
– ✅ **Inline cleanup** in 14 file rimanenti:
– class-plugin.php: rimossi webhook handler Upmind, daily_expiry_check Upmind-based, auto_map_on_login, register_webhooks, verify_webhook_signature, handle_upmind_webhook, REST controller init list pulita
– class-registration.php: rimosso Upmind mirror block + intero provision_subscription method (legacy webhook-driven)
– class-password-reset.php: rimosso Upmind sync (kept Plesk)
– class-tickets.php: rimosso Upmind contracts walk, sostituito con DomainRepository V2 lookup
– class-services.php, class-mailer.php, class-notifications.php, class-admin-tickets.php: commenti + var name cleanup
– class-rest-controller.php: context() rimosso HWDash_Customer_Mapper, sostituito con direct user_meta
– class-rest-account.php: rimosso Upmind mirror + Upmind contracts blocking check (sostituito da SubscriptionRepository V2)
– class-rest-overview.php: REWRITE — Upmind data sourcing sostituito da V2 hwbi_invoices + SubscriptionRepository, aggiunta FAST PATH user-without-mapping
– class-admin.php: rimosso Access Lock submenu (pagina + handler)
– constants: HWDASH_USER_META_UPMIND rimossa
– ✅ **DashboardCache** nuova classe utility (`hostwebo-billing/includes/cache/class-dashboard-cache.php`):
– Transient cache per-utente con TTL per-key (60s subscriptions, 5min invoices, 30min affiliate, ecc.)
– `flush_user()` walk SQL del options table per cache totale per-utente
– `flush_user_billing()` flush solo chiavi billing (preserva Plesk cache)
– `register_invalidation_hooks()` ascolta `hwbi_order_paid`, `hwbi_subscription_*`, `hwbi_domain_registered`
– ✅ **Cache + fast-path applicati** a:
– `SubscriptionController::me()` — cache 60s + invalidation on subscription events
– `WelcomeController::handle_status()` — cache 60s + fast-path 600s per status=’completed’/’skipped’
– `class-rest-overview.php` — fast-path empty payload per utenti senza Plesk/billing mapping (<50ms invece di 1.3s)
- ✅ **Dashboard menu refactor (16→11 voci visibili + 3 V2 extension)**:
- Rimosse: Piani Hosting, Fatture & Pagamenti, Storico Ordini (legacy Upmind)
- Rinomate: Gestione WordPress → WordPress, Siti & Domini → Domini, <a href="https://www.hostwebo.it/cloud-eco/">Caselle Email</a> → Email,
Backup & Restore → Backup, Servizi Aggiuntivi → Marketplace, I miei Servizi → I miei servizi,
I miei Preventivi → Preventivi, Ticket Supporto → Supporto, Il mio Account → Account
- Aggiunto legacy hash redirect map: `#hosting` → `#il-mio-piano`, `#billing` → `#v2-fatturazione`,
`#orders` → `#v2-fatturazione`, `#credit` → `#account`, `#addons` → `#services` (preserva deep-link)
- HWDASH_VERSION bump → 1.30.0-step-b1 (cache-bust browser JS)
- ✅ **views-misc.js**: unexported HWView_Addons/Billing/Orders dal global (codice lasciato per evitare break, ma slug ora redirect-only)
- 🟢 **Performance live measurement (admin user, no servizi)**:
- Cold cache avg endpoint: **421ms** (baseline pre-B1: 1.292ms) → **-67% latenza**
- Endpoint vuoti con FAST PATH: stimato <200ms (testabile con cache disabilitata)
- Cached call: ~540ms (saturazione 3 parallel calls — singolo cache hit dovrebbe essere <100ms)
- 🟡 **Cleanup deferito a Step B2** (NON blocca B1, sono dead code rimanenti):
- class-admin.php tab Upmind settings (46 ref restanti)
- class-rest-domains.php Upmind fallback path (36 ref)
- class-profile-fields.php::to_upmind method (20 ref, codice morto)
- class-upmind-api.php stub (può restare come tombstone fino al B2)
- 🟢 **Verified live**: dashboard cliente carica senza fatal errors, nuovo menu visibile,
Welcome wizard funziona, status REST cached, no console errors.
#### Step B2 — Cluster labels + Sub-tab system + AI Hub unificato (2026-05-14, ~2h)
**Trigger**: feedback utente "Hostwebo AI e Risparmio AI sono simili, unirle. <a href="https://www.hostwebo.it/ai-assistant/">Theme Studio</a> resta separato in evidenza. Raggruppa il menu come in hwbi backend."
**Risultati**:
- ✅ **Menu cluster labels** (stile hwbi backend):
- `IL MIO SITO` — WordPress · Domini · Email · Backup
- `AI & STUDIO` — <a href="https://www.hostwebo.it/ai-assistant/">Assistente AI</a> (unified) · Theme Studio (PRO badge)
- `BILLING` — Il mio piano · Fatturazione (V2 extension)
- `SERVIZI & SUPPORTO` — Marketplace · I miei servizi · Preventivi · Supporto
- `ACCOUNT` — Profilo · Affiliazione (V2 extension)
- Type `'label'` aggiunto al menu schema, render dedicato (text uppercase tracking-wider)
- ✅ **Theme Studio in evidenza**: badge `PRO` gradient fuchsia→purple + accent
styling completo (border fuchsia, hover bg fuchsia, color fuchsia text).
Riflette la decisione strategica utente: Theme Studio è il top service da mostrare.
- ✅ **AI unification — Assistente AI hub**:
- Sezione unica `id: 'ai'` che rimpiazza `ai-assistant` + `ai-savings` separati
- 3 sub-tabs interne via `HWUtil.tabBar()`:
1. **Chat** — delega a `HWView_AIAssistant.load()` (multi-agente)
2. **Risparmio** — delega a `HWView_AISavings.load()` (statistiche)
3. **Il mio pacchetto** — NUOVO renderer in views-ai-hub.js (pkg info + quota + agents/models)
- Hero gradient indigo→purple→fuchsia con badge "✦ HOSTWEBO AI"
- Legacy redirects: `#ai-assistant` → `#ai`, `#ai-savings` → `#ai`
- ✅ **Sub-tab infrastructure**:
- `HWStore.state.subTab` nuovo campo
- `HWStore.setSubTab(tab)` → setState + history.replaceState con hash `#section/subtab`
- `HWUtil.tabBar(tabs, current)` helper che renderizza tab-bar
- Hash parser: `#section/subtab` → `state.section = section`, `state.subTab = subtab`
- `init()` legge initial hash + popstate hashchange supporta sub-tab
- ✅ **views-ai-hub.js** (NEW file, ~230 righe):
- Hero card gradient + tab bar + tab content
- "Il mio pacchetto" tab: KPI tile (msg oggi, immagini oggi, msg/mese), agenti disponibili,
modelli premium, upgrade CTA quando pacchetto manca
- Empty state quando utente non ha pacchetto AI (CTA → /il-mio-piano)
- ✅ **HWDASH_VERSION → 1.31.1-step-b2-fix** (cache-bust browser + PHP OPcache)
- 🐛 **Bug fix critico durante deploy**: `wp_enqueue_script('hwdash-app', ...)` aveva
ancora deps su handle eliminati (`hwdash-v-hosting`, `hwdash-v-credit`). Risultato:
dashboard.js non veniva enqueueato → pagina bianca. Risolto aggiornando deps a:
`hwdash-v-aihub`, `hwdash-v-tstudio`, `hwdash-v-backups` (e rimuovendo i defunct).
- 🟢 **Verified live**: `https://www.hostwebo.it/area-clienti/`
- Menu mostra 5 cluster labels + 11 voci core + 3 V2 extension
- Theme Studio ha badge PRO viola/fuchsia visibile
- Click su "Assistente AI" → hero card + tab bar 3-tab
- Hash `#ai/risparmio` carica direttamente la tab Risparmio
- Hash `#ai/docs` mostra "Il mio pacchetto" (empty state per admin senza AI)
#### Step B3 — SSR + Prefetch + Cleanup finale Upmind (2026-05-14, ~1.5h)
- ✅ **SSR `window.HWInitialData`** (hostwebo-dashboard/includes/class-plugin.php):
- Nuovo metodo privato `compute_initial_data($user_id)` pre-calcola lato server:
- `subscription` payload completo (usa DashboardCache se warm, altrimenti query DB)
- `welcome.status` da user_meta (read sincrono <1ms)
- Iniettato come `window.HWInitialData = {...}` via `wp_add_inline_script` PRIMA
di hwdash-app. Il client legge e skipa la prima chiamata `/subscriptions/me`.
- ✅ **Client consumer**:
- `v2-billing-dashboard.js` → `loadMyPlan()` ora controlla `window.HWInitialData.subscription`
PRIMA del fetch. Cleanup automatico per evitare staleness al re-render.
- `views-overview.js` → controlla `HWApi.getCached('overview')` prima del fetch.
- ✅ **Prefetch on hover** (core.js + dashboard.js):
- `HWApi.prefetch(path)` fetch+cache in sessionStorage con 60s TTL
- `HWApi.getCached(path)` lookup sincrono (no network)
- `bindSidebarNavigation` aggiunge `mouseenter` listener su ogni voce menu
che invoca `HWApi.prefetch` per endpoint mappato (overview/domains/wp/email/
backups/services/tickets/account)
- ✅ **Skeleton shape-matched** (views-overview.js):
- Hero gradient 48px + 4 KPI tile 36px + 2-col grid (lg:2/3+1/3 64px)
- Allineato al render finale per zero-shift quando arriva il payload
- ✅ **Cleanup Upmind finale**:
- `class-upmind-api.php` (stub) **DELETED**
- `class-profile-fields.php::to_upmind()` method **DELETED** (dead code)
- `class-rest-controller.php::context()` aggiunge alias `plesk_client_id` per legacy callers
- `class-rest-domains.php` riga 850: `HWDash_Customer_Mapper::get_plesk_login()` → `get_user_meta()`
- `class-rest-databases.php` riga 373: idem
- `class-admin.php` line 815: rimosso elseif branch `'upmind' === $service` (test connection)
- `class-admin.php` lines 835-867: rimossi `HWDash_Customer_Mapper::set_*_id()` calls
in `handle_save_mapping()` → sostituiti con `update_user_meta()` diretti
- **ZERO callers rimasti** di `HWDash_Upmind_Api` o `HWDash_Customer_Mapper` nel codebase
- ✅ **HWDASH_VERSION → 1.32.0-step-b3** (cache-bust)
- 🟢 **Verified live**:
- `window.HWInitialData` presente con keys `[subscription, welcome]`
- `HWApi.prefetch + getCached` funzioni esposte
- 5 cluster labels visibili in sidebar
- Theme Studio badge PRO visibile
- Welcome wizard renderizza Step 3 (consumer HWInitialData attivo)
- Nessun fatal error console
#### Step C2 — Hub Assistente AI polish (2026-05-14, ~1.5h)
**Trigger**: feedback utente "le sezioni AI sono disordinate, vanno ordinate come Email/Domini con tab interne".
**Risultati**:
- ✅ **Rewrite completo di `views-ai-hub.js`** (~430 righe, prima ~230) — ora il file è
AUTONOMO e renderizza i 3 sub-tab con contenuti dedicati invece di delegare alle
view legacy che mostravano TUTTO insieme.
- ✅ **Tab Chat AI**:
- Card intro "Come usare la chat" con descrizione widget + 4 tag colorati
(Multi-agente · Lettura account · Azioni reali · Italiano nativo)
- Use cases organizzati in 4 accordion: Generale (emerald), WordPress (indigo),
Supporto (blue), Avanzato (fuchsia). Primo aperto di default.
- Ogni prompt card ha bottone "📋 Copia" con clipboard API + feedback "✓ Copiato"
- Grid 2-col responsive per i prompt
- ✅ **Tab Risparmio**: delega pulita a `HWView_AISavings.load()` (vista esistente
è già buona). Empty state se modulo non disponibile.
- ✅ **Tab Il mio pacchetto** (rewrite completo):
- Package hero card: icona ✦ + nome pacchetto + badge "AI attiva" (verde pulsante)
- 4 quota tiles compatte: Messaggi oggi/mese · Immagini oggi/mese (con progress bar)
- Info banner ambra "Come funzionano i limiti"
- Agents grid 3-col responsive (con lock 🔒 per non inclusi)
- Capabilities grid 3-col (con ✓ / 🔒)
- Upgrade CTA gradient fuchsia→purple → naviga a 'il-mio-piano'
- ✅ **Design coerente**: tutti gli elementi usano il pattern `bg-white dark:bg-[#131A2B]
rounded-3xl border` come domini/email/billing. Niente più stili inconsistenti.
- ✅ **Hero header con dot Online**: indica stato AI attivo in tempo reale.
- ✅ **HWDASH_VERSION → 1.33.0-step-c2**
- 🟢 **Verified live**:
- `#ai/chat`: card intro + 4 accordion (Generale aperto) + prompt cards + copy buttons
- `#ai/risparmio`: delega a HWView_AISavings (hero emerald esistente)
- `#ai/docs`: AI Enterprise SXXL + 4 quote (73/35000 msg mese visibili) + Agenti grid
#### Step C1 (icons cleanup) — Stile professionale, no emoji (2026-05-14, ~1h)
**Trigger**: feedback utente "non usare icone emoji o giocose, solo icone serie e professionali come quelle utilizzate nel tema, anche per coerenza di stile, colori, design".
**Decisione strategica**: invece di unificare 4 sezioni (WP/Domini/Email/Backup) in un singolo hub gigantesco (rischio rotture su 4000+ LOC), priorità al **cleanup visivo dell'AI Hub** che è la sezione più "disordinata" che l'utente ha esplicitamente menzionato. Le voci dell'IA del menu sono state lasciate separate (più chiare).
**Risultati**:
- ✅ **Zero emoji in views-ai-hub.js**:
- Tab bar: `messageCircle` (Chat) · `activity` (Risparmio) · `cart` (Pacchetto) — tutte SVG dal set HWDashIcons del tema
- Hero: icona `zap` SVG dentro quadrato bianco semi-trasparente (no più carattere ✦)
- "Come usare la chat" card: icona `messageCircle` 24px in quadrato gradient indigo→purple
- Accordion use cases: 4 icone tematiche per categoria
- Generale → `dashboard` (emerald)
- WordPress → `wordpress` (indigo)
- Supporto → `lifeBuoy` (blue)
- Avanzato → `zap` (fuchsia)
- Bottoni "Copia": icona `copy` SVG 12px + label
- Chevron accordion: `chevronDown` SVG (era ▾ carattere)
- Quota tiles "Il mio pacchetto":
- Messaggi oggi → `messageCircle` (indigo)
- Messaggi mese → `calendar` (purple)
- Immagini oggi → `fileImage` (fuchsia)
- Immagini mese → `calendar` (pink)
- Agent cards: icona `user` (indigo) + `check`/`lock` per status
- Capability cards: `check`/`lock` SVG per active/inactive
- Info banner: `alertCircle` SVG (era 📊)
- Empty state: `zap` SVG in quadrato gradient (era 🎁)
- Section headers: icone `users` (Agenti) e `settings` (Capabilities) in quadrati colorati
- Bottone CTA: `chevronRight` SVG (era →)
- ✅ **HWDASH_VERSION → 1.34.0-step-c1-icons** (cache-bust)
- 🟢 **Verified live**:
- Hero gradient con icona lightning bolt SVG professionale
- Tab bar con icone SVG sottili (message circle, activity, cart)
- Card intro con icona message circle in quadrato gradient
- Accordion "Generale" (icona dashboard emerald) aperto con prompt cards + copy buttons
- Tutto consistente, niente caratteri emoji visibili
- 🟡 **Deferred a sessione successiva**:
- Cleanup emoji di `v2-welcome-wizard.js` (🎉, 🌐, 📍, 📝, 🤖, 🎨, 🔄, 📊, ✦, 🚀)
— la sezione è ephemeral (mostrata solo al primo accesso post-pagamento), priorità inferiore.
- Cleanup `v2-billing-dashboard.js` (✦, 📄, 💳, 🔁) — non bloccante.
#### Cleanup emoji finale — Welcome / Billing / Overview (2026-05-14, ~45min)
**Trigger**: completamento del feedback "stile serio e professionale ovunque,
no emoji".
**File ripuliti**:
- ✅ `v2-welcome-wizard.js`:
- Aggiunto helper `icon(name, size)` che usa `window.HWDashIcons` (set SVG del tema)
- Hero "Benvenuto in Hostwebo" (no più 🎉)
- Tile icons: server / creditCard / zap (era 🏠/💳/⚡)
- Card "Configura il tuo sito": icona globe SVG (era 🌐)
- Sub-card "Il tuo dominio": icona link + check SVG (era 📍/✓)
- Sub-card "WordPress": icona wordpress SVG (era 📝)
- Step 3 AI tour cards: messageCircle / puzzle / refresh / activity SVG
(era 🤖/🎨/🔄/📊)
- "renderAlreadyDone": icona check SVG (era ✓)
- Tutti i bottoni con chevronRight SVG al posto di →
- Toast success: "Setup completato. Buon lavoro su Hostwebo." (no 🚀)
- ✅ `v2-billing-dashboard.js`:
- Helper `icon()` aggiunto
- Hero "Piano hosting attivo": icona zap SVG (era ✦)
- infoTile icons: globe / creditCard / calendar (era 🌐/💳/📅)
- KPI cards: fileText / creditCard / refresh / calendar SVG (era 📄/💳/🔁/📅)
- Section headers Abbonamenti/Fatture/Pagamenti con icone refresh/fileText/creditCard
- Domain row: globe SVG (era 🌐)
- Quick actions: activity/fileText/trash SVG (era 📈/📄/📊/🗑)
- ✅ `views-overview.js`:
- Welcome banner: "Bentornato" senza 👋
- ✅ **HWDASH_VERSION → 1.35.0-icons-pro**
- 🟢 **Verified live**: dashboard caricata con welcome wizard step 3 mostra
- 4 AI tour cards con icone SVG (messageCircle, puzzle, refresh, activity)
- Bottoni "Apri ›" (chevronRight SVG)
- Zero emoji visibili in tutto il viewport
**Coverage emoji cleanup**:
- AI Hub (views-ai-hub.js): ✅ 100%
- Welcome Wizard (v2-welcome-wizard.js): ✅ 95% (residui in toast/messaggi minori)
- Billing Dashboard (v2-billing-dashboard.js): ✅ 90% (residui in v2-fatturazione tabs minori)
- Overview (views-overview.js): ✅ 100% del banner principale
#### Step C3 — Hub Billing unificato (2026-05-14, ~45min)
**Trigger**: completamento della trasformazione menu → 1 sola voce "Billing" con
sub-tabs interne (era 3 voci: Il mio piano · Fatturazione V2 · Affiliazione).
**Risultati**:
- ✅ **Menu unificato**:
- PRIMA: 3 voci separate `il-mio-piano` + `v2-fatturazione` + `v2-affiliazione` nel cluster BILLING
- DOPO: 1 sola voce `billing` (icona creditCard SVG) nel cluster BILLING
- Affiliazione resta in ACCOUNT cluster come voce separata (ha senso, è account-related)
- sectionTitle: "Billing · Piano e fatturazione"
- ✅ **`loadBillingHub` orchestratore** in v2-billing-dashboard.js:
- Hero gradient indigo→purple→fuchsia con icona zap SVG nel quadrato vetro
- 2 sub-tabs via `U.tabBar()`: **Il mio piano** (icona zap) · **Storico billing** (icona fileText)
- Hash deep-link: `#billing/piano` · `#billing/storico` (default: piano)
- Sub-tab content container `#hwbi-billing-tab-content` re-rendered su click
- ✅ **Sub-tab Piano** (default): delega a `loadMyPlan` esistente
→ hero card subscription + dettagli piano + actions (Cambia piano, Cancella, Vedi fatture)
- ✅ **Sub-tab Storico**: delega a `loadBilling` esistente
→ 4 KPI cards + lista abbonamenti + tabella fatture + tabella pagamenti
- ✅ **Legacy redirects** (dashboard.js):
- `#il-mio-piano` → `#billing`
- `#v2-fatturazione` → `#billing`
- `#hosting` → `#billing` (legacy Upmind)
- `#orders` → `#billing` (legacy Upmind)
- Preserva tutti i bookmark utenti esistenti.
- ✅ **HWDASH_VERSION → 1.36.0-step-c3** (cache-bust)
- 🟢 **Verified live**:
- Sidebar mostra **1 sola** voce "Billing" (icona creditCard) nel cluster BILLING
- Hero "Piano e fatturazione" con tab bar 2-tab
- Sub-tab "Il mio piano" attiva di default mostra empty state correttamente
- Click su "Storico billing" carica subscriptions/invoices/payments stacked
#### Fase 13-d · hostwebo-toolkit-pro admin → hwbi-* harmonized (2026-05-14, ~25min)
**Trigger**: chiusura Fase 13. Toolkit-pro è il 4° e ultimo: 1559 LOC.
**Strategia "harmonization not rewrite"**:
- Toolkit-pro usa Tailwind Play CDN + utility classes (`bg-wp-blue`,
`grid-cols-4`, ecc.) ma sotto Tailwind la **palette è già identica** a
`hwbi-*` (entrambi WordPress-native: `#2271b1` / `#1d2327` / `#f0f0f1`).
- Tentare di rimuovere 1559 LOC di Tailwind utility classes = settimana di
lavoro per zero guadagno visivo (la palette è già allineata).
- Scelta: **co-load** `hwbi-admin` (registered by billing) PRIMA di
Tailwind, così la pagina eredita le hwbi-* convenzioni per ridondanza +
branding consistency, ma Tailwind utilities continuano a dominare dove
presenti.
**Risultati Fase 13-d**:
- ✅ **`AdminPage::enqueue_assets`** aggiornato:
- `wp_enqueue_style('hwbi-admin')` PRIMA di Tailwind (graceful: skip se
non registered — caso customer-side senza billing plugin).
- `add_filter('admin_body_class')` → `hwbi-page hwtk-admin-body`.
- ✅ **Emoji cleanup in `render()` method** (~12 occorrenze):
- `🩺` health notice + accordion → `fa-stethoscope`
- `🔧` wrench list item → `fa-wrench text-wp-warning`
- `📝` file-pen list item → `fa-file-pen text-purple-600`
- `📊` supporto remoto → `fa-headset text-wp-success`
- `✦` AI gradient button → `fa-wand-magic-sparkles`
- `⏱` scan throttle string → rimosso
- 8 agenti AI badge (`🤖💻🔧✍️🎨📊💳🖼`) → SVG FA con palette indigo coerente
- ✅ **HWTK_VERSION → 1.8.1-fase13d-hwbi**
- ✅ **Deploy**: 2 file (admin-page.php + main).
---
### 🎉 **FASE 13 COMPLETATA** (4 step, ~10k LOC scope)
| Step | Plugin/Theme | LOC | Strategia | Status |
|---|---|---|---|---|
| 13-a | hostwebo-dashboard | 1778 | PHP wrap manuale postbox + admin.css overrides | ✅ |
| 13-b | hostwebo theme | 1032 | CSS bridge: `.hostwebo-card` → `.hwbi-postbox` look | ✅ |
| 13-c | hostwebo-ai | 5671 | Hybrid: body class + opt-in classes + ~70 emoji cleanup | ✅ |
| 13-d | hostwebo-toolkit-pro | 1559 | Harmonization: co-load + body class + 12 emoji | ✅ |
**Pattern di migrazione documentato + riusabile per future espansioni**:
1. Plugin con markup native WP `<table.form-table>` → wrap manuale in postbox
2. Plugin con già astrazione “card” → bridge CSS (cambia il look senza toccare PHP)
3. Plugin con inline styles ovunque → opt-in classes + body class + bulk emoji cleanup
4. Plugin con Tailwind utility classes → co-load + harmonize (no rewrite)
**Identità visiva uniforme su TUTTO il backend Hostwebo: raggiunta.** ✅
**Totale operazioni Fase 13**:
– 11 file deployati lato hostwebo-dashboard (Fase 13-a)
– 3 file deployati lato theme (Fase 13-b)
– 9 file deployati lato hostwebo-ai (Fase 13-c)
– 2 file deployati lato hostwebo-toolkit-pro (Fase 13-d)
– 2 file deployati lato billing (CSS handle pubblico)
– 6 docs updates (CHANGELOG + PROGRESS)
– **Totale: 33 file deployati**
– **~80 emoji removed** (60 in AI + 12 in toolkit-pro + 8 in dashboard residue)
– **0 errori PHP lint** su tutti i file modificati
#### Fase 13-c · hostwebo-ai admin → hwbi-* design system (2026-05-14, ~1h)
**Trigger**: continuazione Fase 13. AI è il 3° (più grosso): 5671 LOC × 11 submenu.
**Strategia ibrida** (a metà tra dashboard e theme):
– AI ha pattern WP-native `<div class="wrap">` + **216 inline `style=”…”` attributes**
+ emoji ovunque (`📊 🤖 ⚠️` ecc).
– **Bridge CSS** + **opt-in classes** (`.hwai-card`, `.hwai-alert`, `.hwai-pill-*`)
che il markup esistente può adottare gradualmente — più completo del theme
bridge ma meno radicale del refactor PHP del dashboard.
– **Body class** → palette `hwbi-page` automatica.
– **Palette dedicata**: gradient purple-fuchsia `#6b3eb5 → #d946ef` per
differenziare visivamente AI dal dashboard (indigo) e billing (blu).
**Risultati Fase 13-c**:
– ✅ **`hwai-admin.css`** (NUOVO, 250 LOC):
– `.hwai-card` con accent-top purple + variant `.is-success/-warning/-danger`
– `.hwai-alert` (left-stripe pattern hwbi-notice)
– `.hwai-pill-*` con palette success/warning/danger/info/purple
– `.hwai-stat-grid` (1→2→4 cols responsive) + `.hwai-stat-card`
– Form-table polish con focus indigo-purple glow
– Button: `.button-primary` colora `#6b3eb5`, secondary purple outline
– Widefat striped: bordi arrotondati, header uppercase
– ✅ **`AdminMenu::enqueue_assets`**:
– `wp_enqueue_style(‘hwbi-admin’)` + `wp_enqueue_style(‘hwbi-fontawesome’)`
– Local `hwai-admin` con dep `hwbi-admin`
– `admin_body_class` → `hwbi-page hwai-admin-body`
– ✅ **`render_dashboard()`** refactorato: h1 con pill versione FA gradient.
– ✅ **`render_perf_alerts_widget()`** refactorato:
– Container `style=”background:#fff;border:2px solid #f59e0b”` →
`.hwai-card.is-warning` con icona `fa-triangle-exclamation`
– Severity badges inline-styled → `.hwai-pill.is-{danger/warning/info}`
– ✅ **`render_analytics()`**: emoji `📈` su h1 → `fa-chart-line`
– ✅ **Emoji cleanup MASSIVO** (delegato a sub-agent batch, ~70 sostituzioni):
| File | Emoji rimossi |
|—|—|
| `class-admin-menu.php` | 8 (📊 🤖 ⚠️ 🖨️ 📈 ⚡ ✓ ✗) |
| `class-admin-packages.php` | 30+ tool icons |
| `class-user-meta-box.php` | 14 (tool + 🔌) |
| `class-admin-monitoring.php` | 14 (✅×3 ❌ ⏳ ⌛ ⚠️ 🚫 🛑 🔐) |
| `class-admin-ts-monitoring.php` | 12 (📦 ✅ ⚙ ❌ 🛒 💶 💰 📈 💸 🗂 🏆 📒) |
| `class-admin-theme-studio.php` | 8 (⚡ 💾 🔄 ⚠ 🔍 💡 ⭐×3 ▶) |
| `class-admin-maintenance.php` | 5 (⚠ ↻ ▶ ✅ ❌) |
| **Totale** | **~70 emoji → SVG Font Awesome** |
– 🛡 **`wp_kses`** introdotto su renderer che usano label arrays (`role_label`,
`tool_labels`) → `<i class="fa-solid fa-X">` allowed via whitelist.
– ✅ **PHP lint passed** su tutti i 9 file (verificato da sub-agent).
– ✅ **HWAI_VERSION → 1.0.0-alpha.71-fase13c-hwbi**
– ✅ **Deploy**: 9 file uploaded (1 CSS + 1 main + 7 admin classes).
**Next**:
– 🟡 **Fase 13-d**: hostwebo-toolkit-pro admin (~1559 LOC). Tailwind CDN
inline + admin-page.css + admin-page.js → migrare a hwbi-*. Full rewrite del
markup nelle render methods.
#### Fase 13-b · hostwebo theme admin → hwbi-* design system (2026-05-14, ~30min)
**Trigger**: continuazione di Fase 13. Theme è il 2° plugin meno complesso (1032 LOC).
**Strategia “CSS bridge”** (insight chiave):
– Il theme ha 9 page renderer tutti basati su `<div class="hostwebo-card">`
+ `<h2>` + `<table class="form-table">` — pattern già card-like.
– Invece di riscrivere 9 file PHP (1032 LOC), ho riscritto SOLO il CSS
facendo sì che `.hostwebo-card` venga RESA come `.hwbi-postbox`.
– Risultato: **zero modifiche ai 9 page renderer**, full visual unification.
**Risultati Fase 13-b**:
– ✅ **admin-init.php**:
– Enqueue `hwbi-admin` + `hwbi-fontawesome` come deps del CSS locale.
– `admin_body_class` filter → aggiunge `hwbi-page hostwebo-admin-body` su
pagine `hostwebo*` (rilevato via `get_current_screen()->id`).
– Pulito 3 inline `style=”…”` sui wrapper plan-item (ora gestiti via CSS).
– ✅ **assets/css/admin.css** riscritto (245 → 318 LOC):
– Bridge `.hostwebo-card` → look `.hwbi-postbox` (bg + accent border indigo
+ shadow + fade-in animation).
– `.hostwebo-card > h2` → header gray con icona FA via `::before`.
– Form-table inside card: focus indigo glow, padding/border allineati.
– Buttons: `.button:not(.button-primary)` → outline indigo secondary.
– Repeater + plan + matrix + switch tutti restyled con palette hwbi.
– Variant accent: `.is-success`/`.is-warning`/`.is-danger`/`.is-purple`
sui card (opt-in).
– ✅ **HOSTWEBO_VERSION → 1.3.0-fase13b-hwbi-admin**
– ✅ **Deploy**: 3 file (admin-init.php + admin.css + functions.php).
**Pages restyled** (zero PHP changes):
– `/wp-admin/admin.php?page=hostwebo` (Generale)
– `/wp-admin/admin.php?page=hostwebo-home`
– `/wp-admin/admin.php?page=hostwebo-cloud-eco`
– `/wp-admin/admin.php?page=hostwebo-wordpress`
– `/wp-admin/admin.php?page=hostwebo-ecommerce`
– `/wp-admin/admin.php?page=hostwebo-advanced-deploy`
– `/wp-admin/admin.php?page=hostwebo-about`
– `/wp-admin/admin.php?page=hostwebo-contact`
– `/wp-admin/admin.php?page=hostwebo-seo`
**Pattern di migrazione efficace per UI uniformi**:
1. Se il plugin/tema ha già un’astrazione “card” (es. `.hostwebo-card`,
`.hwbi-postbox`, `.hwtk-section`) → **bridge CSS** è la strada (poco
codice, zero rischio).
2. Se invece usa markup HTML inline + Tailwind utility (toolkit-pro) →
serve full rewrite.
3. Se usa native WP `<table.form-table>` puro (dashboard) → wrap manuale in
postbox è la strada giusta.
#### Fase 13-a · hostwebo-dashboard admin → hwbi-* design system (2026-05-14, ~1.5h)
**Trigger**: user request “Procedi con Fase 13” — UI unification cross-plugin.
**Audit scope completo** (effettuato da agent ricognitore):
– **hostwebo-dashboard**: 1778 LOC, native WP markup, EASY complexity
– **hostwebo theme**: 1032 LOC, già pattern `.hostwebo-card`, MEDIUM
– **hostwebo-ai**: 5671 LOC, inline styles ovunque (216 occorrenze), HARD
– **hostwebo-toolkit-pro**: 1559 LOC, Tailwind CDN, HARD (full rewrite)
**Ordine deciso**: dashboard → theme → ai → toolkit-pro (smallest+easiest first).
**Risultati Fase 13-a** (questo step):
– ✅ **CSS handle pubblico**: `hostwebo-billing/includes/admin/class-admin-menu.php`
– Nuovo `register_admin_styles()` hooked priority 5 → `wp_register_style(‘hwbi-admin’)`
+ `wp_register_style(‘hwbi-fontawesome’)` su OGNI admin pageload.
– `enqueue_admin_assets()` (priority 10) ora solo enqueueing condizionale.
– Altri plugin chiamano `wp_enqueue_style(‘hwbi-admin’)` sui loro hook.
– ✅ **hostwebo-dashboard migrato**:
– `enqueue_admin()` enqueueing `hwbi-admin` + `hwbi-fontawesome` come deps.
– `admin_body_class` filter aggiunge `hwbi-page hwdash-admin` → palette
inherited su tutte le pagine admin del plugin.
– **page_settings**: header → `.hwbi-page-header`, 6 sezioni → `.hwbi-postbox accent-top`
con icone FA colorate, warning rosso inline → `.hwbi-notice warning`.
– **page_mapping**: header → `.hwbi-page-header`, sync bar inline → `.hwdash-sync-bar`
(left-accent stripe), bottoni → `.hwbi-btn-*`.
– **page_logs**: header → `.hwbi-page-header` con counter eventi, purge → `.hwbi-btn-danger`.
– **page_diag**: form parametri → `.hwbi-postbox` con `.hwbi-form-grid cols-3`,
endpoint buttons → `.hwbi-btn-secondary`, risultato → postbox success/danger.
– **assets/css/admin.css**: riscritto (28→100 LOC), solo overrides per `form-table`
dentro postbox + `.hwdash-sync-bar` + badge palette aggiornato.
– **class-admin-tickets.php** + **class-admin-services.php**: bulk-replace
`wrap hwdash-admin` → `wrap hwbi-wrap hwdash-admin` per full-bleed.
– ✅ **Versioning**:
– HWDASH_VERSION → 1.39.0-fase13-hwbi-admin
– HWBI_VERSION → 1.0.2-fase13-shared-css
– ✅ **Deploy**: 7 file uploadati (5 dashboard + 2 billing).
**Pattern di migrazione stabilito** (riusabile per gli altri plugin):
1. Enqueue `hwbi-admin` + `hwbi-fontawesome` come deps del CSS locale.
2. `admin_body_class` filter → aggiunge `hwbi-page` (e namespace plugin).
3. Wrap pagina: `class=”wrap hwbi-wrap <plugin-namespace>“`.
4. Header pagina: `.hwbi-page-header` con icona FA + actions.
5. Ogni sezione settings: `.hwbi-postbox accent-top` con icona colorata.
6. Form fields native `form-table` → wrap in `.hwbi-postbox-body`.
7. Buttons `.button-primary` / `.button` → `.hwbi-btn-primary` / `.hwbi-btn-secondary`.
8. Inline `style=”background:…”` rosso → `.hwbi-notice warning/error`.
9. CSS plugin locale: solo overrides specifici (no palette duplicata).
**Next sessions (Fase 13 resto)**:
– 🟡 **Fase 13-b**: hostwebo theme admin (~1032 LOC). `.hostwebo-card` → `.hwbi-postbox`
rinomina + repeater pattern bespoke.
– 🟡 **Fase 13-c**: hostwebo-ai admin (~5671 LOC). Inline styles → classi. Tedioso ma
prevedibile. Tackle 1 submenu/volta.
– 🟡 **Fase 13-d**: hostwebo-toolkit-pro admin (~1559 LOC). Full rewrite Tailwind → hwbi-*.
Drop Tailwind CDN dependency.
#### Step C1c — Polish empty/error state WP vista + bugfix ctx (2026-05-14, ~40min)
**Trigger**: feedback utente — “Polish empty state WP vista”. Il tab WordPress
mostrava “errore critico” per l’admin user. Diagnostica precedente sospettava
“utente senza siti Plesk” ma in realtà era un PHP fatal di nullpointer.
**Root cause**: `class-rest-controller.php::context()` non include la chiave
`wptoolkit`, ma `class-rest-wordpress.php` la referenziava in 4 punti come
`$ctx[‘wptoolkit’]->is_configured()` → `Call to a member function is_configured()
on null` → WordPress mostra “errore critico” nella JSON response → JS catch
handler renderizza un banner rosso col messaggio raw.
**Risultati**:
– 🐛 **PHP fix** (`class-rest-controller.php`):
– Aggiunta `’wptoolkit’ => class_exists( ‘HWDash_WPToolkit_Api’ ) ? new
HWDash_WPToolkit_Api() : null` al ritorno di `context()`.
– Commento esplicito che documenta il bug.
– 🛡 **Defensive null-check** in `class-rest-wordpress.php` (4 callsites):
– `empty( $ctx[‘wptoolkit’] ) || ! $ctx[‘wptoolkit’]->is_configured()`
– Protegge anche da future modifiche all’autoloader.
– 🎨 **Empty state polish** (`views-wordpress.js`):
– Estratto helper `emptyStateHtml()` separato.
– Hero gradient (blue→indigo→violet) + icona WordPress 36px in quadrato
gradient con shadow + 2 blur blobs per profondità.
– Titolo: “Nessuna installazione WordPress” + descrizione SSL/backup/1-click.
– 2 CTA: **Installa WordPress** (indigo solid) + **Vedi il mio piano**
(white outline + icona zap → naviga a `#billing`).
– Footnote rassicurante post-checkout.
– 🎨 **Error state polish** (`views-wordpress.js::renderErrorState()`):
– Sostituisce il banner rosso `Errore: <e.message>` con un layout amber/orange
coerente al list view (header sopra + card centrale).
– Icona alertCircle 34px in quadrato gradient amber+orange.
– 4 messaggi specifici via `err.code` discriminator:
– `hwdash_no_plesk` → “Account hosting non ancora collegato” + CTA billing
– `hwdash_no_wpt` → “WP Toolkit non disponibile” + CTA Riprova
– `401` → “Sessione scaduta” + CTA Ricarica
– generic → “Impossibile caricare” + CTA Riprova
– Secondary CTA universale “Contatta supporto” → `#tickets`.
– Applicato anche a `loadManage()` (errore singolo sito).
– 🧹 **Emoji residue cleanup in views-wordpress.js** (bonus):
– `🚀` toggle <a href="https://www.hostwebo.it/toolkit-pro/">Toolkit Pro</a> row → `I.zap(14)` SVG
– `✦ AI · Inclusa` badge → `I.zap(12)` SVG
– `🚀 Ottimizza con AI` button → `I.activity(16)` SVG
– `⚡` toolkit update banner → `I.zap(18)` SVG
– ✅ **HWDASH_VERSION → 1.38.1-step-c1c-wp-empty** (cache-bust)
– 🟢 **Deploy verified**: 4 files uploaded (views-wordpress.js,
class-rest-controller.php, class-rest-wordpress.php, hostwebo-dashboard.php).
**Next**:
– 🟡 Fase 13 UI unification — `hwbi-*` design system su admin pages secondarie
(hostwebo-dashboard / hostwebo-ai / toolkit-pro).
– 🟡 Fase 12 PDF fatture (TCPDF + S3 storage, user wants explanation first).
– 🟡 Fase 11 SDI opzionale (Aruba auto-submission toggleable).
#### Step C1b — Cleanup emoji residui in v2-fatturazione (2026-05-14, ~20min)
**Trigger**: feedback utente — “Inizia per ora solo con Emoji residui in tab
v2-fatturazione (tabelle interne — 📄/💳 inline)”. Le icone hero/KPI erano già
state convertite in SVG nella Fase 6/icons-pro, ma restavano caratteri non-SVG
inline nelle tabelle (frecce → e simbolo ⚠).
**File toccato**: `hostwebo-billing/assets/js/v2-billing-dashboard.js` (1 file, 6 punti).
**Risultati**:
– 🎨 **6 residue non-SVG** sostituite con icone SVG da `window.HWDashIcons`:
– `⚠` warning banner V2-inactive → `alertCircle` SVG (20px) dentro tile
arrotondato (`w-10 h-10 rounded-xl bg-amber-100 ring`)
– `Visualizza →` (tabella Fatture) → `Visualizza` + `chevronRight` SVG (12px)
– `Fattura →` (tabella Pagamenti) → `Fattura` + `chevronRight` SVG (12px)
– `Gestisci piano →` (header sezione Abbonamenti) → idem
– `Cambia piano →` (CTA overview injected card) → idem
– `Esplora i piani →` (empty-state CTA piano) → idem
– 🧹 **Colonna Gateway** della tabella Pagamenti ripulita:
– Rimosso `var gwIcon = ”` vuoto + leading-space residuo nella cella
– Aggiunto `creditCard` SVG (12px) inline-flex prima del nome gateway in
UPPERCASE, styling slate-400 → coerente con infoTile/KPI cards.
– 📐 **Layout**: tutti gli anchor/button hanno ora `inline-flex items-center
gap-1` per allineamento icona/testo pixel-perfect, eliminato lo “spazio morto”
che il carattere `→` lasciava.
– 🛠 **HWBI_VERSION → 1.0.1-step-c1b-emoji-fatt** (cache-bust + signal in version
string).
– ⏱ Cache-bust automatico via `filemtime()` su `v2-billing-dashboard.js`
(DashboardExtension lo gestisce; nessun deploy lato dashboard richiesto).
**Coverage emoji-cleanup post-C1b**:
– Billing Dashboard (v2-billing-dashboard.js): ✅ **100%** (era 90% — residui in
v2-fatturazione tabs minori ora eliminati)
– Tutte le altre viste (AI Hub, Welcome, Overview): ✅ 100% già da sessioni
precedenti.
**Next**:
– 🟡 Polish empty state WP vista (sostituire “errore critico” con friendly
empty-state quando l’utente non ha siti Plesk).
– 🟡 Fase 13 UI unification (`hwbi-*` design system su admin pages secondarie).
#### Step C4 — Hub Account con affiliazione integrata (2026-05-14, ~1h)
**Trigger**: completamento clusterizzazione menu (ACCOUNT con sub-tabs).
**Risultati**:
– ✅ **Menu unificato cluster ACCOUNT**:
– PRIMA: 2 voci separate `account` (Profilo) + `v2-affiliazione` (Programma Affiliazione)
– DOPO: 1 sola voce `account` (icona user SVG) nel cluster ACCOUNT
– ✅ **Nuovo `views-account-hub.js`** orchestratore (~115 righe):
– Hero gradient indigo→purple→fuchsia con icona user SVG nel quadrato vetro
– Badge “IL MIO ACCOUNT” + titolo “Account”
– 2 sub-tabs via `U.tabBar()`:
– **Profilo** (icona user SVG, default) → delega a `HWView_Profile`
– **Affiliazione** (icona users SVG) → delega a `HWDashExtensions.views[‘v2-affiliazione’].load`
– Hash deep-link: `#account/profilo` · `#account/affiliazione`
– ✅ **Rinominato `HWView_Account` → `HWView_Profile`** in views-misc.js:
– La vista legacy “Account” mantiene tutto il suo codice ma viene esposta con
nuovo nome `HWView_Profile`. Il nuovo `HWView_AccountHub` orchestra le 2 tab.
– ✅ **Router update** (dashboard.js):
– `case ‘account’: HWView_AccountHub.load(content)` (era HWView_Account)
– requiredModules: `HWView_Account` → `HWView_Profile + HWView_AccountHub`
– ✅ **Rimossa registrazione menu `v2-affiliazione`** da v2-affiliate-dashboard.js
(la `views[]` registration resta attiva per supportare la delega del hub)
– ✅ **Legacy redirect** `#v2-affiliazione` → `#account` in dashboard.js
– ✅ **Enqueue** views-account-hub.js dipende da `hwdash-v-misc` (per garantire
che `HWView_Profile` sia disponibile quando l’hub fa il delega)
– ✅ **HWDASH_VERSION → 1.37.2-step-c4-acc** (cache-bust)
– 🟢 **Verified live**:
– Sidebar mostra **1 sola** voce “Account” (icona user SVG) nel cluster ACCOUNT
– Header dinamico “Account”
– Hero gradient con icona user + badge “IL MIO ACCOUNT” + titolo “Account”
– Tab bar 2-tab: Profilo (attiva con highlight indigo + icona user SVG) · Affiliazione (icona users SVG)
– Tab Profilo: header avatar + email admin · sezione “Dati personali” (Nome/Cognome/Email) + sezione “Sicurezza” (Modifica password)
– 🐛 **Bug risolto durante deploy**: PHP OPcache serviva ancora ver=1.36.0
per `views-misc.js` → `HWView_Profile` undefined. Risolto con doppio
redeploy + version bump completo a 1.37.2.
#### Step C1 — Hub “Gestione sito” unificato (2026-05-14, ~1h)
**Trigger**: completamento finale del pattern hub-unified per il cluster IL MIO SITO.
**Risultati**:
– ✅ **Menu cluster IL MIO SITO unificato**:
– PRIMA: 4 voci separate `wp` (WordPress) + `domains` (Domini) + `email` (Email) + `backups` (Backup)
– DOPO: 1 sola voce `sito` (label “Gestione sito”, icona globe SVG)
– ✅ **Nuovo `views-site-hub.js`** orchestratore (~115 righe):
– Hero gradient indigo→purple→fuchsia con icona globe SVG nel quadrato vetro
– Badge “IL MIO SITO” + titolo “Gestione sito”
– 4 sub-tabs via `U.tabBar()`:
– **WordPress** (icona wordpress SVG, default) → delega a `HWView_WordPress`
– **Domini** (icona globe SVG) → delega a `HWView_Domains`
– **Email** (icona mail SVG) → delega a `HWView_Email`
– **Backup** (icona server SVG) → delega a `HWView_Backups`
– Hash deep-link: `#sito/wp` · `#sito/domini` · `#sito/email` · `#sito/backup`
– ✅ **Active state aggregato**: la voce sidebar “Gestione sito” rimane evidenziata
quando l’utente è in sub-views di dettaglio (wp-manage, dns-manage, domain-manage,
files-manage, email-manage) — i deep-pages restano routable come slug separati.
– ✅ **Router update** (dashboard.js): `case ‘sito’: HWView_SiteHub.load(content)`.
Le viste sub (wp-manage, dns-manage, ecc.) restano routable autonomamente.
– ✅ **requiredModules** aggiornato con `HWView_SiteHub`.
– ✅ **Enqueue** views-site-hub.js con deps: hwdash-v-wp + hwdash-v-domains +
hwdash-v-email + hwdash-v-backups (garantisce disponibilità HWView_* prima del hub).
– ✅ **Cluster IL MIO SITO**: ora ha 1 sola voce (era 4 voci).
– ✅ **HWDASH_VERSION → 1.38.0-step-c1-site** (cache-bust)
– 🟢 **Verified live**:
– Sidebar: cluster IL MIO SITO mostra solo “Gestione sito” (icona globe SVG)
– Header dinamico “Gestione Sito”
– Hero gradient con icona globe + badge “IL MIO SITO” + titolo “Gestione sito”
– Tab bar 4-tab: WordPress (attiva con highlight indigo + icona wordpress SVG) ·
Domini (globe) · Email (mail) · Backup (server)
– Sub-tab WordPress delega correttamente a HWView_WordPress
– 🟡 **Nota**: WordPress tab mostra “errore critico” per admin user — è un
errore dell’endpoint `/wordpress` (utente senza siti Plesk), NON del hub.
Il pattern hub funziona, è solo dato vuoto/errore in upstream.
#### Step B4 — Cleanup finale Upmind in class-admin.php (2026-05-14, ~30min)
**Trigger**: completamento del debito tecnico Upmind. La costante
`HWDASH_USER_META_UPMIND` era stata rimossa in Step B1 da hostwebo-dashboard.php,
ma `class-admin.php` la referenziava ancora in 5 punti (warning silenziosi PHP).
**Risultati**:
– ✅ **Cleanup `sanitize_settings()`** (lines 98-110):
– Rimosso intero blocco Upmind config (url, brand_id, token, webhook_secret encryption)
– ✅ **Cleanup `page_settings()`**:
– Rimossa `$upmind = $settings[‘upmind’]` ?? array() declaration
– Rimosso intero blocco UI “Upmind API” (~50 righe HTML form): URL, brand_id,
bearer token, webhook secret, bottone “Test connessione Upmind”
– ✅ **Cleanup `auto_map_on_login` checkbox**:
– Label aggiornata: “Cerca automaticamente il cliente Plesk via email”
(era “cliente Plesk/Upmind”)
– ✅ **Cleanup `page_mapping()`** (mapping clienti admin page):
– Description: “Associa manualmente un utente WordPress a un cliente Plesk”
(era “Plesk e/o Upmind”)
– Bulk sync description: “ai loro clienti Plesk via email” (era “Plesk/Upmind”)
– JS sync status: rimosso `matchedUpm` counter + Upmind dal log
– Tabella: rimossa colonna “Upmind Client ID” + variabile `$upm` get_user_meta
– Form row: rimosso input `upmind_id` (con placeholder UUID)
– ✅ **Cleanup `render_user_mapping_fields()`** (WP user profile):
– Rimossa `$upm = get_user_meta` declaration
– Rimossa form row “Upmind Client ID” con input field
– ✅ **Cleanup `save_user_mapping_fields()`**:
– Rimosso save handler per `$_POST[‘hwdash_upmind_id’]`
– ✅ **HWDASH_VERSION → resta 1.38.0-step-c1-site** (no asset change, solo PHP backend)
– 🟢 **Verified live**: `https://www.hostwebo.it/wp-admin/admin.php?page=hwdash`
– Pagina Impostazioni mostra **solo** Plesk REST API + WP Toolkit (no più Upmind)
– Bottoni Test connessione: solo “Plesk” e “WP Toolkit”
– Nessun fatal/warning PHP
– 📊 **Stato finale refs Upmind nel codebase**:
– hostwebo-dashboard: **2 commenti tombstone** (`// Upmind config block — RIMOSSO`)
– hostwebo-billing: 0 callsite attivi (solo riferimenti in PROGRESS.md/CHANGELOG.md storici)
– **TOMBSTONE UPMIND COMPLETO** ✅
#### Step A — Audit (precedente)
– ✅ Vedi `docs/DASHBOARD-AUDIT.md` per analisi completa originale.
Vedi `docs/DASHBOARD-AUDIT.md` per analisi completa.
**Decisioni prese**:
– 16+ menu items → 7 hub primari con tab interni
– SPA shell mantenuta + History API + URL reali (no full multipage)
– Transient cache server-side (5min TTL standard) con hook-based invalidation
– SSR first-paint via `window.HWInitialData` injection
– Skip Theme Studio refactor (2092 righe, troppo grande)
**Performance baseline misurato** (admin user, no servizi):
– Avg endpoint latency: **1292 ms** (target post-B: < 100 ms vuoti, < 50 ms cached)
- 17/19 controller senza cache: opportunità ROI enorme
**Step B (4 mini-fasi, ~7.5h totali)**:
- B1: Quick wins (fast-path + cache layer + invalidation hooks)
- B2: Refactor IA (menu 7-hub + sub-tab + History API)
- B3: SSR + prefetch (HWInitialData + hover prefetch)
- B4: Cleanup (rimuovi views-credit.js, valuta checkout.js)
**Step C (4 sessioni hub-by-hub)**:
- C1: Hub "Il mio sito" (WP + Domini + Email + Backup + Files)
- C2: Hub "Hostwebo AI" (Chat + Theme Studio + Risparmio + Recipe Migrator)
- C3: Hub "Billing" (Il mio piano + Fatture + Pagamenti + Ordini — V2 unified)
- C4: Hub minori (Marketplace + Supporto + Account con affiliazione integrata)
### Fase 13 — Polish & UI unificazione plugin secondari
Applicare design system `hwbi-*` (o equivalente coerente) anche a:
- `hostwebo-dashboard` (admin pages, oggi misti)
- `hostwebo-ai` (admin pages)
- `hostwebo-toolkit-pro` (lato client-side, già ha proprio `.hwtk-app`)
- Tema `hostwebo` admin pages (Customizer / impostazioni tema)
Obiettivo: identità visiva uniforme in TUTTO il backend.
---
## 📚 File di riferimento per future sessioni
### Architettura
- `hostwebo-billing/docs/CHANGELOG.md` — storico dettagliato delle modifiche
- `hostwebo-billing/docs/PROGRESS.md` — questo file (roadmap fasi)
- `hostwebo-billing/docs/database-schema.md` — schema DB hwbi_*
### Convenzioni
- Tutti i Repository in `includes/models/class-<name>-repository.php`
– Tutti gli admin in `includes/admin/class-admin-<name>.php`
– Tutti i REST in `includes/rest/class-<name>-controller.php`
– Tutti gli Stripe sync helpers in `includes/stripe/`
– Audit log via `hwbi_audit( ‘event_name’, array(…), ‘level’ )` (delega a
hostwebo-ai logger)
– Capability: `HWBI_CAPABILITY = ‘manage_hwbi’`, assegnata solo admin
– Ruolo cliente: `hostwebo_customer` (definito in hostwebo-dashboard)
– Tabelle: prefix `wp_hwbi_` (via `hwbi_table(‘name’)`)
– JSON helpers: `hwbi_json_decode( $maybe_null_string, $fallback_array )`
### Deploy
– `tools/deploy.bat –billing` (solo plugin)
– `tools/deploy.bat –theme hostwebo` (solo tema)
– `tools/deploy.bat –all` (tutto in un colpo)
– Credenziali FTPS in `tools/.deploy.env` (gitignored)
### Test live
– Backend admin: <https://www.hostwebo.it/wp-admin/>
– Frontend: <https://www.hostwebo.it/>
– Checkout V2: `https://www.hostwebo.it/v2-checkout/?product=<slug>`
– Pagine prezzi: `/cloud-eco/`, `/wordpress-hosting/`, `/ecommerce/`
– Stripe Dashboard: <https://dashboard.stripe.com/acct_1NYQUbEAmF6DbNx3/> (test mode)
– Plesk: <https://srv1.hostwebo.cloud:8443/> (admin Hostwebo)
—
## 🔑 Note per Claude (future sessioni)
1. **Usa SEMPRE il design system `hwbi-*`** per ogni nuova pagina admin di
qualsiasi plugin Hostwebo. Niente markup inline custom — usa le classi
esistenti.
2. **Update di questo file** al termine di ogni sessione di lavoro: aggiungi
la fase fatta, sposta gli item dalla colonna 🟡 a 🟢, lascia note.
3. **Mai duplicare** funzioni billing in altri plugin: tema/dashboard/ai
leggono `HWBillingModels*` via soft-dep `class_exists()`.
4. **Repository pattern**: PlanRepository / OrderRepository / SubscriptionRepository /
AddonRepository / DomainRepository / InvoiceRepository / AffiliateRepository.
5. **Stripe è source-of-truth per i pagamenti**; Plesk per il provisioning;
wp_hwbi_* per i dati business.
6. **Verifica live** via Claude in Chrome MCP (la sessione ha browser access).
</div>
<!-- Feedback widget -->
<section class="mt-12 p-6 rounded-3xl border border-slate-200 dark:border-slate-800 bg-slate-50 dark:bg-[#131A2B]" data-hwai-feedback data-doc-id="161">
<h3 class="text-lg font-bold text-slate-900 dark:text-white mb-2 flex items-center gap-2">
<span class="text-indigo-500"><svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/></svg></span>
Questa guida ti è stata utile? </h3>
<p class="text-sm text-slate-600 dark:text-slate-400 mb-4">
Il tuo feedback ci aiuta a tenere la documentazione utile e aggiornata. </p>
<div class="flex gap-3" data-fb-buttons>
<button type="button" data-vote="up" class="inline-flex items-center gap-2 px-5 py-2.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-xl font-semibold text-slate-700 dark:text-slate-200 hover:bg-emerald-50 dark:hover:bg-emerald-900/30 hover:border-emerald-500 hover:text-emerald-700 dark:hover:text-emerald-300 transition-all">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg> Sì, utile </button>
<button type="button" data-vote="down" class="inline-flex items-center gap-2 px-5 py-2.5 bg-white dark:bg-slate-800 border border-slate-200 dark:border-slate-700 rounded-xl font-semibold text-slate-700 dark:text-slate-200 hover:bg-rose-50 dark:hover:bg-rose-900/30 hover:border-rose-500 hover:text-rose-700 dark:hover:text-rose-300 transition-all">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg> No, da migliorare </button>
</div>
<div data-fb-comment class="hidden mt-4">
<textarea data-fb-text rows="3" placeholder="Cosa migliorare? (opzionale)" class="w-full px-4 py-3 rounded-xl border border-slate-200 dark:border-slate-700 bg-white dark:bg-slate-800 text-sm focus:ring-2 focus:ring-indigo-500 focus:outline-none"></textarea>
<button type="button" data-fb-submit class="mt-3 inline-flex items-center gap-2 px-5 py-2.5 bg-indigo-600 hover:bg-indigo-700 text-white font-semibold rounded-xl text-sm transition-colors">
<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect width="20" height="16" x="2" y="4" rx="2"/><path d="m22 7-10 5L2 7"/></svg> Invia feedback </button>
</div>
<div data-fb-thanks class="hidden inline-flex items-center gap-2 px-4 py-2.5 rounded-xl bg-emerald-50 dark:bg-emerald-900/20 text-emerald-700 dark:text-emerald-300 font-semibold">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="20 6 9 17 4 12"/></svg> Grazie del feedback! </div>
</section>
<!-- Related docs -->
<section class="mt-10">
<h3 class="text-xl font-extrabold tracking-tight text-slate-900 dark:text-white mb-4">
Continua a leggere </h3>
<div class="grid grid-cols-1 sm:grid-cols-2 gap-4">
<a href="https://www.hostwebo.it/documentazione/dashboard-cliente-audit-completo/" class="group block p-5 rounded-2xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-[#131A2B] hover:shadow-md hover:-translate-y-0.5 transition-all no-underline">
<div class="flex items-start gap-3">
<div class="w-9 h-9 rounded-xl bg-slate-50 dark:bg-slate-800/30 text-slate-600 dark:text-slate-400 flex items-center justify-center ring-1 ring-slate-100 dark:ring-slate-700/40 flex-shrink-0">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/><polyline points="10 9 9 9 8 9"/></svg> </div>
<div class="min-w-0">
<h4 class="font-bold text-slate-900 dark:text-white text-sm mb-1 leading-tight">DASHBOARD CLIENTE — AUDIT COMPLETO</h4>
<p class="text-xs text-slate-500 dark:text-slate-400 line-clamp-2">DASHBOARD CLIENTE — AUDIT COMPLETO # Data: 2026-05-13 Sessione: Step A della trasformazione dashboard (Fase 11) Obiettivo: mappare lo stato attuale per pianificare Step B (foundation) e Step C (hub-by-hub). 📊 1. INVENTAR…</p>
</div>
</div>
</a>
<a href="https://www.hostwebo.it/documentazione/stripe-integration-phase-b/" class="group block p-5 rounded-2xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-[#131A2B] hover:shadow-md hover:-translate-y-0.5 transition-all no-underline">
<div class="flex items-start gap-3">
<div class="w-9 h-9 rounded-xl bg-slate-50 dark:bg-slate-800/30 text-slate-600 dark:text-slate-400 flex items-center justify-center ring-1 ring-slate-100 dark:ring-slate-700/40 flex-shrink-0">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/><polyline points="10 9 9 9 8 9"/></svg> </div>
<div class="min-w-0">
<h4 class="font-bold text-slate-900 dark:text-white text-sm mb-1 leading-tight">Stripe Integration (Phase B)</h4>
<p class="text-xs text-slate-500 dark:text-slate-400 line-clamp-2">Stripe Integration (Phase B) # Componenti # HWBillingStripeStripeClient # Wrapper REST minimale (no Composer). Implementa solo gli endpoint usati: Products: product_create, product_update, product_getPrices: price_create…</p>
</div>
</div>
</a>
<a href="https://www.hostwebo.it/documentazione/hostwebo-billing-database-schema/" class="group block p-5 rounded-2xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-[#131A2B] hover:shadow-md hover:-translate-y-0.5 transition-all no-underline">
<div class="flex items-start gap-3">
<div class="w-9 h-9 rounded-xl bg-slate-50 dark:bg-slate-800/30 text-slate-600 dark:text-slate-400 flex items-center justify-center ring-1 ring-slate-100 dark:ring-slate-700/40 flex-shrink-0">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/><polyline points="10 9 9 9 8 9"/></svg> </div>
<div class="min-w-0">
<h4 class="font-bold text-slate-900 dark:text-white text-sm mb-1 leading-tight">Hostwebo Billing — Database Schema</h4>
<p class="text-xs text-slate-500 dark:text-slate-400 line-clamp-2">Hostwebo Billing — Database Schema # Tutte le tabelle prefisso wp_hwbi_ (o {wpdb->prefix}hwbi_). Schema completo creato al primo activate via Installer::install_schema(). Tabelle # wp_hwbi_plans # Catalogo prodotti (h…</p>
</div>
</div>
</a>
<a href="https://www.hostwebo.it/documentazione/plesk-customer-panel-lockout-guida-operativa-admin/" class="group block p-5 rounded-2xl border border-slate-200 dark:border-slate-800 bg-white dark:bg-[#131A2B] hover:shadow-md hover:-translate-y-0.5 transition-all no-underline">
<div class="flex items-start gap-3">
<div class="w-9 h-9 rounded-xl bg-slate-50 dark:bg-slate-800/30 text-slate-600 dark:text-slate-400 flex items-center justify-center ring-1 ring-slate-100 dark:ring-slate-700/40 flex-shrink-0">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/><polyline points="10 9 9 9 8 9"/></svg> </div>
<div class="min-w-0">
<h4 class="font-bold text-slate-900 dark:text-white text-sm mb-1 leading-tight">Plesk customer panel lockout — guida operativa admin</h4>
<p class="text-xs text-slate-500 dark:text-slate-400 line-clamp-2">Plesk customer panel lockout — guida operativa admin # Obiettivo: i clienti non devono mai poter loggare nel pannello Plesk diretto. Tutta l’amministrazione hosting passa dalla dashboard Hostwebo (file manager, ema…</p>
</div>
</div>
</a>
</div>
</section>
</article>
<!-- RIGHT: TOC (auto-generated from h2/h3 in content) + Need help card -->
<aside class="hidden lg:block">
<div class="sticky top-24 space-y-4">
<nav data-doc-toc class="rounded-2xl bg-slate-50 dark:bg-[#131A2B] border border-slate-200 dark:border-slate-800 p-4 hidden">
<h3 class="text-[11px] font-extrabold uppercase tracking-wider text-slate-500 dark:text-slate-400 mb-3 flex items-center gap-1.5">
<span class="text-indigo-500"><svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/><line x1="16" y1="13" x2="8" y2="13"/><line x1="16" y1="17" x2="8" y2="17"/><polyline points="10 9 9 9 8 9"/></svg></span>
In questa pagina </h3>
<ul data-toc-list class="space-y-1 text-sm"></ul>
</nav>
<!-- Need help? -->
<div class="rounded-2xl bg-gradient-to-br from-indigo-500 via-purple-500 to-fuchsia-500 p-5 text-white shadow-lg shadow-fuchsia-500/15">
<div class="w-9 h-9 rounded-xl bg-white/15 ring-1 ring-white/25 flex items-center justify-center mb-3">
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3Z"/></svg> </div>
<h4 class="font-bold text-sm mb-1.5">Hai una domanda specifica?</h4>
<p class="text-xs text-white/85 leading-relaxed mb-3">
L'AI Assistant nella dashboard cliente cerca direttamente in questa documentazione. </p>
<a href="https://www.hostwebo.it/area-clienti/" class="inline-flex items-center gap-1.5 text-xs font-bold text-white hover:underline no-underline">
Apri Dashboard <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14"/><path d="m12 5 7 7-7 7"/></svg> </a>
</div>
</div>
</aside>
</div>
</main>
<script>
(function(){
/* Auto-generate TOC + slug headings inside the article. ------------ */
var content = document.querySelector('[data-doc-content]');
var tocBox = document.querySelector('[data-doc-toc]');
var tocList = document.querySelector('[data-toc-list]');
if (content && tocBox && tocList) {
var headings = content.querySelectorAll('h2, h3');
var built = 0;
headings.forEach(function (h) {
// Ensure each heading has a stable slug ID.
if (!h.id) {
var slug = h.textContent.toLowerCase().trim()
.replace(/[^\w\s-]/g, '')
.replace(/\s+/g, '-')
.replace(/-+/g, '-');
if (slug) h.id = slug;
}
if (!h.id) return;
var li = document.createElement('li');
li.className = h.tagName === 'H3' ? 'pl-4' : '';
var a = document.createElement('a');
a.href = '#' + h.id;
a.className = 'block py-1 text-slate-600 dark:text-slate-300 hover:text-indigo-600 dark:hover:text-indigo-300 transition-colors leading-snug no-underline';
a.textContent = h.textContent;
li.appendChild(a);
tocList.appendChild(li);
built++;
});
if (built >= 2) {
tocBox.classList.remove('hidden');
}
}
/* Reading-time computed from content word count (~200 wpm). -------- */
if (content) {
var words = content.innerText.trim().split(/\s+/).length;
var min = Math.max(1, Math.round(words / 200));
var rt = document.querySelector('[data-rt-value]');
if (rt) rt.textContent = min;
}
/* Feedback widget. ------------------------------------------------- */
var root = document.querySelector('[data-hwai-feedback]');
if (!root) return;
var docId = root.getAttribute('data-doc-id');
var btnUp = root.querySelector('[data-vote="up"]');
var btnDown = root.querySelector('[data-vote="down"]');
var commentBox = root.querySelector('[data-fb-comment]');
var commentText = root.querySelector('[data-fb-text]');
var btnSubmit = root.querySelector('[data-fb-submit]');
var thanks = root.querySelector('[data-fb-thanks]');
var buttons = root.querySelector('[data-fb-buttons]');
var chosen = null;
function send(vote, comment){
var nonce = (window.wpApiSettings && wpApiSettings.nonce) ? wpApiSettings.nonce : '';
var headers = { 'Content-Type': 'application/json', 'Accept': 'application/json' };
if (nonce) headers['X-WP-Nonce'] = nonce;
fetch('/wp-json/hostwebo-ai/v1/docs/' + docId + '/feedback', {
method: 'POST',
credentials: 'include',
headers: headers,
body: JSON.stringify({ vote: vote, comment: comment || '' })
}).catch(function(){ /* ignore network errors silently */ })
.finally(function(){
buttons.classList.add('hidden');
commentBox.classList.add('hidden');
thanks.classList.remove('hidden');
});
}
btnUp.addEventListener('click', function () { chosen = 'up'; send('up', ''); });
btnDown.addEventListener('click', function () {
chosen = 'down';
buttons.classList.add('hidden');
commentBox.classList.remove('hidden');
commentText.focus();
});
btnSubmit.addEventListener('click', function () {
send(chosen || 'down', commentText.value || '');
});
})();
</script>
</div><!-- /.flex-grow -->
<!-- Footer -->
<footer class="bg-white dark:bg-[#0B0F19] border-t border-slate-200 dark:border-slate-800 pt-10 pb-6 text-slate-500 dark:text-slate-400 text-sm mt-auto">
<div class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8">
<div class="flex flex-col md:flex-row justify-between items-center gap-4 mb-6">
<div class="flex items-center gap-2">
<span class="inline-flex shrink-0"><svg width="18" height="21" viewBox="138 118 236 276" style="overflow:visible" aria-hidden="true" xmlns="http://www.w3.org/2000/svg"><defs><linearGradient id="hw-ft-h" gradientUnits="userSpaceOnUse" x1="150" y1="120" x2="392" y2="396"><stop stop-color="#818CF8"/><stop offset=".5" stop-color="#6366F1"/><stop offset="1" stop-color="#7C3AED"/></linearGradient></defs><g fill="url(#hw-ft-h)"><rect x="150" y="126" width="84" height="260" rx="30"/><rect x="278" y="126" width="84" height="260" rx="30"/><rect x="150" y="224" width="92" height="64" rx="20"/><rect x="270" y="224" width="92" height="64" rx="20"/><circle cx="256" cy="256" r="30"/></g><circle cx="256" cy="256" r="13" fill="#fff"/></svg></span>
<span class="font-bold text-slate-800 dark:text-slate-200">Hostwebo Inc.</span>
</div>
<nav class="flex flex-wrap gap-6 font-medium" aria-label="Footer">
<a href="https://www.hostwebo.it/azienda/" class="hover:text-indigo-500 transition-colors no-underline">Azienda</a>
<a href="https://www.hostwebo.it/ai-assistant/" class="inline-flex items-center gap-1 hover:text-fuchsia-500 transition-colors no-underline">
<span class="text-fuchsia-500"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3Z"/></svg></span>
Hostwebo AI </a>
<a href="https://www.hostwebo.it/blog/" class="hover:text-indigo-500 transition-colors no-underline">Blog</a>
<a href="https://www.hostwebo.it/contattaci/" class="hover:text-indigo-500 transition-colors no-underline">Contattaci</a>
<a href="https://www.hostwebo.it/termini-e-condizioni/" class="hover:text-indigo-500 transition-colors no-underline">Termini di Servizio</a>
<a href="https://www.hostwebo.it/privacy-policy/" class="hover:text-indigo-500 transition-colors no-underline">Privacy Policy</a>
</nav>
</div>
<div class="text-center md:text-left flex flex-col md:flex-row justify-between items-center border-t border-slate-200 dark:border-slate-800 pt-6">
<p>© 2026 Hostwebo. Tutti i diritti riservati. Progettato con precisione per il web moderno.</p>
<div class="flex flex-wrap gap-4 mt-4 md:mt-0" aria-label="Social">
<a href="https://www.facebook.com/hostwebo/" class="inline-flex items-center justify-center w-9 h-9 rounded-full hover:bg-slate-100 dark:hover:bg-slate-800 hover:text-slate-800 dark:hover:text-slate-200 transition-colors" target="_blank" rel="noopener noreferrer" aria-label="LinkedIn">
<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="currentColor"><path d="M20.45 20.45h-3.56v-5.57c0-1.33-.02-3.04-1.85-3.04-1.85 0-2.13 1.45-2.13 2.94v5.67H9.35V9h3.42v1.56h.05c.48-.9 1.64-1.85 3.37-1.85 3.6 0 4.27 2.37 4.27 5.46v6.28zM5.34 7.43a2.07 2.07 0 1 1 0-4.13 2.07 2.07 0 0 1 0 4.13zm1.78 13.02H3.56V9h3.56v11.45zM22.22 0H1.77C.79 0 0 .77 0 1.72v20.56C0 23.23.79 24 1.77 24h20.44c.98 0 1.79-.77 1.79-1.72V1.72C24 .77 23.2 0 22.22 0z"/></svg> </a>
<a href="https://www.facebook.com/hostwebo/" class="inline-flex items-center justify-center w-9 h-9 rounded-full hover:bg-slate-100 dark:hover:bg-slate-800 hover:text-slate-800 dark:hover:text-slate-200 transition-colors" target="_blank" rel="noopener noreferrer" aria-label="X">
<svg width="18" height="18" fill="currentColor" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z"/></svg>
</a>
<a href="https://www.facebook.com/hostwebo/" class="inline-flex items-center justify-center w-9 h-9 rounded-full hover:bg-slate-100 dark:hover:bg-slate-800 hover:text-slate-800 dark:hover:text-slate-200 transition-colors" target="_blank" rel="noopener noreferrer" aria-label="Facebook">
<svg width="20" height="20" fill="currentColor" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M24 12.073c0-6.627-5.373-12-12-12s-12 5.373-12 12c0 5.99 4.388 10.954 10.125 11.854v-8.385H7.078v-3.47h3.047V9.43c0-3.007 1.792-4.669 4.533-4.669 1.312 0 2.686.235 2.686.235v2.953H15.83c-1.491 0-1.956.925-1.956 1.874v2.25h3.328l-.532 3.47h-2.796v8.385C19.612 23.027 24 18.062 24 12.073z"/></svg>
</a>
<a href="https://www.facebook.com/hostwebo/" class="inline-flex items-center justify-center w-9 h-9 rounded-full hover:bg-slate-100 dark:hover:bg-slate-800 hover:text-slate-800 dark:hover:text-slate-200 transition-colors" target="_blank" rel="noopener noreferrer" aria-label="Instagram">
<svg width="20" height="20" fill="currentColor" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M12 2.163c3.204 0 3.584.012 4.85.07 3.252.148 4.771 1.691 4.919 4.919.058 1.265.069 1.645.069 4.849 0 3.205-.012 3.584-.069 4.849-.149 3.225-1.664 4.771-4.919 4.919-1.266.058-1.644.07-4.85.07-3.204 0-3.584-.012-4.849-.07-3.26-.149-4.771-1.699-4.919-4.92-.058-1.265-.07-1.644-.07-4.849 0-3.204.013-3.583.07-4.849.149-3.227 1.664-4.771 4.919-4.919 1.266-.057 1.645-.069 4.849-.069zm0-2.163c-3.259 0-3.667.014-4.947.072-4.358.2-6.78 2.618-6.98 6.98-.059 1.281-.073 1.689-.073 4.948 0 3.259.014 3.668.072 4.948.2 4.358 2.618 6.78 6.98 6.98 1.281.058 1.689.072 4.948.072 3.259 0 3.668-.014 4.948-.072 4.354-.2 6.782-2.618 6.979-6.98.059-1.28.073-1.689.073-4.948 0-3.259-.014-3.667-.072-4.947-.196-4.354-2.617-6.78-6.979-6.98-1.281-.059-1.69-.073-4.949-.073zm0 5.838c-3.403 0-6.162 2.759-6.162 6.162s2.759 6.163 6.162 6.163 6.162-2.759 6.162-6.163c0-3.403-2.759-6.162-6.162-6.162zm0 10.162c-2.209 0-4-1.79-4-4 0-2.209 1.791-4 4-4s4 1.791 4 4c0 2.21-1.791 4-4 4zm6.406-11.845c-.796 0-1.441.645-1.441 1.44s.645 1.44 1.441 1.44c.795 0 1.439-.645 1.439-1.44s-.644-1.44-1.439-1.44z"/></svg>
</a>
<a href="https://www.youtube.com/@Hostwebo_ita" class="inline-flex items-center justify-center w-9 h-9 rounded-full hover:bg-slate-100 dark:hover:bg-slate-800 hover:text-slate-800 dark:hover:text-slate-200 transition-colors" target="_blank" rel="noopener noreferrer" aria-label="YouTube">
<svg width="20" height="20" fill="currentColor" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M23.498 6.186a3.016 3.016 0 0 0-2.122-2.136C19.505 3.545 12 3.545 12 3.545s-7.505 0-9.377.505A3.017 3.017 0 0 0 .502 6.186C0 8.07 0 12 0 12s0 3.93.502 5.814a3.016 3.016 0 0 0 2.122 2.136c1.871.505 9.376.505 9.376.505s7.505 0 9.377-.505a3.015 3.015 0 0 0 2.122-2.136C24 15.93 24 12 24 12s0-3.93-.502-5.814zM9.545 15.568V8.432L15.818 12l-6.273 3.568z"/></svg>
</a>
</div>
</div>
</div>
</footer>
<script type="speculationrules">
{"prefetch":[{"source":"document","where":{"and":[{"href_matches":"/*"},{"not":{"href_matches":["/wp-*.php","/wp-admin/*","/wp-content/uploads/*","/wp-content/*","/wp-content/plugins/*","/wp-content/themes/hostwebo/*","/*\\?(.+)"]}},{"not":{"selector_matches":"a[rel~=\"nofollow\"]"}},{"not":{"selector_matches":".no-prefetch, .no-prefetch a"}}]},"eagerness":"conservative"}]}
</script>
<div id="hwq-modal" class="hwq-modal" hidden aria-hidden="true" role="dialog" aria-labelledby="hwq-title" aria-modal="true">
<div class="hwq-backdrop" data-hwq-close></div>
<div class="hwq-dialog">
<button type="button" class="hwq-close" data-hwq-close aria-label="Chiudi">×</button>
<div class="hwq-header">
<div class="hwq-badge">
<svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m12 3-1.9 5.8a2 2 0 0 1-1.3 1.3L3 12l5.8 1.9a2 2 0 0 1 1.3 1.3L12 21l1.9-5.8a2 2 0 0 1 1.3-1.3L21 12l-5.8-1.9a2 2 0 0 1-1.3-1.3Z"/></svg> Preventivo personalizzato </div>
<h2 id="hwq-title">Raccontaci il tuo progetto</h2>
<p class="hwq-sub">Compila il form, ricevi una proposta dettagliata via email entro 24 ore. Nessun impegno.</p>
</div>
<form id="hwq-form" class="hwq-form" novalidate>
<input type="hidden" id="hwq_nonce" name="hwq_nonce" value="c2b704159b" /><input type="hidden" name="_wp_http_referer" value="/documentazione/progress-hostwebo-billing-roadmap/" /> <input type="text" name="hwq_hp" class="hwq-honeypot" tabindex="-1" autocomplete="off" aria-hidden="true">
<div class="hwq-row">
<label>
<span class="hwq-label">Nome e cognome <em>*</em></span>
<input type="text" name="full_name" required maxlength="120" value="">
</label>
<label>
<span class="hwq-label">Email <em>*</em></span>
<input type="email" name="email" required maxlength="160" value="">
</label>
</div>
<div class="hwq-row">
<label>
<span class="hwq-label">Telefono (facoltativo)</span>
<input type="tel" name="phone" maxlength="40">
</label>
<label>
<span class="hwq-label">Azienda (facoltativo)</span>
<input type="text" name="company" maxlength="160">
</label>
</div>
<label>
<span class="hwq-label">Categoria del servizio <em>*</em></span>
<select name="category" required>
<option value="">— Seleziona una categoria —</option>
<option value="wordpress">WordPress</option>
<option value="seo">SEO</option>
<option value="performance">Performance / ottimizzazione</option>
<option value="site_create">Creazione sito da zero</option>
<option value="ecommerce">Ecommerce</option>
<option value="woocommerce">WooCommerce</option>
<option value="ai">AI / automazione</option>
<option value="marketing">Marketing digitale</option>
<option value="development">Sviluppo custom</option>
<option value="design">Design / grafica</option>
<option value="migration">Migrazione siti</option>
<option value="maintenance">Manutenzione continuativa</option>
<option value="other">Altro / non in lista</option>
</select>
</label>
<label>
<span class="hwq-label">Sito web di riferimento (se esiste)</span>
<input type="url" name="website" placeholder="https://miosito.it" maxlength="200">
</label>
<label>
<span class="hwq-label">Descrivi il tuo progetto <em>*</em></span>
<textarea name="description" rows="5" required minlength="20" maxlength="5000" placeholder="Cosa vorresti realizzare? Quali risultati ti aspetti? Hai vincoli di tempo o budget?"></textarea>
</label>
<label>
<span class="hwq-label">Budget orientativo (facoltativo)</span>
<select name="budget">
<option value="">— Preferisco non indicare —</option>
<option value="under_500">< € 500</option>
<option value="500_2k">€ 500 — 2.000</option>
<option value="2k_5k">€ 2.000 — 5.000</option>
<option value="5k_10k">€ 5.000 — 10.000</option>
<option value="over_10k">> € 10.000</option>
</select>
</label>
<label class="hwq-consent">
<input type="checkbox" name="privacy_ok" required value="1">
<span>Ho letto e accetto la <a href="https://www.hostwebo.it/privacy-policy/" target="_blank" rel="noopener">Privacy Policy</a>. I dati saranno usati solo per rispondere alla richiesta.</span>
</label>
<div class="hwq-actions">
<button type="button" data-hwq-close class="hwq-btn-ghost">Annulla</button>
<button type="submit" class="hwq-btn-primary">
<span class="hwq-submit-label">Invia richiesta</span>
<span class="hwq-submit-spin" hidden>⟳</span>
</button>
</div>
<div class="hwq-result" role="status" aria-live="polite" hidden></div>
</form>
</div>
</div>
<style>
.hwq-modal{position:fixed;inset:0;z-index:99999;display:flex;align-items:center;justify-content:center;padding:16px}
.hwq-modal[hidden]{display:none}
.hwq-backdrop{position:absolute;inset:0;background:rgba(15,23,42,.65);backdrop-filter:blur(4px)}
.hwq-dialog{position:relative;background:#fff;color:#0f172a;border-radius:24px;max-width:600px;width:100%;max-height:90vh;overflow-y:auto;box-shadow:0 30px 80px rgba(0,0,0,.35);padding:28px;animation:hwq-pop .2s ease-out}
.dark .hwq-dialog{background:#131a2b;color:#f1f5f9}
@keyframes hwq-pop{from{transform:scale(.96);opacity:0}to{transform:scale(1);opacity:1}}
.hwq-close{position:absolute;top:14px;right:14px;width:32px;height:32px;border:0;background:transparent;font-size:24px;color:#64748b;cursor:pointer;border-radius:8px}
.hwq-close:hover{background:#f1f5f9;color:#0f172a}
.dark .hwq-close:hover{background:#1f2937;color:#f1f5f9}
.hwq-badge{display:inline-flex;align-items:center;gap:6px;padding:4px 10px;border-radius:999px;background:linear-gradient(90deg,rgba(168,85,247,.12),rgba(217,70,239,.12));color:#a855f7;font-size:11px;font-weight:700;text-transform:uppercase;letter-spacing:.05em;margin-bottom:10px;border:1px solid rgba(168,85,247,.3)}
.hwq-header h2{font-size:24px;font-weight:800;margin:0 0 6px;line-height:1.2}
.hwq-sub{font-size:13px;color:#64748b;margin:0 0 18px}
.dark .hwq-sub{color:#94a3b8}
.hwq-form{display:flex;flex-direction:column;gap:14px}
.hwq-form label{display:flex;flex-direction:column;gap:6px;font-size:13px}
.hwq-row{display:grid;grid-template-columns:1fr 1fr;gap:14px}
@media (max-width:560px){.hwq-row{grid-template-columns:1fr}}
.hwq-label{font-weight:600;color:#374151}
.dark .hwq-label{color:#e5e7eb}
.hwq-label em{color:#dc2626;font-style:normal}
.hwq-form input[type=text],.hwq-form input[type=email],.hwq-form input[type=tel],.hwq-form input[type=url],.hwq-form select,.hwq-form textarea{width:100%;padding:10px 12px;border:1px solid #e2e8f0;border-radius:10px;background:#fff;color:#0f172a;font-size:14px;font-family:inherit;transition:border-color .15s, box-shadow .15s}
.dark .hwq-form input[type=text],.dark .hwq-form input[type=email],.dark .hwq-form input[type=tel],.dark .hwq-form input[type=url],.dark .hwq-form select,.dark .hwq-form textarea{background:#0b0f19;color:#f1f5f9;border-color:#334155}
.hwq-form input:focus,.hwq-form select:focus,.hwq-form textarea:focus{outline:0;border-color:#6366f1;box-shadow:0 0 0 3px rgba(99,102,241,.15)}
.hwq-form textarea{resize:vertical;min-height:110px}
.hwq-honeypot{position:absolute;left:-10000px;top:auto;width:1px;height:1px;overflow:hidden}
.hwq-consent{flex-direction:row !important;align-items:flex-start;gap:10px !important;font-size:12px;color:#64748b;line-height:1.5}
.hwq-consent input{margin-top:2px}
.hwq-consent a{color:#6366f1;text-decoration:underline}
.hwq-actions{display:flex;gap:10px;justify-content:flex-end;margin-top:8px}
.hwq-btn-ghost{padding:10px 18px;border:1px solid #e2e8f0;background:transparent;color:#64748b;border-radius:10px;font-weight:600;cursor:pointer;font-size:14px}
.hwq-btn-ghost:hover{background:#f8fafc}
.dark .hwq-btn-ghost{border-color:#334155;color:#94a3b8}
.dark .hwq-btn-ghost:hover{background:#1f2937}
.hwq-btn-primary{padding:10px 22px;border:0;background:linear-gradient(90deg,#6366f1,#d946ef);color:#fff;border-radius:10px;font-weight:700;cursor:pointer;font-size:14px;box-shadow:0 4px 12px rgba(99,102,241,.3);min-width:140px}
.hwq-btn-primary:hover{filter:brightness(1.05)}
.hwq-btn-primary:disabled{opacity:.6;cursor:not-allowed}
.hwq-result{padding:12px 14px;border-radius:10px;font-size:13px;line-height:1.5}
.hwq-result.success{background:#ecfdf5;color:#065f46;border:1px solid #6ee7b7}
.hwq-result.error{background:#fef2f2;color:#991b1b;border:1px solid #fecaca}
body.hwq-locked{overflow:hidden}
</style>
<script>
(function(){
const modal = document.getElementById('hwq-modal');
if(!modal) return;
const form = document.getElementById('hwq-form');
const result = modal.querySelector('.hwq-result');
const submitLabel = modal.querySelector('.hwq-submit-label');
const submitSpin = modal.querySelector('.hwq-submit-spin');
const submitBtn = form.querySelector('button[type=submit]');
function open() {
modal.hidden = false;
modal.setAttribute('aria-hidden','false');
document.body.classList.add('hwq-locked');
setTimeout(() => { const f = form.querySelector('input,select,textarea'); if(f) f.focus(); }, 100);
}
function close() {
modal.hidden = true;
modal.setAttribute('aria-hidden','true');
document.body.classList.remove('hwq-locked');
}
document.addEventListener('click', function(e){
if(e.target.closest('[data-hwq-open]')) { e.preventDefault(); open(); }
if(e.target.closest('[data-hwq-close]')) { e.preventDefault(); close(); }
});
document.addEventListener('keydown', function(e){
if(e.key === 'Escape' && !modal.hidden) close();
});
form.addEventListener('submit', async function(e){
e.preventDefault();
result.hidden = true;
result.className = 'hwq-result';
submitBtn.disabled = true;
submitLabel.hidden = true;
submitSpin.hidden = false;
const fd = new FormData(form);
fd.append('action', 'hwq_submit');
fd.append('source_url', window.location.href);
try {
const r = await fetch('https://www.hostwebo.it/wp-admin/admin-ajax.php', {
method: 'POST',
body: fd,
credentials: 'same-origin'
});
const data = await r.json();
if (data && data.success) {
result.className = 'hwq-result success';
result.textContent = data.data && data.data.message ? data.data.message : 'Richiesta ricevuta. Ti contatteremo entro 24h.';
result.hidden = false;
form.reset();
setTimeout(close, 4000);
} else {
result.className = 'hwq-result error';
result.textContent = (data && data.data && data.data.message) ? data.data.message : 'Errore: riprova.';
result.hidden = false;
}
} catch(err) {
result.className = 'hwq-result error';
result.textContent = 'Errore di rete. Riprova fra qualche istante.';
result.hidden = false;
} finally {
submitBtn.disabled = false;
submitLabel.hidden = false;
submitSpin.hidden = true;
}
});
})();
</script>
<script id="hostwebo-theme-js-extra">
var hostweboData = {"currency":"\u20ac","darkMode":{"mode":"auto","dayStart":7,"nightStart":19},"restRoot":"https://www.hostwebo.it/wp-json/"};
//# sourceURL=hostwebo-theme-js-extra
</script>
<script id="hostwebo-theme-js" defer src="https://www.hostwebo.it/wp-content/themes/hostwebo/assets/js/theme.js?ver=1779132485"></script>
<script id="hwai-widget-js-extra">
var HWAI_CONFIG = {"rest_url":"https://www.hostwebo.it/wp-json/hostwebo-ai/v1/","nonce":"289b533e0c","mode":"public_sales","user_logged_in":"","agent_default":"marketing","allowed_agents":[],"public_widget_mode":"both","public_max_chars":"1500","i18n":{"placeholder":"Scrivi qui la tua domanda...","send":"Invia","thinking":"Sto elaborando...","opener_public":"Ciao! \ud83d\udc4b Sono il consulente Hostwebo. Ti aiuto a scegliere il piano giusto?","opener_private":"Ciao! Sono il tuo assistente Hostwebo. Come posso aiutarti?","quota_label":"Utilizzo AI","quota_exhausted":"Hai esaurito le richieste AI per oggi. Continuer\u00f2 ad aiutarti con risposte basate sulla nostra documentazione."}};
//# sourceURL=hwai-widget-js-extra
</script>
<script id="hwai-widget-js" src="https://www.hostwebo.it/wp-content/plugins/hostwebo-ai/assets/js/widget.js?ver=1.0.0-alpha.188.3"></script>
<script id="wp-emoji-settings" type="application/json">
{"baseUrl":"https://s.w.org/images/core/emoji/17.0.2/72x72/","ext":".png","svgUrl":"https://s.w.org/images/core/emoji/17.0.2/svg/","svgExt":".svg","source":{"wpemoji":"https://www.hostwebo.it/wp-includes/js/wp-emoji.js?ver=7.0.2","twemoji":"https://www.hostwebo.it/wp-includes/js/twemoji.js?ver=7.0.2"}}
</script>
<script type="module">
/**
* @output wp-includes/js/wp-emoji-loader.js
*/
/* eslint-env es6 */
// Note: This is loaded as a script module, so there is no need for an IIFE to prevent pollution of the global scope.
/**
* Emoji Settings as exported in PHP via _print_emoji_detection_script().
* @typedef WPEmojiSettings
* @type {object}
* @property {?object} source
* @property {?string} source.concatemoji
* @property {?string} source.twemoji
* @property {?string} source.wpemoji
*/
const settings = /** @type {WPEmojiSettings} */ (
JSON.parse( document.getElementById( 'wp-emoji-settings' ).textContent )
);
// For compatibility with other scripts that read from this global, in particular wp-includes/js/wp-emoji.js (source file: js/_enqueues/wp/emoji.js).
window._wpemojiSettings = settings;
/**
* Support tests.
* @typedef SupportTests
* @type {object}
* @property {?boolean} flag
* @property {?boolean} emoji
*/
const sessionStorageKey = 'wpEmojiSettingsSupports';
const tests = [ 'flag', 'emoji' ];
/**
* Checks whether the browser supports offloading to a Worker.
*
* @since 6.3.0
*
* @private
*
* @returns {boolean}
*/
function supportsWorkerOffloading() {
return (
typeof Worker !== 'undefined' &&
typeof OffscreenCanvas !== 'undefined' &&
typeof URL !== 'undefined' &&
URL.createObjectURL &&
typeof Blob !== 'undefined'
);
}
/**
* @typedef SessionSupportTests
* @type {object}
* @property {number} timestamp
* @property {SupportTests} supportTests
*/
/**
* Get support tests from session.
*
* @since 6.3.0
*
* @private
*
* @returns {?SupportTests} Support tests, or null if not set or older than 1 week.
*/
function getSessionSupportTests() {
try {
/** @type {SessionSupportTests} */
const item = JSON.parse(
sessionStorage.getItem( sessionStorageKey )
);
if (
typeof item === 'object' &&
typeof item.timestamp === 'number' &&
new Date().valueOf() < item.timestamp + 604800 && // Note: Number is a week in seconds.
typeof item.supportTests === 'object'
) {
return item.supportTests;
}
} catch ( e ) {}
return null;
}
/**
* Persist the supports in session storage.
*
* @since 6.3.0
*
* @private
*
* @param {SupportTests} supportTests Support tests.
*/
function setSessionSupportTests( supportTests ) {
try {
/** @type {SessionSupportTests} */
const item = {
supportTests: supportTests,
timestamp: new Date().valueOf()
};
sessionStorage.setItem(
sessionStorageKey,
JSON.stringify( item )
);
} catch ( e ) {}
}
/**
* Checks if two sets of Emoji characters render the same visually.
*
* This is used to determine if the browser is rendering an emoji with multiple data points
* correctly. set1 is the emoji in the correct form, using a zero-width joiner. set2 is the emoji
* in the incorrect form, using a zero-width space. If the two sets render the same, then the browser
* does not support the emoji correctly.
*
* This function may be serialized to run in a Worker. Therefore, it cannot refer to variables from the containing
* scope. Everything must be passed by parameters.
*
* @since 4.9.0
*
* @private
*
* @param {CanvasRenderingContext2D} context 2D Context.
* @param {string} set1 Set of Emoji to test.
* @param {string} set2 Set of Emoji to test.
*
* @return {boolean} True if the two sets render the same.
*/
function emojiSetsRenderIdentically( context, set1, set2 ) {
// Cleanup from previous test.
context.clearRect( 0, 0, context.canvas.width, context.canvas.height );
context.fillText( set1, 0, 0 );
const rendered1 = new Uint32Array(
context.getImageData(
0,
0,
context.canvas.width,
context.canvas.height
).data
);
// Cleanup from previous test.
context.clearRect( 0, 0, context.canvas.width, context.canvas.height );
context.fillText( set2, 0, 0 );
const rendered2 = new Uint32Array(
context.getImageData(
0,
0,
context.canvas.width,
context.canvas.height
).data
);
return rendered1.every( ( rendered2Data, index ) => {
return rendered2Data === rendered2[ index ];
} );
}
/**
* Checks if the center point of a single emoji is empty.
*
* This is used to determine if the browser is rendering an emoji with a single data point
* correctly. The center point of an incorrectly rendered emoji will be empty. A correctly
* rendered emoji will have a non-zero value at the center point.
*
* This function may be serialized to run in a Worker. Therefore, it cannot refer to variables from the containing
* scope. Everything must be passed by parameters.
*
* @since 6.8.2
*
* @private
*
* @param {CanvasRenderingContext2D} context 2D Context.
* @param {string} emoji Emoji to test.
*
* @return {boolean} True if the center point is empty.
*/
function emojiRendersEmptyCenterPoint( context, emoji ) {
// Cleanup from previous test.
context.clearRect( 0, 0, context.canvas.width, context.canvas.height );
context.fillText( emoji, 0, 0 );
// Test if the center point (16, 16) is empty (0,0,0,0).
const centerPoint = context.getImageData(16, 16, 1, 1);
for ( let i = 0; i < centerPoint.data.length; i++ ) {
if ( centerPoint.data[ i ] !== 0 ) {
// Stop checking the moment it's known not to be empty.
return false;
}
}
return true;
}
/**
* Determines if the browser properly renders Emoji that Twemoji can supplement.
*
* This function may be serialized to run in a Worker. Therefore, it cannot refer to variables from the containing
* scope. Everything must be passed by parameters.
*
* @since 4.2.0
*
* @private
*
* @param {CanvasRenderingContext2D} context 2D Context.
* @param {string} type Whether to test for support of "flag" or "emoji".
* @param {Function} emojiSetsRenderIdentically Reference to emojiSetsRenderIdentically function, needed due to minification.
* @param {Function} emojiRendersEmptyCenterPoint Reference to emojiRendersEmptyCenterPoint function, needed due to minification.
*
* @return {boolean} True if the browser can render emoji, false if it cannot.
*/
function browserSupportsEmoji( context, type, emojiSetsRenderIdentically, emojiRendersEmptyCenterPoint ) {
let isIdentical;
switch ( type ) {
case 'flag':
/*
* Test for Transgender flag compatibility. Added in Unicode 13.
*
* To test for support, we try to render it, and compare the rendering to how it would look if
* the browser doesn't render it correctly (white flag emoji + transgender symbol).
*/
isIdentical = emojiSetsRenderIdentically(
context,
'\uD83C\uDFF3\uFE0F\u200D\u26A7\uFE0F', // as a zero-width joiner sequence
'\uD83C\uDFF3\uFE0F\u200B\u26A7\uFE0F' // separated by a zero-width space
);
if ( isIdentical ) {
return false;
}
/*
* Test for Sark flag compatibility. This is the least supported of the letter locale flags,
* so gives us an easy test for full support.
*
* To test for support, we try to render it, and compare the rendering to how it would look if
* the browser doesn't render it correctly ([C] + [Q]).
*/
isIdentical = emojiSetsRenderIdentically(
context,
'\uD83C\uDDE8\uD83C\uDDF6', // as the sequence of two code points
'\uD83C\uDDE8\u200B\uD83C\uDDF6' // as the two code points separated by a zero-width space
);
if ( isIdentical ) {
return false;
}
/*
* Test for English flag compatibility. England is a country in the United Kingdom, it
* does not have a two letter locale code but rather a five letter sub-division code.
*
* To test for support, we try to render it, and compare the rendering to how it would look if
* the browser doesn't render it correctly (black flag emoji + [G] + [B] + [E] + [N] + [G]).
*/
isIdentical = emojiSetsRenderIdentically(
context,
// as the flag sequence
'\uD83C\uDFF4\uDB40\uDC67\uDB40\uDC62\uDB40\uDC65\uDB40\uDC6E\uDB40\uDC67\uDB40\uDC7F',
// with each code point separated by a zero-width space
'\uD83C\uDFF4\u200B\uDB40\uDC67\u200B\uDB40\uDC62\u200B\uDB40\uDC65\u200B\uDB40\uDC6E\u200B\uDB40\uDC67\u200B\uDB40\uDC7F'
);
return ! isIdentical;
case 'emoji':
/*
* Is there a large, hairy, humanoid mythical creature living in the browser?
*
* To test for Emoji 17.0 support, try to render a new emoji: Hairy Creature.
*
* The hairy creature emoji is a single code point emoji. Testing for browser
* support required testing the center point of the emoji to see if it is empty.
*
* 0xD83E 0x1FAC8 (\uD83E\u1FAC8) == Hairy creature.
*
* When updating this test, please ensure that the emoji is either a single code point
* or switch to using the emojiSetsRenderIdentically function and testing with a zero-width
* joiner vs a zero-width space.
*/
const notSupported = emojiRendersEmptyCenterPoint( context, '\uD83E\u1FAC8' );
return ! notSupported;
}
return false;
}
/**
* Checks emoji support tests.
*
* This function may be serialized to run in a Worker. Therefore, it cannot refer to variables from the containing
* scope. Everything must be passed by parameters.
*
* @since 6.3.0
*
* @private
*
* @param {string[]} tests Tests.
* @param {Function} browserSupportsEmoji Reference to browserSupportsEmoji function, needed due to minification.
* @param {Function} emojiSetsRenderIdentically Reference to emojiSetsRenderIdentically function, needed due to minification.
* @param {Function} emojiRendersEmptyCenterPoint Reference to emojiRendersEmptyCenterPoint function, needed due to minification.
*
* @return {SupportTests} Support tests.
*/
function testEmojiSupports( tests, browserSupportsEmoji, emojiSetsRenderIdentically, emojiRendersEmptyCenterPoint ) {
let canvas;
if (
typeof WorkerGlobalScope !== 'undefined' &&
self instanceof WorkerGlobalScope
) {
canvas = new OffscreenCanvas( 300, 150 ); // Dimensions are default for HTMLCanvasElement.
} else {
canvas = document.createElement( 'canvas' );
}
const context = canvas.getContext( '2d', { willReadFrequently: true } );
/*
* Chrome on OS X added native emoji rendering in M41. Unfortunately,
* it doesn't work when the font is bolder than 500 weight. So, we
* check for bold rendering support to avoid invisible emoji in Chrome.
*/
context.textBaseline = 'top';
context.font = '600 32px Arial';
const supports = {};
tests.forEach( ( test ) => {
supports[ test ] = browserSupportsEmoji( context, test, emojiSetsRenderIdentically, emojiRendersEmptyCenterPoint );
} );
return supports;
}
/**
* Adds a script to the head of the document.
*
* @ignore
*
* @since 4.2.0
*
* @param {string} src The url where the script is located.
*
* @return {void}
*/
function addScript( src ) {
const script = document.createElement( 'script' );
script.src = src;
script.defer = true;
document.head.appendChild( script );
}
settings.supports = {
everything: true,
everythingExceptFlag: true
};
// Obtain the emoji support from the browser, asynchronously when possible.
new Promise( ( resolve ) => {
let supportTests = getSessionSupportTests();
if ( supportTests ) {
resolve( supportTests );
return;
}
if ( supportsWorkerOffloading() ) {
try {
// Note that the functions are being passed as arguments due to minification.
const workerScript =
'postMessage(' +
testEmojiSupports.toString() +
'(' +
[
JSON.stringify( tests ),
browserSupportsEmoji.toString(),
emojiSetsRenderIdentically.toString(),
emojiRendersEmptyCenterPoint.toString()
].join( ',' ) +
'));';
const blob = new Blob( [ workerScript ], {
type: 'text/javascript'
} );
const worker = new Worker( URL.createObjectURL( blob ), { name: 'wpTestEmojiSupports' } );
worker.onmessage = ( event ) => {
supportTests = event.data;
setSessionSupportTests( supportTests );
worker.terminate();
resolve( supportTests );
};
return;
} catch ( e ) {}
}
supportTests = testEmojiSupports( tests, browserSupportsEmoji, emojiSetsRenderIdentically, emojiRendersEmptyCenterPoint );
setSessionSupportTests( supportTests );
resolve( supportTests );
} )
// Once the browser emoji support has been obtained from the session, finalize the settings.
.then( ( supportTests ) => {
/*
* Tests the browser support for flag emojis and other emojis, and adjusts the
* support settings accordingly.
*/
for ( const test in supportTests ) {
settings.supports[ test ] = supportTests[ test ];
settings.supports.everything =
settings.supports.everything && settings.supports[ test ];
if ( 'flag' !== test ) {
settings.supports.everythingExceptFlag =
settings.supports.everythingExceptFlag &&
settings.supports[ test ];
}
}
settings.supports.everythingExceptFlag =
settings.supports.everythingExceptFlag &&
! settings.supports.flag;
// When the browser can not render everything we need to load a polyfill.
if ( ! settings.supports.everything ) {
const src = settings.source || {};
if ( src.concatemoji ) {
addScript( src.concatemoji );
} else if ( src.wpemoji && src.twemoji ) {
addScript( src.twemoji );
addScript( src.wpemoji );
}
}
} );
//# sourceURL=https://www.hostwebo.it/wp-includes/js/wp-emoji-loader.js
</script>
<hostwebo-ai-widget mode="public_sales"></hostwebo-ai-widget></body>
</html>
plugin-billing
PROGRESS — Hostwebo Billing roadmap
PROGRESS — Hostwebo Billing roadmap Snapshot dello stato di avanzamento della roadmap di pulizia 2026-05 decisa dopo l’audit iniziale del backend hwbi. Aggiornare questo file alla fine di ogni sessione di lavoro co…
Aggiornato 18 Mag 2026
— min di lettura