Skip to content

Commit

Permalink
Update _index.en.md
Browse files Browse the repository at this point in the history
  • Loading branch information
@netzarbeiter
netzarbeiter authored Jul 24, 2024
1 parent 3ec546b commit 2973d51
Showing 1 changed file with 212 additions and 21 deletions.
233 changes: 212 additions & 21 deletions ...-configuration/store-configuration/products/attributes/select-menu/_index.en.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,41 +6,232 @@ aliases:
weight: 110
---

{{% notice warning %}}
This article is machine translated.
{{% /notice %}}

## Attribute Name & Type

<table><thead><tr><th>Setting</th> <th>Default</th> <th>Description</th> </tr></thead><tbody><tr><td>Use for variants</td> <td>-</td> <td>Here you can provide the attribute for configuring product variants.</td> </tr><tr><td>Selectable by the customer</td> <td>-</td> <td>You must select this field if the customer should be able to make an entry in the frontend.</td></tr></tbody></table>
<table>
<thead>
<tr>
<th>Setting</th>
<th>Default</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Use for variants</td>
<td>-</td>
<td>Here you can provide the attribute for configuring product variants.</td> </tr><tr><td>Selectable by the customer</td> <td>-</td> <td>You must
select this field if the customer should be able to make an entry in the frontend.</td>
</tr>
</tbody>
</table>


## Description

<table><thead><tr><th>Setting</th> <th>Default Setting</th> <th>Description</th> </tr></thead><tbody><tr><td>Description</td> <td>-</td> <td>This description serves as a hint for the backend user and is displayed below the input field.</td></tr></tbody></table>
<table>
<thead>
<tr>
<th>Setting</th>
<th>Default Setting</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Description</td>
<td>-</td>
<td>This description serves as a hint for the backend user and is displayed below the input field.</td>
</tr>
</tbody>
</table>


## Options

<table><thead><tr><th>Setting</th> <th>Default setting</th> <th>Description</th> </tr></thead><tbody><tr><td>Options Source</td> <td>-</td> <td>Here you can select where the options for this field should be taken from. You can choose from: - Options Manager
- Own database table (foreignKey)
- Options Wizard (deprecated

) </td> </tr><tr><td colspan="3">Options Manager</td> </tr><tr><td>Edit Option</td> <td>-</td> <td>Add an option to the field.</td> </tr><tr><td>New Option</td> <td>-</td> <td>Create a new option.</td> </tr><tr><td>Group</td> <td>-</td> <td>Here you can group option (adds a `optgroup` to the option).</td> </tr><tr><td>Default</td> <td>-</td> <td>Here you can pre-select an option (adds `selected` to the option).</td> </tr><tr><td>Label</td> <td>-</td> <td>Here you can specify which label the option should be displayed in the backend or frontend.</td> </tr><tr><td>Price markups or markdowns</td> <td>-</td> <td>You can enter a positive or negative value to change the product price when this option is selected.</td> </tr><tr><td>Published</td> <td>-</td> <td>Make this option available in the product.</td> </tr><tr><td colspan="3">Own database table (foreignKey)</td> </tr><tr><td>Foreign table and field</td> <td>-</td> <td>Instead of options you can also read data from the database. A possible query, after creating the database table and data fields, could look like this: `# Datenbankfeld für die Fallback-Sprachetl_meine_tabelle.mein_feld# Datenbankfeld für die Deutsche-Sprachede=tl_meine_tabelle.mein_feld_de# Datenbankfeld für die Französische-Sprachefr=tl_meine_tabelle.mein_feld_fr`</td> </tr><tr><td colspan="3">Options Wizard (deprecated)</td> </tr><tr><td>Value</td> <td>-</td> <td>Here you can enter the value of the option, which should be transferred when submitting the form.</td> </tr><tr><td>Name</td> <td>-</td> <td>Here you can specify which label the option should be displayed in the backend or frontend.</td> </tr><tr><td>Default</td> <td>-</td> <td>Here you can pre-select an option (adds a `selected` to the option).</td> </tr><tr><td>Group</td> <td>-</td> <td>Here you can group an option (adds `optgroup` to the option).</td> </tr><tr></tr><tr><td colspan="3"></td> </tr><tr><td>Insert empty selection</td> <td>-</td> <td>Here you can define an empty selection for the select menu.</td> </tr><tr><td>Label for the empty selection</td> <td>-</td> <td>Here you can define the label for the empty selection.</td></tr></tbody></table>
<table>
<thead>
<tr>
<th>Setting</th>
<th>Default setting</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Options Source</td>
<td>-</td>
<td>Here you can select where the options for this field should be taken from. You can choose from:
<ul>
<li>Options Manager</li>
<li>Own database table (foreignKey)</li>
<li>Options Wizard (deprecated)</li>
</ul>
</td>
</tr>
<tr>
<td colspan="3">Options Manager</td>
</tr>
<tr>
<td>Edit Option</td>
<td>-</td>
<td>Add an option to the field.</td>
</tr>
<tr>
<td>New Option</td>
<td>-</td>
<td>Create a new option.</td>
</tr>
<tr>
<td>Group</td>
<td>-</td>
<td>Here you can group option (adds a <code>optgroup</code> to the option).</td>
</tr>
<tr>
<td>Default</td>
<td>-</td>
<td>Here you can pre-select an option (adds <code>selected</code> to the option).</td>
</tr>
<tr>
<td>Label</td>
<td>-</td>
<td>Here you can specify which label the option should be displayed in the backend or frontend.</td>
</tr>
<tr>
<td>Price markups or markdowns</td>
<td>-</td>
<td>You can enter a positive or negative value to change the product price when this option is selected.</td>
</tr>
<tr>
<td>Published</td>
<td>-</td>
<td>Make this option available in the product.</td>
</tr>
<tr>
<td colspan="3">Own database table (foreignKey)</td>
</tr>
<tr>
<td>Foreign table and field</td>
<td>-</td>
<td>Instead of options you can also read data from the database. A possible query, after creating the database table and data
fields, could look like this:
<br><code># Database field for the fallback language</code>
<br><code>tl_my_table.my_field</code>
<br><code># Database field for the German language</code>
<br><code>de=tl_my_table.my_field_de</code>
<br><code># Database field for the French language</code>
<br><code>fr=tl_my_table.my_field_fr</code>
</td>
</tr>
<tr>
<td colspan="3">Options Wizard (deprecated)</td>
</tr>
<tr>
<td>Value</td>
<td>-</td>
<td>Here you can enter the value of the option, which should be transferred when submitting the form.</td>
</tr>
<tr>
<td>Name</td>
<td>-</td>
<td>Here you can specify which label the option should be displayed in the backend or frontend.</td>
</tr>
<tr>
<td>Default</td>
<td>-</td>
<td>Here you can pre-select an option (adds a <code>selected</code> to the option).</td>
</tr>
<tr>
<td>Group</td>
<td>-</td>
<td>Here you can group an option (adds <code>optgroup</code> to the option).</td>
</tr>
<tr>
<td colspan="3"></td>
</tr>
<tr>
<td>Insert empty selection</td>
<td>-</td>
<td>Here you can define an empty selection for the select menu.</td>
</tr>
<tr>
<td>Label for the empty selection</td>
<td>-</td>
<td>Here you can define the label for the empty selection.</td>
</tr>
</tbody>
</table>

{{% notice info %}}
Tip
{{% notice info %}}<p>Tip: [MetaModels](https://now.metamodel.me/) is anexcellent tool for creating and maintaining external
tables and fields.{{% /notice %}}

: [MetaModels](https://now.metamodel.me/)

is anexcellent tool for creating and maintaining external tables and fields
## Attribute configuration

.
{{% /notice %}}
## Attribute configuration
<table>
<thead>
<tr>
<th>Setting</th>
<th>Default setting</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Mandatory field</td>
<td>-</td>
<td>If <code>Selectable by the customer</code> is selected, the product cannot be added to the shopping cart without
this information. Otherwise, the field will be displayed as a required field in the backend when creating a product.</td>
</tr>
<tr>
<td>Use the JavaScript plugin "Chosen"</td>
<td>-</td>
<td>This option enables the use of the JavaScript plugin "Chosen" for the selection field, allowing you to select
multiple values using a search function. {{< version "2.6" >}}</td>
</tr>
<tr>
<td>Multiple Selection</td>
<td>-</td>
<td>Allows the user to select more than one option.</td>
</tr>
<tr>
<td>List Size</td>
<td>5</td>
<td>Once <code>Multiple Selection</code> is selected, you can set the size of the selection box here.</td>
</tr>
</tbody>
</table>

<table><thead><tr><th>Setting</th> <th>Default setting</th> <th>Description</th> </tr></thead><tbody><tr><td>Mandatory field</td> <td>-</td> <td>If `Durch den Kunden auswählbar` is selected, the product cannot be added to the shopping cart without this information. Otherwise, the field will be displayed as a required field in the backend when creating a product.</td> </tr><tr><td>Use the JavaScript plugin "Chosen".</td> <td>-</td> <td> This option enables the use of the JavaScript plugin "Chosen" for the selection field, allowing you to select multiple values using a search function. {{< version "2.6" >}} </td> </tr><tr><td>Multiple Selection</td> <td>-</td> <td>Allows the user to select more than one option.</td> </tr><tr><td>List Size</td> <td>5</td> <td>Once 'Multiple Selection' is selected, you can set the size of the selection box here.</td></tr></tbody></table>

## Search &amp; Filter Settings

<table><thead><tr><th>Setting</th> <th>Default setting</th> <th>Description</th> </tr></thead><tbody><tr><td>Filterable in frontend</td> <td>-</td> <td>Once this field is selected, this attribute can be used as a filter in the frontend.</td> </tr><tr><td>Add to "Sort by" option list.</td> <td>-</td> <td>Makes the field, if maintained in the backend and visible to the customer, sortable in the list module.</td> </tr><tr><td>Filterable in the backend</td> <td>-</td> <td>Once this field is selected, this attribute can be used as a filter in the backend.</td></tr></tbody></table>
<table>
<thead>
<tr>
<th>Setting</th>
<th>Default setting</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>Filterable in frontend</td>
<td>-</td>
<td>Once this field is selected, this attribute can be used as a filter in the frontend.</td>
</tr>
<tr>
<td>Add to "Sort by" option list.</td>
<td>-</td>
<td>Makes the field, if maintained in the backend and visible to the customer, sortable in the list module.</td>
</tr>
<tr>
<td>Filterable in the backend</td>
<td>-</td>
<td>Once this field is selected, this attribute can be used as a filter in the backend.</td>
</tr>
</tbody>
</table>

The output of the created attribute in the backend is through the [product types](/de/backend-konfiguration-shop-Produkttypen/). If you have made the select menu `Durch den Kunden auswählbar` it will be displayed automatically in the frontend (using `$this->options` in the template). Otherwise you can output the attribute in the desired isotope template with the following code `<?php echo $this->generateAttribute('InternerName'); ?>`.
The output of the created attribute in the backend is through the [product types](en/backend-configuration/store-configuration/products/product-types/).
If you have made the select menu <code>Selectable by the customer</code> it will be displayed automatically in the frontend (using <code>$this->options</code>
in the template). Otherwise you can output the attribute in the desired isotope template with the following code <code><?= $this->generateAttribute('InternerName'); ?></code>.

0 comments on commit 2973d51

Please sign in to comment.