WPL view path is [plugin-folder]/views/[section]/[view-name]/tmpl/[tmpl-files]

Please put the tmpl files in your theme with this path structure: /[theme-folder]/wplhtml/[section]/[view-name]/[tmpl-files]

Example -  If you are using the WPL28 theme, the files should be put into these paths:

Views

propertylisting default tmpl --> /wpl_twentyeight/wplhtml/frontend/property_listing/default.php

propertyshow default tmpl --> /wpl_twentyeight/wplhtml/frontend/property_show/default.php

gallery pshow tmpl --> /wpl_twentyeight/wplhtml/activities/listing_gallery/pshow.php

PDF flyer tmpl --> /wpl_twentyeight/wplhtml/basics/features/pdf.php

Widgets

For overriding the widgets tmpl you would put the tmpl file into this path /wpl_twentyeight/wplhtml/widgets/agents/default.php

Child Theme

The paths are the same if you're using a child theme. For example /wpl_twentyeight-child/wplhtml/frontend/property_listing/default.php

If you didn't put the file on child theme and the file existed on the main theme, WPL imports the file from the main theme.  Otherwise it would include the original file.

Note: There is no need to remove the original files after overriding. You can also modify overridden files without changing the original files.

Note: There is no need to put overridden files inside of /tmpl/ directory.

How to override WPL views on a theme?

How to assign a specific criteria to a listing page?

How to make your theme WPL compatible?

How do you change the style of WPL views, widgets and activities?

How to create new layouts for WPL widgets?

How to add new categories for listing types and property types?

How to add new fields using database?

WPL Database diagram and table descriptions.

How to save URLs of property images instead uploading them to host?

How to add new units into the WPL?

How to show new fields in property listing page?

"You have included the Google Maps API multiple times on this page. This may cause unexpected errors."

For preventing this issue you need to disable Google map library that is loaded via the theme somehow. Bridge theme has an option for this purpose. You need to go to Qode options -> Contact page and set "Enable google map" on "No".

For other themes, First, you should search for an option in the theme backend to disable it. If there is no option, You need to remove it in another way. First, you should find where the google map library is loaded. For this purpose run the following code in your functions.php:

function wp_inspect_scripts() {
      global $wp_scripts;
      foreach( $wp_scripts->queue as $handle ) :
          echo $handle;
      endforeach;
}
add_action( 'wp_print_scripts', 'wp_inspect_scripts' );

All the handles will be printed. Then you need to find the google map handle library and deregister and dequeue in the child theme functions.php:

function wpjs_dequeue_script()
{
     wp_deregister_script('google-maps-api');
     wp_dequeue_script('google-maps-api');
}
add_action( 'wp_print_scripts', 'wpjs_dequeue_script' );

* Consider Google map library handle is "google-maps-api"

Then copy the image URL an save it somewhere. You will need this URL.

Go to WPL28 Settings -> Custom CSS. Copy following code in the text area:

To change Featured Properties background image:

#top_footer_rows .widget_wpl_carousel_widget
{
    background-image: url(url related to the background image you saved before);
}

To change Featured Agents background image:

#top_footer_rows .widget_wpl_agents_widget .background
{
   background-image: url(url related to the background image you saved before);
}

*Note: It is recommended to remove "http://example.com" from the url. For example, if you have this url:

"http://example.com/wp-content/upload/wp-content/uploads/2016/01/bedroom-interior-design-blue.jpg"

You should remove "http://example.com" from the url and add it to the code:

background-image: url(/wp-content/upload/wp-content/uploads/2016/01/bedroom-interior-design-blue.jpg);

As I already mentioned before, This type is useful only for developers who can customize a WordPress Theme so if you are not a developer we don't recommend you to do any of this changes.

          ...
                   <?php
                break;
          case '10':
                    // Add your custom header codes in here. (Important: You should use this customization in child-theme)
                break;
          ...

Since WPL3.5.0, you can add new property type (and manage existing) categories using WPL->Data Structure->Property Types->Categories.

Listing Type Category

To add new categories listing types you should go to the database of your website and then add new records in [wp_prefix]_wpl_listing_types.

Note: Parent key of new records must be 0.

Note: Insert a high number for the id column (more than 10000). It avoids duplicate id conflicts in the future.

1- Check the table column in the [wp_prefix]_wpl_kinds table and add a new column into the kind table. For example, if you want to add a new field for users you should add a new column into the [wp_prefix]_wpl_users table.

2- Add a new record into the [wp_prefix]_wpl_dbst table. These columns are important when adding this record:

- id: You should find the maximum ID of dbst records for setting this ID. (Maximum+1) The Minumum value for ID is 3000. So if Maximum+1 is less than 3000, you should pick 3000 for the ID.

- kind: Insert kind id from [wp_prefix]_wpl_kinds table.

- name: Insert the name of your field.

- type: Insert your field type. In most of cases, clients need to add a text, textarea, number or select field.

- options:  To insert options for this field based on the field you need, this must be in JSON encoded array. You can see other fields as a sample.

- enabled: It should be 1 or 2. 0 means it is disabled.

- table_name: Insert kind table from [wp_prefix]_wpl_kinds table.

- table_column: Insert the name of the column that you added in first step.

- category: Find category ID from [wp_prefix]_wpl_dbcat table and insert it in this column.

- pwizard: This should be 1 if you want to show it on wizards such as Add/Edit listing wizard or the user profile wizard, and should be 0 if you want to hide it.

Note: For some field types you may need to add more columns to the target table using a naming rule. For example:  For neighborhood, features, price etc., you need to add more than 1 field to the target table. Please see the current fields as a sample.

id: Add a high id into this field. 10001 and higher are good values for id column.

type: Insert 1 for length unit, 2 for area unit, 3 for valume unit and 4 for currency units.

tosi: Insert exchange rate of new unit to SI unit. For currencies, SI unit is USD. For other units, m, m² and m³ are SI units.

After adding new unit, it will appear in WPL->Data Structure->Unit manager and you can enable/disable it or make it default unit by sorting it to the top.

WPL search feature work by using standard criteria query strings, so you can simply define your desired criteria for a specific listing page. Some important parameters are accessible through WPL shortcode wizard. For example, you can specify "listing type", "property type", "user", property tags such as "Featured", "Hot", etc so you can use them easily.

If the shortcode wizard parameters are not enough for you and you want to specify more advanced criteria, you can insert the parameters manually on shortcode. Search query parameters are using this structure: sf_[query-type]_[column-name]=[value]

For example, by adding sf_select_listing="9", WPL will show "For Sale" listings. Some query types need 2 parameters like min/max query type. If you send sf_tmin_f_150="1" sf_tmax_f_150="5" it will show the listing that has at least 1 parking space and maximum 5 parking spaces.

Please check this sample shortcode: [WPL sf_select_listing="9" sf_tmin_f_150="1" sf_tmax_f_150="5"]

You can find all the default query types by tracing this path: [wpl-path]/libraries/create_query/

Creating your own query type

You can also simply create your own query type if needed by adding a new file into the [wpl-path]/libraries/create_query/ directory. you can check one of the default ones as a sample.

Overriding query types

Also WPL has a structure to override query type files. For example, if you want to modify textsearch query type, you can copy and paste the original file and save the new file with an underscore in the beginning of its name (ie: you could create this file for overriding textsearch.php default file: [wpl-path]/libraries/create_query/_textsearch.php)

Here is how you can add a shortcode on WPL:

Then in the Carousel widget options you can select the new layout:

Then you can open this layout and apply your changes. You can also override this layout in your theme.

Note: Always select a custom name for your added layouts. If you name your layout to a general name like gallery.php it will be overriden in future if we add a new layout with same name to WPL core.

Note: Don't do this method when you're using WPL Basic because your custom file will remove in next update of WPL basic. You shouldn't put any custom file inside of a WordPress plugin generally because of update scenario of WordPress.

See below for the requirements to create a WPL compatible theme:

1- Use the WPL shortcode wizard to add all of its shortcodes to your pages, add the pages to a menu, then to a menu bar of your theme.  This will enable you to see all the WPL views (Property listings, Single listing, Agent Listing, Single Agent etc).  You should add WPL widgets to your website as well to check their interface.

Note: Some WPL widgets and activities have more than one layout. It is recommended to integrate all the layouts with your theme.

2- Use CSS to add desired styles to WPL views, activities and widgets.

3- If needed, you can override tmpl files in your theme. Please read the following KB article: How to override WPL views on a theme?

4- WPL has many addons, If you're going to include WPL into your theme you should consider both of WPL free and Pro and also all WPL addons. Please contact us for developer license of our addons.

5- You can contact us if you need any help regarding integrating your theme with WPL. We may provide you some awesome suggestions and offers.

Thank you for developing with WPL.

But if you don't want to save images on the host for any reason, you're able to save only image URLs into the WPL items table ([wp_prefix]_wpl_items). This feature called "External images" in WPL and users are able to insert the image links (each link on a new line) on WPL->Add/Edit Listing->Image Gallery->External Images. Then WPL saves the links into [wp_prefix]_wpl_items table.

You can follow the same structure on your massive import code. Just make sure you use exactly the same code. You can see WPL code as a sample here: /path/to/wpl/views/backend/listing/wpl_gallery.php -> wpl_listing_controller::save_external_images function. You should use wpl_items::save($item); function for saving external images.

1- Open [wp_prefix]_wpl_dbst table in your website database and find the field that you want to show and then set its plisting column to 1 instead of 0.

2- Override /path/to/wpl/views/frontend/property_listing/tmpl/assets/default_listings.php file into your (child) theme and then modify it show your desired field data. You can check this KB article for overriding core files into (child) themes. You can find rendered data of your desired field into $property['materials'] variable. Then you can simply print it to the page and apply your desired icon if needed using some CSS codes.

Note: A same scenario is applicable for showing agent fields in profile listing menu. You should override /path/to/wpl/views/frontend/profile_listing/tmpl/assets/default_profiles.php and then print your desired field from $profile['materials'] variable.

wp_wpl_properties: This table stores properties information.
wp_wpl_users: This table stores WPL users (Agents) information.
wp_wpl_dbst: This table stores list of WPL field which exist in the wp_wpl_properties (or wp_wpl_users) table. because the properties table schema is dynamic, we save the field information over here.
wp_wpl_extensions: This table have several concepts. For example, for registering WPL widgets we define the widget information in this table with type of widget or define the widget position (Sidebar) etc. If you want to register a new widget, javascript library, shortcode etc. you can use this table.
wp_wpl_items: This table is for several purposes, For example for saving image of the properties or saving rooms of properties etc.
wp_wpl_menus: WPL menus saved on this table. You can add new menus using this table.
wp_wpl_units: Contains list of Length, Area, Volume, Currency units. You can add new units using this table.
wp_wpl_dbcat: Categories of the WPL fields (wp_wpl_dbst table). For example, Basic Details, Gallery, Address Map etc. You can add new categories or manage current categories using this table if needed.
wp_wpl_addons: List of installed WPL addons.
wp_wpl_logs: Stores WPL logs (If any).
wp_wpl_settings: WPL uses advanced settings form generator. This table contains the settings list and their data.
wp_wpl_cronjobs: List of cronjobs for running in certain periods of time.
wp_wpl_property_types: Property Types save over here. Records with parent:0 are categories.
wp_wpl_listing_types: Listing Types save over here. Records with parent:0 are categories.
wp_wpl_activities: Activity is something like widget but just used by WPL, For example google map is an activity or image gallery etc.
wp_wpl_events: An API for running codes in a certain hook. For example after adding a property or finalizing a property etc.
wp_wpl_filters: An API for filtering WPL values. Its concept is like WordPress filter system.

wp_wpl_location1: Level 1 locations (Country).
wp_wpl_location2: Level 2 locations (State/Province).
wp_wpl_location3: Level 3 locations (County).
wp_wpl_location4: Level 4 locations (City).
wp_wpl_location5: Level 5 locations.
wp_wpl_location6: Level 6 locations.
wp_wpl_location7: Level 7 locations.
wp_wpl_locationzips: Zipcodes.

wp_wpl_dbst_types: Type of WPL fields. This type uses in wp_wpl_dbst table. You can create your own field type if needed.
wp_wpl_sort_options: List of available sort options for certain kinds.
wp_wpl_item_categories: Categories for wp_wpl_items table.
wp_wpl_room_types: Rooms Type for properties.
wp_wpl_locationtextsearch: Cached location information of property for using in WPL autocomplete. (Using Google auto suggest is recommended.)
wp_wpl_setting_categories: Category of WPL settings fields.
wp_wpl_kinds: Available kinds/entities for WPL. 0 means property and 2 means user. By installing Complex or Neighborhood etc. addons you may have more kinds in this table.

Note: We used category in different tables in wpl so you can check following descriptions to make it clear.

wp_wpl_dbcat: Categories of the WPL fields (wp_wpl_dbst table). For example, Basic Details, Gallery, Address Map
wp_wpl_property_types: Categories of property types is in this table, Records with parent:0 are categories. For example: Residential, Commercial, Land.
wp_wpl_listing_types: Categories of Listing Types, Records with parent:0 are categories. For example: Sale, Rental, Vocational.
wp_wpl_item_categories: Categories for wp_wpl_items table. For example: gallery, attachment, etc.
wp_wpl_setting_categories: in WPL backend we have settings, Each settings have a category for example: Global, Gallery, ... , UI Customizer.

[WPL parameter1="value1" parameter2="value2" ....]

for filtering your desired listings you can simply use parameters. For example placing sf_select_listing="9" will filter "For Sale" listings. As you can see this parameter have 3 parts, Let's see what are these parts.

sf

All filtering parameters start with sf prefix.

select

It's operand of your query, you can use following operand types:

select: It uses for looking for a certain value into the listings. For example sf_select_property_type="6" will create `property_type`="6" into the query for finding the listings that have "Apartment" for their property_type column.

notselect: It acts as opposite of select. It adds `property_type`!="6" into the query for finding the listings that are not "Apartment".

multiple: If you want to look for a multiple values, you can use this operand. For example sf_multiple_listing="9,10" looks for listings that are For Sale and For Rent by creating `listing` IN (9,10) query.

text: If you want to search on a listings with a term, then you can use this operand type. for example sf_text_field_312="Johnson" generate `field_312` LIKE '%Johnson%' for finding all listings that have "Johnson" term into their title.

tmin: You can use it for numeric filters. For example if you place sf_tmin_bedrooms="2" into the shortcode, then it will add `bedrooms`>='2' to the query for finding listings that have more than 1 bedroom.

tmax: It acts like tmin but for maximum search. For example if you place sf_tmax_bedrooms="2" into the shortcode, then it will add `bedrooms`<='2' to the query for finding listings that have less than 2 bedrooms.

between: It's a combination of tmin and tmax. For example if you place sf_between_bathrooms="1:3" into the shortcode, then it will generate `bathrooms`>=1 AND `bathrooms`<=3 into the query.

datemin and datemax: They act like tmin and tmax operands but for date fields.

listing

The third part is column name, You can find the column name in Flex menu. Just click edit button of your desired field.

Note: You can insert multiple filtering parameter into the shortcode.

In order to fix this issue in the version 3.2.0 you need to insert next code into your site:

[itemprop=”description”],[itemprop=”description”] p
{
text-transform: initial;
}

 There are several ways where you can insert this code:

1. If you use WPL Pro plugin version you can insert code in UI Customizer. To find UI Customizer you need to go to Wordpress dashboard and then follow the path WPL -> Settings -> UI Customizer, section Custom styles.
2. If you use official Realtyna template Theme28 you need to go to Wordpress dashboard and in left menu you need to go to WPL28 Settings -> Custom CSS.
3. If you use WPL Basic version UI Customizer is not available. In this case, you can insert code in the appropriate location of your theme if your theme support it.
4. You can use any plugin from Wordpress plugin registry that supports custom css codes.

This issue happens because of the "ft_min_word_len" variable in your server's MySQL Configurations.
It's set to default value of 4, which ignores any word shorter than 4 characters.

You need to change this value to 2 so all your searches that contain values less than 4 letters work properly (like San Juan, Los Angeles, etc).
(Set it to a lesser value like 1 is not recommended, Because it may cause performance issues)

To do so (Root access to the server is required):

1- Edit your MySQL configuration at /etc/my.cnf and add the following line at the end of the file:
ft_min_word_len=2
(If the variable is already there, just change its value to 2)

Note: If your website is a Bitnami app, MySQL configuration file is on a different path:
/opt/bitnami/mysql/my.cnf

2- Restart MySQL server
on cPanel based servers:
sudo /scripts/restartsrv_mysql

On Bitnami stack:
sudo /opt/bitnami/ctlscript.sh restart mysql

on generic servers (You may need to use mariadb instead of mysql):
sudo service mysql restart

3- Confirm the value has changed with the following SQL command
SHOW VARIABLES LIKE 'ft_min_word_len';

4- Repair WPL properties table to rebuild the indexes:
REPAIR TABLE `wp_wpl_properties`
(If Wordpress's database prefix is different, make changes accordingly)