ExtSearch/docs/html/manual/technische_Erlaeuterungen/zusaetzliche_Formularfelder.html

169 lines
15 KiB
HTML

<!DOCTYPE html>
<html class="no-js" lang="de">
<head>
<title>zusätzliche Formularfelder - erweiterte Suche</title>
<meta name="description" content="">
<meta name="author" content="D³ Data Development">
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link rel="icon" href="../../themes/d3/img/favicon.png" type="image/x-icon">
<!-- Mobile -->
<meta name="apple-mobile-web-app-capable" content="yes" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- Font -->
<!-- CSS -->
<link href='../../themes/d3/css/theme-blue.min.css' rel='stylesheet' type='text/css'><link href='../../themes/d3/css/d3.css' rel='stylesheet' type='text/css'>
<!-- Tipue Search -->
<link href="../../tipuesearch/tipuesearch.css" rel="stylesheet">
<!--[if lt IE 9]>
<script src="../../themes/d3/js/html5shiv-3.7.3.min.js"></script>
<![endif]-->
</head>
<body class=" ">
<div class="Columns content">
<aside class="Columns__left Collapsible">
<button type="button" class="Button Collapsible__trigger">
<span class="Collapsible__trigger__bar"></span>
<span class="Collapsible__trigger__bar"></span>
<span class="Collapsible__trigger__bar"></span>
</button>
<a class="Brand" href="../../index.html"><i class='fab fa-d3 d3fa-color-blue'></i> erweiterte Suche</a>
<div class="Search">
<svg class="Search__icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 451 451">
<path d="M447.05 428l-109.6-109.6c29.4-33.8 47.2-77.9 47.2-126.1C384.65 86.2 298.35 0 192.35 0 86.25 0 .05 86.3.05 192.3s86.3 192.3 192.3 192.3c48.2 0 92.3-17.8 126.1-47.2L428.05 447c2.6 2.6 6.1 4 9.5 4s6.9-1.3 9.5-4c5.2-5.2 5.2-13.8 0-19zM26.95 192.3c0-91.2 74.2-165.3 165.3-165.3 91.2 0 165.3 74.2 165.3 165.3s-74.1 165.4-165.3 165.4c-91.1 0-165.3-74.2-165.3-165.4z"/>
</svg>
<input type="search" id="tipue_search_input" class="Search__field" placeholder="Suchen..." autocomplete="on"
results=25 autosave=text_search>
</div>
<div class="Collapsible__content">
<!-- Navigation -->
<ul class='Nav'><li class='Nav__item '><a href="../../manual/Inhalte.html">Inhalte</a></li><li class='Nav__item '><a href="../../manual/Ergebnisanlyse.html">Ergebnisanalyse</a></li><li class='Nav__item '><a href="../../manual/optischeAnpassungen.html">optische Anpassungen</a></li><li class='Nav__item has-children'><a href="../../manual/Optionale_Erweiterungen/phonetischer_Index.html" class="folder"><i class="Nav__arrow">&nbsp;</i>Optionale Erweiterungen</a><ul class='Nav'><li class='Nav__item '><a href="../../manual/Optionale_Erweiterungen/phonetischer_Index.html">phonetischer Index</a></li></ul></li><li class='Nav__item '><a href="../../manual/Statistik.html">Statistik</a></li><li class='Nav__item '><a href="../../manual/Synonym-Editor.html">Synonym-Editor</a></li><li class='Nav__item '><a href="../../manual/korrespondierendeAttributswerte.html">korrespondierende Attributwerte</a></li><li class='Nav__item '><a href="../../manual/Logging.html">Logging</a></li><li class='Nav__item '><a href="../../manual/externeEinstellungen.html">Einstellungen außerhalb des Adminbereichs</a></li><li class='Nav__item '><a href="../../manual/Optimierungen.html">Optimierungen</a></li><li class='Nav__item '><a href="../../manual/Fragen.html">Grundsätzliche Fragen</a></li><li class='Nav__item '><a href="../../manual/Erweiterungsmoeglichkeiten.html">Erweiterungsmöglichkeiten</a></li><li class='Nav__item Nav__item--open has-children'><a href="../../manual/technische_Erlaeuterungen/zusaetzliche_Formularfelder.html" class="folder"><i class="Nav__arrow">&nbsp;</i>technische Erlaeuterungen</a><ul class='Nav'><li class='Nav__item Nav__item--active'><a href="../../manual/technische_Erlaeuterungen/zusaetzliche_Formularfelder.html">zusätzliche Formularfelder</a></li><li class='Nav__item '><a href="../../manual/technische_Erlaeuterungen/MultiAttributFilter.html">Attributfilter mit Mehrfachauswahl</a></li><li class='Nav__item '><a href="../../manual/technische_Erlaeuterungen/Indexleiste.html">Indexleiste</a></li><li class='Nav__item '><a href="../../manual/technische_Erlaeuterungen/Relevanz.html">Relevanz und Wichtigkeiten</a></li><li class='Nav__item '><a href="../../manual/technische_Erlaeuterungen/Phonetic-Cronjob.html">Phonetic-Cronjob</a></li></ul></li></ul>
<div class="Links">
<hr/>
<a href="https://www.oxidmodule.com" target="_blank">Shop</a><br />
<a href="https://blog.oxidmodule.com" target="_blank">Blog</a><br />
<a href="https://faq.d3data.de" target="_blank">FAQ</a><br />
<a href="https://docs.oxidmodule.com" target="_blank">Dokumentationen</a><br />
<a href="https://support.oxidmodule.com" target="_blank">D³ Support Center</a><br />
<a href="https://www.oxidmodule.com/kontakt" target="_blank">Kontakt</a><br />
<a href="https://www.oxidmodule.com/impressum" target="_blank">Impressum</a><br />
</div>
</div>
</aside>
<div class="Columns__right Columns__right--full">
<div class="Columns__right__content">
<div class="doc_content">
<article class="Page">
<div class="Page__header">
<h1><a href="../../manual/technische_Erlaeuterungen/zusaetzliche_Formularfelder.html">technische Erlaeuterungen</a> <svg class="Page__header--separator" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 477.175 477.175"><path d="M360.73 229.075l-225.1-225.1c-5.3-5.3-13.8-5.3-19.1 0s-5.3 13.8 0 19.1l215.5 215.5-215.5 215.5c-5.3 5.3-5.3 13.8 0 19.1 2.6 2.6 6.1 4 9.5 4 3.4 0 6.9-1.3 9.5-4l225.1-225.1c5.3-5.2 5.3-13.8.1-19z"/></svg> <a href="../../manual/technische_Erlaeuterungen/zusaetzliche_Formularfelder.html">zusätzliche Formularfelder</a></h1>
<span class="ModifiedDate">
02.01.2023 </span>
</div>
<div class="s-content">
<p>Mit den zusätzlichen Formularfeldern haben Sie ein mächtiges Werkzeug an der Hand, um Ihren Kunden die Suche vorzubereiten. Mit regulären Formularfeldern (&quot;Select-Boxen&quot;, Textfeldern etc.) können Sie auch shopfremde Felder Ihrer Artikeltabelle in flexibler Art und Weise in Kombination mit den Standardoptionen durchsuchbar machen.</p>
<p>Als Anschauungsbeispiel möchte ich Ihnen die Verwendung in einem Schuh-Shop erklären. Übertragen Sie dies dann einfach auf Ihre Branche:</p>
<p>Alle Ihre Schuhe haben die Informationen über die verfügbaren Schuhgrößen in einem speziellen Feld <code>myShoeSize</code> in der Tabelle <code>oxarticles</code> abgelegt. Für ein Beispiel könnte darin stehen: <code>40, 41, 45, 46</code>. Die Werte müssen zwingend mit Komma getrennt sein.</p>
<p>Ein weiteres Beispielfeld <code>myShoeColor</code> könnte so die Farbe des Schuhs beinhalten. So steht in unserem Farbfeld eindeutig <code>schwarz</code>, <code>blau</code> oder <code>grün</code>.</p>
<p>Mit Hilfe der zusätzlichen Formularfelder können Sie nun in das Template <code>modules/d3/extsearch/Application/views/blocks/widget/header/d3_extsearch_searchfield.tpl</code> ein neues Formularfeld einfügen:</p>
<pre><code>&lt;select name=&quot;d3searchlike[myShoeSize]&quot;&gt;
&lt;option value=&quot;&quot;&gt; - alle Größen - &lt;/option&gt;
&lt;option value=&quot;40&quot; [{if $aD3SearchLike.myShoeSize == &quot;40&quot;}]selected[{/if}]&gt; Größe 40 &lt;/option&gt;
&lt;option value=&quot;41&quot; [{if $aD3SearchLike.myShoeSize == &quot;41&quot;}]selected[{/if}]&gt; Größe 41 &lt;/option&gt;
&lt;option value=&quot;42&quot; [{if $aD3SearchLike.myShoeSize == &quot;42&quot;}]selected[{/if}]&gt; Größe 42 &lt;/option&gt;
&lt;option value=&quot;...&quot; [{if $aD3SearchLike.myShoeSize == &quot;...&quot;}]selected[{/if}]&gt; ... &lt;/option&gt;
&lt;option value=&quot;47&quot; [{if $aD3SearchLike.myShoeSize == &quot;47&quot;}]selected[{/if}]&gt; Größe 47 &lt;/option&gt;
&lt;/select&gt;
&lt;input type=&quot;text&quot; name=&quot;d3searchis[myShoeColor]&quot; value=&quot;[{$aD3SearchIs.myShoeSize}]&quot;&gt;
&lt;select name=&quot;d3searchis[myShoeSize]&quot;&gt;
&lt;option value=&quot;&quot;&gt; - alle Größen - &lt;/option&gt;
&lt;option value=&quot;BETWEEN__AND_35_&quot; [{if $aD3SearchIs.myShoeSize == &quot; BETWEEN__AND_35_&quot;}]selected[{/if}]&gt; bis Größe 35 &lt;/option&gt;
&lt;option value=&quot;BETWEEN_36_AND_40_&quot; [{if $aD3SearchIs.myShoeSize == &quot; BETWEEN_36_AND_40_&quot;}]selected[{/if}]&gt; von Größe 36 bis 40 &lt;/option&gt;
&lt;option value=&quot;BETWEEN_41_AND__&quot; [{if $aD3SearchIs.myShoeSize == &quot; BETWEEN_41_AND__&quot;}]selected[{/if}]&gt; ab Größe 41 &lt;/option&gt;
&lt;/select&gt;
&lt;input type=&quot;hidden&quot; name=&quot;d3searchbitset[bitfield][]&quot; value=&quot;&quot;&gt;
&lt;input type=&quot;checkbox&quot; name=&quot;d3searchbitset[bitfield][]&quot; value=&quot;1&quot; [{if $aD3SearchBitSet.bitfield &amp;&amp; '1'|in_array:$aD3SearchBitSet.bitfield}]checked[{/if}]&gt;1&lt;br&gt;
&lt;input type=&quot;checkbox&quot; name=&quot;d3searchbitset[bitfield][]&quot; value=&quot;2&quot; [{if $aD3SearchBitSet.bitfield &amp;&amp; '2'|in_array:$aD3SearchBitSet.bitfield}]checked[{/if}]&gt;2&lt;br&gt;
&lt;input type=&quot;checkbox&quot; name=&quot;d3searchbitset[bitfield][]&quot; value=&quot;4&quot; [{if $aD3SearchBitSet.bitfield &amp;&amp; '4'|in_array:$aD3SearchBitSet.bitfield}]checked[{/if}]&gt;4&lt;br&gt;
&lt;input type=&quot;checkbox&quot; name=&quot;d3searchbitset[bitfield][]&quot; value=&quot;8&quot; [{if $aD3SearchBitSet.bitfield &amp;&amp; '8'|in_array:$aD3SearchBitSet.bitfield}]checked[{/if}]&gt;8&lt;br&gt;
</code></pre>
<h3 id="page_d3searchlike">d3searchlike</h3>
<p>Mit diesem Namen des Formularfeldes legen Sie das Verhalten des Suchfeldes fest. Zur Verfügung stehen Ihnen hier:</p>
<ul>
<li>d3searchlike: Der damit übergebene Wert muss als Teil des Inhalts im genannten Tabellenfeld enthalten sein. Wählt der Kunde z.B. die Option <code>41</code>, werden alle Artikel gefunden, bei denen die Zahl 41 im Größenfeld mit genannt ist. Da die Werte eindeutig getrennt sind, werden die Artikel sicher selektiert. In unserem Fallbeispiel würde der Schuh gefunden werden, wenn alle anderen Suchoptionen (z.B. der Suchbegriff) auch passt. Bei Option <code>42</code> fehlt der Artikel trotz passenden Begriffs in der Trefferliste; die Größe ist nicht mit in dessen Liste aufgeführt.</li>
<li>d3searchis: Der vom Feld übergebene Wert muss eindeutig in dem Feld am Artikel vorkommen. Wird in das Formular <code>schwarz</code> eingegeben, werden auch nur Artikel mit der Farbe schwarz gefunden. Die Farbe <code>schwarzgrün</code> würde zum Beispiel ignoriert werden. Um ungenaue Suchen auszuschließen, empfehlen wir, auch hier dem Kunden eine genaue Vorgabe in Form von z.B. Selectboxen, Radiobuttons etc. zu machen. Freitexteingaben sind da sehr fehleranfällig.</li>
<li>d3searchis mit BETWEEN-Syntax: Mit der BETWEEN-Syntax können Sie Bereiche festlegen, innerhalb derer die Treffer liegen müssen. Die Feldwerte müssen dabei wie folgt aufgebaut sein:</li>
</ul>
<pre><code>BETWEEN_Wert1_AND_Wert2_
</code></pre>
<p><code>Wert1</code> definiert den Startwert, <code>Wert2</code> den Endwert.</p>
<p>Die beiden Werte sind optional, einer der beiden Werte muss jedoch zwingend angegeben werden. Folgende Konstellationen sind hierbei möglich:</p>
<ul>
<li>
<code>BETWEEN__AND_10_</code> - Alle Werte bis einschließlich 10 werden gefunden.</li>
<li>
<code>BETWEEN_11_AND_20_</code> - Alle Werte zwischen einschließlich 11 bis einschließlich 20 werden gefunden.</li>
<li>
<code>BETWEEN_21_AND__</code> - Alle Werte ab einschließlich 21 werden gefunden</li>
</ul>
<p>Statt Ganzzahlen können Sie auch Dezimalzahlen angeben. Die Schreibweise muss jedoch den Datenbankwerten entsprechen.</p>
<ul>
<li>d3searchbitset: Der vom Feld übergebene Ganzzahlwert muss einem im Feld gesetzten Bitwert entsprechen. Ist das Bit nicht gesetzt, wird der Artikel ausgefiltert.</li>
</ul>
<p>Ein Beispiel für die verwendete Syntax finden Sie weiter oben und in den beiliegenden Modultemplates.</p>
<h4 id="page_Legende">Legende</h4>
<p>Mit <code>myShoeSize</code> sind in den Beispielen die Namen der Datenbankfelder benannt. Tragen Sie die Namen eindeutig (so wie in Ihrer Shopdatenbank in der Tabelle <code>oxarticles</code> benannt) entsprechend der Beispiele ein. Mit diesem Namen geben Sie vor, in welchem Feld die ausgewählten Inhalte vorkommen müssen. Zugriff haben Sie auf alle Tabellenfelder der Tabelle <code>oxarticles</code>, unabhängig ob diese im Standardshop vorhanden oder individuell angelegt wurden.</p>
<p>Die Werte im <code>value</code>-Attribute sind die in der Datenbank abgefragten Werte. In Textfeldern vergeben Sie keine Standardwerte. Im Normalfall (Datenbank-Kollation ist <code>case-insensitiv</code>) ist die Groß-/Kleinschreibung der Werte egal.</p>
<p>Leereinträge werden von der Suche so behandelt, dass derjenige Filter nicht verwendet wird. Damit können Sie also eine Möglichkeit schaffen, eine Filterung komplett zu vermeiden. Im Beispiel der Schuhgrößen würde die Auswahl der ersten Option <code>alle Größen</code> alle Schuhe unabhängig der Größe liefern.</p>
<p>In den Variablen <code>$aD3SearchIs</code> und <code>$aD3SearchLike</code> sind die Werte enthalten, die der Kunden vorab gewählt hatte. Als Parameter übergeben Sie den Feldnamen. Damit können Sie Ihren Formularfeldern die vom Kunden gewählte Auswahl wieder als Standard setzen.</p>
<p>In der Praxis hat sich auch bewährt, an prominenter Stelle im Shop ein kleines Suchformular anzubieten und auf einer speziellen Seite Ihrem Kunden ein umfangreiches Suchformular mit vielen Suchkriterien zur Verfügung zu stellen. Kopieren Sie in diesem Fall das komplette Formular aus dem Template <code>inc/d3_extsearch_form.tpl</code> in Ihre spezielle Seite und füllen dies mit den möglichen Suchfeldern entsprechend der vorangegangen Beschreibung.</p>
<p>Beachten Sie bitte, dass zur Auswertung dieser beschriebenen Suchfelder unbedingt die Option <code>auf zusätzliche Formularfelder prüfen</code> aktiviert sein muss.</p>
</div>
<nav>
<ul class="Pager">
<li class=Pager--prev><a href="../../manual/Erweiterungsmoeglichkeiten.html">Zurück</a></li> <li class=Pager--next><a href="../../manual/technische_Erlaeuterungen/MultiAttributFilter.html">Weiter</a></li> </ul>
</nav>
</article>
</div>
</div>
</div>
</div>
<!-- JS -->
<script src="../../themes/d3/js/jquery-1.11.3.min.js"></script><script src="../../themes/d3/js/highlight.pack.js"></script><script src="../../themes/d3/js/daux.js"></script><script src="../../themes/d3/js/fontawesome-all.js"></script>
<!-- Tipue Search -->
<script type="text/javascript" src="../../tipuesearch/tipuesearch.js"></script>
<script>
window.onunload = function(){}; // force $(document).ready to be called on back/forward navigation in firefox
$(function() {
tipuesearch({
'base_url': '../../'
});
});
</script>
</body>
</html>