You are here

README.txt in Smart IP 7.2

$Id$

Description:
Smart IP Views Bridge exposes Smart IP visitor's location details to 
Views field (coordinates, country, ISO 3166 2-character country code, 
region, region code (FIPS), city and zip) and filter (country, ISO 3166 
2-character country code, region, region code (FIPS), city and zip).

Requirements:
Drupal 7.x
Smart IP
Views

Installation:
1. Login as an administrator. Enable the module at http://www.example.com/?q=admin/modules
as well as the Smart IP and Views modules.
2. Create your views at http://www.example.com/?q=admin/structure/views

Guide/example of using Smart IP views fields and filters with Location module:
1. Download Location module. Enable Location and Location CCK modules.
2. Add location field to "Basic page" content type at
http://www.example.com/?q=admin/structure/types/manage/page/fields. Populate 
the field label with "Location" and field name with "location". Select "Location" 
from "Type of data to store".
3. At "Location" field settings > Locative Information > Collection Settings 
select "Allow" for the "City" and "Country" items.
4. Create a "Basic page" content. Populate the "Title", "City" and select a country 
(Important: be sure that the city and country matches the geolocation that 
Smart IP has detected based on your IP. To check, enable the device_geolocation 
block - Please refer to the README.txt of device_geolocation module for the instructions).
5. Create your views at http://www.example.com/?q=admin/structure/views
6. Inside your Edit view, add a Filter criteria then select "Location: City" from the 
list (click "Add and configure filter criteria" button).
7. In "Configure filter criterion: Location: City", populate the "Value:" textfield 
with "smart_ip][location][city" Smart IP Views token and leave the "Is equal to" 
selected in "Operator" dropdown menu (click "Apply" button). 
8. At your Edit view, add a Filter criteria then select "Location: Country" from the 
list (click "Add and configure filter criteria" button).
9. In "Configure filter criterion: Location: Country", scroll down at the 
bottom of the "Country" list box and select "Smart IP: visitor's country code". 
And select "Is" from "Operator" radio selection (click "Apply" button).
"This will filter contents with the country defined in Location CCK fields (Country 
and City) in ralation to your visitor's country and city detected by Smart IP."
10. Add a field then select "Smart IP: Country" from the list (click 
"Add and configure fields" button).
11. In "Configure field: Smart IP: Country", change the "Label" to "Your Country"
then select "Country name" from the "Display style:" dropdown menu (click 
"Apply" button). This will display the country of your visitor along with other CCK 
fields you've included in your views.

Support:
Please use the issue queue for filing bugs with this module at
http://drupal.org/project/issues/smart_ip

File

modules/smart_ip_views_bridge/README.txt
View source
  1. $Id$
  2. Description:
  3. Smart IP Views Bridge exposes Smart IP visitor's location details to
  4. Views field (coordinates, country, ISO 3166 2-character country code,
  5. region, region code (FIPS), city and zip) and filter (country, ISO 3166
  6. 2-character country code, region, region code (FIPS), city and zip).
  7. Requirements:
  8. Drupal 7.x
  9. Smart IP
  10. Views
  11. Installation:
  12. 1. Login as an administrator. Enable the module at http://www.example.com/?q=admin/modules
  13. as well as the Smart IP and Views modules.
  14. 2. Create your views at http://www.example.com/?q=admin/structure/views
  15. Guide/example of using Smart IP views fields and filters with Location module:
  16. 1. Download Location module. Enable Location and Location CCK modules.
  17. 2. Add location field to "Basic page" content type at
  18. http://www.example.com/?q=admin/structure/types/manage/page/fields. Populate
  19. the field label with "Location" and field name with "location". Select "Location"
  20. from "Type of data to store".
  21. 3. At "Location" field settings > Locative Information > Collection Settings
  22. select "Allow" for the "City" and "Country" items.
  23. 4. Create a "Basic page" content. Populate the "Title", "City" and select a country
  24. (Important: be sure that the city and country matches the geolocation that
  25. Smart IP has detected based on your IP. To check, enable the device_geolocation
  26. block - Please refer to the README.txt of device_geolocation module for the instructions).
  27. 5. Create your views at http://www.example.com/?q=admin/structure/views
  28. 6. Inside your Edit view, add a Filter criteria then select "Location: City" from the
  29. list (click "Add and configure filter criteria" button).
  30. 7. In "Configure filter criterion: Location: City", populate the "Value:" textfield
  31. with "smart_ip][location][city" Smart IP Views token and leave the "Is equal to"
  32. selected in "Operator" dropdown menu (click "Apply" button).
  33. 8. At your Edit view, add a Filter criteria then select "Location: Country" from the
  34. list (click "Add and configure filter criteria" button).
  35. 9. In "Configure filter criterion: Location: Country", scroll down at the
  36. bottom of the "Country" list box and select "Smart IP: visitor's country code".
  37. And select "Is" from "Operator" radio selection (click "Apply" button).
  38. "This will filter contents with the country defined in Location CCK fields (Country
  39. and City) in ralation to your visitor's country and city detected by Smart IP."
  40. 10. Add a field then select "Smart IP: Country" from the list (click
  41. "Add and configure fields" button).
  42. 11. In "Configure field: Smart IP: Country", change the "Label" to "Your Country"
  43. then select "Country name" from the "Display style:" dropdown menu (click
  44. "Apply" button). This will display the country of your visitor along with other CCK
  45. fields you've included in your views.
  46. Support:
  47. Please use the issue queue for filing bugs with this module at
  48. http://drupal.org/project/issues/smart_ip