Knowledge Base - Gateway for Form2Content

Form2Content Preparation

Overview

To geocode your Form2Content articles using the Geocode Factory Form2Content gateway plugin you will need to use your Form2Content fields. Geocoding simply means to assign the proper coordinates for their location.

If you are using Form2ContentPro, you will get your articles geocoded by using the special "Geo Coder" custom field. You only need to create one such field. This special field includes latitude, longitude and address information (1 line).

geocoder field type

If you are using Form2Content lite, you have two options on the ways to get your articles geocoded:

1
Address fields

You can use address fields like street, postcode, city, etc and (automatically) fetch the coordinates based on the data in these fields (using Geocode Factory 5).The address fields of are field types of your choice. For instance they can be drop-down selection or textbox field types.

2
Coordinate fields

Or you can simply use coordinate fields (latitude and longitude) and input the coordinate values directly (manually). If you use this option, you don't need to create address fields.

Please note that in both cases for Form 2 Content lite you will need to create two coordinates fields. These fields are of course latitude and longitude. Even if you use address fields to fetch the coordinates, you will need a longitude and latitude field where the coordinates data from the geocoding process will be stored. The process of creating coordinate fields is very similar to creating address fields as we shall see.

 

Form2Content Content Types

Follow the following steps to create the fields before configuring the Form2Content gateway plugin.

Once inside your Form2Content component in the Joomla administration area, click on the "Content Type Manager" option from the left sidebar.

You should then see a list of your Content Types.

f2c-content type-manager

If you have no Content Types you should create one first. You can create a new F2C Content type by clicking on "New" at the top of the screen as seen on the image above. After this, give it a name and save it right away (please consult the Form2Content documentation for further information on creating a Content type).

In the Content Type Manager list, click on the fields button which is found second column next to the content type you wish to use. In the example of the above image the Content Type is called "Simple article example". This will bring you to the field manager where you can add your new custom fields.

 

Form2Content Custom Fields

f2c-new-field-button

Now, to add a new custom field click on the "New" button.

 

If you're using Form2ContentPro:

In this case you only have to create one "Geo Coder" type custom field.

 f2c-geocoder-new-field

Field Name: Give a name to your field.

Field Caption: Give a name that will appear in the form of the front end (caption) for this field.

Description: Enter the "Description" settings as you like (optional).

Field Type: In this case the field type is a "Geo Coder" field.

Finally, save your new field. Form2Content is now ready!

 

If you are using Form2Content lite:

1
Address fields

Note: If you want to use coordinate fields (latitude and longitude) and input the coordinate values directly (manually), you don't need to create address fields but only coordinate fields (as described in point "2" above).  So you can skip this part and go straight to number 2.

First address field: Street

new-address-field-f2c

Field Name: Give a name to your field.

Field Caption: Give a name that will appear in the form of the front end (caption) for this field.

Description: Enter the "Description" settings as you like (optional).

Field Type: In this case the field type is a "Simple line text (textbox)" field.

Finally, save your new field and repeat these steps for as many fields as you like (ex: postcode, city, state, country, etc).

 

2
Coordinate fields - latitude and longitude

First coordinate field: Latitude

f2c-coordinate-new-field

 

Field Name: Give a name to your field.

Field Caption: Give a name that will appear in the form of the front end (caption) for this field.

Description: Enter the "Description" settings as you like (optional).

Field Type: In this case the field type is a "Simple line text (textbox)" field.

Finally, save your new field and repeat these steps for the Longitude field as well.

Form2Content is now ready!

Applies To

Geocode Factory 5