Skip to content

bbscout/daruj-potrebne

Repository files navigation

Poptávko - nabídkový formulář materiální pomoci

Poznámka na úvod: Nejsem programátor a nikdy jsem nic nepublikoval open source, tak to prosím omluvte. Za vylepšení kódu i textů budu rád!

Jak to funguje

Webová aplikace funguje na bázi Google Scriptu a napojení na Google Tabulku. Na vygenerované URL se objeví formulář se dvěma záložkami:

  • Poptávkový formulář: Zde může každý zadat dvoji poptávku a základní kontaktní údaje.
  • Nabídkový formulář: Zde se (po obnovení stránky) zobrazí všechny nevyřízené poptávky. Dárce si vybere věci, které chce darovat a vyplní krátký kontaktní formulář a vybere sběrné místo.

V Google tabulce se poptávky zobrazují na listu Poptávky. Ty jsou rovnou vkládány se vzorcem, který po zadání nabídky k dané poptávce zaškrtne, že si někdo "rezervoval" dodání. Takovéto poptávky se pak ve formuláři zobrazují přeškrtnutě. Jakmile dojde k předání požadovaného vybavení, tak správce tabulky zaškrtne u dané poptávky pole "Předáno" a poptávka se již dál veřejně nezobrazuje.

Demo webové aplikace a tabulky

Instalace

1. Vytvoření Google tabulky a otevření editoru Apps Script

Vytvoření tabulky

  • Vytvořte si Google Tabulku v libovolné složce na Google Disku a otevřete jí. (Nemám ověřenou funkčnost na Týmovém disku. Prosím o případnou zpětnou vazbu.)
  • Poznamenejte si ID Tabulky (ta část URL mezi d/ a "/edit" -> ".../d/{ID_TABULKY}/edit...").
  • Klikněte na Rozšíření > Apps Script.

2. Vytvoření souborů Kód.gs a index.html

Vložení kódu

  • Do souboru Kód.gs (defaultně vytvořen) vložte kód ze souboru Kód.gs z tohoto repozitáře.
    • na prvním řádku nahraďte u proměnné GOOGLE_SHEET_ID text ID_GOOGLE_TABULKY vlastním ID, které jste si poznamenali výše
  • Vytvořte soubor index.html (defaultně vytvořen) a vložte do něj kód ze souboru index.html z tohoto repozitáře.
  • Vše uložte pomocí symbolu diskety.

3. Inicializujte tabulku

Inicializace tabulky

  • Z rozevíracího seznamu vyberte funkci init a klikněte na Spustit.
  • Poprvé se vám objeví varování "Je vyžadována autorizace. Tento projekt požaduje oprávnění pro přístup k vašim datům."-
    • klikněte na Zkontroloat oprávnění
    • vyberte Google účet, který bude spouštět skript (musí mít přístup k tabulce)
    • potvrďte oprávnění skriptu v uvedeném rozsahu
  • Pokud vše proběhne správně, pak se vám v tabulce objeví tři nové listy, se kterými bude skript pracovat.
  • Pokud se vám následně v Protokolu o spuštění na spodním okraji stránky objeví červeně chyba, tak máte nejspíš chybně zadané ID taulky.

4. Implementujte skript jako webovou aplikaci

Inicializace tabulky

Inicializace tabulky

  • Klikněte na tlačítko Implementovat > Nová implementace.
  • Vyberte typ implementace Webová aplikace
  • Upravte nastavení následujícím způsobem:
    • Název: Libovolný název implementace
    • Spustit jako:
    • Kdo má přístup: Kdokoli

5. Zkopírujte si URL webové aplikace

Inicializace tabulky

  • zkopírujte si URL webové aplikace

6. Doplňte sběrná místa do Google Tabulky

  • V Google tabulce si na listu Sběrná místa doplňte přehled sběrných míst, který se zobrazí v nabídkovém formuláři. Bez toho to nebude fungovat!

Hotovo

  • webovou aplikaci můžete používat přímo zadáním URL https://script.google..., což není úplně uživatelsky přívětivé

  • můžete použít zkracovač (např. bit.ly)

  • webovou aplikaci můžete vložit pomocí iframe tagu na své stránky:

    <iframe src="https://script.google.com/a/macros/skaut.cz/s/AKfycbypHNCg1pQYvLQX3qSm9xZHA0WgX485TqQO5WLfClfN0Bhnzr_Rme6WATyTojFuEE-TyQ/exec" style="width:100%; height:2000px;">Načítám iframe</iframe>
    • doporučuji přizpůsobit výšku iframu vašim potřebám (upravit v části height:2000px;)

Co je v plánu

  • překlad do ukrajinštiny a angličtiny pomocí knihovny i18n

About

Poptávkový a nabídkový formulář napojený na Google tabulku

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors