Create A Gravity Form
First you start by creating a Gravity Forms Form using menu “New Form”, call it e.g. “SLP Basic Form”.
On this form, you can create a number of fields with different parameters.
Try creating a form with a Advanced Fields “Name” and “Address” and a Standard Field “Single Line Field”.
In the form edit screen, you can change the ‘name’ of the fields, e.g. “Store Name” and “Hours” respectively.
Map Form Fields To Locator Fields
Next, you create a new mapping, using the menu GFL Mappings.
It is a custom post type, so you can name it anything you like, e.g. “GFL Basic Mapping”.
On the edit screen, you have a section “Configuration” with some drop down fields.
The first drop down list should show a list of all GF forms defined earlier, so it should contain “SLP Basic Form”.
The Condition can be left for later.
The remainder of the drop down fields should reflect the SLP database fields. The number depends on the other add-ons you have installed. It should show at least the basic SLP fields like “Name”, “Address”, “City”, “Tags”, etc.
If you have the Directory Builder add-on, you should also see fields like “Department”, “Facility”, etc.
Each SLP field has a drop down list showing all the fields defined in the GF form. The list is populated by Ajax and thus will change when you select another form in the first “Gravity Form” field.
If you select “SLP Basic Form”, you should see the fields “Store Name” and “Hours” respectively, along with some address fields.
By selecting the field, you create a mapping. You could e.g. select the “Hours” GF field to be assigned to the “Tags” SLP field. Each mapping is a relation between two fields from the different data sets. Mind, it is a one-to-many (or many-to-one?) relation, you can assign the GF field “Hours” to many SLP fields.
This should complete the back-end configuration.
Gravity Forms Locator Handling
Go the Gravity Forms tab in Store Locator Plus and update the settings to change how new locations are handled.
Publish Your Form
Now for the front-end.
First create a post for the GF form using a GF shortcode. Editing the post shows you a button “Add Form” which can help adding the form. Use this post to generate some entries. For a decent test, you should use some nice address values. When a form is submitted, the data entered is used to also generate an SLP entry according to the mapping defined for that form.
Next create a post for showing the SLP data.
Gravity Forms Locations (Free) vs. Integration (Paid)
The Gravity Forms add-ons for Store Locator Plus comes in two versions. There is a free version called “Gravity Forms Locations” that is available from the WordPress Plugin Directory. The paid version, Gravity Forms Integration, is available from Charleston Software Associates and provides extended capabilities.
In addition to all of the features found in the free version, the paid version adds the following features:
- Extended data, free version only supports basic SLP data.
- Search filters. Premium version supports same filtering as “Country_Selector” as part of ES.
- Shortcode support. Premium version supports [[SLPLUS]] atributes “gfl_form_id_selector=”hidden” gfl_form_id=<id>”.
- Custom mapping definitions. Free version supports mapping of basic SLP data from basic GF elements. Premium version supports custom definition of GF elements to SLP data, including extended data.
Gravity Forms Integration : Added Form Attributes
With GFI, you have some additional extended data and shortcode attributes:
This will use the extended data field “gfl_form_id” to filter out the locations generated with that GF form. You can check those values in the edit locations screen.
With this attribute, you can hide the selector drop down on the slplus page.