JSE Real Estate

From Joomseller Wiki
Jump to: navigation, search

Contents

Introduction

What is JSE Real Estate?

JSE Real Estate is a JOOMLA component designed to fit a multitude of real estate related needs. It includes contracts for sale, mortgage agreements and assignments and liens.

How did this component come out?

When having real estate properties to sell or having demand of buying/renting them, you definitely will need a place where you can find and share all realty information. A realty website is what you are looking for. And our JSE Real Estate component can help you systematically and effectively organize your realty listing as well as other information on your site.

JSE Real Estate Component for whom?

JSE Real Estate is designed not only for companies or individuals doing business in real estate to post their realty’s information on the web, but also for people who want to find information about realty, to find property to buy/or rent.

How does JSE Real Estate work?

You could create a semantic system with companies, agents, owner and you – administrator.

Companies:

  • Receive notification email after user submitted on site.

Agents:

  • Agent is allowed to manage realties which users submitted to him.
  • Submit realties, Manage realties of other user
  • User need to register an agent with the plan that has different time limits.

Owner:

  • Submit realty to an agent or many agents
  • Receive notification email about realty that the user has just submitted
  • Allow to edit realty information.


Administrator:

  • Manage to edit all information to Realty both in front end and back end. Admin can also create reaties.
  • Receive notification of the user when registering to become an agent or user to submit a site Realty.
  • Manage information on Companies, agents , Plans , realties …
  • Authorization user can manipulate the component.

That is only a brief description of what our component can do. There’re many features you can only see when actually use it.

The features of JSE Real Estate

JSE Real Estate is a feature rich component.

  • User can register to become an agent & upload realty.
  • Admin can create as many companies as they want. Each company will have one company's admin. Company's admin can change the information of company.
  • Manage realty from backend by administrator, from frontend by owner (agents).
  • Manage agents from backend by administrator.
  • Add realty from backend by administrator, from frontend by agents in the frontend with property types, categories, cities, states, countries, etc…
  • No limit in adding realty types, categories/sub-categories, realty, amenities, custom field groups and custom fields.
  • Google map V3 and driving directions for each realty.
  • Email form management.
  • Flexible frontend display: our component provides two layouts to display list of realties (Default vs. Table layout).
  • Full Management In backend: administrator has full control of companies, agents, realty, plan, country, state… from backend.
  • Custom fields: for a specific realty. The custom field feature allows administrator to define custom fields and creators can use those fields as they desire. JSE Real Estate can help you create many types of fields: Textbox, Text area, Dropdown (single and multiple select lists), checkbox list, radio list, Date Time.
  • Dynamic email template: you could setup email template with placeholders which will be filled with information when email is actually sent. The feature is available for all emails sent to donors, creators and administrator. And creator could create unique email template for each realty.
  • Strongly integrated with JOOMLA! 3.0 permission system: you can control permission to add new, edit, edit state of all user groups or set access level for each realty and view page.
  • Multi-payment gateways support: Currently, JSE Real Estate supports PayPal, 2CheckOut, Money Bookers, Paylater payment gateways (for paid agent). We will continue on working and adding more payment gateways for this product in the near future.
  • Social Share buttons: Users can share realty with their friends via many social networks such as Facebook, Twitter, etc…
  • Flexible configuration options: There are many configuration options which can be changed from JSE Real Estate Backend. That makes JSE Real Estate become a flexible & easy to use extension.
  • Multiple Templates system: our component can handle multi templates. You could create unique and different templates and change it anytime you want. You’ve never created a component template before? Don’t worry, we provide document that helps you customize your site with just a little experience in HTML & CSS.
  • '100% JOOMLA! 3.0 code friendly: as you know, there’re not many component that use Joomla 3 native code, but our JSE Real Estate does. And if you are a developer, you know that it is very beneficial if a component uses the same code style with core system.
  • Responsive extension: with the support of JOOMLA 3.x and bootstrap, our JSE Real Estate is responsive. JSE Real Estate can display your site perfectly on all devices: PCs, tablet, or smartphone, etc.

Screenshots

Com jse real estate back end dashboard.jpg


Figure 1: JSE Real Estate Control Panel

Installation Guide

Requirement

Server Requirements

JSE Real Estate has the following System Requirements:

You must ensure that you have MySQL-, XML- and Zlib-Support built into your PHP. PHP should be compiled with support for https (open SSL) and URL!

PHP Safe Mode should be turned off.

Client Requirements

JSE Real Estate can be used with most major browsers including: Internet Explorer (version 8+), Firefox, Chrome, Opera 9+ and Safari. JavaScript should be enabled.

The client/browser needs to be capable of accepting Cookies and Cookies must be enabled.

Download

Com jse real estate download button.png

After ordering our product, you’ll see the download link at JSE Real Estate product page:

http://joomseller.com/joomla-components/real-estate-component.html

Note: If there is any problem, please contact us at: contact@joomseller.com

Installation & Upgrade

Install component

  • Go to your administrator site
  • Select “Extensions” => “Extension Manager” in the Top Menu
  • In "Upload Package File" block, please Upload &Install our extensions:
    • pkg_jse_real_estate.zip: JSE Real Estate package. This is required.


Com jse real estate install extension.png
Figure2: JOOMLA! 3.0 Extension Manager

Modules & Plug-ins:

mod_jse_realestate_recently_viewed

“JSE Real Estate Recently viewed module”

This module is to display realty list by user's most recently viewed ones.

mod_jse_realestate_agentsearch

“JSE Real Estate Agent Search module”

This module is to find agents in your location.

mod_jse_realestate_maprealty

“JSE Real Estate Map Realty module”

This module is to show a list of realties in Google map.

mod_jse_realestate_categories


mod_jse_realestate_slider

“JSE Real Estate module”

This module is to display all realty's categories

“JSE Real Estate Slider module”

This module is to display the most viewed realty list.

mod_jse_realestate_realtysearch

“JSE Real Estate Realty Search module”

This module is to display a search realty form.

mod_juxrealestate_types

“JSE Real Estate Types module”

This module is to display all realty's types.

plg_jspayment_paypal

“JSE Real Estate PayPal payment plug-in”

Payment plug-in for payment via PayPal.

plg_jspayment_offline

“JSE Real Estate Offline payment plug-in”

Payment plug-in that lets you accept offline donation.

plg_jspaymeny_2checkout


plg_jspaymen_2co

“JSE Real Estate 2CheckOut payment plug-in”

Payment plug-in for payment via 2CheckOut.

“SE Real Estate 2CO payment plug-in

Payment plug-in for payment via 2CO”

Language Installation

JSE Real Estate’s Interface can be switched to various Languages. At first, JSE Real Estate only came with English language files. To make your JSE Real Estate run in the language of your choice you need to follow these steps:

  • Download & Install new JOOMLA! Language Files

To be able to use other languages, you must first find the right language File for JOOMLA!

JOOMLA! Language Files can be downloaded from the Translation Packs for JOOMLA! 3.0 [http://community.joomla.org/translations/joomla-16-translations.html].

  • Translate the JSE Real Estate Language Files

After installing your language, let say its xx-YY, you need to create the JSE Real Estate Language file to your language by:

Copying this file:

{site root}/language/en-GB/en-GB.com_jse_real_estate.ini

to

{site root}/language/xx-YY/xx-YY. com_jse_real_estate.ini

Then translate it to your language.

Note: sometimes you need to change encoding type of language file to "UTF8 without Bom" (you can use notepad++ to change encoding type of the file).

If you want to change backend language, do the same with language in "administrator" folder.

  • Switch the global Language

For JOOMLA! 3.0: go to "Extensions" => "Languages Manager" select the language of your choice and make it "Default" by clicking that icon in the toolbar.

JSE Real Estate should now pick up the correct language from its own language folder.

Installation FAQs

User Guide

After installing JSE Real Estate component, you will need to create basic elements and set values in Configuration before you could actually operate the component in practice. The correct steps would be:

  • Creating basic elements: basic elements are Currencies, Extra fields, Amenities, Categories, Types, Plans, Agents.
  • Configuration: setting default values for currency, email template, message, permission…
  • Operation: the main operation of this component is creating realty → agent approve, admin approve. First, you could create some realties on your own, or let users create and submit realties to agents. After that, these agents will need to manage realties and respond to approve realty.

Those steps will be explained in more detail in remain parts of this chapter.

Create basic elements

Setup Currencies

Currency is used in realty. You need to create at least one currency for JSE Real Estate. All currencies are managed in Currency Management Panel.

The Currency Management Panel can be accessed via “JSE Real Estate Control Panel” => “Currencies”

Com jse real estate back end currencies.png
Figure 3: Currency Management

If it’s first time you install JSE Real Estate, we created sample Currency data for you with US Dollar, Euro. You could setup a new currency on your own or edit our sample currencies.


Com jse real estate back end currency.png
Figure 4: Currency Edit

Currency’s property

Title

Currency’s title.

Code

The code of currency. USA, EUR, GBP, JPY…

Sign

The sign of currency. $, €, £, ¥…

Position

When display an amount of money, the currency’s sign should be placed to the left or the right of number. Such as: 1000$ or $1000.

Setup Extra Fields

Extra fields are used in realty form. For example, you need to gather email of realty, you could create a custom field named jp_email and the title is Email for realty. All extra fields are managed in Field Management Panel.

The Field Management Panel can be accessed via “JSE Real Estate Control Panel” => “Fields”


Com jse real estate back end fields.png
Figure 5: Field Management

If it’s first time you install JSE Real Estate, you can see that we created sample Fields for you. You could setup a new custom field on your own or edit our sample fields.


Com jse real estate back end field.jpg
Figure 6: Field Edit

Field’s property:

Title

Field’s title. This title will be used as label for field in donation form.

Field Type

Type of field, it could be Textbox, Text area, Dropdown, Checkbox List, Radio List, Date Time.

Required

If one field’s required, user must input value to that field before processing to next step.

Values

For Dropdown, Checkbox List, Radio List, you must setup data for that field.

For example, field Gender, type is Radio List, must have Values is Male and Female

Default Values

Field’s default value.

Rows, Cols, Size, CSS class

Field’s style attributes.

Setup Companies

JSE Real Estate component has the feature of allowing managing agents in each company. This is useful for a company or organization to manage their agents.

The Companies Management Panel can be accessed via “JSE Real Estate Control Panel” => “companies”


Com jse real estate back end companies.png
Figure 7: Companies Management

You could setup new or edit companies on your own

Com jse real estate back end company.png
Figure 8: Company Edit

Company property:

Name

Company’s name. This name’s for displaying in Frontend.

Alias

Email

Phone

Fax

Website

Street

City

State

Country

Province

Zip

Image

Status

Featured

Access

Company’s alias. Automatically generated if you leave this blank

Company’s email

Company’s phone

Company’s fax

This is an URL to link company’s website

Company’s street

Company’s city

Company’s State

Company’s country

Company’s province

Company’s zip

It allows to direct upload or switch image together for company’s image

Published, Unpublished or Trashed

Company is featured or not

Access Level - permission to allow viewing this company or not. Fully integrated with JOOMLA! 3.0 access level.

Sub description

The sub description of each company will be shown in view company list.

Description

The description of company will be shown in view company's detail.

Display at Frontend

The Company will be displayed with some company's information that admin entered in form at Backend.

Com jse real estate front end companies.png

Setup Plan

This is a way for a company or organization to make money by allowing user to register to become an agent (free or paid agent). The Plans are managed in Plans Management Panel.

The Plan Management Panel can be accessed via “JSE Real Estate Control Panel” => “Plans”

Com jse real estate back end plans.png
Figure 9: Plans Management

You could setup new plan on your own or edit our sample Plan.


Com jse real estate back end plan.jpg
Figure 10: Plan Edit

Plan’s property:

Name

Plan’s name

Ordering

Plan Manager Order.

Price

Days

Count Limit


Status

Featured

Date

Publish up

Publish down

Image

Description

If price is 0 or left blank, this input means "free". If price > 0 then you must choose currency type for your plan.

This is the number of days of plan. Agent can approve, edit, and submit realties...in the limited time provided here within a plan. If day = 0, time for agent will be unlimited.

Agent is limited in submitting realty. If Count limit = 5 for example, agent can only submit maximum 5 realties. If Count limit is 0, it will be unlimited for agent to submit realty.

Published, Unpublished or Trashed

Plan is featured or not

Plan’s created date

Plan’s start date to display at front end.

Plan’s end date to not display at front end.

Plan’s image

Plan’s description.

Setup Agent

The new feature of JSE Real Estate is allowing user to register as an agent at frontend or admin can set up an agent at backend.

The Agent Management Panel can be accessed via “JSE Real Estate Control Panel” => “Agents”

Com jse real estate back end agents.png
Figure 11: Agent Management

You could setup new agent on your own



Com jse real estate back end agent.png
Figure 12: Agent Edit


Com jse real estate back end agent property.png

Agent’s property:

First name

Agent’s first name.

Last name

Alias

Company



Email

Phone

Organization

Ordering

Address

City

State

Country

Sub description

Description

Avatar

User

Plan

Payment Method

Transaction id

Created date

Payment date

Website

Msn

Skype

Gtalk

Linkedin

Facebook

Twitter

Status

Featured

Approved

Agent’s last name.

Agent’s alias. Automatically generated if you leave this blank

A company can have many agents, so you need to choose a company for agent.


Agent’s email

Agent’s phone

Agent’s organization

Agent Manager Order

Agent’s address

Agent’s city

Agent’s state

Agent’s country

The sub description of company to be shown in view company list for each agent.

The description of company will be shown in view agent's detail.

Agent’s avatar. You can upload new avatar or switch between the existing avatars.

Enter a user who registered for this agent.

Enter plan that agent registered. Plan is the duration time that an agent is limited in to post and manage their realties.

Agent’s payment method

Transaction id of agent’s payment

Agent’s created date

Agent’s payment date

Agent’s website

Agent’s msn

Agent’s Skype

Agent’s talk

Agent’s Linkedin

Agent’s Facebook

Agent’s twitter

Agent’s status

Agent is featured or not

Agent is approved or not



Configuration

The Configuration Panel is the most important part of JSE Real Estate. It can be accessed via “JSE Real Estate Control Panel” => “Configuration”

Note that the Configuration Panel can be accessed by Users with Permissions "admin" only (by default).

You can access the different parts of the Configuration Panel by clicking on the Sub-menu Headings.



Com jse real estate back end configs.png
Figure 13: Configuration – General

General

Select color:

Choosing default color for view Realty list, Company, Agent at Front_end of JSE Real Estate component.

Template:

Choosing template for JSE Real Estate component. In the installation package, we only provide default template. However, you could create your own template using our [ Customization Guide]

Auto approve

YES: Each new realty submitted by user will be published right after being created.

NO: You’ll need to go to Administrator site and manually publish newly created realties at Realties Manager section.


Show social share

On realty detail page, social share buttons will be displayed if the setting is Yes.

You can see it display at frontend like this:


Accept term for post realty

Show/hide checkbox to require that anyone who posts realty must accept this term.

Term and condition article

Choosing a term and condition article when posting realty.

Date format

Y-m-d

Street number position

Select Before or After to require the street number come before or after the street address (when not using title field).

Measurement Units

Use metric or standard measurement units (SQFT or M2).

ReCaptcha

Anti-spam for website when submitting data.

You can choose theme for reCaptcha.

Note that, you need to have a key for reCaptcha please click https://www.google.com/recaptcha/admin/create to get one.

Thousand separator

The thousand separator for format price

Digits

Digits for format price.

Allow user upload images

Allowing user to upload images if it is set to yes.

Max images upload

The maximum number of images allowed to be uploaded

Max images size

The maximum Image's size allowed when uploading image. Default is 2000 KB

Allow image extensions

The Image extensions allowed when uploading image. Default is “png, jpg, jpeg”.

Google map configuration

Choosing “On” if you want to display the position of property on Google map. Otherwise, when submitting a property there will be the “Show map” option to decide to display Google map by each property or others.

* Note that, you need to have a Google map API key please go to https://code.google.com/apis/console/ to get one.

Facebook

Facebook comments: allows user using Facebook or other account to comment in realty, company, Agent.

Facebook API

Facebook app API: You must create a Facebook app for realty's site. After you created app, you will have api_key, you must copy this key here.

Realty

Enable use Facebook comment in Realty site.

Agent

Enable use Facebook comment in Agent site.

Company

Enable use Facebook comment in Company site.

Realties

Com jse real estate back end configs realty.png
Figure 15: realties configuration

Show agents

Display Agent information in realty view.


Show featured

Display featured realties.

Number of featured

Display realty featured in limited number in view list Company realty, Agent realty.

Featured position

You can display the position of featured realties at top or bottom of category detail layout.

Number intro realties

Number of realties to show after Leading realties. Realties will be shown in columns.

Max desc

The maximum number of characters for description of realty to display in list.

Agents

Com jse real estate back end configs agent.png
Figure 16: agents configuration

Max desc

The number character for description of agent to display in list.


Show agent Image

Enable show agent image

Show agent address

Enable show agent address

Show agent email

Enable show agent email

Show agent phone

Enable show agent phone

Show agent mobile

Enable show agent mobile

Show agent fax

Enable show agent fax

Show agent web

Enable show agent web

Show featured

If it is set to “yes” then featured agents will be shown by setting number of featured below.

Number of featured

Number of featured agent will be shown on agent detail page

Featured position

The position of featured agent will be shown on agent detail page. Default is bottom.

Number of featured

The limit of featured will be show in front-end.

Companies

Com jse real estate back end configs companies.png
Figure 17: Companies configuration

Show company image

Enable company show image

Show company address

Enable company show address

Show company email

Enable company show email

Show company phone

Enable company show phone

Show company fax

Enable company show fax

Show company web

Enable company show web

Show featured

If it is set to “yes” then featured companies will be shown by setting number of featured below.

Number of featured

Number of featured agent will be shown on company detail page

Featured position

The position of featured agent will be shown on company detail page. Default is bottom.

Email

In this section, you will setup default email templates used in this component.

Com jse real estate back end configs emails.jpg
Figure 18: Email configuration


Email Configuration

Admin E-mail& Admin E-mail name

E-mail Address and Name for sending email. Default is your admin email.

Admin Notify E-mail

When new realty’s submitted. A notification email will be sent to this email.

Email Property Configuration

New Realty Inform

Notify if there is any realty submitted on site

New Realty Confirmation

Notify to whom submitted realty successfully about their realty information

'Agent approved

Notify when an agent has approved realty. An email will be sent right after realty is approved

Agent rejected

Notify when an agent has rejected realty. An email will be sent right after realty is rejected.

Agent send email


User send email


Email Property inform & New Property confirmation

Com jse real estate back end configs emails 2.jpg
Figure 19: Email Property

Customer

The user's name who submitted realty

Details

Information of submitted realty.

Email Agent Configuration

Com jse real estate back end configs emails 3.pngCom jse real estate back end configs emails 4.png
Figure 20: Email Agent Configuration

Email Agent Configuration

New Agent Placed

Notify when a new agent is placed.

Agent Actived

Notify when an agent was approved by administrator.

{name}

Agent’s name.

{full_info}

Agent’s name, Agent’s email & Additional information (Additional Information collected when users enter on register to become an agent).

{total_price}

Total price that agent must pay when registering to become an agent

{agent_id}

Agent’s ID

{active_link}

The link will be sent to agent to activate their agent account

{active_date}

The date when an agent is approved

{transaction_id}

Agent’s transaction id

{plan_title}

Plan’s title

Message

In this section, you will setup Thank you page where agent is redirected to after creating an agent.


Com jse real estate back end configs emails 5.png
Figure 21: Configuration-Message – Thank You Message Page

Thank You Message Page

Use URL & Message URL

If Use URL is Yes, the Thank You Page will redirect to your Message URL.

If Use URL is No, the Thank You Page will display the content setup in Message Title and Message Content.

Message Title & Message Content

Title and content of Thank You Page.

Cancel Message Page

Currently, this block is unused.

Permission

JSE Real Estate is fully integrated with JOOMLA!3.0 permission. You could setup permission via Configuration-Permission section.

Com jse real estate back end configs permission.png
Figure 22: Configuration-Permission

Base on realty, JSE Real Estate creates a set of permissions: Create, Delete, Edit, Edit State, Edit Own... You could configure permission for every user groups on your site JOOMLA!

Permission meanwhile is based on Access Level on your site JOOMLA! You could specify which level will be able to access realty page.

Management at Backend

Manage realties

All functions of our component based on the process of creating realty. Realties are managed in Realty Management Panel at Backend or at Frontend.

The Realty Management Panel can be accessed via “JSE Real Estate Control Panel” => “Realties”


Com jse real estate back end realties.png
Figure 23: Realty Management

On the Realty Management Panel, we setup all popular functions: Publish, Unpublished, Ordering… Besides, we add the Featured function. Realty that was featured can receive special promotion from your site. For example, you could create a menu or a module dedicated for featured realty only. (For more information, please see [ Creating Menu Items] section or [ Modules & Plug-ins configuration] section).


You could add new or edit realty via Realty Edit Page.


Com jse real estate back end realtie edit.png
Figure 24: Realty Edit

Realty’s property:

Title

Realty’s title.

Alias

Realty’s alias. Automatically generated if you leave it blank.

Ordering

Realty Manager Order.

Company

Protection company

Sale type

Choose realty’s Sale type

Price

Enter the realty's price. NUMBERS ONLY! The 'per' field is not required but will be used for rentals, leased or commercial realties (Per month, per FT, etc…)

Original price

If the price has been reduced and you want to display the original price on the frontend, enter the original price here. Otherwise, leave it blank.

Agents

Select agent for realty

Categories

Select category for realty

Ordering

Select ordering for show list realty

Approved

Realty is approved or rejected

Access

Access Level allowed to view this realty. Fully integrated with JOOMLA! 3.0 access level.

Language

On Multilanguage site, select language to display realty.

Published

Published, Unpublished or Trashed.

Sub description

The sub description of realty will be shown in view list realty.

Description

Realty’s content. Description is usually used for introducing realty.

See pictures at Display at Frontend for more information.

Location

Realty’s location as street number, street, zip, city, state, country, the position of realty on Google map …..

Com jse real estate back end realty location.png

Amenities

Realty’s Amenities displayed as list checkbox, if any checkbox is selected then they will be displayed on the frontend

Amenities for editing realty

Com jse real estate back end realty amenities.png

Details

Realty’s detail property. It is not required that it will be displayed if there is any input entered.

Com jse real estate back end realty description.png

Extra Fields

Extra fields to gather information for this realty. Base on published fields created at [ Field Management Panel], you could control SHOW/HIDE for this realty.

Com jse real estate back end realty addition infor.png

Image

Realty’s image. You can add more images

Com jse real estate back end realty images.png

Video

Realty’s video. You can add Youtube.com link for realty. You must follow description.

Com jse real estate back end realty video.png

Publishing options





Realty’s publishing option.

Hits: The count of times that realty is viewed.

Created by: Author’s realty.

Created Date: Realty‘s created date.

Modified Date: Realty’s modified date.

Modified by: Realty’s modified by [username].

Sold: If it is set to “yes” Realty’s status is sold.

Start Publishing: Realty’s Start publishing.

Finish Publishing: Realty’s Finish publishing.

Com jse real estate back end realty publishing option.png

Metadata options


Keywords: Realty’s Keywords for SEO.

Meta Keywords: Realty’s meta keywords.

Meta Description: Realty’s meta description.

Com jse real estate back end realty meta data.png

Who can post realty

  • All Registered
  • Users or Guest
  • Agent Only

Manage Agent

All agents made by creators or Users who registered as Agent are stored and managed in Agent Management.

The Agent Management Panel can be accessed via “JSE Real Estate Control Panel” => “Agents”

Com jse real estate back end agents.png
Figure 25: Agent Management

Create Menu Items

JSE Real Estate Component comes with several views that can be set to Menu Items.

Com jse real estate back end menu.png
Figure 26: JSE Real Estate Menu Items

AddAgent Form

Create a new Agent at frontend.

Agent Realties

View agent detail with agent’s realties

All Agents

View all agents

All Categories

View all categories

Category Realties

View category detail with category’s realties

All Companies

View all companies

Company Agents

View company detail with company’s agents

Company Realties

View company detail with company’s realties

Featured Realties

View all realties are featured by agent or administrator

Submit Realty

Create a new realty at frontend

Default layout

Default layout of view all realties

Table layout

Table layout of view all realties

Map realties

View all realties on Google map

My message

View all messages of owner realty

My Realty

The user interface to manage their realties

All Open houses

View all realties that has opening hours for customers can come to visit their home

View Realty

View realty detail

'All Types

View all Types


For the meaning of parameters for each menu item, please see the corresponsive parts at User Cases at Frontend.

Use Case at Frontend

View AddAgent form

Com jse real estate front end add agent.png
Figure 27: AddAgent form

View Agent Realties

Com jse real estate front end agent detail.png
Figure 28: View agent detail

View All Agents

Visitors go to your site, view information about agents. If they want to look for someone to contact

Com jse real estate front end agents.png
Figure 29: View all agents

View All Categories

Realties can be viewed by a category in list categories. You could also create a Menu Item to view all categories.

Com jse real estate front end categories.png
Figurse 30: View all categories

View Category Realties

Com jse real estate front end all realty category.png
Figure 31: View list realty of category

View all companies

Realties can be viewed by a company in a list companies. You could also create a Menu Item to view all companies. You also can view all agents when viewing an agent detail.

Com jse real estate front end companies 2.png


Figure 32: View all sscompany

View Company Agents

View company detail with company’s agents

Com jse real estate front end company agents.png
Figure 33: View company agent’s detail

View company realties

View company detail with company’s realties

Com jse real estate front end all realty company.png
Figure 34: View company realties detail

Submit a Realty

At frontend, users could submit their realties. You could create a Menu Item for New Realty link.

Realty Edit Form

The content of Frontend Realty Edit Form is similar to the version in Backend. And you could see the [ Realty’s property] section to know the meaning of each item.

Please remember that you could set that user to be able to edit Extra Fields and Message or not at [ Configuration General]

Com jse real estate front end submit realty.png
Figure 35: Realty form

View Default layout

This page can be used to make Home page for your site. This page will display all realties which is approved and published by agents or administrator. You could create Menu Item link to home page.

Com jse real estate font end default layout.png
Figure 36: View Default layout


Menu parameters

When create a Menu Item for Default Layout, you must specify bellow parameters.


Com jse real estate font end default layout config menu1.pngCom jse real estate font end default layout config menu2.png
Figure 37: View Default layout’s parameters

Select Type

Filter all realties by a type

Select Category

Filter all realties by a category

Number intro

Number of realties to show after leading realties. Realties will be shown in columns

Max desc

Max description character will be displayed.

Type order

Filter all realties which are ordered by type order

Category order

Filter all realties which are ordered by category order.

Primary order

Choose primary order for realties

Pagination

Show pagination or hide

Pagination results

Show pagination or hide

View Table layout

Com jse real estate font end table layout.png
Figure 38: View Table Layout

View Map Realty.

Display all approved realty and realty published on Google Maps which is distinguished between realty’s types on Google Maps.

When users click on icon or title on the sidebar, it will show information of realty and users can view realty’s detail. Support finding location to here when click on an icon.

Com jse real estate font end map realty.png
Figure 39: View Map Realty

View My Message

Display all messages of user. In order to view all the messages of the user, User need to log in before you can view their messages. Messages include some information such as user From, Email, Realty, Subject, Sent date.

Com jse real estate font end message layout.png
Figure 40: View My messages

View My Realty

Realty Management that all users have submitted, you can create a menu item for users to use View My realty so that they can change the information they want.

Com jse real estate font end view my realty.png
Figure 41: View My realty

View All Open houses

Com jse real estate font end view open houses.png
Figure 42: View Open houses

Modules configuration

We provide some modules for you to display information about agent, realty. Those modules have numerous parameters which help you to create flexible module of your choice.

<centerMod jse re map.jpg></center>

Mod jse re most viewed.png
Mod jse re types cat.pngMod jse re realty search.pngMod jse re agent search.png

JSE Real Estate Recently Viewed

Mod jse re recently viewed.png
Figure 34: All Modules

From left to right are: JSE Real Estate Realty Map module, JSE Real Estate Slider(most viewed) module, JSE Real Estate Types module and JSE Real Estate Categories module, Search Realty module, JSE Real Estate Agent search module, JSE Real Estate Recently Viewed module.

JSE Real Estate Realty Map module

JSE Real Estate Realty Map module displays the list of properties by order by

Module settings

Mod jse re map realty option1.pngMod jse re map realty option2.png
Mod jse re map realty option3.png

Title

Title of module.

Show title

Enable showing title of module at front-end.

Position

Select position to show module at front-end.

Status

Status of module: published or unpublished.

Module assignment

Module assignment at front-end.

'Menu selection

Select page to see module at front-end.

Map zoom

The level for user to see map. Recommend 12.

Map height

The height of map to display at front-end.

Enable icon bar

Enable showing icon bar above module.

Show map description

Show description of realty on map.

Max Desc

The maximum character of description in the realty information displayed on map.

Show map by location

Enable admin to select default location to show realty. If you choose No then Realty Map module will required user to share location from browser.

Certain area

Location form to select default location of module.

Select type

Select data to show in Realty Map module at front-end.

JSE Real Estate Slider (Most viewed) module

This is the classic slider- most viewed module. It helps you to find most viewed list of realties.

Module settings

Mod jse re most viewed option.png

Count Realty View

The limited number of realty to show in module. Recommended value is > or = 5.

Show title

Enable showing title of realty in slider.

Linked Image

Enable you to click on image to view realty's detail.

Show description

Enable showing description of realty in slider.

Description Max Chars

The maximum character of description to show in slider.

Show Read more

Enable showing button “”Read more”

Read more Text

You can change text of button “Read more”

JSE Real Estate Agent Search Module

This is the classic agent search module. It helps you to find an agent or list of agents.

Module settings

Mod jse re agent search option.png

JSE Real Estate Search Realty Module

It is a module displaying a search realty form.

Module settings

Mod jse re realty search option.png

Module Class Suffix

A suffix to be applied to the CSS class of the module.

Layout

There are two types of displays you can choose: displayed vertically.

Extra fields

Maximum number of donors to display.

Advance search

It is set to yes then all search options will be shown such as Extra fields, Date, Currency…

Search date

Show date option

Show currency

Show currency option

Toggle advance

It only shows toggle advance button. This is only used when advanced search option is set to yes.

Min price

This is a basic field used to display the minimum price.

Max price

This is a basic field used to display the maximum price.

JSE Real Estate Categories and Types Module

Mod jse re types categories view.png

Module Class Suffix

A suffix to be applied to the CSS class of the module.

Order by

There are two types of displays you can choose: displayed vertically and horizontally

Count Realties

Show number of Realties on each category.

JSE Real Estate Recently viewed Module

This module shows a list of realties user has recently viewed in slider.

Mod jse re recently viewed option1.pngMod jse re recently viewed option2.png

Count Realty View

The number of realties show in module. Recommended value is > or = 5.

Show title

Enable showing title of realty in slider.

Linked Image

Enable you to click on image to view detail realty.

Show description

Enable showing description of realty in slider.

Description Max Chars

The maximum character of description to show in slider.

Show Read more

Enable button “”Read more”

Read more Text

You can change text of button “Read more”

Realty default

Select list of realty will be shown in recently module when users view site the first time.

Plug-ins configuration

PayPal Plug-in

This is a payment plug-in. It allows users to register an agent via PayPal method.

Plug-in settings

Plugin paypal.jpg

Test mode

If yes, the payment through this plug-in will go to PayPal Sandbox test instead of real payment page.

Note: the Secure mode must be Yes for Test mode to perform correctly.

Secure mode

Use PayPal secure response URL.

PayPal Account

Your PayPal’s account.

Merchant image

Your merchant image URL.

Payment logo

PayPal Logo URL to show at payment listing.

Log IPN data

Log all the payment information to folder plugins/jserealestate/paypal/paypal/ipn_log.txt

No Shipping

Choose Yes for no shipping method, use this for intangible products/items.

Offline Payment Plug-in

Sometimes, Agents cannot register agent through online method. This Offline Payment plug-in helps you enable this type of payment. By default, when Agents choose Offline Payment, the payment will be approved automatically. You can view it later on [ Agent Management Panel] in Backend.

Plug-in settings

The only parameter for this plug-in is Transaction ID that will be displayed on agent detail page. By default, it is set to OFFLINE.

2Checkout Plug-in

This is a payment plug-in. It allows users to register an agent via 2Checkout method.

Plug-in settings

Plugin checkout.jpg

Payment logo

2Checkout Logo URL to show at payment listing.

Merchant ID

Your 2Checkout merchant image URL.

Secret Word

Your 2Checkout secret word.

Routine

2Checkout routine, Single page for one step checkout, Multi page for multi-page checkout.

Mode

2Checkout mode. Testing or Live.

Email Merchant

Send email to merchant when new payment is placed.

FAQs

Customization Guide

In this chapter, we will show you how to create a template for JSE Real Estate component.

Multiple Templates system

This component as well as all the components from Joomseller.com has multiple templates system.It means that you could create unique and differential templates and switch between them anytime you want.

So, how to create a new template, it’s very simple:

  • Go folder “components/com_jse_real_estate/templates/”. You could see that there’s a folder named “default”, this is our default template.
  • Duplicate folder “default” and give new folder a name call “your_template”. Make sure that all files in folder “default” are copied to folder “your_template”.
  • Now you can go to “JSE Real Estate Control Panel” => “Configuration” => “General”. You can see in Template block, there’re “default” and “your_template” in Default template dropdown list. If you choose “your_template” our component will use “your_template” to display.

Now, you’ve already created a new template. And the best past is you could modify it in any way you like,if anything went wrong, you could always switch back to our default template.

Please see our next part to know how to create template as you want correctly and effectively.

Modify JSE Real Estate template

Note before you do anything

First, please remember that you need to know about HTML & CSS before doing anything. If you don’t know, we highly recommend that you read two tutorials:

Second, please keep in mind that you must only modify “your_template”, don’t change anything in our default template.

Customize template

Tools

We highly recommend that you should use Firebug (plug-in for Firefox). It’s very useful tool. When you browse a webpage, you could right click on any element (image, button, link…), choose “Inspect Element with Firebug”. You will see all the HTML & CSS resources, the CSS values that affect this element and where you could find those values too. Moreover, you could modify CSS values right on the browser to see how your page will be changed before actually editing it on CSS file.

How to customize correctly

We have template files and resources files. Template files have structure and resources files include style and images. You could modify resources file: edit CSS values, change image files as you want. Template files should be used only for reference about element information such as: name, type and CSS class.

Resources file

All our CSS files and images are stored in folder your_template/assets.

jux_realestate.css

Common CSS file, the CSS for realties page and realty detail page are all written here.

rotator.css

Contain common the CSS setting of slide show for this component.

simpletabs.css

Contain all the CSS setting for Menu tab in view myrealty.

slimbox.css

Contain some CSS setting for picture viewer window.

style.css

Contain common the CSS setting ofslide showfor this component.

Template files

All the templates files used for displaying at frontend are stored in folder your_template. The source codes in those files are a little bit complex, because they included PHP code.But you should easilyspot the html structure there.

addagent.php&addagent…..php

Template for registering an agent page

addagent.plan


agentrealties.php&agentrealties_....php

Template for agent detail page with their realties

agents.php& agents_...php

Template for agents page

categories.php& categories_....php

Template for categories page

categories_item


category.php& category_...php

Template for category detail page

companies.php& companies_...php

Template for companies page

companyagents.php&companyagents_...php

Template for company detail page with their agents

companyrealties.php&companyrealties_...php

Template for company detail page with their realties

confirmagent.php

Confirm form for view addagent

featured.php&featured_realty.php

Template for featured realties

featured_realty


form.php


hot.php&hot_realty.php

Template for hot realties

list.php& list_...php

Template for realties default layout and table layout

maprealty.php

Template for realties on Google map

message_delete.php

Template for messages to list, edit, delete, reply message.

message_display.php


'message_list.php


message_message.php


message_send.php


message_share.php


myrealty.php

Template for owner realties

openhouses.php&openhouses_item.php

Template for realties

realty.php

Template for realty detail page

types.php&types_item.php

Template for types page



Developer Guide