Moteur de recherche

Le plugin wordpress intègre nativement de nombreuses fonctionnalités permettant de rechercher des annonces immobilières depuis notre API.

Critères de recherche

Le plugin permet d'intégrer nativement la liste suivante de critères de recherche :

Champs extras

Les champs extras sont des informations libres stockées dans les annonces. Elles sont accessibles en tant que critère de recherche.

Localité

Le critère localization permet de filtrer les annonces basées sur une ville, un département, une région ou même plus simplement, un code postal. Ce champ supporte plusieurs valeurs (séparées par une virgule ,) :

localization = lyon-69000
localization = Lyon (69000)
localization = 69000
localization = lyon-69000,paris-75,auvergne-rhone-alpes

Transaction

La transaction représente un format d'annonce spécifique, destiné à des marchés différents :

Le champ transaction peut contenir chacune de ces valeurs, séparées par une virgule.

Type d'annonce

Il existe plusieurs types d'annonces, avec des formats différents :

Vous pouvez chercher sur n'importe quelle valeur ici (anglaise ou française). Il est à noté qu'à partir du moment que vous souhaitez utiliser un type (et non pas une catégorie de type), vous devez préfixer la valeur avec s_ (subtype_{type}) comme le montre l'exemple ci-dessous :

type = s_gîte
type = s_activity locals
type = s_camping,s_mobil home
type = house,s_fleuriste

Catégorie de type

Comme le montre le tableau ci-dessus, les catégories de types permettent de recherche parmi tous les types associés :

• house ou maison
• flat ou appartement
• terrain
• shop ou boutique
• office ou bureau
• industrial ou industriel
• other ou autre

La catégorie de type n'a pas besoin d'être préfixée.

Modification du moteur

Pour permettre des modifications dans le moteur de recherche, vous allez devoir récupérer le template de base dans votre thème :

-wp-content/plugins/lsi/modules/LsiAds/templates/lsi_searchgrid.php
+wp-content/themes/{theme}/LsiAds/lsi_searchgrid.php

Le moteur inclut de base une configuration par le plugin permettant d'afficher ou cacher certains champs. Mais ce comportement ne peut être exhaustif à partir du moment que vous avez des besoins spécifiques. Le moteur inclut par défaut les champs suivants :

• transaction
• type
• localization
• min_surface
• max_surface
• rooms
• meuble
• mandate
• prestige

Dès lors que ces critères ne sont pas assez complets pour vous, vous aurez besoin de modifier le template afin d'en ajouter de nouveau.

Ajouter un critère

Le template par défaut inclut une bonne partie des critères de recherche, mais pas tous. Afin d'ajouter le support de nouveaux champs dans le moteur de recherche, il faut modifier le template. La plupart des champs sont des input, vous pouvez donc très facilement en ajouter de nouveau en suivant l'exemple ci-dessous :

<!-- Exemple d'un `input` -->
<input type="text" id="sg_{criteria}<?= $uniqId ?>" name="lsi_s_{criteria}" value="<?= $defaults[{criteria}] ?>" />

<!-- Exemple d'un `select` -->
<select id="sg_{criteria}<?= $uniqId ?>" name="lsi_s_{criteria}">
    <option value=""><?= __("Choisir", "lsi") ?></option>
    <option value="1" <?= $defaults[{criteria}] == 1 ? 'selected="selected"' : '' ?>>1</option>
    <option value="2" <?= $defaults[{criteria}] == 2 ? 'selected="selected"' : '' ?>>2</option>
</select>

Exemple

Un client demande à ce qu'une liste de nombre de chambres (1 à 5) soit mise en place dans le moteur. Facile !

<select id="sg_bedrooms<?= $uniqId ?>" name="lsi_s_bedrooms">
    <option value=""><?= __("Nombre de chambres", "lsi") ?></option>
    <option value="1" <?= $defaults["bedrooms"] == 1 ? 'selected="selected"' : '' ?>>1</option>
    <option value="2" <?= $defaults["bedrooms"] == 2 ? 'selected="selected"' : '' ?>>2</option>
    <option value="3" <?= $defaults["bedrooms"] == 3 ? 'selected="selected"' : '' ?>>3</option>
    <option value="4" <?= $defaults["bedrooms"] == 4 ? 'selected="selected"' : '' ?>>4</option>
    <option value="5" <?= $defaults["bedrooms"] == 5 ? 'selected="selected"' : '' ?>>5</option>
</select>

Ajout d'un champ extra

Comme pour l'ajout d'un critère, vous pouvez ajouter le support des différents champs extras (soit configurable par l'internaute, soit par défaut).

<input type="checkbox" id="sg_extras_{key}<?= $uniqId ?>" name="lsi_s_extras[{key}]" value="{key}:{value}" <?= !empty($defaults["extras"][{key}]) ? "checked" : "" ?> />

// Exemple avec le champ extra `sauna`
<input type="checkbox" id="sg_extras_sauna<?= $uniqId ?>" name="lsi_s_extras[sauna]" value="sauna:1" <?= !empty($defaults["extras"]["sauna"]) ? "checked" : "" ?> />

Évidemment, ce code est à adapter en fonction des besoins. Si le champ extra est une chaîne de caractère ou qu'il doit se présenter sous la forme d'un select, il faut modifier la structure du champ.

<select id="sg_extras_nb_sdb<?= $uniqId ?>" name="lsi_s_extras[nb_sdb]">
    <option value=""><?= __("Nb de SdB", "lsi") ?></option>
    <option value="nb_sdb:1" <?= $defaults["extras"]["nb_sdb"] == "nb_sdb:1" ? 'selected="selected"' : '' ?>>1</option>
    <option value="nb_sdb:2" <?= $defaults["extras"]["nb_sdb"] == "nb_sdb:2" ? 'selected="selected"' : '' ?>>2</option>
    <option value="nb_sdb:3" <?= $defaults["extras"]["nb_sdb"] == "nb_sdb:3" ? 'selected="selected"' : '' ?>>3</option>
    <option value="nb_sdb:4" <?= $defaults["extras"]["nb_sdb"] == "nb_sdb:4" ? 'selected="selected"' : '' ?>>4</option>
    <option value="nb_sdb:5" <?= $defaults["extras"]["nb_sdb"] == "nb_sdb:5" ? 'selected="selected"' : '' ?>>5</option>
</select>

Vous pouvez aussi supporter plusieurs champs extras en une valeur, comme par exemple l'exemple suivant (annonce avec travaux et à rénover sous le même label :

<input type="checkbox" id="sg_extras_travaux<?= $uniqId ?>" name="lsi_s_extras[travaux]" value="travaux:1;a_renover:1" <?= !empty($defaults["extras"]["travaux"]) ? "checked" : "" ?> />

Mise en page

Le moteur de recherche est stylé de base par le module. Ceci peut potentiellement poser problème lors de l'implémentation de thème complexe. Le template lsi_searchgrid.php se veut très simple, n'hésitez pas à le modifier à votre guise et de déplacer les éléments ainsi que les conditions afin de correspondre à vos besoins.