Versioni pubblicate e deploy hook
Ogni pubblicazione del tuo sito viene conservata come versione numerata, e la sezione Versions nelle Settings del progetto le elenca. Gli Deploy hooks, nelle stesse Settings, permettono a un altro strumento di chiedere a Briks di pubblicare di nuovo il tuo sito. Questa pagina tratta entrambi.
L'elenco delle versioni pubblicate
La sezione elenca le ultime 100 versioni, dalla più recente. Ogni riga mostra:
- Version e il suo numero, con un'etichetta verde Live su quella che i visitatori vedono ora.
- Com'è nato: Built, Changed, Checked and repaired o Published again, e chi l'ha richiesto.
- La data e l'ora di pubblicazione, ad esempio 8 ott 2026, 14:32.
- Un breve riepilogo. Per una modifica, sono le parole con cui l'hai chiesta; per una creazione o una nuova pubblicazione, è ciò che ha fatto Briks.
- Quando una versione è online da una settimana, una riga indica se è servita (vedi sotto).
| Etichetta | Cosa ha prodotto la versione |
|---|---|
| Built | Una prima creazione, o un nuovo progetto copiato da un modello o da un altro progetto |
| Changed | Una modifica che hai chiesto, codice che hai salvato in File Explorer, o un'immagine che hai sostituito dalla libreria multimediale |
| Controllato e riparato | Un controllo del sito che ha corretto qualcosa che ha trovato |
| Pubblicato di nuovo | Un passaggio in produzione o di ritorno all'anteprima, Apply to the live site, un nuovo indirizzo, un dominio che va online o un deploy hook. Il riepilogo dice quale, per esempio “Published again with the site's settings.” |
Per ogni lavoro sul progetto, compresi quelli che non hanno pubblicato nulla, vedi Log.
La modifica è stata utile?
Quando una versione è online da 7 giorni, la sua riga mostra un'indicazione che confronta le visite prima e dopo, per le pagine che la versione ha cambiato, ciascuna come media settimanale su un massimo di 14 giorni per parte. Dice, per esempio, “Since version 12 (Add a prices section), enquiries from /prices went from 3 to 5 a week, on similar visits.” Quando quelle pagine hanno avuto meno di 25 visitatori a settimana, dice che le visite sono troppo poche per giudicare. Una modifica fatta da un agente è indicata come sua. La riga viene calcolata dalle tue analisi senza IA e non costa nulla. Le versioni che sono state solo ripubblicate e la prima creazione non hanno nessuna riga. Vengono lette le ultime 12 versioni e una lettura è definitiva dopo 14 giorni.
Ripristina una versione
Trova la versione
Dove: Settings, Versions
Ogni riga tranne quella online ha un pulsante Restore, se il tuo ruolo ti permette di modificare il progetto.
Ripristinalo
Dove: Restore version
Premi Restore. La finestra dice “It goes back on the live site exactly as it was published. The versions after it stay saved, so you can come back.” Premi Restore version e il numero.
Guardalo mentre si pubblica
Dove: Studio
Briks ti porta nello studio mentre pubblica. Il messaggio dice, per esempio, «Version 12 is live again, exactly as it was published.» Il tag Live si sposta su quella riga.
Un ripristino non usa l'IA. Owner, Admin ed Editor possono ripristinare; i Viewer possono vedere l'elenco. Non è possibile mentre è in corso un test A/B. Versioni, annulla e ripeti tratta la stessa cronologia dall'interno dello studio.
Cos'è un deploy hook
Un deploy hook è un indirizzo web privato che pubblica di nuovo il tuo sito ogni volta che qualcosa lo richiama. (Fare il deploy significa pubblicare.) Dai l'indirizzo a un altro strumento, per esempio un servizio di pianificazione, e quello lo richiama quando vuole una nuova pubblicazione.
Una chiamata pubblica di nuovo la versione online a partire dai suoi file, con le impostazioni del progetto così come sono. Non viene eseguita nessuna IA, non viene addebitato nulla e non cambia nulla che tu non abbia già cambiato. Le pagine del tuo sito vengono composte quando viene pubblicato, non a ogni visita, quindi una nuova pubblicazione recepisce:
- gli ultimi record pubblicati dal database del sito, per le pagine costruite a partire da essi;
- le impostazioni che hai cambiato dall'ultima pubblicazione, come il logo, la favicon o le impostazioni di ricerca;
- tutto ciò che una pagina calcola nel momento in cui viene assemblata.
Non applica le modifiche che descrivi, non legge i dati dello strumento che lo chiama e non esegue il controllo prima del lancio.
Crea un deploy hook
Apri Deploy hooks
Dove: Settings, Deploy hooks
Apri il tuo progetto, clicca la scheda Settings, poi Deploy hooks nel gruppo Developer.
Aggiungine uno
Dove: Add a deploy hook
Premi Add deploy hook. Dagli il nome di ciò che lo chiamerà, per esempio
Nightly scheduler, e premi Make hook.Copia l'indirizzo
Dove: Your deploy hook
Briks mostra l'indirizzo una sola volta. Premi Copy e incollalo direttamente nello strumento che lo chiamerà. Briks non ne conserva una copia leggibile, quindi non potrai rivederlo più tardi.
Fine
Dove: Your deploy hook
Premi Done. L'hook entra nell'elenco con la data di creazione e «never called».
Gli hook iniziano a funzionare una volta pubblicato il progetto; fino ad allora la sezione lo indica. Owner, Admin ed Editor possono creare ed eliminare hook.
Chiamare un hook
Lo strumento deve inviare una richiesta POST all'indirizzo (il tipo di richiesta web che chiede di far succedere qualcosa, invece di limitarsi a leggere una pagina). La maggior parte degli strumenti di automazione e pianificazione ha un'impostazione per questo. La finestra mostra la forma di una chiamata fatta da un terminale: curl -X POST https://app.briks.dev/api/hooks/bdh_…, con il tuo indirizzo completo al posto di quello abbreviato.
| Quando arriva la chiamata | Cosa succede |
|---|---|
| Il sito è pronto | Una pubblicazione parte e compare nello studio come tutte le altre. |
| Una build o una pubblicazione è già in corso | La chiamata viene accettata e unita a quella in corso, così una raffica di chiamate pubblica una sola volta. |
| L'hook è stato chiamato sei volte nell'ultima ora | Rifiutato: «Questo hook è stato chiamato sei volte nell'ultima ora. Riprova più tardi.» |
| Il progetto non è mai stato pubblicato | Rifiutato: “The project has not been published yet.” |
| Un test A/B è in corso | Rifiutato: “An A/B test is running on this site. End it by keeping one version first.” |
| Né chi ha creato l'hook né chi ha creato il progetto ha più un account Briks | Rifiutato: «This hook has no owner left. Make a new one in the project's Deploy hooks.» |
| L'hook è stato eliminato | L'indirizzo non funziona più. |
Ogni chiamata aggiorna l'orario dell'ultima chiamata sulla riga dell'hook, così puoi vedere che il tuo strumento funziona.
Un esempio pratico
Il sito del Northside Running Club elenca le prossime gare dai record del suo database. L'organizzatrice ha chiesto nello studio se la pagina delle gare calcola qualcosa in base alla data quando viene pubblicata. La risposta era sì: sceglie le gare ancora da disputare in quel momento. Così ha creato un hook chiamato
Nightly schedulere ha impostato il servizio di pianificazione che già usava per le email del club perché gli invii una POST alle 03:00 ogni notte.
Ogni mattina la pagina delle gare riparte dal giorno corrente. La riga dell'hook mostra quando è stato chiamato l'ultima volta, e Versions guadagna una riga a notte con il riepilogo “Published again with the site's settings.”
Tieni presente che ogni pubblicazione aggiunge una versione, quindi un hook notturno aggiunge circa trenta righe al mese a Versions, e l'elenco mostra le ultime 100. Se non sei sicuro che una pagina dipenda dalla data, chiedi prima nello studio (vedi Fare domande); alle domande si risponde senza una build.
Deploy hook e webhook
| Deploy hook | Webhook | |
|---|---|---|
| Direzione | Un altro strumento chiama Briks | Briks chiama un altro strumento |
| Cosa fa | Pubblica di nuovo il tuo sito | Avvisa lo strumento che è successo qualcosa |
| Quando | Ogni volta che viene chiamato | Su site.published, form.received o record.changed |
| Dove | Settings, Deploy hooks | Settings, Webhooks |
Funzionano bene insieme. Un webhook su site.published può avvisare un altro strumento ogni volta che una pubblicazione finisce, anche una avviata da un deploy hook (vedi Webhooks).
Eliminare un hook
Premi Delete sulla riga dell'hook. La conferma dice “Its address stops working at once.” Premi di nuovo Delete. Gli strumenti che lo chiamano ancora non pubblicheranno nulla, quindi togli l'indirizzo anche da quelli.