BT Property User Manual 1.0
-
Upload
marenindza -
Category
Documents
-
view
233 -
download
0
Transcript of BT Property User Manual 1.0
-
8/10/2019 BT Property User Manual 1.0
1/42
BT PROPERTYJOOMLA EXTENSION
User guide
Version 1.0
Copyright 2014 Bowthemes.com
-
8/10/2019 BT Property User Manual 1.0
2/42
1
www.bowthemes.com
Table of Contents
Introduction ................................................................................. 2
Related Topics: ................................................................................................. 2
Product Features .............................................................................................. 2
Installing and Upgrading ............................................................... 3
System Requirement ........................................................................................ 3
Downloading .................................................................................................... 3
Manual Installation .......................................................................................... 3Module Upgrading............................................................................................ 5
Uninstalling ....................................................................................................... 5
Settings ......................................................................................... 6
Properties Manager.......................................................................................... 6
Property status: .............................................................................................. 16
Categories Manager ....................................................................................... 17
Extra Fields Manager.................................................................................... 21
Review system: ............................................................................................... 23
Configuration .................................................................................................. 24
Common Error Using Product................................................ 38
Problem with Flash Uploader ......................................................................... 38
Conflict with sh404 Component ..................................................................... 38
Uninstall by limitation of file size ................................................................... 39
Problem with image processing ..................................................................... 39
Contacting Bowthemes ............................................................... 41
-
8/10/2019 BT Property User Manual 1.0
3/42
2
www.bowthemes.com
Introduction
BT Property is a free responsive real estate component for Joomla 2.5 and 3.x. In addition toessential features including management of properties, categories, locations and agents; BT
Property allows users to create custom extra fields by groups, and supports with Google Map,
OpenStreetMap and advanced search. Also BT Property can decentralize right by user groups
such as front-end submission allowance. Let customers experience marvelous features of BT
Property component on your realty site.
Related Topics: Details View Demo Forum
Product Features
Properties Management
Flexibility: BT Property component allows you to create multi-level of Categories, fully
attributes for Properties.
Representative image: Each property has a mini image album, its very easy to upload
images by Flash Uploader and you can select a featured one.
Extra fields: Ability to well manage extra fields in accordance with categories and property
items. Extra fields can be grouped.
Mapping system
Google Map and OpenStreetMap: BT Property supports both of them
Map style customization: You can get styled Google Maps as well
Marker cluster: Allow to group a large number of makers
Voting and Commenting System
Easy to customize: Configurable voting and commenting system; enable to show avatar.
Security system: Limit characters, anti-spam with Captcha
Highly Optimization
Powerful plug-ins: Search Plug-in is included. Article Plug-in allows users to insert projects
into articles is included
Friendly interface: SEF and breadcrumbs are supported.
Cross-browser support
Compatible with Joomla 1.7 or above; and almost all web browsers: Firefox 3+, IE7+, Opera
9.5, Safari, Netscape, Google Chrome, Camino, Flock 0.7+.
http://bowthemes.com/joomla-extensions/bt-property-component.htmlhttp://demo.bowthemes.com/bt-property/http://bowthemes.com/forums/http://bowthemes.com/forums/http://bowthemes.com/forums/http://demo.bowthemes.com/bt-property/http://bowthemes.com/joomla-extensions/bt-property-component.html -
8/10/2019 BT Property User Manual 1.0
4/42
3
www.bowthemes.com
Installing and Upgrading
System Requirement
Server requirements PHP 5.0 or above with GD library is enabled. Please follow this link
to check it
MySQL 5.0 or above
Joomla 2.5.x or above;
Client requirements Firefox 30.x, Internet Explorer 9 or above...
Downloading
BT Property Component is a free extension. You can register and downloadhere.
Manual Installation
Please follow these steps to install the product:
Step 1: Go to Extension Manager
Step 2: Browse the install package
Step 3: Click Upload & Install
http://www.plus2net.com/php_tutorial/gd-support.phphttp://www.plus2net.com/php_tutorial/gd-support.phphttp://www.plus2net.com/php_tutorial/gd-support.phphttp://www.bowthemes.com/http://www.bowthemes.com/http://www.bowthemes.com/http://www.bowthemes.com/http://www.plus2net.com/php_tutorial/gd-support.php -
8/10/2019 BT Property User Manual 1.0
5/42
4
www.bowthemes.com
Illustrated image of successful installation:
-
8/10/2019 BT Property User Manual 1.0
6/42
5
www.bowthemes.com
Module Upgrading
Upgrading of this extension to newest version can be easily done by following again installation
steps above. But we recommend you to back up your changes of source code and language files
in this module before starting any upgrades.
UninstallingFor uninstalling the product, please follow these steps:
Step 1: Go to Extension Manager
Step 2: Click to Manage tab
Step 3: Choose Componenttype
Step 4: Mark checkbox of the module
Step 5: Click Uninstall button
-
8/10/2019 BT Property User Manual 1.0
7/42
6
www.bowthemes.com
Settings
Back-end access: Choose Component from the main menu. Click BT Property to start
configuration process.
All configuration parameters are divided into the following areas:
Properties Manager
Categories Manager
Extra fields Manager
Locations
Reviews
Configuration
Properties Manager
Manage your properties here.
List of properties page
-
8/10/2019 BT Property User Manual 1.0
8/42
7
www.bowthemes.com
Add and Edit Page
To add a new property, click on New button, next, please look on the left side of
browser. To edit, select a property to modify.
o Details tab
-
8/10/2019 BT Property User Manual 1.0
9/42
8
www.bowthemes.com
Title Enter title of Property here. Its required
Alias Alias of Property. No need to enter any value. Its automatically.
Category Choose one or many categories which the property belongs with
Property status Select status of property. Example For Rent
Ordering Choose an order of property. But this parameter isnt available
when you create new property.
Ribbon The ribbon over property image on listing. Example: Free Visit
Price Enter price for property
Agent Select agent for property
Featured Mark a property as the featured one
Allow rating Users can give you a stars rating which is displayed in property
detail and then leave a comment
Access Choose an access level (to allow the person who can view this
property).
Language Choose a language
Status Choose a publication status with two options: Published and
Unpublished
ID Product ID, its 0 when you are creating a new one.
-
8/10/2019 BT Property User Manual 1.0
10/42
-
8/10/2019 BT Property User Manual 1.0
11/42
10
www.bowthemes.com
If you do not specify, the icon of property category will be used
Place on map You can drag and drop the marker to set the location of property. The latitude,
longitude and zoom level will be updated automatically
o Extra Fields
This is Extra Fields tab in Property Edit Page, all extra fields of categories, of which the
property are listed here. You can enter or select a particular value to these extra fields.
-
8/10/2019 BT Property User Manual 1.0
12/42
11
www.bowthemes.com
o Media tab
Manage propertys gallery here:
-
8/10/2019 BT Property User Manual 1.0
13/42
12
www.bowthemes.com
- Upload images: you can select either Flash Upload or Simple Upload in component
configuration:
+ Flash upload: You can upload all images at once. However, this function might not
working properly on some hostings and browsers, so you have to switch uploader to
simple upload
+ Simple upload: You must click the + icon and x to add/remove more upload boxes.
You only select one file for one upload box. Please see the following illustrated image:
-
8/10/2019 BT Property User Manual 1.0
14/42
13
www.bowthemes.com
- Deleting images: You can completely remove one or multiple images by clicking Clear
all or click the Remove button on each images when you mouse over them.
- Making an image default: you can choose and make an image as the propertys default
image by clicking radio button on top-left corner of image.
- Edit image info: Click edit button on each images, enter title and description in the
popup window
- Ordering images: just drag and drop it to new position
-
8/10/2019 BT Property User Manual 1.0
15/42
14
www.bowthemes.com
o Related properties tab
Click add new and select one property to make it as the related property. You can clickRemove or Clear All button to delete one or all of them.
o Advanced tab
Created date Select a date from Date Picker or let it be selected automatically
Modified Date Last modified date of property. Itsfor read-only
Hits Number of property hits.
Comment Total Number of comments on the property
o Metadata tab
-
8/10/2019 BT Property User Manual 1.0
16/42
15
www.bowthemes.com
Meta Title Title of propertys details page.
Meta Keywords Value of HTML Keywords Meta Tag. Each word is separated by a
comma. Frequently used for SEO
Description Enter a paragraph that will be value of HTML Description Meta Tag.
Used for SEO
Robots Choose value of HTML Robot Tag. All of options are:
- Use Global
- Index, Follow
- No Index, Follow
- Index, No Follow
- No Index, No Follow
Author Value of "author" meta tag
-
8/10/2019 BT Property User Manual 1.0
17/42
16
www.bowthemes.com
Content Rights Value of "copyright" meta tag
o Permissions tab
See more in the permissionspage
Property status
You can add and manage the status of property on this page:
This status can be searched, filtered, sorted in frontend.
This is the position where status can be showed
Listing page: Detail page:
Searching module:
-
8/10/2019 BT Property User Manual 1.0
18/42
17
www.bowthemes.com
Categories Manager
Manage all categories here. This is the screenshot of Categories Manager:
Add/edit a category
-
8/10/2019 BT Property User Manual 1.0
19/42
18
www.bowthemes.com
Title Insert Category name here. Its required
Alias Alias of category. You can enter a text or let it empty. Module will
assign a value base on categorys title.
Parent Choose a category to make it parent of current category
Ordering Order category here. Only use this parameter when new category is
created.
Access Choose access level (who is allowed to view) of this category
Language Choose language which the category is assigned to
-
8/10/2019 BT Property User Manual 1.0
20/42
19
www.bowthemes.com
Status Choose Status for category
ID Id of category. At the time of creating a category, the value is 0
Main image Main image is shown as thumbnail id grid of categories
Short Description Enter description of category here
A category also has other parameters. Please take a look on the right side of screen, you will
see these sections: Category options, Category Layout, Metadata, and Permissions (see more
in the Permissions page)
*Note: Value Use Global in a parameter means that this parameter will have the same value
with the corresponding parameter in Configuration section
Extra Fields Choose list of extra fields
Inherited If you choose Yes, Extra Fields will be inherited from parent
category
You can choose a category to make parent of current category
Show on navigation Select whether you want this category to be shown on categories
menu
-
8/10/2019 BT Property User Manual 1.0
21/42
20
www.bowthemes.com
Category Layout There are 04 layouts to display properties list of this category:
- Use Global
- Grid Listing
-
Line Listing
- Mansory Listing
Meta Title Title of categorys details page.
Meta Keywords Value of HTML Keywords Meta Tag. Each word is separated by a
comma. Frequently used for SEO
-
8/10/2019 BT Property User Manual 1.0
22/42
21
www.bowthemes.com
Description Enter a paragraph that will be value of HTML Description Meta Tag.
Used for SEO
Robots Choose value of HTML Robot Tag. All of options are:
-
Use Global
- Index, Follow
- No Index, Follow
- Index, No Follow
- No Index, No Follow
Extra Fields Manager
Each property can have different informations like Area, Beds, Baths, Garages, Thats why this
component was built with an Extra Fields Manager. Extra fields will be assign to each category.
Managing them in BT Properties is as simple as in other original components of Joomla. It
contains a list, toolbar, filter and ordering.
-
8/10/2019 BT Property User Manual 1.0
23/42
22
www.bowthemes.com
Title Giving name of extra fields here
Type Choose one of 08 types:
- Link: using a tag
- Image: using img tag
- String: using textbox
-
Editor: using editor to enter data
- Measurement: using for the measurement and searching purpose.
Example: the number of room, area
- Dropdown: Select one of the given options. Example: Quality (High,
Normal, Low)
- Checkboxlist: Allow to select multiple options. Example: Features
(Air conditioning, Internet, Use of pool, Cable TV, Terrace, Hi-Fi,
Beach, Balcony)
- Date: using a calendar to enter data.
Default Value This parameter will be shown after choosing type (Link, Images, String,
-
8/10/2019 BT Property User Manual 1.0
24/42
23
www.bowthemes.com
Editor, Measurement, Date). There are different parameters corresponding
with each type. This value is just default, when the extra field is assigned to
a category, and can be changed.
Default Options This parameter will be shown after choosing type (Dropdown & Checkbox
list)
Enter options for dropdown/ checkbox list. The values are separated by
new line.
Description Enter description of extra field here
Ordering Order extra field here. Only use this parameter when new extra field is
created.
Status Choose from 02 statuses: Published (default) and Unpublished.
Featured Featured extra fields will be showed on the listing page and the first block
of property detail page (summary information)
Show on submit If yes, this extra fields will be showed on frontend submit property page
Show the label Show or hide title label of extra field
Group Select group for the extra fields. The group can be created in Extra field
group manager
Categories Select the categories that you want to assign
Review system
This feature allows users to comment and rate properties. You may turn off this feature for all
properties using component configuration () or for each property using property parameter.
-
8/10/2019 BT Property User Manual 1.0
25/42
24
www.bowthemes.com
Configuration
This section allows you to configure whole component like: display options, slideshow options
or print options Its is a modal window, you can open it by clicking Option button on the top-
right corner of the page.
After clicking, a modal window is showed. It contains 05 tabs:
Display Options: These are parameters relating themes, price options, image quality,
etc
Review Options: All parameters of Comment and Voting System are gathered here.
Agent Options: Allows you to integrate with BT Social Connect. You can disable empty
agent (who doesnt have any property) in the agents listing page
Advanced Options: Submission, Uploader, Watermark parameters are putted into this
tab.
Permissions: Permissions for users
Lets discover each tab to see how they work.
Display Options
-
8/10/2019 BT Property User Manual 1.0
26/42
25
www.bowthemes.com
o Themes Options
Select theme Currently, we only support one theme: default. You may clone this
theme to make your custom theme.
- Copy the folder of theme
components/com_bt_property/themes/defaultand then
rename to your custom theme you want.
- Return this configuration and then select your custom
theme
- Click save and check the new theme in front end
o Listing Options
-
8/10/2019 BT Property User Manual 1.0
27/42
26
www.bowthemes.com
Properties list limit Select number of properties per page
Properties order Order properties here
Images order Order images here. This order is used in property detail
page for the images gallery
Images order direction Choose direction for images ordering.
Properties order direction Choose direction for ordering. ASC or DESC
Category order Choose an order that properties will be showed in a
category
Category order direction Choose direction for category ordering.
o
Category Layout
-
8/10/2019 BT Property User Manual 1.0
28/42
27
www.bowthemes.com
Category layout Choose from 03 layouts: Grid listing, Masonry listing and, Line
listing. You can override this value in Properties List Menu
parameter
Masonry Listing Layout in Default theme
-
8/10/2019 BT Property User Manual 1.0
29/42
28
www.bowthemes.com
Grid Listing Layout in Default theme
-
8/10/2019 BT Property User Manual 1.0
30/42
29
www.bowthemes.com
Line Listing Layout in Default theme
-
8/10/2019 BT Property User Manual 1.0
31/42
30
www.bowthemes.com
o Image Options
Large img processing There are 4 options:
None: Import image from original folder.
Crop: Crop image by image width, image height and by cropping
position.
Resize: Resize image by image width, image height.
Resize and keep ratio: Resize but keep ratio between width and
height provided that image size isnt exceeding configured size.
Thumb img processing There are 4 options:
-
8/10/2019 BT Property User Manual 1.0
32/42
31
www.bowthemes.com
None: Import image from original folder.
Crop: Crop image by thumbnail width, thumbnail height and by
cropping position.
Resize: Resize image by thumbnail width, thumbnail height.
Resize and keep ratio: Resize but keep ratio between width and
height provided that image size isnt exceeding configured
thumbnail size.
Crop Position Select a position to crop images from 07 positions below:
-
TopLeft
- TopMiddle
- TopRight
- BottomLeft
- BottomMiddle
- BottomRight
-
Center
JPEG Quality Quality of cropped images. The value is from 1 to 100
Image Width Specify width of cropped images
Image Height Specify height of cropped images
Thumbnail Width Specify width of thumbnail images
Thumbnail Height Specify height of thumbnail images
Slideshow Thumb Width Specify width of slideshow thumbnail images
Slideshow Thumb
Height
Specify height of slideshow thumbnail images
-
8/10/2019 BT Property User Manual 1.0
33/42
32
www.bowthemes.com
Reviews Options
Enable review Enable/Disable review system
Allow Guest Select whether you allows website visitors to review for your
property
Auto publish review If you select Yes, reviews will be approved automatically
Limit Characters Specify the maximum number of characters in a comment
Comment display order Choose from two options: Date Ascending and Date Descending
to order comments
Comment per page Choose number of comments on a page
Agent Options
-
8/10/2019 BT Property User Manual 1.0
34/42
33
www.bowthemes.com
This tab configuration is used to integrate BT Social Connect component. You can select what
the fields in BT Social Connect User will be gotten and shown. If BT Social Connect
Component is not installed, all these fields will empty.
Agent contact fields Select one or more fields for contact info
Agent about field Select only one field.
Advanced Options
-
8/10/2019 BT Property User Manual 1.0
35/42
34
www.bowthemes.com
o Submission
Auto-
publish
properties
If you enable this options, the submitted property in frontend will be
published automatically. Else, they have to be reviewed by administrator
o
Uploader
Admin Upload Type Choose Simple or Flash Upload to upload images to
propertys gallery. Flash Uploader has greater view than
Simple. In case that it has error, please use Simple instead.
-
8/10/2019 BT Property User Manual 1.0
36/42
35
www.bowthemes.com
Frontend upload type Enable the upload method will be used in frontend. Similar
to Admin Upload Type
Front end file upload max size Limit the size of each upload image
Number of images Maximum number of images per property (Frontend only)
o Watermark System
Watermark System Use Watermark System on images
WM in categories Choose Categories on which you want to apply watermark
system
WM on thumbnail Apply watermark on thumbnail
WM Type Choose one from two watermark types: Text or Image
WM Text If you choose watermark type is Text. Please enter a text
string here
WM Image If you choose watermark type is Image, browser a image
from folder images of Joomla
WM Font Choose font for watermark
WM Font size Specify watermark font size
WM Font color Enter a hexa code for watermark color. For example: ffffff
(white) or 000000 (black)
WM Background Select whether you want to add background for text
watermark
WM Background Color Enter a hexa code for WM Background color
WM Position Choose a position for WM from 05 positions below:
TopRight
-
8/10/2019 BT Property User Manual 1.0
37/42
36
www.bowthemes.com
TopLeft
BottomRight
BottomLeft
Center
WM Padding Enter padding of watermark. Unit: pixel
WM Opacity Its only available for image watermark. You can set
transparency level here (Value: from 0 to 100)
WM Rotate Specify watermark image overlay rotation. Unit: Degree
o Libraries
If your site is not use bt-zoner & bt-property templates, jquery, bootstrap & owl carousel
libraries is required.
Permissions
-
8/10/2019 BT Property User Manual 1.0
38/42
37
www.bowthemes.com
This is a high advanced and important function for frontend submission and editing. The
permission of user can be managed here. You should set Create, Edit own, Delete Own,
Upload mediafor agent users in frontend whom can submit properties on your website.
- Create: Agent User can create and submit properties
- Edit own: Agent User can edit their properties
- Delete own : Agent User can delete their properties
-
Upload media: Agent User can upload the images for their properties
Please read more this article:
J2.5:http://docs.joomla.org/J2.5:Access_Control_List_Tutorial
J3.x:http://docs.joomla.org/J3.x:Access_Control_List_Tutorial#Component_Options-
.3EPermissions
http://docs.joomla.org/J2.5:Access_Control_List_Tutorialhttp://docs.joomla.org/J2.5:Access_Control_List_Tutorialhttp://docs.joomla.org/J3.x:Access_Control_List_Tutorial#Component_Options-.3EPermissionshttp://docs.joomla.org/J3.x:Access_Control_List_Tutorial#Component_Options-.3EPermissionshttp://docs.joomla.org/J3.x:Access_Control_List_Tutorial#Component_Options-.3EPermissionshttp://docs.joomla.org/J3.x:Access_Control_List_Tutorial#Component_Options-.3EPermissionshttp://docs.joomla.org/J3.x:Access_Control_List_Tutorial#Component_Options-.3EPermissionshttp://docs.joomla.org/J2.5:Access_Control_List_Tutorial -
8/10/2019 BT Property User Manual 1.0
39/42
38
www.bowthemes.com
Common Error Using Product
Problem with Flash Uploader
At present, some web browsers dont support Flash/ HTML5 or theyre having problems with it,so you cant upload images to propertys gallery. Please use Simple Uploader instead, its just
an original File input of HTML.
Conflict with sh404 Component
If you are using sh404 for SEO on your site, your website may come across an error (Not Found
404 or Internal Server Error 500). In this case, please open sh404 component, find BT
Property in By component tab then choose Use Joomla Route for the component as the
following image:
-
8/10/2019 BT Property User Manual 1.0
40/42
39
www.bowthemes.com
Uninstall by limitation of file size
Installation package of this component takes 2MB, not too large, but the problem here is that
some hosting services only allow customers to upload file with capacity less than 2MB. To solve
it, you should contact with your hosting provider to increase upload max size.
You can see this information in Site > Site Information > PHP information tab
Problem with image processing
If you use BT Property in a long time, many images were created. In case that you try to change
its size in control panel, that might cause the server to be overloaded because it cant process
all images at the same times. Thus, after setting a new dimension of the images, please save
change and click Rebuild Image in Propertys Managerto resize images one by one.
Afterward, the web browser will direct to the page that shows you progress of image processing.
-
8/10/2019 BT Property User Manual 1.0
41/42
40
www.bowthemes.com
After successful image rebuilding, browser will redirect to previous page with a notice like
illustrated image:
-
8/10/2019 BT Property User Manual 1.0
42/42
41
Contacting Bowthemes
All Bowthemes products include forum support, email support and ticket support.
Please refer your membership package to select the compatible kind of support, as we may be
able to solve the problem without delay.
Website:http://bowthemes.com
Forum support:http://bowthemes.com/forums/
Email support:[email protected]
Ticket support:http://bowthemes.com/submit-a-ticket
If you encounter any issues with Bowthemes extensions and templates, email us at
[email protected] we will be happy to answer your questions.
This document is proprietary and confidential. No part of this document may be disclosed in any manner
http://bowthemes.com/http://bowthemes.com/http://bowthemes.com/forums/http://bowthemes.com/forums/http://bowthemes.com/forums/http://localhost/var/www/apps/conversion/tmp/scratch_9/[email protected]://localhost/var/www/apps/conversion/tmp/scratch_9/[email protected]://localhost/var/www/apps/conversion/tmp/scratch_9/[email protected]://bowthemes.com/submit-a-tickethttp://bowthemes.com/submit-a-tickethttp://bowthemes.com/submit-a-ticketmailto:[email protected]:[email protected]:[email protected]://bowthemes.com/submit-a-tickethttp://localhost/var/www/apps/conversion/tmp/scratch_9/[email protected]://bowthemes.com/forums/http://bowthemes.com/