You are here

Home » API reference » Location 7.3

README.txt in Location 7.3

Same filename in this branch
  1. 7.3 README.txt
  2. 7.3 contrib/location_cck/README.txt
  3. 7.3 contrib/location_fax/README.txt
CONTENTS OF THIS FILE
--------------------

* Introduction
* Requirements
* Installation
* Configuration
* Maintainers


INTRODUCTION
------------

The Location module allows real-world geographic locations to be associated with
Drupal nodes, including people, places, and other content. The Location module
allows admins to collect addresses, geocode them (translate addresses to
latitude/longitude), and associate locations with Drupal nodes and users.
Location data is automatically used to generate GeoRSS within your existing
RSS feeds.

* For a full description of the module visit
https://www.drupal.org/documentation/modules/location

* To submit bug reports and feature suggestions, or to track changes visit
https://www.drupal.org/project/issues/location


REQUIREMENTS
------------

This module has no required dependencies outside of Drupal core.


INSTALLATION
------------

* Install the Location module as you would normally install a contributed Drupal
module.
https://www.drupal.org/docs/7/extending-drupal-7/installing-contributed-modules-find-import-enable-configure-drupal-7
for further information.


CONFIGURATION
--------------

1. To configure the general location settings navigate to Administration >
Configuration > Content authoring > Location.

2. To configure map link settings navigate to Administration > Configuration >
Content authoring > Location > Map links. Map links are displayed with
locations and link to an external mapping website. When the link is clicked
the user is taken to the mapping website and the corresponding location is
loaded into it. Map link settings are per country.

3. To configure the geocoding settings navigate to Administration >
Configuration > Content authoring > Location > Geocoding options. Geocoding is
used to automatically calculate latitude/longitude coordinates based on a given
address. When geocoding is enabled a user can enter address details for a
location and then on saving the page the module tries to automatically populate
the latitude/longitude values using geocoding. Geocoding settings are per
country.

4. There is a Location Utilities page at Administration > Configuration >
Content authoring > Location > Location Utilities (admin/settings/location/util).
This page currently provides the ability to clear province and country list
caches if you modify the lists for your website.

5. User permissions can be configured by navigating to Administration >
People > Permissions.
* "View location directory" allows users to view the location_directory view,
which is a default view provided by the location module.
* "Submit latitude/longitude" allow users to add longitude and latitude values
while registering. The anonymous user role must have this permission.
* "View node location table" allows users to view the location_table view,
which is a default view provided by the location module.
* "View user location table" allows users to view the user_location_table view,
which is a default view provided by the location module.

To create mass geocoding/re-geocoding of node locations visit
https://www.drupal.org/node/1041632.


MAINTAINERS
-----------

* Dmitry Drozdik (ddrozdok) - https://www.drupal.org/u/ddrozdik
* Andrii Podananko (podarok) - https://www.drupal.org/u/podarok
* Alexander Schedrov (sanchiz) - https://www.drupal.org/u/sanchiz
* Brandon Bergren (bdragon) - https://www.drupal.org/u/bdragon

This project was supported by Druler - https://www.drupal.org/druler

File

README.txt
View source 
  1. CONTENTS OF THIS FILE

  2. --------------------

  3. 

  4. * Introduction

  5. * Requirements

  6. * Installation

  7. * Configuration

  8. * Maintainers

  9. 

  10. 

  11. INTRODUCTION

  12. ------------

  13. 

  14. The Location module allows real-world geographic locations to be associated with

  15. Drupal nodes, including people, places, and other content. The Location module

  16. allows admins to collect addresses, geocode them (translate addresses to

  17. latitude/longitude), and associate locations with Drupal nodes and users.

  18. Location data is automatically used to generate GeoRSS within your existing

  19. RSS feeds.

  20. 

  21. * For a full description of the module visit

  22. https://www.drupal.org/documentation/modules/location

  23. 

  24. * To submit bug reports and feature suggestions, or to track changes visit

  25. https://www.drupal.org/project/issues/location

  26. 

  27. 

  28. REQUIREMENTS

  29. ------------

  30. 

  31. This module has no required dependencies outside of Drupal core.

  32. 

  33. 

  34. INSTALLATION

  35. ------------

  36. 

  37. * Install the Location module as you would normally install a contributed Drupal

  38. module.

  39. https://www.drupal.org/docs/7/extending-drupal-7/installing-contributed-modules-find-import-enable-configure-drupal-7

  40. for further information.

  41. 

  42. 

  43. CONFIGURATION

  44. --------------

  45. 

  46. 1. To configure the general location settings navigate to Administration >

  47. Configuration > Content authoring > Location.

  48. 

  49. 2. To configure map link settings navigate to Administration > Configuration >

  50. Content authoring > Location > Map links. Map links are displayed with

  51. locations and link to an external mapping website. When the link is clicked

  52. the user is taken to the mapping website and the corresponding location is

  53. loaded into it. Map link settings are per country.

  54. 

  55. 3. To configure the geocoding settings navigate to Administration >

  56. Configuration > Content authoring > Location > Geocoding options. Geocoding is

  57. used to automatically calculate latitude/longitude coordinates based on a given

  58. address. When geocoding is enabled a user can enter address details for a

  59. location and then on saving the page the module tries to automatically populate

  60. the latitude/longitude values using geocoding. Geocoding settings are per

  61. country.

  62. 

  63. 4. There is a Location Utilities page at Administration > Configuration >

  64. Content authoring > Location > Location Utilities (admin/settings/location/util).

  65. This page currently provides the ability to clear province and country list

  66. caches if you modify the lists for your website.

  67. 

  68. 5. User permissions can be configured by navigating to Administration >

  69. People > Permissions.

  70. * "View location directory" allows users to view the location_directory view,

  71. which is a default view provided by the location module.

  72. * "Submit latitude/longitude" allow users to add longitude and latitude values

  73. while registering. The anonymous user role must have this permission.

  74. * "View node location table" allows users to view the location_table view,

  75. which is a default view provided by the location module.

  76. * "View user location table" allows users to view the user_location_table view,

  77. which is a default view provided by the location module.

  78. 

  79. To create mass geocoding/re-geocoding of node locations visit

  80. https://www.drupal.org/node/1041632.

  81. 

  82. 

  83. MAINTAINERS

  84. -----------

  85. 

  86. * Dmitry Drozdik (ddrozdok) - https://www.drupal.org/u/ddrozdik

  87. * Andrii Podananko (podarok) - https://www.drupal.org/u/podarok

  88. * Alexander Schedrov (sanchiz) - https://www.drupal.org/u/sanchiz

  89. * Brandon Bergren (bdragon) - https://www.drupal.org/u/bdragon

  90. 

  91. This project was supported by Druler - https://www.drupal.org/druler