- Text
- Color
- Textarea
- Fileupload
- Selector
- Editor
- Checkbox
- Radio Group
- Select
- MultiSelect
- Title
- Slider
- Date
#Champs disponibles
Que ce soit dans la section config
ou repeater
, les champs utilisés restent identiques. Voici un aperçu des différents types de champs disponibles et comment les utiliser dans vos blocks PrettyBlocks.
Les exemples suivants illustrent la configuration de divers types de champs, que vous pouvez adapter selon vos besoins spécifiques.
#Text
1'title' => [2 'type' => 'text', // type of field3 'label' => 'Title', // label to display4 'default' => 'Customer reviews' // default value5]
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Label Ă afficher |
default |
Valeur par défaut (type: String ) |
force_default_value |
Autorise à placer la valeur par défaut lors de l'insertion du bloc sur une zone (type: Bool ) |
#Color
Affiche un sélecteur de couleur avec un choix de couleurs prédéfinies et/ou un champ pour saisir une couleur personnalisée.
1'color' => [2 'type' => 'color', // type of field3 'label' => 'Background color', // label to display4 'default' => '#121212' // default value5]
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Label Ă afficher |
default |
Valeur par défaut (type: String représentant une couleur en hexadécimal) |
force_default_value |
Autorise l'utilisation de la valeur par défaut lors de l'insertion du block sur une zone (type: Bool ) |
#Textarea
1'description' => [2 'type' => 'textarea', // type of field3 'label' => 'Title', // label to display4 'default' => 'Customer reviews' // default value5]
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Label Ă afficher |
default |
Valeur par défaut (type: String ) |
force_default_value |
Autorise l'utilisation de la valeur par défaut lors de l'insertion du bloc sur une zone (type: Bool ) |
#Fileupload
1'upload' => [2 'type' => 'fileupload', // type of field3 'label' => 'File upload', // label to display4 'path' => '$/cz_gallery/imgs/', // path to upload5 'default' => [ // default value6 ['url' => 'https://via.placeholder.com/100x100'],7 ],8]
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Libellé à afficher |
path |
Chemin d'upload du fichier. Doit impérativement commencer par $ $ équivaut à _PS_ROOT_DIR_ Pour un chemin personnalisé d'un module : $/modules/nom_du_module/views/images/ |
default |
Image par défaut (type : Array ) |
force_default_value |
Permet d'utiliser la valeur par défaut lors de l'insertion du block sur une zone (type : Bool ) |
#Selector
Selector
Vous permettra de créer un champs de recherche en fonction d'une PrestaShopCollection
ou ObjectModel
Return ObjectPresenter
Exemple pour rechercher un produit:
1'product' => [2 'type' => 'selector', // type of field3 'label' => 'Choose a product', // label to display4 'collection' => 'Product', // Collection to cearch5 'default' => 'default value', // default value6 'selector' => '{id} - {name}' // will be replaced by Object Attribute and will be used for search results7]
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Libellé à afficher |
collection |
PrestaShopCollection ou ObjectModel Ex: Product / Category / CMS (fonctionne avec tous les objets model) |
default |
Valeur par défaut (type: Array ) |
force_default_value |
Permet d'utiliser la valeur par défaut lors de l'insertion du block sur une zone (type: Bool ) |
#Editor
Editor
Vous permettra de créer un champs de type VueQuill
ou TinyMce
1'text' => [2 'type' => 'editor', // type of field3 'label' => 'Editor', // label to display4 'provider' => 'vuequill' // default, you can use tinymce by you need to put your api key5 'default' => '<p>Hello <strong>World</strong> !' // default HTML value6]
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Libellé à afficher |
provider |
VueQuill ou TinyMce (type : String 'vuequill' ou 'tinymce') |
default |
Valeur par défaut (type : String ) |
force_default_value |
Permet d'utiliser la valeur par défaut lors de l'insertion du block sur une zone (type : Bool ) |
#Checkbox
checkbox
Vous permettra de créer un champs de type <input type='checkbox'>
Idéal pour certaines configurations.
Return Bool
1'show' => [2 'type' => 'checkbox', // type of field3 'label' => 'Use custom image', // label to display4 'default' => false // default value (Boolean)5]
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Libellé à afficher |
default |
Valeur par défaut (type : Boolean ) Défaut : |
force_default_value |
Permet d'utiliser la valeur par défaut lors de l'insertion du block sur une zone (type : Bool ) |
#Radio Group
radio_group
Vous permettra de créer un choix sous forme de <input type='radio'>
Return String
1'radio_group' => [ 2 'type' => 'radio_group', // type of field 3 'label' => 'Choose a value', // label to display 4 'default' => '3', // default value (String) 5 'choices' => [ 6 '1' => 'Radio 1', 7 '2' => 'Radio 2', 8 '3' => 'Radio 3', 9 ]10],
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Libellé à afficher |
choices |
Options possibles au format: ['id' => 'value'] |
default |
Valeur par défaut (type: String ) |
force_default_value |
Permet d'utiliser la valeur par défaut lors de l'insertion du block sur une zone (type: Bool ) |
#Select
select
Vous permettra de créer un choix sous forme de <select></select>
Return String
1'choices' => [ 2 'type' => 'select', // type of field 3 'label' => 'Choose a value', // label to display 4 'default' => '3', // default value (String) 5 'choices' => [ 6 '1' => 'Radio 1', 7 '2' => 'Radio 2', 8 '3' => 'Radio 3', 9 ]10],
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Libellé à afficher |
choices |
Options disponibles au format: ['id' => 'value'] |
default |
Valeur par défaut (type: String ) |
force_default_value |
Permet d'utiliser la valeur par défaut lors de l'insertion du block sur une zone (type: Bool ) |
#MultiSelect
multiselect
Vous permettra de créer un choix multiple sous forme de tag
Return String
1'choices' => [ 2 'type' => 'multiselect', // type of field 3 'label' => 'Choose a value', // label to display 4 'default' => ['1','2'], // default value (Array) 5 'choices' => [ 6 '1' => 'Select 1', 7 '2' => 'Select 2', 8 '3' => 'Select 3', 9 '4' => 'Select 4',10 '5' => 'Select 5',11 ],12],
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Libellé à afficher |
choices |
Options disponibles au format: ['id' => 'value'] |
default |
Valeur par défaut (type: Array ) |
force_default_value |
Permet d'utiliser la valeur par défaut lors de l'insertion du block sur une zone (type: Bool ) |
#Title
title
Vous permettra de créer un champs de type titre, qui sera compatible avec le composant Title
Return void
1'title' => [ 2 'type' => 'title', 3 'label' => 'Title', 4 'force_default_value' => true, // force default value 5 'default' => [ 6 'tag' => 'h2', 7 'classes' => [], 8 'value' => "Default value", 9 'focus' => false,10 'bold' => false,11 'italic' => false,12 'underline' => false,13 'size' => 18,14 ],15],
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title |
label |
Libellé à afficher |
choices |
Options disponibles au format: ['id' => 'value'] |
default |
Valeur par défaut (type: Array ) |
force_default_value |
Permet de définir la valeur par défaut lors de l'insertion du block sur une zone (type: Bool ) |
#Slider
slider
Vous permettra de créer un champs de type slider range (<input type="range">
)
1'slider' => [2 'type' => 'slider',3 'label' => 'Slider',4 'force_default_value' => true, // force default value5 'step' => 3, // default 16 'min' => 0,// set a min value7 'max' => 12, // set a max value.8 'default' = 0 // set a default value9],
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title / slider / date |
label |
Libellé à afficher |
default |
Valeur par défaut (type varie selon le champ) |
force_default_value |
Permet d'utiliser la valeur par défaut lors de l'insertion du block sur une zone (type: Bool ) |
step |
Pas d'incrémentation pour les champs de type slider (type: Int ) |
min |
Valeur minimale pour les champs de type slider (type: Int ) |
max |
Valeur maximale pour les champs de type slider (type: Int ) |
#Date
date
Vous permettra de créer un champs de datepicker
1'date' => [2 'type' => 'datepicker',3 'label' => 'Date',4 'force_default_value' => true, // force default value5 'default' => date('Y-m-d', strtotime('+30 days')), // set now() + 30 days6],
Options | Description |
---|---|
type |
Type du champ text / color / textarea / fileupload / selector / editor / checkbox / radio_group / select / multiselect / title / slider / date |
label |
Libellé à afficher |
default |
Valeur par défaut (type varie selon le champ, ex: String pour text , color , etc., Date pour date ) |
force_default_value |
Permet d'utiliser la valeur par défaut lors de l'insertion du block sur une zone (type: Bool ) |