GeoContacts
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.
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
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.
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.
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.