NitAGE Client Hub

Un plugin WordPress per creare aree riservate ("Hub") dedicate ai clienti. Permette di gestire branding personalizzato, caricamento loghi e link a risorse esterne con un'interfaccia scura, moderna e pulita.

Requisiti

• WordPress: 6.0+
• PHP: 8.2+
• Composer: Per la gestione delle dipendenze

Installazione

⚠️ Importante per i Colleghi

La cartella /vendor/ è esclusa dal controllo di versione per Best Practice. Dopo aver clonato la repository, è necessario installare le dipendenze.

Metodo Consigliato: Make

Nel terminale, dalla root del plugin, eseguire:

make install

Questo comando eseguirà automaticamente composer install per scaricare le dipendenze e generare l'autoloader.

Metodo Alternativo: Composer

In alternativa, è possibile utilizzare direttamente Composer:

composer install

Funzionalità Principali

Custom Post Type

Gestione degli Hub tramite il menu "Client Hubs" nella dashboard di WordPress. Ogni Hub è un post personalizzato con funzionalità dedicate.

Branding Dinamico

• Logo Cliente: Possibilità di caricare il logo del cliente tramite media library
• Colore Primario: Impostazione di un colore primario personalizzato per i bordi delle card e gli effetti hover
• Default: Colore oro (#d4af37) se non specificato

Link con Descrizione

Aggiunta di card con:

• Titolo (label)
• Icona (dashicons)
• Descrizione opzionale
• URL esterno

Le card sono organizzate in una griglia responsive e possono essere riordinate tramite drag & drop.

UI Professionale

• Layout Centrato: Design moderno e pulito con contenuto centrato
• Loghi: Dimensione fissa di 120px per garantire simmetria visiva
• Tipografia: Testi bianchi su sfondo scuro (#050505) per massima leggibilità
• Spaziature: Calibrate per creare un'esperienza visiva equilibrata
• Responsive: Ottimizzato per desktop, tablet e mobile

URL Segreti

Generazione automatica di slug casuali (12 caratteri alfanumerici) per garantire la privacy degli Hub senza necessità di sistema di login. Ogni Hub ha un URL univoco e non indicizzato dai motori di ricerca.

Note per gli Sviluppatori

Standard di Codifica

Il codice segue gli standard di codifica di WordPress (WPCS):

• I file delle classi seguono la convenzione class-nome-classe.php
• Esempio: class-links-meta-box.php, class-hub-assets.php
• Le classi utilizzano namespace PSR-4: NitAGE\ClientHub\

Struttura del Plugin

nitage-client-hub/
├── assets/
│   ├── css/
│   │   └── hub-style.css
│   ├── js/
│   │   ├── admin-list.js
│   │   └── hub-links.js
│   └── images/
│       └── logo-nitage.png
├── includes/
│   ├── Assets/
│   │   └── class-hub-assets.php
│   ├── Branding/
│   │   ├── class-branding-meta-box.php
│   │   └── class-client-hub-cpt.php
│   ├── Features/
│   │   └── class-links-meta-box.php
│   ├── class-loader.php
│   └── class-plugin.php
├── templates/
│   └── client-hub-template.php
├── composer.json
├── nitage-client-hub.php
└── README.md

Asset CSS e JS

Gli asset sono organizzati nella cartella /assets/:

• CSS: /assets/css/hub-style.css - Stili principali del frontend
• JS:
  • /assets/js/admin-list.js - Funzionalità per la lista degli Hub
  • /assets/js/hub-links.js - Gestione drag & drop dei link

Template Principale

Il template principale si trova in /templates/client-hub-template.php ed è caricato automaticamente quando viene visualizzato un post di tipo client_hub.

Autoloading

Il plugin utilizza Composer autoloading con classmap per caricare automaticamente tutte le classi. Dopo ogni modifica alla struttura delle classi, rigenerare l'autoloader con:

composer dump-autoload

Meta Fields

• _client_branding_logo: ID dell'attachment del logo
• _client_branding_primary_color: Colore primario in formato hex (#RRGGBB)
• _nitage_hub_links: Array di link con struttura:

  [
      [
          'label' => 'Titolo Link',
          'url' => 'https://example.com',
          'description' => 'Descrizione opzionale'
      ]
  ]

Sviluppo

Comandi Make Disponibili

Il plugin include un Makefile con i seguenti comandi:

• make install: Installa le dipendenze Composer e genera l'autoloader
• make lint: Esegue PHPCS per verificare la conformità agli standard WordPress
• make lint-fix: Esegue PHPCBF per correggere automaticamente i problemi di formattazione

Testing

Per verificare che il plugin funzioni correttamente:

1. Creare un nuovo "Client Hub" dalla dashboard
2. Caricare un logo e impostare un colore primario
3. Aggiungere alcuni link con descrizioni
4. Visualizzare l'Hub tramite il suo URL segreto

Supporto

Per domande o supporto, contattare il team NitAGE.

---

Sviluppato da NitAGE