FEPS Shortcodes and Widgets
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
| Shortcode | Type | Default | Description |
|---|---|---|---|
| form | string | none (required) | The slug of the FEPS form, this is required to identify which form must be displayed. |
| parent_id | number | none | Use 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/false | true | If 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 | number | 450px | Sets the height of the address map, in pixels. |
| template | string | none | If 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_text | string | Requested 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] - It’s a block menu which contains some specific information and FEPS tools for management. Note, menu is shown only for logged in users. Menu can be added to your site via FEPS Menu widget or [wpp_feps_menu] shortcode.
You can overview, edit or remove listings which was submitted by you.
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 = true/false - 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 = true/false - 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 = true/false - 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. - show_login_form = true/false - Will show login form instead of FEPS Menu if user is not logged in on your site.
- show_reg_link = true/false - Will show registration link under the login form when user is not logged in on your site.
- show_remember_link = true/false - Will show Restore password link under the login form when user is not logged in on your site.