Lavorare a un sito che Le è stato condiviso

Il proprietario di un sito può concedere l'accesso a uno dei propri siti (non al proprio account, non alla fatturazione, non agli altri siti) e Lei potrà lavorarci utilizzando le Sue credenziali di accesso a Zinn Digital® e l'interfaccia a riga di comando gratuita Zinnector®. Questa guida illustra entrambe le parti: ciò che fa il proprietario e ciò che fa Lei.

Se non ha mai usato Zinnector® prima d'ora, Guida introduttiva a Zinnector® provvede all'installazione in circa due minuti. Nessuna operazione qui descritta richiede l'acquisto di un servizio dihosting.

Per il proprietario del sito: condivisione di un singolo sito

1. Apra il sito nel Suo pannello di controllo e vada su Sicurezza.
2. In Chi altro può accedere a questo sito, scelga Condividi questo sito.
3. Inserisca l'indirizzo email dello sviluppatore. Non è necessario che disponga già di un account: se non ha mai effettuato l'accesso, riceverà un invito e l'accesso avrà inizio nel momento stesso in cui lo accetterà.
4. Scelga un ruolo:

• Visualizzatore: può consultare, ma non può modificare nulla.
• Editor: il ruolo di cui uno sviluppatore ha normalmente bisogno. Può modificare i file del sito, utilizzare wp-admin e scaricare un archivio del sito per lavorarci in locale. Tale archivio include il database.
• Manager: tutte le funzioni di un editor, più il ripristino di un backup.

1. Indichi un motivo e, se il lavoro ha una data di fine, una scadenza. L'autorizzazione cesserà semplicemente di avere validità in quella data; non dovrà ricordarsi di rimuoverla.
2. Salvi.

Qualunque sia la Sua scelta, un collaboratore non potrà mai eliminare il sito, visualizzare i dati di fatturazione o accedere a nessun altro dei Suoi siti.

Cosa significa "l'archivio include il database"

Un editor o un manager può prelevare una copia del sito su cui lavorare, e la copia di un sito è costituita dai suoi file e dal suo database. Il database di WordPress contiene tutto ciò che i visitatori hanno fornito al sito: nomi e indirizzi email dei commentatori, account dei clienti, ordini WooCommerce e indirizzi di spedizione, invii di moduli.

Di norma è esattamente ciò di cui uno sviluppatore ha bisogno: senza di esso si troverebbe a confrontare il tema con un sito vuoto. È utile esserne a conoscenza, poiché si tratta di dati personali reali e le persone a cui appartengono sono i Suoi clienti, non i nostri.

Ne conseguono due aspetti, di cui la piattaforma si occupa per Lei:

• Ogni esportazione è registrata nel registro di audit. Apri Registro di audit e cerchi site.backup.exported. Ciascuna riga indica chi ha effettuato l'operazione, quando e se quell'archivio contenesse il database. Non è necessario che lo chieda.
• Può interromperlo in qualsiasi momento. La revoca è istantanea: vedi sotto.

Se preferisce che il lavoro venga svolto senza il database, dica allo sviluppatore di aggiungere --no-database al momento del pull; si tratta di un singolo flag e il resto funzionerà allo stesso modo.

Per lo sviluppatore: importare il sito sulla propria macchina

1. Installare Zinnector®

npm install -g zinnector
zinnector --version

È necessario Node 24 o versioni successive. node --version deve restituire v24 o superiore.

2. Effettuare l'accesso con il proprio account

zinnector login

Questo comando aprirà il browser e Le consentirà di accedere con il Suo account Zinn Digital®, ovvero quello a cui è stato inviato l'invito. Non avrà mai bisogno della password del proprietario, e quest'ultimo non dovrà mai fornirgliela.

Verifichi gli elementi che Le sono stati assegnati:

zinnector sites

Visualizzerà esattamente i siti che Le sono stati condivisi e nient'altro. Se l'elenco è vuoto, l'invito non è ancora stato accettato oppure l'autorizzazione è stata revocata o è scaduta.

3. Effettuare il pull del sito

zinnector clone client-domain.com
cd client-domain.com

Il comando clone crea un progetto locale a partire dal sito ospitato. Include:

• wp-content: i temi, i plugin, i plugin mu, le lingue e i file multimediali che costituiscono il lavoro proprio del sito;
• il database, salvato nel file database.sql all'interno del progetto.

Vengono deliberatamente esclusi il core di WordPress (il runtime locale fornisce la versione corretta), wp-config.php (che contiene la password del database del sito live) e qualsiasi file multimediale scaricato su object storage.

Ogni esecuzione stampa esattamente ciò che è stato prelevato e ciò che è stato escluso, completi di conteggi. Se desidera solo i file, aggiunga --no-database.

Dispone già del progetto e desidera semplicemente l'ultima versione? Esegua zinnector pull all'interno della cartella del progetto.

4. Eseguirlo in locale, con i contenuti reali

zinnector dev --runtime docker

Sul runtime Docker, questo comando importa il file database.sql, aggiorna l'URL del sito impostando l'indirizzo locale e apre il sito includendo i contenuti reali del cliente. Per accedere, utilizzi gli account WordPress del sito stesso.

Il runtime predefinito, WordPress Playground, che non richiede Docker, è più rapido da avviare e non importa il database; in tal caso verrà visualizzato un messaggio di avviso anziché un avvio silenzioso con dati vuoti. Lo utilizzi quando sta lavorando sul codice e non ha bisogno dei contenuti.

5. Gestire con cura la copia ricevuta

Il file database.sql corrisponde al database di un sito attivo. Zinnector® provvede ad aggiungerlo al file .gitignore del progetto nel momento stesso in cui viene generato, in modo che un comando git add -A distratto non pubblichi i clienti di qualcuno su un repository. Non modifichi quella riga ed elimini il file al termine del lavoro.

Operazioni consentite e non consentite per un collaboratore

| | Visualizzatore | Editor | Manager | |---|---|---|---| | Visualizzare il sito e le relative impostazioni | ✔ | ✔ | ✔ | | Modificare i file, utilizzare wp-admin, effettuare il deployment | | ✔ | ✔ | | Eseguire il pull del sito, database incluso | | ✔ | ✔ | | Ripristinare un backup sul sito attivo | | | ✔ | | Eliminare il sito | | | | | Visualizzare fatturazione o fatture | | | | | Accedere agli altri siti del proprietario | | | |

Le ultime tre righe sono vuote per qualsiasi ruolo. Non si tratta di un'impostazione.

Revoca dell'accesso

Il proprietario apre la sezione Sicurezza del sito e seleziona Revoca accanto al nome dell'utente. L'operazione ha effetto immediato: il comando Zinnector® successivo eseguito da quello sviluppatore non sarà in grado di visualizzare il sito, così come nessun altro elemento in suo possesso.

Una data di scadenza produce lo stesso risultato in un determinato giorno, senza che nessuno debba ricordarsene. Se ne ha impostata una al momento della condivisione del sito, il processo è già completo.

In caso di problemi

• zinnector sites non mostra alcun elemento. L'invito non è stato accettato, oppure l'autorizzazione è stata revocata o è scaduta. Chieda al proprietario di verificare la sezione Sicurezza del sito: gli inviti in sospeso sono elencati lì.
• zinnector pull segnala che il sito non dispone di alcun backup recente. Il comando esegue il pull di una versione aggiornata se il piano lo consente, chiedendo prima conferma. Se il piano non include i backup su richiesta, aumenti il valore di --max-age per accettare un backup meno recente.
• zinnector dev avvia un'installazione di WordPress vuota. Significa che si sta utilizzando il runtime Playground, il quale non importa alcun database. Esegua zinnector dev --runtime docker.
• Il sito locale continua a reindirizzare al dominio live. L'operazione di importazione aggiorna l'URL del sito; se tale passaggio non è andato a buon fine, il comando restituisce un messaggio di errore e stampa la riga wp search-replace da eseguire.

Ulteriori errori e relative soluzioni: Risoluzione dei problemi di Zinnector®.