Popis
Elektilo přidá na jakoukoli stránku se shortcodem [elektilo] interaktivní kvíz typu „pomozte mi vybrat“. Nakupující zodpoví krátkou řadu otázek s jednou možností výběru a zobrazí se jim jeden doporučený produkt s obrázkem, cenou a tlačítkem přímo na stránku produktu.
Elektilo je vyvíjen otevřeně. Kód a místo pro hlášení chyb nebo požadavků na nové funkce najdete na github.com/wppoland/plogins-finder.
Definujete otázky a možnosti a poté namapujete každou kombinaci odpovědí na produkt. Tlačítko „Vygenerovat kombinace“ vytvoří mapu z vašich kroků, takže už jen vyberete produkt pro každou cestu.
Dokumentace a odkazy
- Dokumentace: plogins.com/plogins-finder/docs/
- Stránka pluginu: plogins.com/plogins-finder/
- Zdrojový kód: github.com/wppoland/plogins-finder
- Hlášení chyb a požadavky na funkce: github.com/wppoland/plogins-finder/issues
Vytvořeno pro rychlost a přístupnost
- Žádné jQuery ve vlastním frontendovém kódu pluginu, skript je čistý JS (vanilla JS), odložený a načítaný v zápatí.
- Žádný posun rozvržení (CLS). Pro každý krok i kartu výsledku je vyhrazen prostor, takže přechod mezi kroky nezpůsobuje překreslování stránky. Obrázek doporučeného produktu má prioritu pro rychlé LCP.
- Výsledek poháněný přes REST. Doporučení se načítá z odlehčeného koncového bodu REST (nikoli admin-ajax), čte se živě, takže cena i skladová dostupnost jsou vždy aktuální, a nikdy se neukládá do mezipaměti.
- Přívětivé pro klávesnici. Skutečné přepínače (radio buttons), živý indikátor průběhu, viditelný fokus, tlačítko Zpět a plná ovladatelnost pomocí klávesnice.
- Možnost pokračování i sdílení. Aktuální krok i odpovědi se ukládají do URL a do úložiště dané záložky, takže obnovení stránky zachová vaši pozici a odkaz s kompletně zodpovězenými otázkami se otevře přímo s výsledkem.
Nastavení
Stránka nastavení vyžadující oprávnění pro správu WooCommerce (menu Elektilo) vám umožňuje:
- Povolte nebo zakažte kvíz, nastavte hlavní nadpis, podnadpis i barvu zvýraznění a zvolte, zda se má na kartě výsledku zobrazovat cena.
- Vytvořte kroky: každý krok představuje jednu otázku s možnostmi s jednou volbou; „hodnota“ možnosti je krátký název v URL sloužící k identifikaci odpovědi.
- Namapujte výsledky: vygenerujte jeden řádek pro každou kombinaci odpovědí z vašich kroků a poté pro každou z nich vyberte doporučený produkt s volitelným nadpisem, popisem a textem tlačítka. Přehledné upozornění zobrazuje, kolik kombinací stále vyžaduje přiřazení produktu.
- Nastavte záložní produkt, který se zobrazí, pokud žádná kombinace neodpovídá nebo namapovaný produkt není dostupný.
Připraveno k překladu
Všechny textové řetězce lze překládat pomocí textové domény elektilo a šablona elektilo.pot je dodávána v /languages. Smazáním pluginu se odstraní i jeho nastavení.
Jak to funguje
Kvíz se vykresluje na straně serveru (takže jej lze ukládat do mezipaměti společně se stránkou) a posun mezi kroky probíhá zcela na straně klienta bez dodatečných síťových požadavků mezi jednotlivými kroky. Načítá se pouze závěrečné doporučení prostřednictvím REST požadavku (same-origin) na váš vlastní web a vykresluje se nově, aby byly cena a skladová dostupnost vždy aktuální. CSS a JavaScript se načítají pouze na stránkách, které obsahují shortcode [elektilo].
Externí služby
Elektilo se nepřipojuje ani neodesílá žádná data na žádnou externí službu ani server třetí strany. Neobsahuje žádné SDK, API klienta, webové písmo, mapové podklady, assety z CDN ani analytická volání – vše běží na vašem vlastním webu.
Všechna data zůstávají v databázi WordPressu: otázky, možnosti, mapa výsledků a nastavení se nacházejí ve volbě finder_settings (přičemž finder_db_version sleduje schéma). Když nakupující dokončí kvíz, jeho odpovědi se odešlou v REST požadavku na vlastní koncový bod webu /wp-json/ v rámci stejného původu (same-origin), který vrátí doporučení; neprobíhá žádný odchozí HTTP požadavek. Aktuální krok a odpovědi se také ukládají v URL stránky a v úložišti relace prohlížeče pro danou záložku, takže v kvízu lze pokračovat. Smazáním pluginu se odstraní i jeho nastavení.
Snímky obrazovky



Instalace
- Nahrajte plugin do
/wp-content/plugins/elektilonebo jej nainstalujte přes Pluginy > Přidat nový. - Aktivujte jej. WooCommerce musí být aktivní.
- Přejděte do menu Elektilo ve wp-admin, vytvořte jednotlivé kroky, vygenerujte kombinace, pro každou z nich vyberte produkt a poté kvíz povolte.
- Přidejte kvíz na libovolnou stránku nebo příspěvek pomocí shortcodu
[elektilo].
Nejčastější dotazy
-
Vyžaduje WooCommerce?
-
Ano. Elektilo vyžaduje aktivní instalaci WooCommerce.
-
Používá jQuery?
-
Ne. Vlastní frontendový skript pluginu je čistý JavaScript (vanilla JavaScript) bez závislosti na jQuery.
-
Kam mohu kvíz umístit?
-
Kdekoli, kde lze použít shortcode
[elektilo]– stránka, příspěvek nebo blok pro čisté HTML / shortcode v editoru stránek. -
Kolik otázek mohu položit?
-
Kolik kroků chcete, každý s tolika možnostmi s jedním výběrem, kolik potřebujete. Nejlepší konverze mívají dva nebo tři krátké kroky.
-
Co se stane na konci?
-
Nakupující uvidí jeden doporučený produkt, jeho obrázek, volitelně cenu, volitelný nadpis a popis a tlačítko na stránku produktu. Pokud žádná kombinace neodpovídá nebo namapovaný produkt není dostupný, zobrazí se záložní produkt.
-
Je cena ve výsledku vždy aktuální?
-
Ano. Doporučení se načítá živě přes REST při každém požadavku a nikdy se neukládá do mezipaměti, takže cena i skladová dostupnost odpovídají aktuálnímu stavu obchodu v danou chvíli.
-
Funguje tento plugin v prostředí WordPress Síť webů?
-
Ano. Můžete jej aktivovat pro celou síť webů nebo na jednotlivých webech; každý web si uchovává své vlastní nastavení.
Autoři
Elektilo – Product Finder Quiz for WooCommerce je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.
SpolupracovníciPlugin „Elektilo – Product Finder Quiz for WooCommerce“ byl přeložen do 4 jazyků. Děkujeme všem překladatelům za jejich pomoc.
Přeložte “Elektilo – Product Finder Quiz for WooCommerce” do svého jazyka.
Zajímá vás vývoj?
Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.
Přehled změn
1.1.5
- Obrazovka nastavení zobrazovala shortcode jako [finder], což se vypisuje jako prostý text. Nyní zobrazuje [elektilo].
- Hodnota odpovědi s mezerou nebo interpunkcí, například „home gym“, byla v kroku uložena jako „homegym“, ale v mapě výsledků jako „home-gym“, takže nakupující, kteří ji zvolili, vždy obdrželi záložní produkt. Obě místa nyní používají stejnou hodnotu; pro opravu kvízu vytvořeného před touto verzí znovu uložte nastavení a přegenerujte kombinace.
- Klávesy se šipkami se nyní pohybují mezi odpověďmi bez odeslání kroku, takže každá odpověď je dostupná z klávesnice. Mezerník, Enter nebo kliknutí zvolí odpověď, včetně té již vybrané.
- Po stisknutí tlačítka Zpět kliknutí na již vybranou odpověď znovu pokračuje dál, místo aby se nic nestalo.
- Zpětná lomítka v názvu, otázkách a textech výsledků jsou při uložení zachována.
- Byla odstraněna nepoužívaná tabulka finder_compare_items, kterou vytvářely dřívější verze; odinstalace ji nyní také odstraní.
1.1.4
- Výběr produktů zobrazoval pouze prvních 200 produktů, takže větší obchody nemohly zvolit ostatní. Nyní při psaní prohledává celý katalog pomocí stejného vyhledávacího pole jako WooCommerce.
1.1.3
- Plugin URI v záhlaví vracelo chybu 404. Stránka, na kterou odkazuje, je již publikována a stejná kontrola proběhla u všech pluginů z této řady.
1.1.2
- Pojmenováno Elektilo. Schvalovací tým WordPress.org vyžaduje, aby název pluginu začínal osobitým, nově vytvořeným identifikátorem namísto obecného popisného slova. Elektilo je v esperantu nástroj, který vybírá, což přesně odpovídá účelu tohoto kvízu. Textová doména následuje název; uložená data, nastavení i všechny hooky zůstávají beze změny.
- Shortcode je nyní
[elektilo]. Původně byl[finder], což je štítek natolik obecný, že by si jej mohl dříve nárokovat jakýkoli jiný plugin. Toto je poslední vydání, ve kterém jej bylo možné změnit bez narušení existujících stránek, protože plugin ještě nebyl publikován. - V menu administrace se nyní zobrazuje Elektilo místo Product Finder a byla aktualizována místa v dokumentaci, kde byl stále uveden název Finder.
1.0.10
- Opraveno: symboly šipek v cestách v menu administrace a v řetězcích předávaných překladatelům. Šipka uvnitř přeložitelného řetězce způsobuje komplikace překladatelům a mění rozvržení v jakékoli lokalizaci, která ji vynechá.
1.0.9
- Stručný popis měl 151 znaků, což bylo o jeden znak více, než povoluje WordPress.org, takže jej katalog pluginů usekl uprostřed věty. Byl zkrácen o jedno slovo; význam zůstává nezměněn.
1.0.8
- Šablona překladu byla přegenerována. Stále uváděla starší verzi pluginu a odkazovala na řádky zdrojového kódu, které se mezitím posunuly, z nichž překladatelské nástroje čerpají informace pro zobrazení kontextu řetězce.
1.0.7
- Přejmenováno na Plogins Finder – Product Finder Quiz for WooCommerce, aby název začínal značkou namísto obecného slova, což vyžaduje schvalovací tým pluginů na WordPress.org. Název pluginu v URL zůstává nezměněn.
1.0.6
- Otestováno s WordPress 7.1. Ověřeno aktivací tohoto sestavení na čisté instalaci 7.1 s WooCommerce 11.1, nikoli úpravou záhlaví.
1.0.5
- Vylepšení přístupnosti v administraci i ve značkování na webu.
1.0.4
- Opraveno: na počítači se stránka při načtení již neposouvá dolů ke kvízu (fokus nyní používá preventScroll).
- Opraveno: URL zůstává při první návštěvě čisté, stav kvízu (?fa=&fs=) se zapíše až poté, co návštěvník odpoví.
1.0.3
- Byla přidána možnost „Otevřít v nové záložce“, takže se doporučený produkt otevře v nové záložce prohlížeče.
1.0.2
- První stabilní verze: řízený krokový kvíz pro výběr produktů s přehlednou administrací kroků/výsledků, živým doporučením přes REST, přístupným frontendem v čistém JS (vanilla JS) a nulovým posunem rozvržení. Indikátory možností ve stylu přepínačů, decentní animace (s ohledem na preferenci omezení pohybu) a polský překlad.
