Vytvořte nový prostředek v kořenovém adresáři stromu

Dnešní lekce je o tom, jak implementovat vyhledávání na webu v Modx Revolution pomocí komponenty SimpleSearch.

Hlavní parametry úryvku:

1. SimpleSearch

2. Řešíme různé problémy s kódováním atp.

Přejděte na adresu core/components/simplesearch/model/simplesearch/simplesearch.class.php a nahraďte v ní následující řádky:

řádek 297:

$text = preg_replace("/(\[\[\+.*?\]\])/i", "", $text);

nahradit s

$text = preg_replace("/(\[\[\+.*?\]\])/iu", "", $text);

řádek 311:

$text = trim(preg_replace("/\s+/", " ", $this->sanitize($text)));

nahradit s

$text = trim(preg_replace("/\s+/u", " ", $this->sanitize($text)));

řádek 413:

$string = preg_replace("/" . $quoteValue . "/i", "$0", $string);

nahradit s

$string = preg_replace("/" . $quoteValue . "/iu", "$0", $string);

komentovat řádek 179:

If (!empty($str)) $this->searchString = strip_tags($this->modx->sanitizeString($str));

těch. mělo by to dopadnout takto

/*if (!empty($str)) $this->searchString = strip_tags($this->modx->sanitizeString($str)); */

3. Vytvořte kopie všech standardních bloků, které jsou v adresáři core/components/simplesearch/elements/chunks/

Vytváříme nové kusy se stejnými názvy a předponou -new a stejným obsahem (jen už nejsou souborové, ale obyčejné), u kterých to všechno dále pochopíte.

Například vezmeme první blok currentpagelink.chunk.tpl a vytvoříme nový blok currentpagelink-new (prvky - vytvořit nový blok) a přeneseme do něj kód.

[[+text]]

Zodpovědný za správu tlačítka ve stránkování aktivní stránky.

A stejným způsobem vytvoříme zbytek kousků:

- pagelink-new - odpovídá za zobrazení samostatného tlačítka stránkování.

[[+text]]

• [[+odkaz]] - odkaz na dokument
• [[+text]] - číslo dokladu

- searchform-new - vyhledávací formulář

[[%sisea.search? &namespace=`sisea` &topic=`výchozí`]]

- výsledky hledání nelze přenést - neexistuje žádný design;

- searchresult-new - výstup každé položky výsledku.

[[+idx]]. [[+pagetitle]]

[[+výpis]]

• [[+idx]] - číslo výsledku hledání v seznamu
• [[+link:is=``:then=`[[~[+id]]]]`:else=`[[+link]]`]]
• [[+longtitle]] - rozšířený název
• [[+pagetitle]] - název
• [[+extract]] – text, podle kterého byl tento dokument nalezen

- searchresultli - ve skutečnosti to také nemůžete přenést.

- searchresults-new - obálka všech výsledků

[[+resultInfo]]

• [[+resultInfo]] - informace o počtu nalezených dokumentů a pro jakou frázi.
• [[+sisea.result_pages? &namespace=`sisea` &topic=`výchozí`]]

  Výstup fráze „Stránky s výsledky vyhledávání:“

• [[+paging]] - stránkování
• [[+results]] - výsledky hledání

Po dokončení všeho byste měli mít 5 nových kousků.

4. Vytvořte nový dokument, ve kterém se zobrazí výsledky hledání

Název: Výsledky vyhledávání, zaškrtněte políčko „Nezobrazovat v nabídce“. V "Nastavení" a zrušte zaškrtnutí políček "Vyhledatelné", "Použít HTML editor". šetříme. Obnovte stránku a přidejte obsah

[[!SimpleSearch? &tpl=`searchresult-new` &containerTpl=`searchresults-new` &pageTpl=`pagelink-new` ¤tPageTpl=`currentpagelink-new`]]

kousky dekorace, které jste vytvořili v kroku 3 (vzhled).

Pokud chcete, aby byly obrázky ve výsledcích vyhledávání, přidejte je na konec tohoto výstupu

&includeTVs=`1` &processTVs=`1`

V bloku výsledků vyhledávání lze obrázek nazvat takto: [[+img]].

5. Zobrazte vyhledávací formulář

Na místo, kde chcete zobrazit vyhledávací formulář, napište

[[!SimpleSearchForm? &landing=`11` &tpl=`searchform-new`]]

Zde landing je id stránky s výsledky vyhledávání, v tpl jsou části návrhu formuláře, které byly vytvořeny v kroku 3.

Kroky 4 a 5 jsme provedli, abychom mohli upravit externí design podle našeho uvážení: samotný formulář, výsledky vyhledávání atd. aniž byste se dostali do zdrojového kódu. A standardní provedení je spíše tristní, například takto vypadá standardní vyhledávací formulář.

6. Změňte design.

Nevidím smysl v popisování toho, jak uspořádat všechny části, například dám nový design pro vyhledávací formulář – nový chunk

Toto je obvyklé standardní označení formuláře z bootstrapu 3, na webu to vypadá takto:

Oficiální dokumentace zde: docs.modx.com/extras/revo/simplesearch

Pokud máte dotazy, pište zeptejte se jich do komentářů.

SimpleSearch je standardní balíček pro vyhledávání na stránkách v modx revoluci. K němu přidáme ajaxovou žádost o živé vyhledávání. Příklad si můžete prohlédnout na stejném webu, funguje to docela jednoduše a, povšimněte si, se stránkováním. Fragment SimpleSearchForm (vyhledávací formulář) odešle požadavek ajax na jednu stránku s výsledky, která vykreslí úryvek SimpleSearch.

1 Stáhněte si populární vyhledávací balíček SimpleSearch z repozitáře modx revo a nainstalujte jej.
Vytvoříme zdroj s prázdnou šablonou, aby ajax mohl shromažďovat data a odesílat je, když jsou ve vyhledávacím formuláři zadány požadavky.
Nazvěme alias například „výsledky vyhledávání“, k němuž bude mít přístup ajax.
Obsah zdroje:

výsledky hledání if(typeof jQuery !== undefined) ( $(document).ready(function() ( $(".sisea-page a").click(function(event) ( // stránkování event.preventDefault(); // Zabrání prohlížeči procházet stránkami // Načte další vyhledávací stránku a zobrazí kontejner $("#site-search-results").load($(this).attr("href")).show() ; return false; // stub )); )); ) [[!SimpleSearch]]

2 Nyní umístíme vyhledávací formulář na místo, které vám vyhovuje, za to odpovídá úryvek „SimpleSearchForm“.
Zpravidla se vyhledávací formulář strčí do modx šablon.
Element div zobrazuje výsledky požadavku ajax.

[[!SimpleSearchForm]]

3 Připojte ajax k odesílání požadavků z formuláře na stránku, kterou jsme vytvořili v kroku 1.
(!) Nezapomeňte zahrnout jquery
(!) Ujistěte se, která adresa ajax přistupuje k prostředku. Na 2 místech je za to zodpovědná metoda load().

// SimpleSearch ajax $(document).ready(function() ( // Tlačítko $(".sisea-search-form").submit(function () ( // zrušte komentář, pokud potřebujete tlačítko // $("# site- search-results").load("/search-results/",$(".sisea-search-form").serialize()).slideDown("fast"); return false; )); // Živé vyhledávání $(".sisea-search-form input").keyup(function() ( if(this.value.length > 2) ( // Uživatel zadá více než 2 znaky do vyhledávacího řetězce // skryje/zobrazí výsledky mimo okna $(document).click(function(event)( // hide if ($(event.target).closest(".site-search-results").length) return; $(".site-search- výsledky" ).slideUp("fast"); //event.stopPropagation(); )); $("#search").click(function() ( // display $(".site-search-results") .slideDown ("fast"); return false; )); // požadavek ajax načtení výsledků vyhledávání ze stránky a zobrazení kontejneru $("#site-search-results").load("/search-results/", $(". sisea-search-form").serialize()).slideDown("fast"); ) else ( // Pokud je méně než 2 znaky, skryjte kontejner (CSS display:none;) $("#site- search-results" ).slideUp("rychle"); ))); ));

4 Připojíme css pro zobrazení výsledků ajax efektu skrytí a rozbalení okna a jeho nezbytných stylů zobrazení, to vše na minimum. Zbytek stylů dokončete sami, jak je popsáno v manuálu balíčku SimpleSearch v modx revolution.

/* SimpleSearch ajax */ .site-search-results ( display:none; position:absolute; text-align:left; padding:15px; background:#F7F7F7; border-radius:5px; -webkit-border-radius:5px ; -moz-border-radius:5px; box-shadow: 2px 3px 9px -2px rgba(50, 50, 50, 0,55); -webkit-box-shadow: 2px 3px 9px -2px rgba(50, 50, 50, 0,55); -moz-box-shadow: 2px 3px 9px -2px rgba(50, 50, 50, 0,55); )

Tlačítko vyhledávání ve fragmentu SimpleSearchForm lze zcela odstranit
protože ajax již zachycuje stisknutí tlačítka Enter.

Tento úryvek zobrazuje výsledky vyhledávání na základě odeslaných kritérií vyhledávání.

Jednoduše vložte úryvek do zdroje, ve kterém chcete zobrazit výsledky vyhledávání.

[[!SimpleSearch]]

V SimpleSearch jsou zpracovány 4 bloky. Jejich odpovídající parametry SimpleSearch jsou:

• tpl – Blok, který se má použít pro každý zobrazený výsledek.
• containerTpl – Blok, který bude použit k zabalení všech výsledků vyhledávání, stránkování a zprávy.
• pageTpl – Chunk, který se má použít pro stránkovací odkaz.
• currentPageTpl – Blok, který se má použít pro aktuální odkaz stránkování.

Vyhledávání vlastních tabulek je dostupné v SimpleSearch pomocí vlastnosti &customPackages; musíte však mít vytvořený vlastní balíček. Formát je:

ClassName:fieldName(s):packageName:packagePath:joinCriteria||class2Name:fieldName(s):package2Name:package2Path:join2Criteria

Jinými slovy, každý vlastní balíček je oddělen ||. Poté je každá jeho část oddělena dvojtečkami (:). Příklad vyhledávání komentářů Quip:

&customPackages=`quipComment:body:quip:(core_path)components/quip/model/:quipComment.resource = modResource.id`

Pojďme si jednotlivé části rozebrat:

• className – Název třídy tabulky, kterou chcete prohledávat. Tady je to QuipComment.
• fieldName(s) – čárkami oddělený seznam názvů sloupců k vyhledávání. Udělali jsme "tělo", mohli jste také udělat "tělo, e-mail" nebo cokoli jiného.
• packageName – Název schématu Balíček, který se má přidat. Tenhle se jmenuje Quip.
• packagePath - Cesta k adresáři model/, kde je balíček umístěn.
• joinCriteria – SQL pro připojení k tabulce, kterou chcete prohledat, ak tabulce modResource. Vaše tabulka musí mít nějaké spojení se zdrojem, na kterém se nachází (jinak SimpleSearch nebude vědět, jak pro ni načíst adresu URL!)

Jakmile jej přidáte, prohledá data i v těchto polích. Pokud je najde v této tabulce, zobrazí výsledek jako odkaz na zdroj, který jste zadali v kritériích spojení. V našem příkladu by to byl zdroj, na kterém se nachází komentář Quip.

Dnešní lekce je o tom, jak implementovat vyhledávání na webu v Modx Revolution pomocí komponenty SimpleSearch.

Hlavní parametry úryvku:

1. SimpleSearch

2. Řešíme různé problémy s kódováním atp.

Přejděte na adresu core/components/simplesearch/model/simplesearch/simplesearch.class.php a nahraďte v ní následující řádky:

řádek 297:

$text = preg_replace("/(\[\[\+.*?\]\])/i", "", $text);

nahradit s

$text = preg_replace("/(\[\[\+.*?\]\])/iu", "", $text);

řádek 311:

$text = trim(preg_replace("/\s+/", " ", $this->sanitize($text)));

nahradit s

$text = trim(preg_replace("/\s+/u", " ", $this->sanitize($text)));

řádek 413:

$string = preg_replace("/" . $quoteValue . "/i", "$0", $string);

nahradit s

$string = preg_replace("/" . $quoteValue . "/iu", "$0", $string);

komentovat řádek 179:

If (!empty($str)) $this->searchString = strip_tags($this->modx->sanitizeString($str));

těch. mělo by to dopadnout takto

/*if (!empty($str)) $this->searchString = strip_tags($this->modx->sanitizeString($str)); */

3. Vytvořte kopie všech standardních bloků, které jsou v adresáři core/components/simplesearch/elements/chunks/

Vytváříme nové kusy se stejnými názvy a předponou -new a stejným obsahem (jen už nejsou souborové, ale obyčejné), u kterých to všechno dále pochopíte.

Například vezmeme první blok currentpagelink.chunk.tpl a vytvoříme nový blok currentpagelink-new (prvky - vytvořit nový blok) a přeneseme do něj kód.

[[+text]]

Zodpovědný za správu tlačítka ve stránkování aktivní stránky.

A stejným způsobem vytvoříme zbytek kousků:

- pagelink-new - odpovídá za zobrazení samostatného tlačítka stránkování.

[[+text]]

• [[+odkaz]] - odkaz na dokument
• [[+text]] - číslo dokladu

- searchform-new - vyhledávací formulář

[[%sisea.search? &namespace=`sisea` &topic=`výchozí`]]

- výsledky hledání nelze přenést - neexistuje žádný design;

- searchresult-new - výstup každé položky výsledku.

[[+idx]]. [[+pagetitle]]

[[+výpis]]

• [[+idx]] - číslo výsledku hledání v seznamu
• [[+link:is=``:then=`[[~[+id]]]]`:else=`[[+link]]`]]
• [[+longtitle]] - rozšířený název
• [[+pagetitle]] - název
• [[+extract]] – text, podle kterého byl tento dokument nalezen

- searchresultli - ve skutečnosti to také nemůžete přenést.

- searchresults-new - obálka všech výsledků

[[+resultInfo]]

• [[+resultInfo]] - informace o počtu nalezených dokumentů a pro jakou frázi.
• [[+sisea.result_pages? &namespace=`sisea` &topic=`výchozí`]]

  Výstup fráze „Stránky s výsledky vyhledávání:“

• [[+paging]] - stránkování
• [[+results]] - výsledky hledání

Po dokončení všeho byste měli mít 5 nových kousků.

4. Vytvořte nový dokument, ve kterém se zobrazí výsledky hledání

Název: Výsledky vyhledávání, zaškrtněte políčko „Nezobrazovat v nabídce“. V "Nastavení" a zrušte zaškrtnutí políček "Vyhledatelné", "Použít HTML editor". šetříme. Obnovte stránku a přidejte obsah

[[!SimpleSearch? &tpl=`searchresult-new` &containerTpl=`searchresults-new` &pageTpl=`pagelink-new` ¤tPageTpl=`currentpagelink-new`]]

kousky dekorace, které jste vytvořili v kroku 3 (vzhled).

Pokud chcete, aby byly obrázky ve výsledcích vyhledávání, přidejte je na konec tohoto výstupu

&includeTVs=`1` &processTVs=`1`

V bloku výsledků vyhledávání lze obrázek nazvat takto: [[+img]].

5. Zobrazte vyhledávací formulář

Na místo, kde chcete zobrazit vyhledávací formulář, napište

[[!SimpleSearchForm? &landing=`11` &tpl=`searchform-new`]]

Zde landing je id stránky s výsledky vyhledávání, v tpl jsou části návrhu formuláře, které byly vytvořeny v kroku 3.

Kroky 4 a 5 jsme provedli, abychom mohli upravit externí design podle našeho uvážení: samotný formulář, výsledky vyhledávání atd. aniž byste se dostali do zdrojového kódu. A standardní provedení je spíše tristní, například takto vypadá standardní vyhledávací formulář.

6. Změňte design.

Nevidím smysl v popisování toho, jak uspořádat všechny části, například dám nový design pro vyhledávací formulář – nový chunk

Toto je obvyklé standardní označení formuláře z bootstrapu 3, na webu to vypadá takto:

Oficiální dokumentace zde: docs.modx.com/extras/revo/simplesearch

Pokud máte dotazy, pište zeptejte se jich do komentářů.