Jeden seznam pro každý projekt

Aktualizováno: · Autor: Radim Sekera

První web pro restauraci píšete seznam položek od nuly: logo, úvodní text, příběh restaurace, otevírací doba, galerie fotek jídla a interiéru, možná PDF s menu. U druhého webu pro restauraci píšete skoro stejný seznam znovu — stejné položky, stejná omezení, jiný klient. Šablona existuje přesně proto, aby podruhé stačilo kliknout, ne psát znovu.

Šablona v BriefGate je uložená sada definic položek — klíč, typ, popisek, omezení, všechno — na kterou při zakládání nového sběru podkladů odkážete místo skládání položek jednu po druhé. define_intake (nebo obrazovka Nový sběr v dashboardu) sběr rovnou naplní vším, co šablona nese, a vy si ho pak pro konkrétního klienta můžete dál upravit.

Sestavte seznam jednou

Ve chvíli, kdy si všimnete, že po třetí za sebou žádáte o totéž, je to seznam, který se vyplatí uložit jako šablonu. Nemusí být hned dokonalý — smysl šablony je právě v tom, že se snadno upraví jednou a použije mnohokrát, na rozdíl od jednorázového seznamu položek, který byste museli hlídat a aktualizovat všude, kam jste ho zkopírovali.

Do účtu se šablona dostane dvěma způsoby:

Vlastní šablony — ty, které si postavíte sami — vyžadují tarif Solo nebo vyšší. Na Free vrátí POST /v1/templates chybu plan_required a tlačítko v dashboardu tam ani není. Není to ale omezení, se kterým byste dlouho bojovali — Free má pořád k dispozici tři vestavěné šablony níže, každá pro reálný typ projektu.

Tři, které nemusíte stavět sami

Ve všech tarifech včetně Free jsou od prvního dne k dispozici tři veřejné šablony:

Všechny tři jsou české šablony — jejich popisky a nápovědy jsou psané česky, protože vznikly pro reálnou agenturní praxi, ne jako obecné zástupné texty. (Vestavěná e-shopová šablona momentálně neexistuje; club-web-cs je pro kluby a spolky, ne pro e-shopy.) Nelze je smazat a jsou tam pořád, takže jsou bezpečným výchozím bodem, i kdybyste nakonec polovinu položek změnili.

Šablonu předáte define_intake v poli template:

json
{
  "project_name": "Bella Cucina Restaurant Website",
  "client": { "email": "owner@bellacucina.cz", "name": "Marco" },
  "template": "restaurant-web-cs"
}

Jakmile je template vyplněné, pole items je nepovinné — vynecháte ho, nebo pošlete "items": [], a všechny položky přijdou ze šablony. Bez template je items pořád povinné a nesmí být prázdné, stejně jako dřív.

Co jednotlivé typy validují, najdete v Typy položek, plné tabulky položek všech tří šablon pak v Šablony.

Upravte, aniž byste začínali znovu

Šablona málokdy sedne na projekt beze zbytku a nemusí. Když k template pošlete i pole items, BriefGate ho se šablonou sloučí: key, který se shoduje s položkou ze šablony, ji přebije, nový key se připojí za položky ze šablony.

json
{
  "template": "restaurant-web-cs",
  "items": [
    {
      "key": "menu_pdf",
      "type": "file",
      "label": "Jídelní lístek (PDF)",
      "required": false,
      "help": "Potřeba jen tehdy, když chcete jídelní lístek ke stažení."
    },
    {
      "key": "allergen_info",
      "type": "file",
      "label": "Dokument s informacemi o alergenech",
      "required": false
    }
  ]
}

Jedna věc, kterou dobré vědět předem: každá položka v poli items musí být úplná definice — key, type i label jsou povinné vždy — i když chcete změnit jen to, jestli je položka povinná. Zkratka pro úpravu jednoho pole položky ze šablony neexistuje.

Nesou se i jiná nastavení

Šablona umí vedle položek uložit i všechna ostatní nastavení, která nový sběr potřebuje: cyklus upomínek, pravidla retence, branding, do jaké složky nové sběry padají, i brief pro klienta. POST /v1/templates přijímá volitelný objekt settings s poli due_in_days, chase_schedule, respect_quiet_hours, max_reminders, email_copy, retention, branding, folder_id a dalšími — celý seznam je v Šablony.

Jde o výchozí hodnoty, ne o přebití: když se sběr zakládá ze šablony, pole z settings se použije, jen když ho požadavek na založení sběru sám nevyplní. Cokoli požadavek nastaví explicitně, vždy vyhraje. due_in_days se v okamžiku založení sběru přepočítá na skutečné due_date — šablona nemůže nést pevné kalendářní datum, jen posun od chvíle, kdy se použije.

Zatím je to jen přes API. Tlačítko Uložit jako šablonu v dashboardu stále ukládá jen položky a jazyk; pokud chcete šablonu, která nastaví i cyklus upomínek nebo branding, postavte ji přes POST /v1/templates.

Kde se to vyplatí

První projekt s novou šablonou stojí stejně času jako dřív — pořád rozhodujete, o co požádat, a píšete nápovědy, aby každá položka dávala smysl klientovi, který podobný formulář nikdy nevyplňoval. Vyplatí se to až u druhého projektu: nasměrujete define_intake na šablonu, doplníte dvě tři věci, které jsou u tohoto klienta jiné, a odešlete. Z dvaceti minut psaní definic položek je tak pár minut doplnění jména klienta a úpravy jednoho termínu.

V tarifu Agency se tahle výhoda automaticky přenáší na celý tým — šablonu vytvořenou kterýmkoli uživatelem vidí všichni na účtu, bez zvláštního kroku pro sdílení. Pokud si stavíte knihovnu pro víc typů projektů, konzistentní pojmenování slugů (restaurant-web-v2, advisor-web-minimal, webapp-onboarding) usnadní orientaci, jak seznam poroste.

Související

Související návody

Nejste vývojář? Podívejte se na stránku pro sběr podkladů nebo projděte všechny návody.