Geotagger Documentation

Please contact support if you have questions or see incorrect or missing information.

Upgrading from Geotagger 2.x

Geotagger 3 is a complete re-write. Geotagger 3 is a proper fieldtype and does not include extension code or module code any longer. Follow these instructions if you have previously installed Geotagger 2.x.

  1. Uninstall your Geotagger 2.x extension, module and fieldtype. You won't lose any field data since Geotagger doesn't actually store any data currently.
  2. Follow installation instructions below.
  3. Follow instructions for adding a Geotagger Field below.

Installation

  1. Copy EE2/system/expressionengine/third_party/geotagger to your third_party folder (e.g. /_your_ee_system_dir_/expressionengine/third_party/).
  2. Copy EE2/themes/third_party/geotagger to your themes third_party folder (e.g. /themes/third_party/).
  3. Login to the ExpressionEngine Control Panel, go to Add-Ons → Fieldtypes.
  4. Find Geotagger in the list of fieldtypes and click “Install”.

Adding a Geotagger Field

Geotagger does not store latitude, longitude, zoom or any address data in it. You need to create separate custom fields for storing latitude, longitude, zoom and address fields. See instructions below for directions.

  1. Login to the ExpressionEngine Control Panel, go to Admin → Channel Administration → Custom Fields.
  2. Find the field group you want to add a Geotagger field to and click Add/Edit Custom Fields.
  3. Add all of the location fields you need (e.g. address, city, state, postal code, latitude, longitude, zoom). At least one address field and both latitude and longitude fields are the minimum fields required for Geotagger.
  4. After all of the mapping fields have been created, click the Create a New Custom Field button.
  5. Select Geotagger in the Field Type dropdown.
  6. Enter the field label (e.g. Geotag).
  7. Enter the field name (e.g. geotag).
  8. Under Custom Field Options, select a Geotagger mode (Manual or Auto-tag).
  9. Select a default zoom level for the map that will display after a location has been geotagged.
  10. Specify field mappings for the location fields you will be using. You should map at least one of the following:
    • Address field
    • City field
    • State field
    • Zip code field
  11. Specify field mappings for latitude and longitude fields.
  12. Optionally specify a field mapping to capture the zoom level.
  13. Click Submit.

SafeCracker Usage & Requirements

Geotagger now fully supports usage in SafeCracker forms and we have included an example form to help get you started. Be sure to review the requirements and instructions below when setting up your SafeCracker / Geotagger form.

  1. Your SafeCracker form must have a class="geotagger" attribute.
  2. DO NOT give the submit button a name="submit" attribute. Doing so will break Auto-tag mode.
  3. For Geotagger related inputs (fields you have mapped in the field configuration), make sure you set the id attribute to your custom field name (e.g. id="venues_address", id="venues_latitude", etc).
  4. Override Geotagger's CSS by applying your own style sheet.
  5. You can only use one SafeCracker / Geotagger form per page.

SafeCracker Example Form

		
			{exp:safecracker channel="venues" return="geotagger/ENTRY_ID" entry_id="{segment_2}" class="geotagger"}
			<div>
				<input type="hidden" name="venues_latitude" id="venues_latitude" value="{venues_latitude}" />
				<input type="hidden" name="venues_longitude" id="venues_longitude" value="{venues_longitude}" />
				<input type="hidden" name="venues_zoom" id="venues_zoom" value="{venues_zoom}" />
			</div>
			<ul>
				<li>
					<label for="title">Title</label>
					<input type="text" name="title" id="title" value="{title}" size="50" maxlength="100" />
				</li>
				<li>
					<label for="venues_address">Address</label>
					<input type="text" name="venues_address" id="venues_address" value="{venues_address}" size="50" maxlength="100" />
				</li>
				<li>
					<label for="venues_geotagger">Map</label>
					{field:venues_geotagger}			
				</li>
			</ul>
			<p><input type="submit" value="Save Entry" name="geotag_submit" /></p>
			{/exp:safecracker}

Changelog

1.0

1.1

1.1.1

1.1.2

1.1.3

1.1.4

1.1.5

2.1

2.1.1

2.1.2

3.0

3.0.1

3.0.2

3.0.3

3.0.4