Thème

Le plugin Wordpress propose différents templates par défaut, permettant d'afficher tous les éléments importants sur un site immobilier. Ces templates ne correspondront pas à besoin dans le cadre de thème complexe, il faudra donc les modifier.

Structure des modules

Chaque module du plugin est présent dans le dossier modules. Chaque module possède différents fichiers :

{moduleName}.php
js (optionnel)
templates

En fonction des changements que vous souhaitez apporter, vous devrez copier les fichiers templates dans votre thème afin d'en prendre le contrôle et de modifier l'affichage selon vos besoins :

-wp-content/plugins/lsi/modules/{module}/templates/{template}
+wp-content/themes/{theme}/{module}/{template}

Liste des ressources

Chaque plugin peut intégrer une ou plusieurs ressources dans un namespace donné. Voici la liste exhaustive de toutes les ressources associées aux namespaces.

Namespace	Fichier (base du plugin)
`LsiAdGeoloc`	`modules/LsiAdGeoloc/js/LsiAdGeoloc.js`
`LsiAddFavorites`	`js/LsiAddFavorites/LsiAddFavorites.js`
`LsiAds`	`modules/LsiAds/css/ads.less`
`LsiAgents`	`modules/LsiAgents/css/agents.less`
`LsiAgents`	`modules/LsiAgents/js/LsiAgents.js`
`LsiAjaxNavigation`	`modules/LsiAds/js/LsiAjaxNavigation.js`
`LsiAjaxResults`	`modules/LsiAds/js/LsiAjaxResults.js`
`LsiAlert`	`js/LsiAlert/LsiAlert.js`
`LsiCalc`	`modules/LsiCalc/js/LsiCalc.js`
`LsiChoosenAds`	`modules/LsiChoosenAds/css/admin-chosen.less`
`LsiChoosenAds`	`modules/LsiChoosenAds/js/LsiChoosenAds.js`
`LsiCurrentResultsMap`	`modules/LsiSearchMap/css/CurrentResultsMap.less"`
`LsiCurrentResultsMap`	`modules/LsiSearchMap/js/LsiCurrentResultsMap.js`
`LsiEventsBus`	`modules/LsiScore/js/LsiEventsBus.js`
`LsiFavorites`	`modules/LsiFavorites/css/slideshowFavorites.less`
`LsiFavorites`	`modules/LsiFavorites/js/lsiFavorites.js`
`LsiFormAds`	`modules/LsiAds/js/LsiFormAds.js`
`LsiMag`	`modules/LsiMag/css/admin.css`
`LsiMag`	`modules/LsiMag/css/style.less`
`LsiMap`	`modules/LsiScore/css/map.less`
`LsiMap`	`modules/LsiScore/js/LsiMap.js`
`LsiMusic`	`modules/LsiMusic/css/flashblock.css`
`LsiMusic`	`modules/LsiMusic/css/mp3-player-button.css`
`LsiMusic`	`modules/LsiMusic/js/LsiMusic.js`
`LsiMusic`	`modules/LsiMusic/js/soundmanager2.js`
`LsiNeuf`	`modules/LsiNeuf/css/programs.less`
`LsiPreview`	`js/LsiPreview/LsiPreview.js`
`LsiPrograms`	`modules/LsiPrograms/css/programs.less`
`LsiPubAdmin`	`modules/LsiPubAdmin/css/admin-pub.less`
`LsiPulse`	`modules/LsiCore/js/LsiPulse.js`
`LsiRealEstateCalc`	`modules/LsiCalc/css/LsiRealEstate.less`
`LsiRealEstateCalc`	`modules/LsiCalc/js/LsiRealEstateCalc.js`
`LsiRegionMap`	`modules/LsiScore/js/LsiRegionMap.js`
`LsiSearchAds`	`modules/LsiAds/js/LsiSearchAds.js`
`LsiTools`	`modules/LsiScore/js/LsiTools.js`
`LsiTranslate`	`modules/LsiTranslate/css/translate.less`
`LsiTranslate`	`modules/LsiTranslate/js/LsiTranslate.js`
`adminStats`	`modules/LsiStats'/css/style.css`
`adminStats`	`modules/LsiStats/js/LsiStats.js`
`autoEllipsis`	`modules/LsiScore/js/jquery.autoellipsis.min.js`
`calendar`	`modules/LsiStandardWidgets/css/calendar.less`
`datePicker`	`modules/LsiScore/js/jquery-ui/jquery.ui.datepicker-fr.js`
`flexSlider`	`modules/LsiScore/css/flexslider.less`
`flexSlider`	`modules/LsiScore/js/flexSlider/jquery.flexslider-min.js`
`googleJsApi`	`http://www.google.com/jsapi`
`googleMaps`	`https://maps.google.com/maps/api/js?key={key}`
`isotope`	`modules/LsiScore/js/jquery.isotope.min.js`
`jcarousellite`	`modules/LsiScore/js/jcarousellite.min.js`
`jcoverflip`	`modules/LsiAds/css/jCoverFlip.css`
`jcoverflip`	`modules/LsiAds/js/jCoverFlip.js`
`jquery_form`	`modules/LsiScore/js/jquery.form.js`
`jquery_validation`	`modules/LsiScore/css/jquery_validation.less`
`jquery_validation`	`modules/LsiScore/js/jquery-validation/jquery.validate.min.js`
`jquery_validation`	`modules/LsiScore/js/jquery-validation/localization/messages_fr.js`
`jqueryui_multiselect`	`modules/LsiScore/css/jquery.multiselect.css`
`jqueryui_multiselect`	`modules/LsiScore/css/jquery.multiselect.less`
`jqueryui_multiselect`	`modules/LsiScore/js/jquery.multiselect.min.js`
`jqueryui`	`modules/LsiCore/js/jquery-ui/jquery-ui.js`
`jqueryui`	`modules/LsiScore/css/jquery-ui/jquery-ui.css`
`lightbox`	`modules/LsiCore/js/jquery.lightbox_me.js`
`lsi-negos`	`modules/LsiNegos/css/style.css`
`lsi-negos`	`modules/LsiNegos/js/negosMap.js`
`lsi-slideshow`	`modules/LsiSlideshow/js/lsiSlideshow.js`
`lsiAgenciesFees`	`modules/LsiAgenciesFees/css/lsiAgenciesFees.css`
`lsiAgenciesMap`	`modules/LsiAgenciesMap/js/lsiAgenciesMap.js`
`lsiSearchMap`	`modules/LsiSearchMap/css/style.css`
`lsiSearchMap`	`modules/LsiSearchMap/js/lsiSearchMap.js`
`lsiSlidingMenu`	`js/lsiSlidingMenu/lsiSlidingMenu.js`
`lsiSubMenu`	`js/lsiSubMenu/lsiSubMenu.js`
`lsiVerticalAligner`	`modules/LsiScore/js/LsiVerticalAligner.js`
`lsi`	`css/admin.less`
`lsi`	`css/lsi.less`
`lsistatsv2`	`modules/LsiStatsV2/js/stats.js`
`mouseWheel`	`modules/LsiScore/js/jquery.mousewheel.js`
`msTranslate`	`https://www.microsoftTranslator.com/ajax/v3/WidgetV3.ashx?siteData={key}`
`openLayers`	`modules/LsiCore/js/openLayers/OpenLayers.js`
`placeholder_pf`	`modules/LsiScore/css/placeholder_polyfill.less`
`placeholder_pf`	`modules/LsiScore/js/placeholder_polyfill.jquery.min.combo.js`
`raphael`	`modules/LsiScore/js/raphael-min.js`
`select2`	`modules/LsiScore/js/select2/select2.min.js`
`selection`	`modules/LsiSelection/js/LsiSelection.js`
`socialButtons`	`modules/LsiSocial/css/social.less`
`sortAds`	`modules/LsiAds/css/sortAds.css`
`sortAds`	`modules/LsiAds/js/LsiSortAds.js`
`sortTable`	`modules/LsiStats/css/jquery.dataTables.css`
`sortTable`	`modules/LsiStats/js/jquery.dataTables.min.js`
`spectrum`	`js/spectrum/spectrum.css`
`spectrum`	`js/spectrum/spectrum.js`
`swfobject`	`js/swfobject/swfobject.js`
`swipebox`	`modules/LsiScore/css/swipebox/swipebox.less`
`swipebox`	`modules/LsiScore/js/jquery.swipebox.min.js`
`underscore`	`modules/LsiScore/js/underscore-min.js`

Vous pouvez récupérer n'importe quel de ces fichiers afin de les modifier facilement directement depuis le thème.

Ajouter une ressource

functions.php

if (class_exists('LsiPlugin')) {
    $lsi = LsiPlugin::getInstance();
    $lsi->enqueueResource({namespace}, get_stylesheet_directory_uri() . "/" . "{path}/{file}");
}

Le {namespace} n'est pas remplacé, la source courante n'est donc pas supprimée. L'utilité de cette méthode est d'ajouter de nouvelle fonctionnalité pour un {namespace} donné, pas de remplacer les fonctions existantes.

Remplacer une ressource

functions.php

if (class_exists('LsiPlugin')) {
    $lsi = LsiPlugin::getInstance();
    $lsi->replaceResource({namespace}, get_stylesheet_directory_uri() . "/" . "{path}/{file}");
}

Le {namespace} est totalement remplacé. Attention si plusieurs fichiers sont ajoutés puisqu'ils seront définitivement perdus si vous ne les ajoutez pas de nouveau.

Par exemple, si vous souhaitez remplacer le fichier javascript du namespace LsiFavorite, vous devrez donc utiliser le code suivant afin de conserver le style :

functions.php

if (class_exists('LsiPlugin')) {
    $lsi = LsiPlugin::getInstance();
    $lsi->replaceResource("LsiFavorite", get_stylesheet_directory_uri() . "/" . "js/LsiFavorite.js");
    $lsi->enqueueResource("LsiFavorite", plugin_dir_path("lsi") . "modules/LsiFavorites/css/slideshowFavorites.less");
}

Exemples

Si vous souhaitez modifier le fichier modules/LsiAgents/js/LsiAgents.js :

-wp-content/plugins/lsi/modules/LsiAgents/js/LsiAgents.js
+wp-content/themes/{theme}/js/LsiAgents/LsiAgents.js

functions.php

if (class_exists('LsiPlugin')) {
    $lsi = LsiPlugin::getInstance();
    $lsi->replaceResource("LsiAgents", get_stylesheet_directory_uri() . "/" . "js/LsiAgents/LsiAgent.js");
    $lsi->enqueueResource("LsiAgents", plugin_dir_path("lsi") . "modules/LsiAgents/css/agents.less");
}

Style

Par défaut, aucun fichier CSS n'est chargé. Cependant, vous pouvez utiliser l'un des thèmes déjà développé afin de vous en servir de base de travail.

LESS

Notre plugin Wordpress a été développé il y a un moment déjà, et à cette époque, nous travaillons avec le pré-processeur less. Aujourd'hui, cette technologie peut potentiellement vous poser problème si vous ne souhaitez pas modifier le thème que nous avons développé. Si cependant, vous avez besoin de certains fichiers, vous pouvez ajouter le contenu suivant dans le fichier functions.php de votre thème :

functions.php

if (class_exists('LsiPlugin')) {
    $lsi = LsiPlugin::getInstance();
    $lsi->enqueueResource("tpl", __DIR__ . "/css/{file}.less");
}

Une fois les lignes placées, vous allez devoir mettre à jour les fichiers générés. Il suffit de vous rendre dans le panel d'administration et de cliquer sur « module upgrade » dans le menu « Studio-Net » en haut à droite.