3 Frontend: Agent / Visitor / Admin
The Frontend refers to the platform and functions accessed directly from the website/URL before or after login to the website. This ranges from performing property searches as a visitor to adding/editing properties and agents (based on access rights) listed on the site. In this section we will describe how each feature works and the varied rights of each member that access the site.
3.1 Add Listing
Add Listing, also known as the Property Wizard, is included in the frontend interface to add new property listings to your website. This is only available to users with access to this feature.
To start, you must login through the front end of your website (depends of your joomla template). This will require your Joomla Username & Password.
Once you are logged in, Select the UPL dropdown Menu "Manage Listing", then select "Add Listing" (red arrow).
This will take you to a screen where you enter all of the necessary details of the property.
Note: This is called Add Listing Wizard or Property Wizard. The data fields of this form is flexible and managable through the Flex Add-on in the administration (backend) section of the website.
There are several section tabs on the left side and each has detailed information that needs to be completed for the property listing. Tabs shown are based on the add-ons you have installed. For example, the CRM and the availability calendar would each be an additional tab.
UPL allows you to set fields based on the listing type (for sale, for rent, etc) or property type (home, apartment, office, etc). Fields that are listing specic or property type specic will be shown after the listing type or property type is chosen.
For example, if the property type "apartment" is selected, then the "bedroom" field appears; however, if "office" were selected then the "room" field would appear.
Different tabs will be shown based on the listing type or property type selected, such as the calendar tab, which is only shown for vacation rental listing types.
Please note that you can change these settings through the Flex Add-on in the administration section (backend) of UPL.
3.1.1- The Basic Details
The Basic Details tab starts with the Property Title field. Using descriptive words to name the property is recommended.
The following Listing Setting section has fields for basic property information,such as Listing Type, Price, etc.
In this example the title is set as multilang a tible by language must be set.
In the Details section, there is a text box for a detailed property description. This includes a Toggle Editor button, which generates your plain text into an HTML code. After completing the property description, remember to click the "Save Property Description" button.
The last section is the Meta Keyword and Meta Description. There are two fields that will be automatically filled which are generated based on the information entered in the previous fields. The metadata fields will be used for Search Engine Optimization purposes, which results in driving traffic from the search engines.
3.1.2 The Location
The Location tab includes the Address section where users enter the property address information.
Since the last Google Map API an API Key is needed, You have to fill the key it in the UPL configuration (backend)
As the information is entered into the address fields for the first time the Google Map section is automatically locate the property on the map. Any changes to the address will automatically reflect on the Google Map. Users are also allowed to pinpoint the exact location by moving the red map marker. If Google cannot retrieve the address, you will receive the following response: "Geocode was not successful for the following reason: ZERO_RESULTS". Simply move the marker by dragging and dropping it on the actual property location.
3.1.3 The Image Gallery
The Image Gallery tab allows property photos/images to be uploaded. There are three tabs available for uploading process options:
- Pro Uploader (multiple images at one time)
- Simple Uploader (single images).
- Link on image url (not uploaded to your site)
An image title and description can be included. The image category can be assigned to Property Images or Floor Plan. Images can be dragged and dropped by the blue arrow icon to change the order in which they are listed, or deleted by clicking the red X.
3.1.4 The Features
The Features tab includes detail fields such as room sizes, the types of heating/cooling systems, and special features.
Some fields have dropdown menus for additional specications. Fields can be disabled and added through the Flex Add-on in the UPL Backend.
3.1.5 The Appliances
The Appliances tab has options to display any appliances included with the property such as refrigerator, stove, dishwasher,etc. Some fields have dropdown menus for additional specications. The tab itself or its fields can be disabled or edited through the Flex Add-on in the Ultimate Property Listing backend.
3.1.6 The Neighborhood
The Neighborhood tab shows how close local features/places are from the property.Each checked box produces further options to appear, such as distance time and mode of transportation to certain locations, such as Airport, Hospital, School, etc. Fields can be disabled and added through the Flex Add-on in the UPL Backend.
3.1.7 The Videos
The Video tab gives the option to add video links (embed code) from websites such as YouTube.There is a text field for an optional Video Title.
The Attachments tab works like the Image Gallery, with tab options for the Pro Uploader (multiple documents) or Simple Uploader (single documents).
NOTE:It will not upload any le with a picture format (for example: .jpeg).
Attachments can be a PDF or Word/Excel document and should be for public viewing, such as a oor plan or brochure. Attachments can be dragged and dropped by the blue arrow icon to change the order they are displayed, or deleted by clicking the red X icon.
3.1.9 Property Tags
The Property Tags tab offers tags that can be selected for each property to highlight selling points on the listing. Simply check the box for the tag to be inserted in the listing. Additional property tags and icons can be added through the Flex Add-on in the UPL Backend.
Open house dates can be chosen and agents can leave notes such as "call before coming to the open house".
The Finalize tab secures all the property information entered in all of the other tabs and publishes the property to the website. This process essentially checks all the required fields and warns if they are not properly submitted to the system.
It is important to understand that all property details that are entered are automatically saved ajaxly. This is useful in the event your entry process is interrupted or disconnected, as the data entered is not lost. You can return later and continue where you left off.
This notice will remain below the Finalize tab until this process is completed:
When your property as been finalized, this notice will appear:
3.2 Property Details Page
The Property Details page is where most details about a property can be seen by all visitors, including registered and unregistered users. There are several ways to view the details of a property published on the frontend of your website.
As Admin/Super User/Agent, after entering and nalizing the property details in the Add Listing platform, select "Click here to view this property" from the finalized page (shown above). This will take you to directly to the property details page (seen below).
From the Home Page, (as any user) you can view the any published properties listed on the front page. Click the Details button on the specic property to display the page (as seen above) with the details of the estate.
1.0 Installing UPL
UPL is a Joomla Component(Package) that includes a core of several modules and plugins. Some of these modules are internal and they are set automatically, while some need installation and further conguration.
In order to setup UPL, you must have the Joomla CMS package installed on your server. This free downloaded (plus more details about Joomla) can be found directly on the website: www.Joomla.org. Please note that UPL is only compatible with Joomla versions 3.0 and later.
Make sure that your server or web-hosting servicesupports the PHP versions 5.3 or 5.4 (we no longer support versions 5.2 or older).
To determine your current PHP version, follow these 3 steps:
- Login to your Joomla administration backend
- Select "System Information"
- Locate the PHP version listed
1- Download the package
Once you have conrmed which PHP version you have, you cannow download the Package on faboba.com.
2- Install the package
Return to the Joomla backend manager. Find the Extensions tab/dropdown menu at the top and select Extension Manager. Click on Install, which will prompt you to choose a package file to upload. Locate the UPL zip files , then click Upload & Install or use the new drag&drop system
3. Check the install
The UPL installer takes care of all necessary modules/plugins. After the le is uploaded and UPL installation is complete, an item will be added to your Joomla backend under the Components dropdown menu called Ultimate Property Listing. Click on it to begin the installation wizard.
You will need to enter initial settings for running UPL for the first time. If the installation goes without any problems you will see three green checks stating that the libraries, modules and plugins are installed and configured. The picture below is an example of what you should see.
Note : If any of the check signs are red, this indicates that the part(s) is not installed correctly, which could be for various reasons based on your server congurations
On the left are default settings that must be configured before using UPL:
- Country: Set the default country based on where your properties are located
- Currency: Select a currency denomination. Additional currencies can be added through the UPL currencies and measuring units under the data structure. There is no limit for the amount of currencies.
- Area Unit: Choose a measuring unit, such as square foot or meters. Additional measuring units can be added through the UPL currencies and measuring units under data structure.
- Length Unit: Choose a measuring unit, such as square foot or meters. Additional measuring units can be added through the UPL currencies and measuring units under data structure.
- Long lengh:Used for radius search. Choose a measuring unit, such as square foot or meters. Additional measuring units can be added through the UPL currencies and measuring units under data structure.
- Website Layout: UPL inner views have two kinds of CSS (cascading style sheets): dark templates and light templates. If your template is black/dark, choose the dark option. If it is white/light, choose the light option. This can be changed at anytime under view settings, then template manager. The dark/light CSS system can be expanded by customization to the template CSS. For further information, see the template manager documentation.
On the right side, some of your server congurations are displayed. The minimum requirements for each item are shown. For instance, your server PHP version should be at 5.2 so the server status of 5.2.4 is accepted. Below the status you may see a red circle warning icon, which means your server does not have the minimum requirements and UPL will not function properly.
Some settings are not crucial for proper functioning of UPL, but are recommended. If your server settings are less than the minimum requirements then you will see this yellow triangle icon: (For example, settings such as CURL would produce this sign).
Through the Joomla standard menu management system, you can create menus for UPL, including Property Listing Display, Add Listing, etc. It is also possible to do it with one click through the menu wizard on the bottom right. You can select a Joomla parent menu where sample menus are automatically created.
After you submit the settings you will be directed to the following UPL dashboard: Congratulations, you have now successfully installed Ultimate Property Listing!
2 Basic Setup
After the installation of UPL, in order to show its features on the frontend, some congurations must be done including:
- Creating menus
- Activating UPL modules that are installed along with UPL
- Installation of the related Locality Package
- Uploading your company logo
2.1 Creating UPL Menu
There are two ways to create a menu :
Creating Menu from UPL back-end:
1- Select Ultimate Property Listing from the components top menu, in the backend of the Joomla control panel.
2- Select Setting & Tools tab from UPL admin interface.
3- In the Menu Creation section of the Settings & Tools tab, select the menu that you want to add UPL Menu (Main Menu, Top Menu, Side Menu, etc). This is different from template to template, so first try to identify each menu on your template.
After selecting the menu location, click on Add Menu Items. This will automatically add UPL menus within the selected menu.
Creating Menu from Joomla Menu Manager
Alternatively to the above method, you can also add UPL menus through Joomla itself.
1- Click on Menu Manger from Menus (Joomla backend)
2- Click on New to Add a Menu OR Menu Items and and set the menu type. Please note that you need to select the menu that you want to publish UPL menus on. Whether it is the Main Menu, Top Menu, etc.
2.2 Activating UPL Modules
UPL Core comes with many dierent modules.
1- Some of these modules will be installed and activated automatically along with UPL Core package.
2- Some of the modules will be installed but need to be activated individually. The module activation includes assigning the module to a 'module position', activating it and then configure it if necessary.
3- Some of the modules need to be installed separately and then go through activation process.
Note: Please note that each template has its own set of 'module positions'. So a module will look dierent on dierent positions of your website.
In order to see the positions of modules on your Joomla website, you can do it through adding /?tp=1 to the end of the url of your website: http://www.your-domain.com/?tp=1
If adding /?tp=1 is not working, you need to login to the Joomla backend, go to Extensions Menu and select Template Manager. Then select (check) your default site template without clicking on it. On top there is one button called 'Options'. Click on that and enable the 'Preview Module Positions'.
1- To activate a module, click on Module Manager from Extensions Menu.
2- Click on New and then select the module type. All UPL module names start with UPL.
3- After selecting the module type, you need to assigne it to a suitable module position on your website. Sometimes you need to redo this step and assign the module to different positions until you find the most proper position.
4- The next step is configuring the modules (if necessary). We will cover this in later chapters of the documentation.
The following modules will be installed, activated and assigned to positions automatically at the time of Ultimate Property Listing installation.
|Property Listig Agent Info
|Property Listing Direction
|Property Show gallery
|Property Show GoogleMap
|Property Show links
|Property Listing pictures
|UPL payment balance
|next/prev/edit on propertyshow
|UPL Advanced Search Module
|Property Show Property Tags
The following modules will be installed along with UPL but they need to be activated and congured separately:
- UPL Carousel Module
- UPL Currency Module
The following modules are not included in the UPL Standard Package. They need to be installed separately and they need to be activated and configured separately. We cover the installation and configurations of these modules in the Modules chapter of this manual.
- UPL Energy-tag Module
- UPL QR Code Module
- UPL School info
- UPL Walkscore
- UPL Google Places
- UPL Listing Stat Module
- UPL Video Module
- UPL CraigList
- UPL Xmap
2.3 Installing the Locality Package
Real Estate is all about "The Location", therefore one of the important features of any Property Listing application is having a complete location database containing State/Province, County, City, ZIP Codes for each country. Faboba has made the database of a series of countries available for free. For downloading UPL locality packages you should login to www.faboba.com. Under downloads menu in the UPL addons you should click on "Location" tab and then click on locality le name and download it to your computer.
Note: If you can't nd the database of your country, please refer to the Location Manager section of this manual.
Now you should install the downloaded package through the Joomla extension manager like any other Joomla extensions. However, for some packages you need unzip the package first and then install the extracted zip files.
Here is the list of the packages that need to be unzip prior to the installation: