• Non-logged users can access the property submission form by clicking on the Submit button in the Menu.
• Note: You can disable this option. Learn more about disabling the submit option here.

The property information will be saved when the Description is filled, but users must register or log in to complete the submission.

Orphan Listings and Auto-Delete Option for not logged in users

When users start submitting a property but don’t finish the registration or login process, the listing is considered an Orphan Listing. These listings will be automatically deleted after a certain period, depending on the Auto Delete Orphan Listings setting.

Orphan Listings Behavior:

Default: Orphan listings are deleted automatically by a Cron Job that runs once per day.

Options:

• Yes: Orphan listings will be deleted automatically after a day.
• No: Orphan listings will not be deleted automatically.

To prevent orphan listings from being deleted, set this option to No in the Theme Options -> General -> Orphan Listings -> Auto delete orphan listings? -> NO

The post Theme Options -> General -> Orphan Listings appeared first on WP Rentals Help.

Read more about all supported payment methods here: Supported Payment Platforms in WpRentals

For WpRentals Included merchants, you can control whether to enable Sandbox or LIVE mode for payments:

• Sandbox – Used for testing the API.

• Live – Used for the LIVE API.

For WpRentals Included merchants, select the Payment Currency:

You can also set the Payment Currency for WpRentals included merchants:

Note: PayPal and Stripe support a limited number of countries and currencies.

• Check PayPal supported currencies:
  https://developer.paypal.com/docs/classic/api/currency_codes/

• Check Stripe supported currencies:
  https://support.stripe.com/questions/which-currencies-does-stripe-support

• See Stripe supported countries:
  https://stripe.com/global

If your country currency is not on the list “Currency for Paid Submission”, please open a ticket in our support system and ask for your currency to be added.

The post Theme Options -> Payment Currency Settings appeared first on WP Rentals Help.

Available Fields for Multi-Selection

The multi-selection option can be enabled for the following fields:

• Property Category
• Property Type
• Property City
• Property Area

These fields are managed from WP Admin > Listings. For more information on how to manage property categories and taxonomies, see how to manage Property Categories / Taxonomies. 

Once the multi-selection option is enabled, users will be able to select more than one category in the dropdown.

To make searching easier, you can enable the Show Search in the Multi-Select Component option. This will add a search bar inside the multi-select dropdown, allowing users to search for specific categories more efficiently.

Adding Property Categories in WP Rentals Search Forms

For detailed instructions on how to add Property Categories to your WP Rentals search form, please refer to this article.

Field Names and Compare Settings

Here’s how the fields and their compare settings work:

Listing Main Category and Second Category:

• You can configure the names for these dropdowns in the Theme Options.
• Ensure you use the Compare Term “like” and set the Label that will display on the advanced search field on the frontend.

Listing City and Property Area (as separate and independent dropdowns):

• You can configure the names for these dropdowns in the Theme Options.
• Ensure you use the Compare Term “like” and set the Label that will display on the advanced search field on the frontend.

The post Enabling Multi-Selection for Property Categories | Taxonomies in the Search Form appeared first on WP Rentals Help.

Overview: In the WPRentals platform, admin can control how payments are handled for bookings. When setting up deposits and service fees, all payments are routed through the admin account, whether through PayPal, Stripe, or other WooCommerce-supported merchants.

Key Payment Settings:

Deposit Fee:

• Admin can set a global deposit value to confirm bookings.
• The deposit can be a fixed amount or a percentage of the booking total.
• If a deposit is set, the user must pay it before the booking is confirmed.
• If the deposit is non-zero, it must cover any service and administrative fees.

Admin Service Fee:

• Admin can set a service fee that is paid by the guest.
• The service fee is deducted from the owner’s earnings, but paid by the guest as part of the deposit.
• The service fee can also be set as a fixed amount or percentage.

Expenses:

• Admin can decide whether to include city and cleaning fees in the deposit calculation.
• If the deposit is set to 100%, including the city and cleaning fees is mandatory.

Possible Booking scenarios:

Instant Booking: No owner approval is required. How to set up Instant Booking

• Guest sends a booking request.
• The renter must pay the deposit (if set by admin) to confirm the booking.
• Payment goes to the admin account.

Manual Booking Approval: The owner must approve the booking request. More on the booking process

• Guest sends a booking request.
• The owner approves or rejects the request.
• If the owner approves, they issue an invoice.
• The renter must pay the deposit (if set by admin) to confirm the booking. The payment goes to the admin account.

Deposit Fee Required (different setup variations)

Important note for Deposit: Choose either percentage or fixed value for the deposit (not both).

Deposit asked is different than 0

• If the Deposit is set to a value greater than 0, the guest must pay that deposit before the booking can be confirmed.
• Deposit required value is set in Add Listing Page & Payment Settings -> Booking Payment Settings

Admin wishes to collect only his Service Fee with Deposit

• If the admin wishes to only collect a percentage deposit as the service fee and leave the remaining payment between the guest and owner outside of the theme, this is possible.
• He needs to set Deposit Fee and Admin Service Fee as equal values:

• In the User Dashboard, the confirmed booking will show the deposit paid and the remaining balance.
• Paying the remaining balance through the theme to the admin account is optional and can be removed with CSS if desired.

Deposit is 100% – full payment required 

• You can choose to include additional expenses (e.g., city fee and cleaning fee) when calculating the deposit.
• However, if 100% deposit is required, these fees must be included.

Admin Service fee

The Service Fee:

• Is paid by the guest and is deducted from the owner’s earnings.
• It is part of the deposit, so the deposit must be greater than or equal to the service fee.

For Service Fee Calculation:

• You can set the service fee as a fixed amount or a percentage (not both).
• The service fee is deducted from the owner’s earnings, but it’s included in the deposit paid by the guest.
• If you use 0 for Deposit, use 0 for the Service fee

Service Fee Visibility:

• The service fee is visible in the Owner Dashboard under View Invoice Details.
• The fee is deducted from the owner’s earnings.

Payment Methods

WP Rentals supports several payment options for collecting funds:

a. Theme-Integrated Payment Methods:

• PayPal: Help to set up PayPal
• Stripe: Help to set up Stripe
• Wire Transfer: Help to set up Wire Transfer

b. WooCommerce Payment Options:

• You can also use WooCommerce-supported merchants to process payments.
• To enable WooCommerce payments: Help to install WooCommerce
• WooCommerce supports hundreds of merchants. Each merchant has its own documentation for setup.

Note: Payments are processed through WooCommerce merchants, but the money always goes to the admin account.

Important Considerations

• If you set the Deposit to 0, set the Service Fee to 0 as well.
• The service fee is deducted from the deposit, and the deposit must always be greater than or equal to the service fee (including city and cleaning fees if applicable).

The post Booking: How to work with Deposit Fee and Service Fee appeared first on WP Rentals Help.

Once a booking is confirmed, a Trip Details email will be automatically sent to the guest.

This email will include:

• The owner’s contact details
• Relevant information about the confirmed booking

Managing Trip Details Email Settings

You can manage this email by going to:

• Theme Options > Email Management > Trip Details Email

Here, you have two options:

1. Include Owner’s Email Address: You can choose to include the owner’s email address in the Trip Details email.
2. Disable the Trip Details Email: You can also choose to turn off this email if desired.

Important Notes

• The Trip Details email is hardcoded in the theme.
• You can find the code related to this email in the file:
  wprentals\libs\help_functions.php

The post Trip Details Email in WP Rentals appeared first on WP Rentals Help.

If you wish to learn about how to manage the emails content, please check  Help for Email Content section 

Managing Email Settings in WP Rentals

The settings of the emails sent from the theme can be managed from Theme Options > Email Management > Email Settings.

Below are detailed explanations of each option available in this section.

Send Emails as HTML or Text

You can choose the format of the emails:

• HTML: If selected, all design and formatting options below will apply.

• Text: If selected, only plain text emails will be sent, and the options below will not apply. Instead, the content from the Text section in Email Content will show, without any logo or colors or links.

Emails Will Be Sent from Name

Here, you can define the “From Name” that appears in the emails sent by the theme.

For example, you can set it to “WP Rentals” or “Your Company Name.”

Emails Will Be Sent from Email

This setting defines the email address that appears as the sender.

• If left blank, the emails will be sent from a random address.
• Some hosting providers require a validated email address to be used as the sender. If the email is not properly configured, emails may not be sent.

Important: If you experience issues with emails not being delivered, please check this help guide:
Emails Are Not Sent / Emails Not Working

Display Email Header

• If enabled (Yes), the email will include a header section that typically contains the logo.
• If disabled (No), the email header will not be shown.

Email Logo

You can upload a logo that will be displayed in the email header.

• Click “Upload” to select and insert an image.
• Click “Remove” to delete the current logo.
• Ensure the logo size is correctly set. If you upload a large logo, it will display in full size in emails, which may affect the layout.

For best results, use a small and optimized logo that fits well in the email header.

Display Email Footer

• If enabled (Yes), the email will include a footer section at the bottom.
• If disabled (No), the footer will not be displayed.

Show Address in Email Footer

• If enabled (Yes), the address details will be displayed in the footer of the email.
• If disabled (No), the address will not appear.

Footer Content

If the “Display Email Footer” option is enabled, the text added here will be displayed in the footer section.

• Example: “Please do not reply directly to this email. If you need assistance, contact us at [support email].”

Social Icons & Links

You can add up to 3 social media icons with links in the email footer.

• Social Icon No. 1, 2, and 3: Upload an icon (e.g., Facebook, Twitter, LinkedIn).
• Link Social Account No. 1, 2, and 3: Add the corresponding social media profile links.
• Add the correct icons before sending emails.

Email Background Color

Select the background color for the entire email.

Email Content Background Color

Select the background color for the content section inside the email.

The post Theme Options – Email Management – Email Settings appeared first on WP Rentals Help.

Accessing the Listing Page Layout Manager

• Navigate to WpRentals Options in your WordPress dashboard.
• Click on Listing Page.
• Open Listing Page Layout Manager.

Enabling the Layout Manager

To make changes to the listing page layout, you need to enable the Layout Manager:

1. Locate Enable Layout Manager?
2. Set it to Yes.
3. Click Save Changes.

Now, you can modify the sections of your listing page.

Hiding the Double Sections

By Default these sections will show 2 times when Listing Layout Manager is Enabled

• Description
• Owner
• Map
• Similar Listings

To hide a section:

• Find the respective Hide Default [Section Name] Section? option.
• Select Yes.
• Click Save Changes and refresh your listing page to see the update.

OR

• Locate the Property Page Layout Manager.
• Drag and drop sections from Enabled to Disabled.
• Click Save Changes.

Rearranging Sections

To change the order of sections:

1. Drag and drop sections within the Enabled column.
2. Click Save Changes.
3. Refresh your listing page to see the new order.

The post How to work with the Listing Page Layout Manager appeared first on WP Rentals Help.

WpRentals offers three ways to set / search property locations:

1. Google or OpenStreet Places Autocomplete
2. Theme auto save location based on saved property location details
3. A dropdown selector

In this guide we will explain how to manage the listing location with Google Places or OpenStreet Places

To use Google places, you must add a Google API key (and make sure the Places library is enabled for that key).

Configuring Google or OpenStreet Autocomplete

1. Enable Autocomplete

1. Navigate to Admin > WpRentals Options.
2. Go to Search > Location Field Search Settings
3. Enable the option to Use Google Places or Open Street Places for Location Field in Search?  (set YES)
4. Disable the option Use Dropdowns for Cities and Areas in Submission Form? (Set NO)
5. Click Save Changes.

Optional: Limit Limit Use Google Places or Open Street Places to a specific country?

2. Set the Map System

• Go to Admin > WpRentals Options > Map Configuration > Map General Settings
• Choose What Map System do you want to use? and Select Google Maps or OpenStreetMaps.
• If using Google Maps:
  • Generate a Google Maps API Key. Click to see the help for how to generate a google api key.
  • Enable Google Places.

• If using What Map System do you want to use? -> OpenStreet
• Enable OpenStreet Places.
• Click Save Changes.

3. Configure Submission Form Settings

• Navigate to Admin > WpRentals Options > Search > Location Field Search Settings
• Disable the option Use Dropdowns for Cities and Areas in Submission Form? (Set NO)

Why:  For location to be saved correctly with Google Places or Open Street Places it needs to be selected and searched with the same system.

Using Google or OpenStreet Autocomplete in Submission Form

1. Go to User Dashboard > Add New Listing.
2. Fill in the mandatory fields.
3. In the City field, start typing a city name.
4. A dropdown will appear with suggestions from Google or OpenStreet.
5. Select a city from the dropdown.
6. The Country field and other location details will be automatically populated based on the selected city.
7. Complete the remaining listing details and publish the listing.

Searching for Listings Using Google or OpenStreet Autocomplete

1. Go to the Homepage.
2. Enter a location (e.g., New York) in the Search Field.
3. Select the matching result from the dropdown.
4. Click Search.
5. The listing that matches the selected location will appear in the search results.

Configuring Search Form with the location field

The settings for Auto-Complete with Google Places or OpenStreet Places will apply to all search forms that support location.

The following search forms are available in the WpRentals theme, and you may use them in any setup you wish with the Location Field search:

Hero Media Search (available in 5 variations). More here

• Type 1 – Default Search (hardcoded)
• Type 2 – Default Search (hardcoded)
• Type 3 – Supports Custom Fields only
• Type 4 – Default Fields (Hardcoded) + Custom Fields
• Type 5 – Supports Custom Fields only

Each of these variations  may show as

• Mobile Search
• Search Shortcode
• Search Widget

Half Map Layout Search. More here 

• This form is configured exclusively with Custom Fields.

Search Form Builder in Elementor. More here 

• This form is configured exclusively with Custom Fields.

In these search forms, the location field can appear as:

• Default Field (“Where do you want to go?”)

Custom Field (“Location”)

Elementor Search Form Builder Field – Location

The post How to manage the listing location with Google Places or OpenStreet Places in WpRentals appeared first on WP Rentals Help.

WpRentals offers three ways to set location:

• Google Places or OpenStreet Places AutoComplete
• Theme auto save location based on saved property location details
• A dropdown selector

In this guide we will explain how to manage the listing location with theme autocomplete system.

Configuring Theme Autocomplete

1.Adjust Theme Autocomplete Settings

• Navigate to Admin > WpRentals Options.
• Go to Search > Location Field Search Settings
• Disable the option to Use Google Places or Open Street Places for Location Field in Search?  (set NO)
• Locate Use Dropdowns for data saved from properties in Location Search Field?
• Choose between:
  • No (Allows users to type in cities and areas as free fields).
  • Yes (Displays pre-defined drop-down selection).
• Click Save Changes.

2. Configure Submission Form for Theme Autocomplete

• Navigate to Admin > WpRentals Options > Search > Location Field Search Settings
• Locate Use Dropdowns for Cities and Areas in Submission Form?
• Choose between:
  • No (Allows users to type in cities and areas as free fields).
  • Yes (Displays pre-defined drop-down selections for cities and areas).
• Click Save Changes.

Using Theme Autocomplete in Submission Form

• Locate Use Dropdowns for Cities and Areas in Submission Form?
• Choose No (Allows users to type in cities and areas as free fields).

• Go to User Dashboard > Add New Listing.
• Fill in the mandatory fields.
• In the City field, manually type the city name.
• Manually enter the Neighborhood.
• Select the Country from the drop-down list.

• Complete the location listing details – County And State
• Complete the remaining listing details and publish the listing.

Using City and Area Dropdowns in Submission Form

• Locate Use Dropdowns for Cities and Areas in Submission Form?
• Choose Yes (Displays pre-defined drop-down selections for cities and areas).

• Add Cities and Areas in Wp-admin -> Listings -> Cities and Areas. More here

• Go to User Dashboard > Add New Listing.
• Fill in the mandatory fields.
• Select the City from the dropdown.
• Select Area from the dropdown
• Select the Country from the drop-down list.

Note: Cities and Areas are independent

• Complete the location listing details – County And State
• Complete the remaining listing details and publish the listing.

Generating Data for Theme Autocomplete

• The City and Area are saved as listing property categories / taxonomies and as a autocomplete date.
• County, Country and State fields will save as autocomplete date
• The file with autocomplete data updates itself once a day (for performance)
• To instantly display new property details in the autocomplete location in form, manually generate the data from Map Configuration > Generate Data & Pins
• Click Save Changes. Refresh the page. Autocomplete file is generated

Searching for Listings Using Theme Autocomplete

• Go to the Homepage.
• Enter a location (e.g., London) in the Search Field.
• The manually added city and area will appear in the drop-down.
• Select the location and click Search.
• The matching listing will appear in the results.

Searching with Location Dropdown Enabled

• Enable Use Dropdowns for data saved from properties in Location Search Field?

• Select the property location in the search form from the dropdown

Configuring Search Form with the location field

The settings for  theme autocomplete search will apply to all search forms that support location.

The following search forms are available in the WpRentals theme, and you may use them in any setup you wish with the Location Field search:

Hero Media Search (available in 5 variations). More here

• Type 1 – Vertical Search – Default fields.
• Type 2 – Horizontal Search – Default fields.
• Type 3 – Horizontal Search – Custom fields.
• Type 4 – 3 default fields (title keyword, category 1, category 2) + custom fields.
• Type 5 – Vertical Search – Custom fields.

Each of these variations  may show as

• Mobile Search
• Search Shortcode
• Search Widget

Half Map Layout Search

• This form is configured exclusively with Custom Fields.

Search Form Builder in Elementor

• This form is configured exclusively with Custom Fields.

In these search forms, the location field can appear as:

• Default Field (“Where do you want to go?”)

Custom Field (“Location”)

Elementor Search Form Builder Field – Location

The post How to manage the listing location with theme autocomplete in WpRentals appeared first on WP Rentals Help.

In the theme, you will have 3 options to set the Location option

• Google Places or OpenStreet Places AutoComplete
• Theme auto save location based on saved property location details
• With a dropdown selector

In this guide we will explain how to manage the listing location with dropdown selector

1. Adjust Search Location Autocomplete Settings

• Navigate to Admin > WpRentals Options.
• Go to Search > Location Field Search Settings
• Disable the option to Use Google Places or Open Street Places for Location Field in Search?  (set NO)
• Locate Use Dropdowns for data saved from properties in Location Search Field?
• Choose between:
  • No (Allows users to type in cities and areas as free fields).
  • Yes (Displays pre-defined drop-down selection).
• Click Save Changes.

Using City and Area Dropdowns in Submission Form

• Navigate to Admin > WpRentals Options > Search > Location Field Search Settings
• Locate Use Dropdowns for Cities and Areas in Submission Form?
• Choose Yes (Displays pre-defined drop-down selections for cities and areas).

• Add Cities and Areas in Wp-admin -> Listings -> Cities and Areas. More here

• Go to User Dashboard > Add New Listing.
• Fill in the mandatory fields.
• Select the City from the dropdown.
• Select Area from the dropdown
• Select the Country from the drop-down list.

Note: Cities and Areas are independent

• Complete the location listing details – County And State
• Complete the remaining listing details and publish the listing.

Generating Data for Theme Autocomplete

• The City and Area are saved as listing property categories / taxonomies and as a autocomplete date.
• County, Country and State fields will save as autocomplete date
• The file with autocomplete data updates itself once a day (for performance)
• To instantly display new property details in the autocomplete location in form, manually generate the data from Map Configuration > Generate Data & Pins
• Click Save Changes. Refresh the page. Autocomplete file is generated

Searching for Listings Using Theme Autocomplete

• Go to the Homepage.
• Enter a location (e.g., London) in the Search Field.
• The manually added city and area will appear in the drop-down.
• Select the location and click Search.
• The matching listing will appear in the results.

Searching with Location Dropdown Enabled

• Enable Use Dropdowns for data saved from properties in Location Search Field?

• Select the property location in the search form from the dropdown

Configuring Search Form with the location field

The settings for  theme autocomplete search will apply to all search forms that support location.

The following search forms are available in the WpRentals theme, and you may use them in any setup you wish with the Location Field search:

Hero Media Search (available in 5 variations). More here

• Type 1 – Default Search (hardcoded)
• Type 2 – Default Search (hardcoded)
• Type 3 – Supports Custom Fields only
• Type 4 – Default Fields (Hardcoded) + Custom Fields
• Type 5 – Supports Custom Fields only

Each of these variations  may show as

• Mobile Search
• Search Shortcode
• Search Widget

Half Map Layout Search

• This form is configured exclusively with Custom Fields.

Search Form Builder in Elementor

• This form is configured exclusively with Custom Fields.

In these search forms, the location field can appear as:

• Default Field (“Where do you want to go?”)

Custom Field (“Location”)

Elementor Search Form Builder Field – Location

Searching for Listings Using Cities and Areas fields

In the search forms that support custom fields, you can set Listing City and Property Area (as separate and independent dropdowns):

• You can configure the names for these dropdowns in the Theme Options.
• Ensure you use the Compare Term “like” and set the Label that will display on the advanced search field on the frontend.

• You can set the dropdowns as classic dropdowns

• Or you can enable multi-select from Search > Categories Multi Selection

The post How to manage the listing location with a dropdown selector in WpRentals appeared first on WP Rentals Help.

This search form appears in:

• Search Results Half Map Layout
• Taxonomies / Property Categories Half Map Layout
• Properties List – Half Map Layout 

It allows users to search and filter properties without reloading the page

The options for the Half Map filter section can be set in Theme Options -> Search -> Half Map Search Form

You can configure:

• Number of Search Fields (Enter a number, save, and refresh)
• Fields Per Row (Options: 2, 3, or 4)
• Custom Fields (Choose from theme default and custom fields)
• Custom Icons (Assign FontAwesome icons to fields)

Custom Fields You Can Add

Location Field

• You can use Location search in various combinations. Help: Configuring Location Search
• Use Like for Compare

Check-in & Check-out Fields

• Use “Date Greater” and “Date Smaller” as compare terms.
• Requires a label for front-end display.

Guest Number Field

• Displays results for properties based on guest count:
• To get Greater or Equal results, use the “greater” compare term.

You can use guest dropdown or advanced guest separator. Activate your option in Theme Options. More on guest selector here.

Example of the Advanced Guest Selector:

Property Taxonomies / Categories

These are managed in WP Admin → Listings:

• Property Category
• Property Type
• Property City
• Property Area

For more information on how to manage property categories and taxonomies, see how to manage Property Categories / Taxonomies. 

Listing City and Property Area (as separate and independent dropdowns):

• You can configure the names for these dropdowns in the Theme Options.
• Ensure you use the Compare Term “like” and set the Label that will display on the advanced search field on the frontend.

Listing Main Category and Second Category:

• You can configure the names for these dropdowns in the Theme Options.
• Ensure you use the Compare Term “like” and set the Label that will display on the advanced search field on the frontend.

Enable Multi-Select from Theme Options → Search → Categories Multi Selection

Listing County & State

• Text input fields.
• Uses “Like” compare term.
• Requires a label for front-end display.

Listing Country

• Dropdown with pre-coded country list.
• Uses “Like” compare term.
• Requires a label for front-end display.

Baths, Bedrooms & Rooms as separate fields

• Can be input fields or dropdowns.
• Uses “Smaller, Equal, or Greater” compare terms.

To enable dropdowns, activate “Show Dropdowns for Guests, Beds, Bathrooms, or Rooms” in Theme Options and configure the number of beds and baths to display

Beds and Baths Component

• This element combines both beds and baths into a single field.
• Configure the field to use “Equal” as the comparison, meaning the results will always show properties with equal to or greater than the selected number of beds or baths.

To configure the number of beds and baths to display in the Theme Options -> Advanced Search Settings 

Price Field

The Price Field can be used in two variations:

Version 1: Price Slider

This version displays a slider that allows users to select a price range. The minimum and maximum values for the Price Slider are set in the Advanced Search Settings.

Version 2: Component with Input and Slider Selectors

This version displays both an input field and a slider. Users can either type a price directly into the input field or use the slider to adjust the price range.

Min and Max values for both versions are configured in the Advanced Search Settings.

Features and Amenities

• Select Show Amenities and Features fields? – YES
• Select the features you need to display
• Read more on how to add features and amenities in this help

Listing Custom Fields

To add fields to your listings, go to General → Custom Fields

The custom fields you add can be:

• text
• numeric
• dropdown

To add the custom fields to Search Form, use the following configuration

•  Dropdown Fields → Use “Like” compare.
•  Text Fields → Use “Like” compare.
•  Number Fields → Use “Greater,” “Smaller,” or “Equal” compare.
•  Date Fields → Use “Date Greater” / “Date Smaller” compare.

Other default fields that can be added to search:

• Zip (text field – input style),
• Size (number – input style).

Geo location Search

Geolocation is a specific search feature for map locations (not property locations). It allows users to search for a specific location on the map and view properties within a defined radius around that location. This feature is only available in the Half Map layout, which is commonly used for advanced search results, properties list with a half-page map, and taxonomy half-page views.

Set the Map System

• Go to Admin > WpRentals Options > Map Configuration > Map General Settings
• Choose What Map System do you want to use? and Select Google Maps or OpenStreetMaps.
• If using Google Maps:
  • Generate a Google Maps API Key. Click to see the help for how to generate a google api key.
  • Enable Google Places.

• If using What Map System do you want to use? -> OpenStreet
• Enable OpenStreet Places.
• Click Save Changes.

Set Geo Location Search by Typing Location:

Users type a specific location into the Half Map Location field. Then, they can use the Radius slider to narrow the search results to a specific distance around that location.

To enable and configure Geo Location Search for the Half Map layout, follow these steps:

• Go to Search Settings – Geo Location Search
• enable/disable this option entirely,
• show the radius in miles or km,
• set the minim and maxim radius value as well as the initial radius value.

Optional: Limit Use Google Places or Open Street Places to a specific country

Go to Search -> Location Field Search Settings -> Limit Use Google Places or Open Street Places to a specific country -> Yes -> Select Country

The post Theme Options – Search – Half Map Search Form appeared first on WP Rentals Help.

CONTENT

• YouTube Video
• Login & Register Forms Overview
• Register and Login Theme Options Settings
• WordPress Required Setting
• Login / Register & Submit Display
• Redirect User After Login
• Register Form Fields
• Renter / Owner Separation Options
• Social Login Options
• Terms and Conditions

YouTube Video

WpRentals Login & Register Forms Overview

The Login & Register Forms in WpRentals can be displayed in multiple ways:

Modal Form

• Enabled via Theme Options >Register and Login Settings
• Displays an image and message (configured in the Header section).
• Mobile-friendly version available.

Shortcode

• Add the Login & Register shortcode to any page.
• Help Guide: Login & Register Shortcode

Widget

• Available as a Login & Register widget.
• Help Guide: Login & Register Widget

Register and Login Theme Options Settings

WordPress Required Setting to Allow User Registration

Go to WP-Admin → Settings → General and make sure Membership: “Anyone can register” is checked.

Login / Register & Submit Display

This section includes the following options

Show User Login Menu in Header?

YES → The Login/Register modal is displayed in the header.

NO → The Login and Register links are hidden in the header.

• However, login/register is still required for booking requests.
• If a user is not logged in, a Login/Register modal will appear on the single listing page when they try to book.

 Show the Submit Listing Button in Header?

YES → A Submit Property button appears in the header.

NO → The Submit Property button is hidden.

Clicking this button takes users to the Submit Property page.

Users must Register/Login before completing a submission.

Orphan listings (submitted by users who don’t complete registration) may be automatically deleted based on the setting:
General → General Settings → “Auto delete orphan listings” (Learn more).

Login / Register Modal Image

• You can replace the default modal image with your own.

Redirect User After Login

Manage these from Theme Options > Register & Login Settings >Login Redirect Settings ->
Redirect users to the same page after login?

YES → Users stay on the same page after login.
NO → Users are redirected to a specific URL (if set).

• If no URL is set, they are sent to My Profile (User Dashboard).

Exceptions:

• If a user logs in from a Property Page, they stay on the same page to complete booking.
• If a user logs in from the Submit Property page, they are redirected to Edit Listing.

Debugging Login Redirect Issues:

• If redirection does not work, check if the page was edited with Elementor.
• To ensure proper functionality:
  • Do not use an Elementor-edited page as a login redirect.
  • Test the redirect manually before setting it in Theme Options.

Register Form Fields

Manage these from Theme Options > Register & Login Settings > Register Form Fields

Can users type their own password during registration?

YES → Users create their own password.

• Fields included: Username, Email, Password, Password Confirmation.
• The password field will include a security verification, and only Strong and Medium passwords will be accepted.

NO → A system-generated password is emailed to the user after registration.

Enable Mobile Phone Number in the Registration Form?

YES → A Mobile Phone field is added to the form.

• The phone number is NOT verified after submission.

NO → The phone number field is not displayed.

Renter / Owner Separation Options

• Go to Register & Login Settings -> Renter / Owner Separation
• Enable or Disable the split user option to differentiate Renters and Owners.
• OR Allow only certain users to submit properties in the front end

If the split option is enabled:

 “I want to book and rent” → Creates an Owner profile page.
 “I only want to book” → No Owner profile page, no ability to list properties.

Users who check: I only want to book

These users will have the user dashboard pages limited to those from the below screenshot (no pages for submitting)

Users who check: I want to rent my property

These users will have the user dashboard with all pages, including submitting property:

If the split option is disabled

All users will register as Owners.

If the User Split is disabled AND admin specifies the users who can be owners

• Admin lists in “Only these users can publish listings (can be owners)” the users who can be owners (including his own username)
•  Help Guide: Use WpRentals for a single property or single owner

The user login can be bypassed when a booking is placed by using Instant Booking and WooCommerce, for the new users created in checkout page to have limited User Dashboard pages- only to book- the separate users on registration needs to be set to NO and the owner’s usernames need to be in Theme Options.

Social Login Options

Role assigned to users who register through social login, if social login is enabled and connected.

See also:

• How to enable Google Login
• How to enable Facebook Login 

Use reCaptcha for the Register Form:

• Enable or disable reCaptcha via Theme Options > reCaptcha Settings.
• Help article for reCaptcha setup.

Terms and Conditions

• Users must agree to Terms and Conditions before registering which is created and published from wp-admin – Pages.
• It is always included in the register box.
• Help article about the Terms and Conditions page.

The post WpRentals Login & Register – How to Create Renters / Owners appeared first on WP Rentals Help.

Twilio provides SMS notifications for WpRentals using its API. You need an active Twilio account to enable this feature

SMS Management is offered through Twilio API https://www.twilio.com.

Twilio is not free service, but it offers a free trial with some limitations. Here’s what you need to know:

Twilio Free Trial

• You get a small amount of free credit (usually $15) to test Twilio services.

• Messages sent from a free account will have a “Sent from Twilio” prefix.

• You can only send SMS to verified numbers (you must add them in your Twilio console).

Paid Plans (After Trial)

• Pay-as-you-go: You pay per message (pricing varies by country).

• Monthly plans: Some services offer flat-rate pricing.

Approximate Costs (May Vary by Region)

• SMS (US): ~$0.0079 per message.

• Phone Numbers: ~$1/month for a Twilio number.

• WhatsApp Messages: ~$0.0042 per message.

How to generate the Twilio Phone Number

Sign Up for Twilio

• Go to Twilio Signup https://www.twilio.com/en-us 

• Create an account and verify your email & phone number.

• Navigate to Phone Numbers > Buy a Number.

• Select your country, choose SMS-enabled numbers, and purchase one.

How To generate the Twilio phone number:

How to manage Twilio in WPRentals Theme Options

Go to Theme Options -> SMS Management

Add Twilio Phone Number

Add Twillio Account SID

Add Twillio Auth Token

Add the SMS messages you wish to send

SMS Lists

SMS for Phone Number Validation – will validate user phone number and will send the pincode to the phone number added in My Profile

SMS for New user admin notification – this SMS notifies Admin (twilio account admin) about new users

SMS for Password Reset Request – this SMS goes to the registered user initiating the forgot password process on WPRentals installation

SMS for Password Reseted this SMS goes to the registered user initiating the forgot password process on WPRentals installation

SMS for Approved Listings – this SMS goes to the registered user who has submitted a listing, when his listing was approved. Approval can be manual or automatic – help https://help.wprentals.org/article/how-to-approve-properties-manually-how-to-approve-properties-automatically/

SMS for Admin – Expired Listing – this SMS goes to administrator when user resubmits an expired listing after he renews his membership. Help on membership – https://help.wprentals.org/article/membership-submission/

SMS for Paid Submission and SMS for Featured Submission – this sms go to administrator when he has a new submission added with paid submission enabled. Help on paid submission – https://help.wprentals.org/article/paid-submission/

SMS for Account Downgraded – SMS goes to user whose membership has been downgraded after buying a different package with less listings. Help on membership – https://help.wprentals.org/article/membership-submission/

SMS for Membership Cancelled – SMS goes to user whose membership has expired as it reached its end, or payment couldn’t be processed for recurring. Help on membership – https://help.wprentals.org/article/membership-submission/

SMS for Free Listing Expired – – SMS goes to user free listing reached its expiration date https://help.wprentals.org/article/membership-submission/

SMS for New Listing Submission – SMS goes to site administrator when a listing is added to the rentals installation

SMS for Recurring Payment – SMS goes to user whose membership has been renewed, when recurring is checked https://help.wprentals.org/article/membership-submission/

SMS for Membership Activated – SMS goes to user whose membership been activated after purchase was validated https://help.wprentals.org/article/membership-submission/

SMS for Update Profile – SMS goes to site administrator when a registered user updates his profile.

SMS for Booking Confirmed – User – SMS goes to user who sent a booking request and his booking was confirmed. Help to understand the booking process – https://help.wprentals.org/article/issue-invoice-reject-booking/

SMS for Booking Confirmed – SMS goes to property owner when a request for one of his properties was confirmed, and deposit was paid to site administraor. Help to understand the booking process – https://help.wprentals.org/article/issue-invoice-reject-booking/

SMS for Booking Confirmed – no deposit – SMS goes to property owner when a request for one of his properties was confirmed without deposit needed. Help to understand the booking process – https://help.wprentals.org/article/issue-invoice-reject-booking/

SMS for Inbox- New Message – SMS goes to property owner someone sends a message – https://help.wprentals.org/article/contact-owner/

SMS for New Booking Request – SMS goes to property owner when making a manual booking for one of his properties. Help https://help.wprentals.org/article/adddelete-booked-periods-as-owner/

SMS for User – New Booking Request – SMS goes to property owner when he gets a new request. Help to understand the booking process – https://help.wprentals.org/article/issue-invoice-reject-booking/

SMS for Invoice generation – SMS goes to user who sent a booking request when owner approves the request, but deposit needs to be paid. Help https://help.wprentals.org/article/issue-invoice-reject-booking/

SMS for Booking request rejected – SMS goes to user who sent a booking request when owner rejects the request. Help https://help.wprentals.org/article/issue-invoice-reject-booking/

SMS for Booking Request Cancelled – SMS goes to property owner when the user cancels his request before paying the deposit. Help https://help.wprentals.org/article/issue-invoice-reject-booking/

SMS for Booking Period Cancelled SMS goes to user who sent a booking request when owner cancels a confirmed booking request. Help https://help.wprentals.org/article/issue-invoice-reject-booking/

SMS for New wire Transfer – sms goes to user who initiates the wire transfer request. Help https://help.wprentals.org/article/wire-transfer-payment-method/

SMS for Admin – New wire Transfer – sms goes to site administrator who receives a the wire transfer request. Help https://help.wprentals.org/article/wire-transfer-payment-method/

SMS for Invoice Payment Reminder – sms goes to user who has a confirmed booking and paid a deposit only. There is an automated cron that runs daily and sends 1 automatic email to users who have a confirmed booking that starts 3 days before the current day. Help https://help.wprentals.org/article/issue-invoice-reject-booking/

The post SMS Management by Twilio appeared first on WP Rentals Help.

You can replace the booking form with the owner contact form by following these steps:

1. Go to Theme Options → Booking Configuration → Form Display Settings.
2. Set “Show Contact Form instead of Booking Form” to YES.
3. Click Save.

Once enabled, the contact form will replace the booking form on the property/listing page.

Contact Form Behavior

• If the user is logged in: The form will display without additional fields.
• If the user is not logged in: The form will include two additional optional fields for email and name.
• Check-in and Check-out fields: Users can select dates, but the calendar will not display booked dates for the propert

Additional Settings

Admins can customize the form from Social & Contact → Contact Form Settings:

• Enable GDPR Checkbox: Yes / No
• Show Phone Number in Contact Form: Yes / No

Email Notifications

• Messages are sent directly to the property owner’s email address.
• If the property owner is an admin, messages will go to the admin email.
• Admins can receive duplicate message copies by setting their email in:
  Theme Options → Email Management → Duplicate Email.

The post Hide Booking Form and Replace with Owner Contact Form appeared first on WP Rentals Help.

In Theme Options → Register & Login Settings → Renter / Owner Separation, there are two key options:

1. Separate Users on Registration
2. Only These Users Can Publish

Separate users on registration

When enabled, users are categorized into two types:

 “I want to book and rent” → Creates an Owner profile page.
 “I only want to book” → No Owner profile page, no ability to list properties.

The Register Form will display these options as checkboxes.

Important Notes:

• If a user selects “I only want to book”, they will have a limited dashboard with no submission pages.

• If a user selects “I want to rent my property”, they will have full dashboard access, including the ability to submit properties.

Social Media Login (Facebook, Twitter, Yahoo) bypasses this selection. Users registering through social login are automatically assigned full access, including property submission, even if user separation is enabled.

Don’t Separate Users on Registration

If this option is disabled, all registered users will have full dashboard access, including property submission.

This is how the user dashboard page looks like:

Separate Users & Limit Property Submission to Specific Users

If you want to restrict property submission to specific users, enter their usernames (comma-separated, without spaces) in the “Only These Users Can Publish” field.

Users listed here → Full dashboard, including property submission.
All other users → Limited dashboard (no submission option).

Important! Do not add spaces between usernames when entering them in the settings.

Then only those specific usernames will have full dashboard pages.

The rest will have the dashboard with limited pages (not submit options).

The user login can be bypassed when a booking is placed by using Instant Booking and WooCommerce, for the new users created in checkout page to have limited User Dashboard pages- only to book- the separate users on registration needs to be set to NO and the owner’s usernames need to be in Theme Options.

The post How to allow only certain users to be owners appeared first on WP Rentals Help.

Adding a Custom Field

Add new custom fields from Theme Options -> General -> Listing Custom Fields:

WpRentals supports the following custom fields:

• Drop-downs,
• Text fields,
• Number fields,
• Date fields

For each field you can select

• Field Name (For dropdown fields, use a single-word name)
• Field Label
• Field Order
• Field Type

How to Select the fields to show in the submit form

• Go to Theme Options -> Add Listing Page & Payment Settings -> Listing Submission Form –>
  Select the Fields for listing submission
• Select the fields to show in submission form

How custom fields display

When adding or editing a listing, custom fields appear in the Listing Submission Form after the default fields.

To edit a listing, go to User Dashboard → My Listings → Edit Listings → Details.

On The Property Pages the custom fields filled in are listed under LISTING DETAILS section, after the theme default fields

Add Custom details by Property

You can also add Custom Details for each property from the same section.

These appear after the Property Custom Fields added in Theme Options.

Related Help

How to add listings as site admin – https://help.wprentals.org/article/use-wprentals-for-a-single-property-single-owner/

How to manage submit form – https://help.wprentals.org/article/1-30-how-to-manage-submit-form-fields-and-mandatory-fields/

The post Add, Edit and Delete Listings Custom Fields appeared first on WP Rentals Help.

• Go to Theme Options > Contact Form Settings.
• Enable or Disable Use GDPR Checkbox? in the Owner Contact form. Help https://help.wprentals.org/article/contact-owner/
• Show phone number in contact form? -> Use YES (to show the field) and NO (to hide the field)

If Use GDPR Checkbox? is set to YES, you must create the GDPR page with the GDPR Terms template.

If enabled, the checkbox with GDPR terms will show in contact forms.

The post Theme options – Social & Contact – Contact Form Settings – GDPR appeared first on WP Rentals Help.

Submitted Listings should be approved by admin?

From this section, you can choose whether property submissions should be approved automatically (after payment is received, if payment is required) or manually (admin always reviews submissions).

• NO – Submissions are approved automatically.
• YES – Submissions are approved manually.

Help: https://help.wprentals.org/article/how-to-approve-properties-manually-how-to-approve-properties-automatically/

Note: Only the initial submission requires admin approval. Any subsequent edits to the listing will be saved automatically and do not require re-approval.
If you wish to change this behavior and require admin approval after each edit, follow the instructions here:
How to make admin approve listings after each edit

Enable Paid Submission – NO

This option means users can add listings for free. You can set properties to be submitted without any payment.

More on this option here – https://help.wprentals.org/article/free-submission/

Enable Paid Submission – PER LISTING

This option requires users to pay a fee for each listing they submit.

Help:  https://help.wprentals.org/article/paid-submission/

Enable Paid Submission – MEMBERSHIP

With this option, listing submission is based on the user’s membership package.

Help: https://help.wprentals.org/article/membership-submission/

Read more about all supported payment methods here: Supported Payment Platforms in WpRentals

The post Theme options – Listings Submission Settings appeared first on WP Rentals Help.

Login with your twitter account and follow instructions to CREATE AN APP

The APP page must contain these details for twitter login to work

Permission  must be set to request email address for user to get his email address in the account

Copy keys and tokens from Twitter to WpRentals

Copy the credentials into WpRentals -> Social Login & Contact -≥ Twitter Login & Widget

Users will be able to login via Twitter

The post Twitter Login appeared first on WP Rentals Help.

How to enable Wire Transfer as payment method

To enable Wire Transfer, go to Theme Options -> Add Listing Page & Payment Settings ->Wire Transfer Setting and fill in the details where users should send their payments.

If you want to use only Wire Transfer and your currency is not listed, you can add your currency in Theme Options > Add Listing Page & Payment Settings > Payment Currency Settings.

How does Wire Transfer button display in Front-End

On the front end, users will see a “WIRE TRANSFER” button next to PayPal or Stripe.

A. For Paid Submission

B. For Membership Packages

C. For Booking Payments

How does Wire Transfer work

When the user clicks the Wire Transfer button, a modal info box with Wire Instructions will appear.

The modal box will display the details you’ve set in Theme Options.

The user then clicks the “Send me the invoice” button to receive the same information via email.

After clicking on the button, the user will receive an email with a unique Invoice ID (payment reference number).

The email will include the INVOICE NUMBER generated by the system. The user should reference this ID in their payment information. After the payment is received, the admin can search for the invoice using the ID.

• The email’s default text (like the subject) can be updated from Email Management in Theme Options: Help: Email Management.

What to do as Admin to activate purchases

Once you receive the payment via bank transfer, go to Admin > Invoices and search for the invoice using the ID.

In the Admin Invoices section, you’ll see the invoice status:

• Issued – The invoice is not paid.

• Confirmed/Paid – The invoice has been paid.

To activate the purchase, the admin will click the EDIT INVOICE button.

Notes about Wire Transfer and Membership:

• In Users > Edit Users, you can confirm the user has received the correct package ID, listings included, and featured listings automatically.
• The package will expire based on the Membership Package expiration settings, counting days, weeks, months, or years starting from the package activation date.

• Wire Transfer does not work with the recurring option.

Notes about Wire Transfer and Paid Listing:

• Once the admin marks the invoice as paid, the property is published, and the owner will be notified that their property has been published on the website.

• When enabling Paid Listings, the PAID status will also appear in the Properties List.

The post Wire Transfer payment method appeared first on WP Rentals Help.