• Forums

    This way to the forums

GeoContacts

* NOTE: I do not plan to update this module. Suggestions to link over to other WP modules that do a better job are welcome.

GeoContacts 0.1.5 for WordPress 2.2.1 – 2.5

Download geocontacts.zip
Click for the support forum

What’s New

Version 0.1.2:
Interface cleanups, readme updates, and screen shots.

GeoContacts Quick Start

Install your site’s Google key, select the field you want to sort your contacts by in options, enter a few addresses and include one of the following in a post:

GEOCONTACT [*] – To display the entire contact list
GEOCONTACT [1] – To display one contact by its id #

(Remove the space between GEOCONTACT and the [.)

GeoContacts supports Gravatars. Several options are available to tailer Gravatar use for your website. Blank.gif is automatically provided for the default image when there is no Gravatar available for a contact. You can also choose your own site default Gravatar by supplying a valid image URL. Please note that this image will not be resized, so pick an image with a reasonable size.

Preferably this image will match the size of Gravatar you have chosen in the options.You can format the contact layout for your website to just about anything you like. You will find a few contact templates in the templates directory. Simply rename the one you want to use on your site to default.htm. You are encouraged to edit these templates to your liking and share any templates that work especially well for you. Be sure to save a copy of your working template so it does not get lost.

Geocoding

The built-in geocoder is what makes GeoContacts a powerful contact manager plug-in. Click the geocode link in the edit contact window and you have coordinates provided by Google. You can fine tune coordinates by navigating the map shown in the edit contact window. Single click where you want the new marker.

If you don't see a map, first make sure you have a valid Google key installed for your site. If you already know you have a good key then try refreshing the page or dragging the map. A design choice has been made to limit the stored zoom level to 18. This works for most major US cities. In many cases you can zoom in a few more times but the maximum stored zoom level per contact will not go above 18.

Advanced Usage

Anchor templates can be individually selected for a contact or the entire contact list. If you have a template named geo.htm in your templates folder, you can chose this file using the following format:

GEOCONTACT [*,geo.htm] – to display all contacts using the geo.htm template
GEOCONTACT [1,geo.htm] – to display contact 1 using the geo.htm template

(Remove the space between GEOCONTACT and the [.)

Your templates can contain these hot-words.
{$gravatar} = fully built Gravatar URL
{$first_name}
{$last_name}
{$address_line1}
{$address_line2}
{$city}
{$state}
{$postcode}
{$phone}
{$website}
{$email}
{$notes}
{$organization}
{$country}
{$lat} = geocoded latitude
{$lon} = geocoded longitude
{$zoom} = selected zoom level
{$mapsite} = url to map provider

Multiple anchors can be listed per page. With some creative GeoContacts templates you can make a robust review site for restaurants, hotels, and other destinations. You can make your own geocaching site or simply make a contact list of friends and family. You have control of the templates so you can also make imaginative use of the first_name, last_name, phone, organization, and notes fields.

Test Environment

GeoContacts has been tested with WordPress 2.3.1 on a PHP5 Apache MySQL server.

Thank you for trying GeoContacts.

If you like this plug-in, you will be blessed with a warm fuzzy feeling by doing one or more of the following: leaving the links to my site intact in the templates, contributing a template, contributing to coding this plug-in, or donating to the cause.

8 Responses to “GeoContacts”

  1. Hello,
    Congrats for this plugin.
    I just wanna know if you plan to :
    1. add a possibility to show a map of all the contacts (and not all the maps of the contacts)
    2. on my site, the map never showed up, unfortunately. Did I miss something ? (i’m using 2.5.1 and I’ve set up the google API key)
    3. Could we add images to the contact list (in the description or a picture of someone) ?

    Thanks !
    Benjamin

  2. Enseignement,
    1. A single map of all contacts is not currently planned. Other plugins do this.
    2. I’m not sure which map you are talking about. If the administration interface isn’t showing a map in details then try a different browser to see if that does the trick.
    3. Currently contact images are available as gravatars.

    Of course I’ll gladly look at any submitted patches.

  3. Sorry it is not a support question but a praise statement: fantastic work on GeoContacts! Addressbook was really good and now you’ve made it a lot better. Not only that, I think Sam is about to go travelling, so it’s great news you’ve given this essential plugin a new lease of life. What’s this about food and great plugins? You and the Delicious team are awesome! Oh by-the-way I’m a foodie and shocked to hear how bad gluten issues are – my mother had gluten related problems so I can really relate to your mission.

    Okay on a practical note do you mind if I set up a new section in the forum on feature requests? I need my users to be able to add their own details. Should I go down the route of trying to get cforms to act as an input form (I see you use them) or is that something you are working on or considering. Futhermore are you considering different address lists (group a, b, c, etc.)?

    Sorry to clog this box, but as your forum is relatively new I did not want to start dictating structure, unless of course that would be helpful.

    Thanks again and brilliant work.

  4. seamus,
    Thank you.

    You have some great ideas. I’ll happily look at any patches you come up with.

    Generally speaking a plugin should be self sustaining, or not be reliant on another plugin to work. I was at one time debating storing the template html and css in mysql for safety when a plugin is updated. Ultimately I chose not to because the speed reading a file on the server is usually faster than a mysql read.

    (You might want to look at the latest 8.5 cforms. I was beta testing a copy with Oliver this morning that has a few updates on it. Mainly there is a new cform tag that when used will help avoid problems when a form is deleted.)

    User entry is currently outside the design of the plugin. I have a couple of features I want to finish up before taking on new direction. This is my after work, after family, hobby and I don’t plan to change this order of importance. Changes will not come as fast as some of the other plug-ins may come but changes will happen faster if more people worked and submitted patches.

  5. Bravo on an outstanding plugin! This is exactly what I was searching for on a particular project. I cannot express how grateful I am that you took the time to write this.

    I’m not sure if I should direct this to the forum or not… so please chastise me if I am wrong (moreso that others will not follow in my footsteps).

    I would like to offer users the option to search/otherwise filter the listings by state. I thought I would ask if there is an easy method for this, before parsing through your code myself. Any suggestions would be most appreciated!

    Grace and peace!
    -Brian

  6. Hi,

    it looks like the plugin i need. :-)

    I have installed and activated it on wp 2.6.1 but after i updated the setting with the API key etc. i’ll get a fatal error message.

    Fatal error: Cannot redeclare geocontacts_adminhead() (previously declared in /home/user/public_html/wp-content/plugins/geocontacts/geocontacts.php:39) in /home/user/public_html/wp-content/plugins/geocontacts/geocontacts.php on line 58

    Now i am not good with those things. Do you know what this could be about? :-(

    Thank you very much in advance.

    Toto

  7. No matter what I do, or how many times I refresh the browser/restart, the Gravatar will not refresh to the updated image from the Gravatar url. I think it has something to do with the url that it is adding to the backend of image location. The only solution I have found is to delete the email address from Gravatar and re-add it. For obvious reasons, I don’t want to do that every time I update a Gravatar… Can you help?

  8. [...] Page du plugin [...]

Leave a Reply

You must be logged in to post a comment.