Why to add Grafetee button to your site
<< back
Adding Grafetee to your site is easy:
  • Simply copy-paste a short piece of HTML to your site
  • No api keys or registrations required!
Grafetee button allows:
Test what Grafetee button looks like
Click this [G] (or better yet, drag it to your browser's bookmarks or bookmark toolbar) to see how Grafetee looks like to end-users when they're adding content from web to their mobile devices. When using the button here, you can use category code TEST for testing purposes.

We're not telling you to use a ready-made Grafetee icon: You are free to use whatever type of text, button, icon or graphics you like that best suits your site's layout.
How to add Grafetee button to your site
When adding Grafetee button to your site, you can pre-populate some or all the fields so the user does not have to enter them themselves:

Parameter: Example value: Notes:
lat 40.71435 Location of the item (latitude)
It is strongly recommended that you provide at least this and "lng" parameter
(example is for New York, value will be used only if both lat and lng are specified)
lng -74.005974 Location of the item (longitude)
It is strongly recommended that you provide at least this and "lat" parameter
(example is for New York, value will be used only if both lat and lng are specified)
projection EPSG:3067 Format of lat & lng parameters
If your coordinates are not in EPSG:4326 projection, use this parameter to tell the correct projection so the widget understands your coordinates.
(if you don't know what this is, leave this out - if you use, for example, Google Maps, then your coordinates are already in correct format and you don't need this parameter)
day 14 Day of month when the location/item/event is relevant
(1=first day, value will be used only if all day,month,year,hour and minute -parameters are specified)
month 4 Month when the location/item/event is relevant
(1=January, value will be used only if all day,month,year,hour and minute -parameters are specified)
year 2012 Year when the location/item/event is relevant
(Use 4 numbers, value will be used only if all day,month,year,hour and minute -parameters are specified)
hour 13 Hour when the location/item/event is relevant
(Use 24h format, value will be used only if all day,month,year,hour and minute -parameters are specified)
minute 15 Minute when the location/item/event is relevant
(value will be used only if all day,month,year,hour and minute -parameters are specified)
address Middle+of+New+York Text shown in address search text field
Remember to url-encode your text when passing it as a parameter!
(just for show - no functionality will depend on this text. Will be cleared out when user clicks on the address search text field.)
content Party+party! Pre-filled content to the content field.
If you have newlines in the content, only the first line will be shown in lists (all lines will be shown in details).
If the content contains urls, addresses, phone numbers etc they can be opened in the phone.
Remember to url-encode your text when passing it as a parameter!
If you want to enter multiple lines and have trouble with newline characters you can also use underscore character "_" to split lines. So the content string "foo_bar_baz" will generate an entry with title "foo" and two lines of details, "bar" and "baz".
lang fi Language and time/date format for the widget.
At the time of writing "fi" will produce a Finnish widget, any other value (or missing value) will produce English widget.
note %3Ci%3EExample!%3C%2Fi%3E Optional HTML displayed on the widget page (<i>Example!</i>).
If you wish to display your own HTML on the widget page, you can add HTML here.
Remember to url-encode your text when passing it as a parameter!
encoding ISO-8859 If your URL-escaped special characters don't appear correctly in the widget (might happen if your page is non-UTF-8 and you escape in UTF-8) you can specify your page's encoding in this parameter so our servers have a hint how to decode your äs and ös.

If you use all the parameters (except the lang) listed above, the HTML code that you have to add to your site is:

... which produces the following (click the link to open/close the bookmarking window):


Feel free to edit the above HTML if you want to try out different parameters.
Editing the HTML modifies the link on this page in real-time.
Reload this page if you really mess it up :)

That's all there is to it!
How to track Grafetee button
If you are already using Google Analytics, you can easily track bookmarkings:
  1. Add _gaq.push(['_trackEvent', 'grafetee_bookmarked', 'ID']); before the var __grafetee-in the code so the code to be copied to your site becomes:
  2. Change the ID in the code to a code unique to each item or event so you can track the number of bookmarkins in per-item fashion. Also, if you want to change the event name "grafetee_bookmarked" to something else, feel free to do so.
  3. You can track bookmarkings in Google Analytics if you:
    1. Go to Content > Events > Overview
    2. On the right, in "Event Category", click "grafetee_bookmarked"
    3. Below the graph, in "Primary Dimension", click "Event Action"
    4. A page will be shown that lists all the statistics related to Grafetee button:
      [G]
  4. That's it! Piece of pie! Easy as cake!
Latitude, longitude, what's that?
If you just want to hardcode one location to the HTML (for example: you're adding the widget to a contact page which has a location that does not change) you can use this tool to get the correct latitude and longitude for any given address.

Latitude and longitude parameters for address are .