Versions publiées et deploy hooks
Chaque publication de votre site est conservée comme une version numérotée, et la section Versions des Settings du projet les liste. Les Deploy hooks, dans les mêmes Settings, permettent à un autre outil de demander à Briks de publier de nouveau votre site. Cette page couvre les deux.
La liste des versions publiées
La section liste les 100 dernières versions, de la plus récente à la plus ancienne. Chaque ligne indique :
- Version et son numéro, avec une étiquette verte Live sur celle que voient les visiteurs en ce moment.
- Comment il est né : Built, Changed, Checked and repaired ou Published again, et qui l'a demandé.
- La date et l'heure de publication, par exemple 8 oct. 2026, 14:32.
- Un court résumé. Pour une modification, ce sont les mots de votre demande ; pour une création ou une nouvelle publication, c'est ce que Briks a fait.
- Une fois qu'une version est en ligne depuis une semaine, une ligne indique si elle a aidé (voir plus bas).
| Libellé | Ce qui a produit la version |
|---|---|
| Built | Une première création, ou un nouveau projet copié depuis un modèle ou un autre projet |
| Changed | Un changement que vous avez demandé, du code enregistré dans File Explorer, ou une image remplacée depuis la médiathèque |
| Checked and repaired | Une vérification du site qui a corrigé ce qu'elle a trouvé |
| Published again | Un passage en production ou un retour à l'aperçu, Apply to the live site, une nouvelle adresse, un domaine mis en ligne, ou un deploy hook. Son résumé dit lequel, par exemple « Published again with the site's settings. » |
Pour chaque tâche du projet, y compris celles qui n'ont rien publié, voir Journaux.
Le changement a-t-il aidé ?
Une fois qu'une version est en ligne depuis 7 jours, sa ligne gagne une phrase qui compare les visites avant elle et depuis elle, pour les pages que la version a changées, chacune en moyenne hebdomadaire sur 14 jours au plus de chaque côté. Elle se lit par exemple : « Since version 12 (Add a prices section), enquiries from /prices went from 3 to 5 a week, on similar visits. » Quand ces pages avaient moins de 25 visiteurs par semaine, elle indique qu'il y a trop peu de visites pour conclure. Un changement fait par un agent est attribué à cet agent. La phrase est calculée à partir de vos propres statistiques, sans IA et sans coût. Les versions simplement republiées, et la première construction, n'ont pas de phrase. Les 12 dernières versions sont lues, et une lecture est définitive une fois 14 jours passés.
Restaurer une version
Trouver la version
Où : Settings, Versions
Chaque ligne, sauf celle en ligne, a un bouton Restore, si votre rôle vous permet de modifier le projet.
Le restaurer
Où : Restore version
Appuyez sur Restore. La boîte de dialogue indique « It goes back on the live site exactly as it was published. The versions after it stay saved, so you can come back. » Appuyez sur Restore version suivi du numéro.
Regardez-le se publier
Où : Studio
Briks vous renvoie vers le studio pendant la publication. Le message indique par exemple : « Version 12 is live again, exactly as it was published. » Le badge Live passe sur cette ligne.
Une restauration n'utilise aucune IA. Les Owners, Admins et Editors peuvent restaurer ; les Viewers peuvent voir la liste. C'est impossible pendant qu'un test A/B est en cours. Versions, annuler et rétablir présente le même historique depuis l'intérieur du studio.
Ce qu'est un deploy hook
Un deploy hook est une adresse web privée qui republie votre site chaque fois que quelque chose l'appelle. (Déployer, c'est publier.) Vous donnez cette adresse à un autre outil, par exemple un service de planification, et cet outil l'appelle quand il veut une nouvelle publication.
Un appel publie de nouveau la version en ligne à partir de ses propres fichiers, avec les réglages du projet tels qu'ils sont. Aucune IA ne tourne, rien n'est facturé, et rien ne change que vous n'ayez déjà modifié. Les pages de votre site sont assemblées à la publication, et non à chaque visite : une nouvelle publication prend donc en compte :
- les derniers enregistrements publiés de la base de données du site, pour toutes les pages qui en sont issues ;
- les paramètres que vous avez modifiés depuis la dernière publication, comme le logo, le favicon ou les réglages de recherche ;
- tout ce qu'une page calcule au moment où elle est assemblée.
Il n'applique pas les modifications que vous décrivez, ne lit pas les données de l'outil qui l'appelle et ne lance pas la vérification de lancement.
Créer un deploy hook
Ouvrir Deploy hooks
Où : Settings, Deploy hooks
Ouvrez votre projet, cliquez sur l'onglet Settings, puis sur Deploy hooks dans le groupe Developer.
En ajouter un
Où : Add a deploy hook
Appuyez sur Add deploy hook. Nommez-le d'après ce qui l'appellera, par exemple
Nightly scheduler, puis appuyez sur Make hook.Copier l'adresse
Où : Your deploy hook
Briks affiche l'adresse une seule fois. Cliquez sur Copy et collez-la directement dans l'outil qui l'appellera. Briks n'en garde aucune copie lisible, vous ne pourrez donc plus la revoir ensuite.
Terminer
Où : Your deploy hook
Appuyez sur Done. Le hook rejoint la liste avec sa date de création et « never called ».
Les hooks fonctionnent une fois le projet publié ; d'ici là, la section l'indique. Les Owners, Admins et Editors peuvent créer et supprimer des hooks.
Appeler un hook
L'outil doit envoyer une requête POST à l'adresse (le type de requête web qui demande qu'une action ait lieu, plutôt que de simplement lire une page). La plupart des outils d'automatisation et de planification ont un réglage pour cela. La boîte de dialogue montre la forme d'un appel passé depuis un terminal : curl -X POST https://app.briks.dev/api/hooks/bdh_…, avec votre adresse complète à la place de la version abrégée.
| Quand l'appel arrive | Ce qui se passe |
|---|---|
| Le site est prêt | Une publication démarre et s'affiche dans le studio comme n'importe quelle autre. |
| Une création ou une publication est déjà en cours | L'appel est accepté et rattaché à celui en cours, donc une rafale d'appels ne publie qu'une seule fois. |
| Le hook a été appelé six fois dans la dernière heure | Refusé : « This hook was called six times in the last hour. Try again later. » |
| Le projet n'a jamais été publié | Refusé : « The project has not been published yet. » |
| Un test A/B est en cours | Refusé : « An A/B test is running on this site. End it by keeping one version first. » |
| Ni la personne qui a créé le hook ni celle qui a créé le projet n'a encore de compte Briks | Refusé : « Ce hook n'a plus de propriétaire. Créez-en un nouveau dans les Deploy hooks du projet. » |
| Le hook a été supprimé | L'adresse ne fonctionne plus. |
Chaque appel met à jour l'heure du « dernier appel » sur la ligne du hook, ce qui vous permet de voir que votre outil fonctionne.
Un exemple concret
Le site du Northside Running Club liste les courses à venir à partir d'enregistrements de sa base de données. Son organisatrice a demandé dans le studio si la page des courses calcule quelque chose à partir de la date au moment de la publication. La réponse était oui : elle choisit les courses encore à venir à cet instant. Elle a donc créé un hook appelé
Nightly scheduleret réglé le service de planification qu'elle utilisait déjà pour les e-mails du club afin qu'il lui envoie un POST à 03:00 chaque nuit.
Chaque matin, la page des courses repart de ce jour. La ligne du hook indique quand il a été appelé pour la dernière fois, et Versions gagne une ligne chaque nuit avec le résumé « Published again with the site's settings. »
Gardez à l'esprit que chaque publication ajoute une version : un hook nocturne ajoute donc environ trente lignes par mois dans Versions, et la liste affiche les 100 dernières. Si vous ne savez pas si une page dépend de la date, posez d'abord la question dans le studio (voir Poser des questions) ; les questions reçoivent une réponse sans construction.
Deploy hooks et webhooks
| Deploy hook | Webhook | |
|---|---|---|
| Direction | Un autre outil appelle Briks | Briks appelle un autre outil |
| Ce que ça fait | Publie à nouveau votre site | Signale à l'outil qu'un événement s'est produit |
| Quand | Chaque fois qu'il est appelé | Sur site.published, form.received ou record.changed |
| Où | Settings, Deploy hooks | Settings, Webhooks |
Ils fonctionnent bien ensemble. Un webhook sur site.published peut informer un autre outil à chaque fin de publication, y compris celle lancée par un deploy hook (voir Webhooks).
Supprimer un hook
Appuyez sur Delete sur la ligne du hook. La confirmation indique « Its address stops working at once. » Appuyez de nouveau sur Delete. Les outils qui l'appellent encore n'obtiennent aucune publication : retirez-y donc aussi l'adresse.