https://github.com/msantos/wwallo

Tag cloud for your geo location
https://github.com/msantos/wwallo

Last synced: about 2 months ago
JSON representation

Tag cloud for your geo location

• Host: GitHub
• URL: https://github.com/msantos/wwallo
• Owner: msantos
• Created: 2009-12-24T19:28:18.000Z (over 15 years ago)
• Default Branch: master
• Last Pushed: 2010-03-17T14:53:59.000Z (about 15 years ago)
• Last Synced: 2025-02-13T05:30:15.607Z (4 months ago)
• Language: JavaScript
• Homepage:
• Size: 169 KB
• Stars: 2
• Watchers: 4
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README

Awesome Lists containing this project

README

        


wwallo is a tag cloud for wherever you happen to be.

WHY?

Wouldn't it be cool if locations were tagged just like websites?

If you're stuck in traffic or wandering through an unfamiliar place,

your location is tagged by what people have been saying around you.

Maybe they're in a frenzy about an accident that has traffic at a

standstill or ranting about some local event. Maybe the buzz is

about the outbreak of the zombie plague (in which case you should

get out of there ASAP :)

WHAT AND WHY?

wwallo is a twitter client and an excuse to experiment with (the

kickass) WebMachine, jQuery (and a lot of awesome jQuery plugins)

and the geolocation features of Google Gears.

wwallo geolocates the client by using Google Gears (tested with the

web browser on an Android phone and firefox on Mac OS X and Ubuntu).

If Gears is not installed, wwallo falls back to using the IP address

to lookup the client's location. Finally, if the client source IP

address is within the private range, wwallo resorts to using its

public IP address.

DEMO

Test server, may not always be available:

    http://tinyurl.com/wwallo

DEPENDENCIES

rfc4627 JSON parser: http://hg.opensource.lshift.net/erlang-rfc4627/archive/default.tar.gz

egeopip: http://code.google.com/p/egeoip/source/checkout

HOWTO

1. Download and build rfc4627 and egeoip.

2. Download the GeoLite database from MaxMind and place it in the egeoip/priv directory:

    cd egeoip/priv

    wget http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz

3. Check out wwallo and build.  mochiweb is set to listen on port

8585. The port can be changed in src/wwallo_sup.erl.

    cd wwallo

    make

4. Create symbolic links to the directories of the dependencies.

    mkdir deps

    cd deps

    ln -s /path/to/webmachine # webmachine contains the ebin directory

    ln -s /path/to/rfc4627    # rfc4627 contains the ebin directory

    ln -s /path/to/egeoip     # egeoip contains the ebin directory

5. Start the server:

    ./start-dev.sh

6. Open your browser:

    http://localhost:8585/

COMPONENTS

WebMachine: http://webmachine.basho.com/

jQuery: http://jquery.com/

Google Gears: http://gears.google.com/

egeoip: http://code.google.com/p/egeoip/

Erlang rfc4627 JSON parser: http://www.lshift.net/blog/2007/02/17/json-and-json-rpc-for-erlang

Erlang stemmer: http://github.com/klajo/hacks/blob/master/stem/src/stem_en.erl

WebMachine static resource: http://bitbucket.org/bryan/wmexamples/

jQuery Plugins:

jquery.corner: http://malsup.com/jquery/corner/

jGrowl: http://stanlemon.net/projects/jgrowl.html

jquery.loading: http://plugins.jquery.com/project/loading

jquery.selectbox: http://www.brainfault.com/jquery-plugins/jquery-selectbox-replacement/

jquery.tagcloud: http://code.google.com/p/jquery-tagcloud/

This product includes GeoLite data created by MaxMind, available from http://maxmind.com/

Any remaining code written by me can be used under the MIT license:

Copyright (c) 2009 Michael Santos 

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

copies of the Software, and to permit persons to whom the Software is

furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in

all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN

THE SOFTWARE.