WP-Property: FEPS

FEPS is a premium feature for the WP-Property plugin that allows WordPress professionals to create front-end forms that facilitate a simple way for website visitors to submit listings.

Using an easy-to-use interface you can select the attributes you want to display, image upload, property address, and more.

GETTING STARTED

Property Form

Front End Property Submission (FEPS) allows you to create multiple forms using the interface found under Properties -> Property Forms. Multiple forms can be used to setup targeted pages that limit the number of images for the form, direct all submissions into a certain property type, or property status.

Creating Forms

  • Form Name: Form's name must be unique. Form slug, which is used for setting shortcode ( attribute "form" ) is generated using form name. So, be careful changing the name of an already existing form!
  • Property Status: Status to assign to new Properties after they are submitted. (Note, the current option is disabled for sponsored listings. Sponsored Submission will be automatically published after successfull payment. Otherwise, it has pending status.)
  • Property Type: Default Property type of submitted Properties. (Note: This type will be set by default if the Property Type is not set in Property Attributes.)
  • Automatically removes FEPS of the current Form with 'Pending' status: Set a period of time in which Pending Property will be removed. Set 0 if you don't want Pending Property to be removed at all.
  • Preview Thumbnail Size: The size of the image to be used to display the thumbnail of an uploaded image.
  • Image Upload Limit: The maximum number of images that can be uploaded per submission. (Note, the current option is disabled for sponsored listings. Images limit for sponsored listings must be set for every Subscription plan separately.)
  • New User Role: Role to assign to users submitting Property if they do not already have an account.
  • Automatically load added images into Property Slideshow: This option is available when you have our premium feature Slideshow. All added images will be automatically placed in Slideshow box. (Note: You can use [property_slideshow] shortcode on Single Property page to show added images. Also, some premium themes such as Denali support automatic slideshow view on single Property pages.)
  • Allow user to edit and remove his FEPS: The Admin. can choose whether or not the user is allowed to edit and delete their Property submitted by FEPS. (Note: removed property will be moved to trash automatically.)
  • Disable new user account creation notification: An Administrator can choose whether or not a new user notification will be sent to new users as they register.
  • Notify user on update status of his FEPS: User will receive notification when his property changed its status.
  • Propery Attributes: The list of Property attributes fields which will be shown in FEPS form. User will be able to add/edit only the chosen attributes. These are optional fields, you do not have to add attributes if you choose not to.

Creating Sponsored Listings Forms

It enables billable Property submissions. WP-Invoice plugin and Single Page Checkout Add-on must be installed to enable this option.

  • Name: Create a name of Subscription plan.
  • Price: Currency is set via WP-Invoice settings. The exchange rate is 1 chosen currency = 1 credit.
  • Duration: The published period. The expiration date is based on this option and will be set after successful payment. When expiry date is over, the Property status will automatically be set to "Pending".
  • Is Featured: Property will be featured if this option is checked.
  • Images Limit: To enable this option, Image Upload must be set in Property Attributes. The amount of images which can be uploaded to the Property with the current subscription plan. Note: limit must not be less than 1 or empty.
  • Description: Optional. Useful information about subscription plan, advertisement offer or whatever else you can choose to be added here.
  • Allow user to edit and remove his FEPS: Whether or not to allow user to edit and delete their Property submitted by FEPS. (Note: removed property will be moved to trash.)

Form Shortcode

The FEPS feature has main shortcode, [wpp_feps_form form="{form_slug}"] which is used to render forms you have created on the front-end. Below is a list of arguments that may be passed into the shortcode, in the very least you must pass the form argument.

So if you want to display a property submission form for homes in a certain neighborhood, you can place the FEPS form into the content of the parent (neighborhood) property. The shorcode looks like this:

[wpp_feps_form form="form_slug" map_height=300]

In the above example we also set the height of the map to 300 pixels, if it is displayed. Keep in mind, if the property type used in the form is set to inherit the address (or whatever your location attribute is called), the map will not be displayed since there is no point prompting the visitor for an address.

Cheet Sheat for [wpp_feps_form] Shortcode

ShortcodeTypeDefaultDescription
form stringnone
(required)
The slug of the FEPS form, this is required to identify which form must be displayed.
parent_id numbernoneUse to set the parent ID of all the submitted properties. This works well if you want to group all the submitted properties under a parent. For example, if you want to allow visitors to submit condos that below to a certain neighborhood, you would create the neighborhood properties, then place FEPS forms into their content.
detect_parent true/falsetrueIf set to “true”, the form will automatically detect if it is displayed on a property page, and use the current property as parent for newly added properties. If parent_id is set, detect parent does not do anything.
map_height number450pxSets the height of the address map, in pixels.
template stringnoneIf you would like to use your own template for displaying the property form, you may do so by passing a template name. For example, if you pass ‘my_layout’ the actual PHP template would need to be named feps_my_layout.php, and be located in your theme, or child theme, folder.
not_found_textstringRequested FEPS form not found.This is the text to display when the form is not found, this is only needed if a form has been deleted, but shortcodes still reference it throughout your site.

Other Available Widgets and Shortcodes

Widgets:

  • FEPS Information. Shows Information about current FEPS Property. It's available only for logged in users and shown only on Edit Property page.
  • FEPS Menu. It's a block menu which contains specific information (ex. Credits Available) and FEPS tools for management. Note, menu is shown only for logged in users.

Shortcodes:

  • [wpp_feps_menu] This is the same as the FEPS Menu widget above.

Shortcode [wpp_feps_menu] has the following available attributes:

  • title - Shows title of menu if attribute is passed. By Default it's empty. Example, [wpp_feps_menu title="My Submissions"].
  • filters - Shows Property overview links by Properties statuses. Available values are true|false. Default is false. Example, [wpp_feps_menu filters="true]".
  • form_page - If set, shows the link to FEPS Property Form page. Default is empty. Example, [wpp_feps_menu title="http::/example.com/my_feps_Property_form_page]".
  • show_balance - Shows user's current credits balance. Available values are true|false. Default is true. Example, [wpp_feps_menu show_balance="false"]. Note, to use this attribute, WP-Invoice plugin and Single Page Checkout premium feature must be installed.
  • show_spc_link - Shows the link to Add Credits page. Available values are true|false. Default is true. Example, [wpp_feps_menu show_spc_link="false"]. Note, to use this attribute, WP-Invoice plugin and Single Page Checkout premium feature must be installed.

Integration with other Plugins

Functionality of FEPS Add-on can be increased via the following WordPress plugins:

WP-Invoice

To add aditional functionality to FEPS Add-on, Single Page Checkout Add-on for WP-Invoice plugin must be installed and activated.

It allows you to use FEPS Property Forms as billable service where users have to pay for publishing Properties on your site.

Billable service is called Sponsored listings. Sponsored listings allows you to set different Subscription plans where you are able to set expiration dates and images limit for submitted Properties.

WP-CRM

If WP-Invoice plugin is installed, you are able to see all user's completed transactions on CRM User Edit page.

Also, you have the ability to manage Email notifications using WP-CRM plugin. See Email Notifications section below.

Submitting Sponsored Listings and Approving Properties

Submitting sponsored property will has 3 stages.

1. You fill out the information about your property

2. Сhoose subscription plan

3.Here you can check available credits and/or add them to your account.

The form could be filled out by a logged in user, using FEPS forms is an easy way to automate your property creation procedure, it is primarily intended to be used by visitors who do not have user accounts. After filling out the form, the visitor is prompted for an e-mail address. If the submitted e-mail address belongs to a user in the system, then an additional prompt will be displayed for the password.

If, however, the provided e-mail does not belong to a user, the form will be submitted, and a user account will be created for the submitter, which will be held in inactive status until the submitted property is approved.

After a property is submitted, it is accessible using an unique URL (with a hash), anyone who has this URl link will have the access to the property (even by non-registered user).

Once a property is approved by a administrator or another user with approving authority (which can be configured using the WP-Property: Power Tools Add-on), the property becomes publicly visible via the normal URL based on your permalinks, and an account created for the submitter also becomes active.

Automatic renewal of Subscription plan

User will have the ability to add credits to his/her account on your site -  1$=1 credit and enable automatic renewal of Subscription plan. Credits will be automatically withdrawn from user's balance until they will have enough credits on their balance.

When the paid period expires, the property changes to Pending status and the user receives a notification.

See more details in integration with WP-CRM plugin section.

Email Notifications

Using the FREE WP-CRM plugin you can create custom notifications for all sorts of events, to include FEPS actions.

Additional Trigger Actions in CRM -> Settings -> Notifications will appear if WP-Property FEPS, and WP-CRM, are installed. They can be used to set up FEPS action user notifications.

Notification’s Available Actions

ActionsShortcodesDescription
Pending Property Approve
[user_email]Email where to send notification
[display_name]User's name
[url]Property url
[title]Property title
Pending Property Added[user_email]Email where to send notification
[pending_url]Pending Property url
[title]Property title
Pending Account Approved[user_email]Email where to send notification
[user_login]User's login
[site_url]Current site url

Advanced Usage

On a pending property a body class is added for styling, which is: feps-pending wpp_[post_status]

Pending pages use the same front-end templates as regular properties, and will load conditional property-type templates if they exist. Below is the the load order of templates based on specificity:

  • your_theme/property-pending.php
  • your_theme/property-pending-[property-type].php
  • your_theme/property-[property-type].php
  • your_theme/property.php

So if your property type is called "Single Family Home", then the property type slug is single_familly_home, and the template would be: property-single-family-home.php