Sincronizzazione bidirezionale con il Suo repository GitHub

Colleghi il Suo account GitHub a un sito e noi manterremo i due elementi sincronizzati in entrambe le direzioni. È gratuito, è disattivato finché non lo accende e noi eseguiamo il commit esclusivamente in un repository di un account di Sua proprietà, mai in uno nostro.

Cosa viene sincronizzato

Qualsiasi modifica apportata ai file del Suo sito diventa un commit nel Suo repository, indipendentemente da come l'abbia effettuata: tramite file manager, SFTP, editor dei temi di WordPress o sessione SSH. Non è tenuto a comunicarcelo; confrontiamo il Suo sito con il suo ultimo commit e inviamo la differenza.

In senso inverso, un push sul branch connesso viene applicato al sito.

Cosa non viene mai inserito nei commit

Il file wp-config.php viene escluso, in modo deliberato e permanente. Contiene la password del Suo database e i relativi salt di autenticazione, che non devono trovarsi in un repository, nemmeno privato, poiché git conserva la cronologia per sempre.

Sono esclusi anche: i file .env, chiavi e certificati, la cartella degli upload, le cache e node_modules. Un repository è il codice sorgente del Suo sito, non un backup. I file multimediali appartengono ai Suoi backup, dove sono già conservati, e inserirli qui rallenterebbe ogni push e renderebbe ogni modifica illeggibile.

Cosa succede se entrambi i lati subiscono modifiche

Questa è la domanda che vale la pena leggere. Supponga di modificare un file nel file manager e che nel frattempo un collega invii una modifica allo stesso repository.

Ci fermiamo. Non effettuiamo il merge e non sovrascriviamo nessuno. La scheda Distribuzione del sito mostra la dicitura "Il repository contiene modifiche non ancora rilevate", indica il commit da esaminare e rimane in attesa. Nulla viene perso da nessuna delle due parti durante l'attesa: la Sua modifica è ancora sul sito, il commit dell'altra persona è ancora nel repository.

Successivamente potrà scegliere:

Conserva i file di questo sito — pubblicheremo la Sua versione al di sopra della loro. I loro commit rimangono nella cronologia; nulla viene cancellato.
Usa il repository, scarta le modifiche del sito — la versione del repository viene applicata al sito e le modifiche apportate qui vengono scartate. Questa opzione è distruttiva, motivo per cui richiede un clic deliberato e non viene mai eseguita automaticamente per Suo conto.

Non è prevista alcuna opzione di "merge automatico", e questo è voluto. Un merge eseguito da noi produrrebbe un file che nessuno dei due ha scritto, su un sito attivo, senza che nessuno dei due lo abbia visionato prima.

Perché la sincronizzazione potrebbe interrompersi

Non ha collegato il Suo account GitHub. L'interruttore rimane disattivato finché non lo fa.
È in attesa di un Suo intervento. Come indicato in precedenza, un blocco non si risolve da solo.
Il Suo account non è in regola. La sincronizzazione si interrompe e riprende autonomamente una volta regolarizzata la fatturazione. Nulla va perduto.

La scheda Distribuzione mostra le ultime sincronizzazioni, incluse quelle in cui non ci sono state modifiche. Se tale elenco è vuoto e la sincronizzazione è attiva, è molto probabile che l'account connesso non disponga dei permessi di scrittura sul repository; verifichi l'accesso ed effettui nuovamente la connessione.

Scelta degli elementi da sincronizzare

Per impostazione predefinita viene sincronizzato l'intero sito. Nel caso di un sito WordPress, di norma questa non è la soluzione ideale, in quanto comporterebbe la sincronizzazione di ogni file del core di WordPress, che non ha scritto Lei e che non modificherà. Imposti "Sincronizza solo questa cartella" sul Suo tema, ad esempio wp-content/themes/my-theme, e il resto verrà ignorato.