DOCUMENTATION UTILISATEUR JEA - Joomlajoomlacode.org/gf/download/docmanfileversion/1364/66892/...Le...

sur 19

DOCUMENTATION UTILISATEURDOCUMENTATION UTILISATEURDOCUMENTATION UTILISATEURDOCUMENTATION UTILISATEUR

SommaireSommaireSommaireSommaire Sommaire ........................................................................................................................................................................................................ 1

Introduction ..................................................................................................................................................................................................... 2

Composant JEA .............................................................................................................................................................................................. 2

Installation ................................................................................................................................................................................................... 2

Pré recquis ............................................................................................................................................................................................. 2

Installation .............................................................................................................................................................................................. 2

Mise à jour .............................................................................................................................................................................................. 2

Packs de langages ................................................................................................................................................................................. 3

Multilinguisme avec JoomFish ................................................................................................................................................................ 4

Configuration .............................................................................................................................................................................................. 4

Configuration du composant ................................................................................................................................................................... 4

Initialiser les listes des caractéristiques .................................................................................................................................................. 5

Configurer le site pour voir les annonces ............................................................................................................................................... 6

Ajouter des biens .................................................................................................................................................................................... 7

Configurer le site pour permettre de faire une recherche ....................................................................................................................... 9

Configurer le site pour ajouter des biens ................................................................................................................................................ 9

Compléments ............................................................................................................................................................................................ 11

Module JEA Search ...................................................................................................................................................................................... 12

Module JEA Emphasis .................................................................................................................................................................................. 13

Plugins JEA ................................................................................................................................................................................................... 14

Search ...................................................................................................................................................................................................... 14

Dpe ........................................................................................................................................................................................................... 15

Tincaptcha ................................................................................................................................................................................................ 16

Conclusion .................................................................................................................................................................................................... 17

Support.......................................................................................................................................................................................................... 19

sur 19

IntroductionIntroductionIntroductionIntroduction

Ce document reprend les documents :

o http://joomlacode.org/gf/project/jea/wiki/?pagename=Documentation+%28english%29

o http://joomlacode.org/gf/project/jea/wiki/?pagename=FAQ

Le premier est la documentation proposée par les développeurs, et le second la FAQ.

Les deux étant proposés en anglais sur le site d’origine, voici une traduction en français.

Il y aura également quelques petits ajouts personnels ^^.

N’hésitez pas à me le signaler s’il y des erreurs / des améliorations à apporter ☺

Bonne lecture.

Composant JEAComposant JEAComposant JEAComposant JEA

InstallationInstallationInstallationInstallation

Pré recquisPré recquisPré recquisPré recquis

o PHP4 or PHP5

o MYSQL4 or MYSQL5

o Recommandés : PHP5 / MYSQL5

InstallationInstallationInstallationInstallation

Télécharger le composant à l’adresse : http://joomlacode.org/gf/project/jea/frs/?action=FrsReleaseBrowse&frs_package_id=3388

Installer le composant à l’aide du gestionnaire d’installation des extensions de Joomla.

(NB : pour savoir comment utiliser le gestionnaire d’installation des extensions : cf. documentation « Joomla 1.5 pour les nuls »)

Mise à jourMise à jourMise à jourMise à jour

�� Depuis la version 1.1

Installer simplement la nouvelle version à la place de l’ancienne, via le gestionnaire d’installation des extensions de Joomla.

�� Depuis une version antérieure à 1.1

Désinstaller l’ancienne version via le gestionnaire d’installation des extensions de Joomla. Puis, toujours avec le gestionnaire

d’installation des extensions de Joomla, réinstaller la nouvelle version.

Vos listes de caractéristiques ne seront pas perdues.

Il est possible qu’il y ai une perte des utilistaeurs de type « JEA » et/ou de la configuration du composant. Pour palier à cela,

sauvegardez avant ces données :

o Une copie d’écran de la configuration du composant

o Une sauvegarde de la table mysql des utilisateurs

sur 19

Packs de langagesPacks de langagesPacks de langagesPacks de langages

Les packs sont disponibles à cette adresse : http://joomlacode.org/gf/project/jea/docman/?subdir=520

�� Pour créer un pack

Les packs sont crées de manière à pouvoir être installés comme une extension.

Afin d’avoir un modèle, télécharger le pack de langue de votre choix (cf. adresse juste au dessus).

Créer un fichier avec le nom : xx-XX.com_jea-NUM_VERSION.zip

o xx-XX = le code iso du pays (liste à cette adresse : http://www.loc.gov/standards/iso639-2/php/code_list.php)

o NUM_VERSION = version du pack

La structure interne de ce dossier sera :

o admin/

� xx-XX.com_jea.ini

� xx-XX.com_jea.menu.ini

o site/

� xx-XX.com_jea.ini

� xx-XX.mod_jea_emphasis.ini

� xx-XX.mod_jea_search.ini

o install.xml

Pour les fichiers *.ini : Copier/coller le contenu du pack que vous avez télécharger pour exemple, et remplacer les valeurs des

variables par les textes voulus.

Pour le fichier intall.xml : Le contenu est le suivant :

<?xml version="1.0" encoding="utf-8"?> <install version="1.5" type="language" client="both" method="upgrade"> <name>JEA translation in your language</name> <tag>xx-XX</tag> <version>Version of JEA</version> <creationDate>YYYY-MM-DD</creationDate> <author>Your name</author> <authorEmail>[email protected]</authorEmail> <authorUrl>http://www.yourdomain.com/</authorUrl> <copyright>Copyright (C) 2008-2009 Sphilip. All rights reserved.</copyright> <license>http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL</license> <description>Translation for Joomla Estate Agency extension.</description> <administration> <files folder="admin"> <filename>xx-XX.com_jea.ini</filename> <filename>xx-XX.com_jea.menu.ini</filename> </files> </administration> <site> <files folder="site"> <filename>xx-XX.com_jea.ini</filename> <filename>xx-XX.mod_jea_emphasis.ini</filename> <filename>xx-XX.mod_jea_search.ini</filename> </files> </site> <params /> </install>

Zipper ensuite la totalité du nouveau dossier. Le pack est près ☺

sur 19

MultilinguismeMultilinguismeMultilinguismeMultilinguisme avec Joomavec Joomavec Joomavec JoomFishFishFishFish

Les différents éléments XML en rapport avec JoomFish sont placés dans le répertoire du composant :

administrator/components/com_jea/joomfish

Si vous voulez que les traductions soient gérées avec JoomFish, il faut copier ce qu’il y a dans ce répertoire, dans ce répertoire :

administrator/components/com_joomfish/contentelements

ConfigurationConfigurationConfigurationConfiguration

Configuration du composantConfiguration du composantConfiguration du composantConfiguration du composant

Aller dans le composant JEA, puis sur le menu « Configuration ». Vous aurez la possibilité de régler les propriétés ci-dessous :

sur 19

Initialiser les listes des caractéristiquesInitialiser les listes des caractéristiquesInitialiser les listes des caractéristiquesInitialiser les listes des caractéristiques

Aller dans le composant JEA :

Cliquer sur le menu « Gestion des critères » :

Choisir la caractéristique dans laquelle vous voulez ajouter des valeurs :

Cliquer sur l’icône « nouveau » :

Entrer la valeur à ajouter et sauver :

La liste se recharge :

NB : pour modifier le libellé d’une valeur : cocher la case qui lui correspond dans la liste, et clique sur l’icone « Editer ».

NB : pour supprimer une valeur : cocher la case qui lui correspond dans la liste, et clique sur l’icone « Supprimer ».

sur 19

Configurer le siteConfigurer le siteConfigurer le siteConfigurer le site pour voir les annoncespour voir les annoncespour voir les annoncespour voir les annonces

Pour voir les annonces qui ont été saisies, il faut passer par le système de menus. Voici un exemple de configuration :

Créer un menu principal. (NB : si vous ne connaissez pas la gestion des menus : cf documentation « Joomla 1.5 pour les nuls)

Dans ce menu, créer un élément du type « Joomla Estate Agency / Biens / Mise ne page des biens » :

Dans les propriétés de l’élément de menu : choisir si on affiche les ventes ou les locations :

Vous pouvez également affiner l’affichage grâce au bloc « Paramètres avancés » :

Voici le menu obtenu :

sur 19

Ajouter des biensAjouter des biensAjouter des biensAjouter des biens

Nous allons voir comment ajouter un bien. Que ça soit pour la vente ou la location, le système est le même. C’est pourquoi nous

ne verrons qu’un exemple avec l’ajout d’une vente.

Aller dans le composant JEA. Puis dans le menu « Gestion des ventes ».

Cliquer sur l’icône « Nouveau ». Un nouvel écran apparait, il se compose en 2 parties verticales.

Sur la partie gauche : saisir les données demandées (l’alias n’est pas obligatoire, il se génèrera automatiquement) :

Sur la partie droite, il y a 3 blocs à remplir selon le besoin :

sur 19

NB : pour importer les photos : choisir le fichier grâce au bouton « Parcourir » et importer grâce au bouton « Envoyer ». Si cette

dernière manipulation n’est pas faite, les photos ne seront pas enregistrées (et n’apparaitrons pas telles que dans la copie d’écran

ci-dessus).

NB : pour les photos : pour en ajouter plus de 2 : dans la partie « Photos secondaires » il est possible de renouveler l’envoi autant

de fois que voulu.

Vous pouvez voir l’annonce sur le site ☺

Clic sur le lien détails…

sur 19

NB : un slogan permet d’attirer l’attention sur certaines annonces dans la liste des annonces :

Configurer le Configurer le Configurer le Configurer le site pour site pour site pour site pour permettre de faire une recherchepermettre de faire une recherchepermettre de faire une recherchepermettre de faire une recherche

Il est possible de dédier une page à la recherche d’annonces.

Pour cela, créer un nouvel élément de menu du type « Joomla Estate Agency / Biens / rechercher ».

Il est alors possible d’afficher/masquer un bloc de recherche rapide et un bloc de recherche avancé.

Le bloc de recherche rapide permet de recherche à partir de la localisation des biens.

La recherche avancée permet d’affiner avec les différentes autres caractéristiques du bien.

Voici ce que donne la page avec les 2 blocs affichés :

Configurer le site pour ajouter Configurer le site pour ajouter Configurer le site pour ajouter Configurer le site pour ajouter ddddes bienses bienses bienses biens

Pour utiliser ces options, il faut pouvoir se connecter sur le site. Et avoir un login qui ait les droits suffisants. Pour cela on crée un

nouveau menu utilisateur / identification. Puis on ajoute nouvel utilisateur dans le groupe dédié à JEA. Pour de l’aide sur ces

fonctions propres à joomla : cf. documentation « Joomla 1.5 pour les nuls ».

Pour avoir accès à la page qui permet d’ajouter des annonces via le site, il faut passer par le système de menus. Voici un exemple

de configuration (qui suit l’exemple commencé plus haut) :

Dans le menu principal qui a été créé plus tôt, ajouter un élément du type « Joomla Estate Agency / Biens / ajouter un bien »

Donner un titre au menu, et sauver.

sur 19

Nous avons maitenant le menu suivant :

Après s’être connecté avec l’utilisateur approprié (menu « Connexion ») : aller sur le menu « Ajouter un bien » pour voir le résultat :

sur 19

ComplémentsComplémentsComplémentsCompléments

Voici 2 vidéos tutoriels :

o http://www.youtube.com/watch?v=QEzMhcmLu48

o http://www.youtube.com/watch?v=9BxNP8VX0ko

En plus des fonctions citées ci-dessus, sur le site pour chaque annonce, vous aurez accès à une optioin d’export pdf et une option

d’impression (icones visibles à droite du titre de l’annonce) :

sur 19

Module JEA SearchModule JEA SearchModule JEA SearchModule JEA Search

Le module JEA Search permet d’afficher le bloc de recherche rapide à un emplacement du template.

Télécharger le module : http://joomlacode.org/gf/project/jea/frs/?action=FrsReleaseBrowse&frs_package_id=3530

L’installer, l’activer. (Cf. documentation « Joomla 1.5 pour les nuls pour plus d’informations à ce propos).

Configuration : exemple ci-dessous : placement dans le top du Template par défaut joomla, pas de modifications autres :

Pour configurer le module, aller dans la gestion des modules / sur le module concerné :

Voici les options spécifiques proposées pour ce module :

sur 19

Module JEA EmphasisModule JEA EmphasisModule JEA EmphasisModule JEA Emphasis

Le module JEA Search Emphasis de aux permet de gérer les coups de cœur : si un bien à la case à cocher coup de cœur, il

apparaitra à l’endroit ou vous aves situé le module JEA Emphasis.

Télécharger le module : http://joomlacode.org/gf/project/jea/frs/?action=FrsReleaseBrowse&frs_package_id=3529.

L’installer, l’activer. (Cf. documentation « Joomla 1.5 pour les nuls pour plus d’informations à ce propos).

Configuration : exemple ci-dessous : placement dans le right du Template par défaut joomla + masquer le titre du module :

Les options proposées pour ce module sont les suivantes :

NB : s’il y a plusieurs coups de cœur en même temps, ils sont affichés les uns à la suite des autres.

sur 19

Plugins JEAPlugins JEAPlugins JEAPlugins JEA

Vous pourrez télécharger les plugins à cette adresse :

http://joomlacode.org/gf/project/jea/frs/?action=FrsReleaseBrowse&frs_package_id=5570.

SearchSearchSearchSearch

Le plugin Search pour JEA, permet de customiser le module de recherche standard de Joomla. Il permet de sonder en plus les

titres, descriptions et références des biens.

Télécharger le module, l’installer, l’activer. (Cf. documentation « Joomla 1.5 pour les nuls pour plus d’informations à ce propos).

Dans la configuration du plugin, vous pourrez choisir quels champs le module parcourras durant la recherche :

Exemple :

recherche sans le plugin : recherche avec le plugin :

+ entrée =

+ entrée =

sur 19

DpeDpeDpeDpe Le module DPE permet d’ajouter à la description d’un bien son diagnostique énergétique.

Attention : ce plugin ne fonctionne qu’à partir de la version 1.1 (qui à ce jour est en beta). Vous pourrez télécharger cette version

ici : http://joomlacode.org/gf/project/jea/frs/?action=FrsReleaseBrowse&frs_package_id=5569


Quand vous créez un nouveau bien, un nouveau bloc est disponible sur la partie de droite :

Voici un exemple de ce que cela donne sur le site pour une des ventes que nous avons créé précédemment :

sur 19

TincaptchaTincaptchaTincaptchaTincaptcha

Ce module permet d’afficher un système de captcha lors du remplissage des formulaires proposés en bas de chaque annonce.

Attention : ce plugin ne fonctionne qu’à partir de la version 1.1 (qui à ce jour est en beta). Vous pourrez télécharger cette version

ici : http://joomlacode.org/gf/project/jea/frs/?action=FrsReleaseBrowse&frs_package_id=5569


Dans la configuration du plugin, vous pourrez choisir le format des mots générés pour le captcha :

Voici le nouveau format du formulaire :

sur 19

ConclusionConclusionConclusionConclusion

Avec les différents exemples cités tout au court de la doc, le site obtenu est le suivant :

sur 19

NB : format type d’une annonce :

sur 19

Il permet :

o D’enregistrer des biens

o Dont les caractéristiques sont proposées selon vos besoins

o Avec un nombre illimité d’images qui peuvent être présentées via light box

o A partir de l’administration ou du site

o Cette dernière action est possible grâces à la gestion des utilisateurs qui font parties d’un groupe spécifique à JEA

o De visualiser les biens en vente et/ou en location

o De mettre en valeur certains biens, via les coups de cœur, ou les slogans

o D’effectuer une recherche à partir d’une page ou d’un module

o La recherche de base consiste à préciser une localisation

o La recherche via la page propose également un bloc « recherche avancée » qui permet d’affiner avec les caractéristiques

autres que de localisation

o De faire une recherche par simple saisie grâce au module standard de recherche de joomla

o Chaque bien consulté comprend une description complète (grâces aux caractéristiques renseignées)

o Ainsi qu’un diagnostique énergétique

o Et un formulaire de contact

o Qui peut être sécurisé via un système de captcha

Bien sur, si les différents styles ne vous conviennent pas, vous pouvez comme pour tout autre composant, modifier le css ☺

SupportSupportSupportSupport

Vous pouvez demander de l’aide à 2 endroits :

o Sur la communauté Joomla fr : http://forum.joomla.fr/showthread.php?54806-Composant-pour-site-immobilier

o Ou sur la forge joomla du développeur : http://joomlacode.org/gf/project/jea/forum/

DOCUMENTATION UTILISATEUR JEA - Joomlajoomlacode.org/gf/download/docmanfileversion/1364/66892/...Le...

Documents

Transcript of DOCUMENTATION UTILISATEUR JEA - Joomlajoomlacode.org/gf/download/docmanfileversion/1364/66892/...Le...