You are here

README.txt in Simple Google Maps 8

Same filename and directory in other branches
  1. 7 README.txt
  2. 3.0.x README.txt
Simple Google Maps module

This module is about the simplest way to get a Google Map, or a link to a
Google Map, displayed with your content. It simply provides a field formatter
for Drupal 8 text fields. With this formatter, you can enter a single-line
address that Google Maps would recognize into a plain text field, such as:
   100 Madison Ave, New York, NY
And then on your Manage Display screen (or in Views field setup), you can choose
to display the field with an embedded iframe Google Map, a link to a Google Maps
map, or both; with or without the original address text.

No Google Maps API, JavaScript downloads, etc. are required. This just uses
Google Maps' iframe embedding capability to embed a map at a given address that
Google Maps can recognize, or to make a link to Google Map.

To install and use:
- Upload/unzip to your Drupal 8 /modules directory (or /modules/contrib or
  whatever).
- Enable the module.
- Add a plain Text field to your content type. You probably should add some
  Help text to the field to explain that a one-line address that Google Maps can
  recognize needs to be entered, and that the output will be formatted with a
  map (or a link or both, depending on how you are using this field).
- On the Manage Display screen, or when adding this field to Views, choose the
  provided mapping formatter.
- If desired, click the button to change the field display settings.

Note: There are no field validation steps in this module, and it just uses a
regular Text field rather than defining its own field (this is the "simple" part
of this module). The display settings let you choose the size of the map, the
text for the map link, the map zoom level (applies to both embedded and linked
map), and to turn on/off the various things you can display. That's pretty much
it (remember: simple is in the name!).

File

README.txt
View source
  1. Simple Google Maps module
  2. This module is about the simplest way to get a Google Map, or a link to a
  3. Google Map, displayed with your content. It simply provides a field formatter
  4. for Drupal 8 text fields. With this formatter, you can enter a single-line
  5. address that Google Maps would recognize into a plain text field, such as:
  6. 100 Madison Ave, New York, NY
  7. And then on your Manage Display screen (or in Views field setup), you can choose
  8. to display the field with an embedded iframe Google Map, a link to a Google Maps
  9. map, or both; with or without the original address text.
  10. No Google Maps API, JavaScript downloads, etc. are required. This just uses
  11. Google Maps' iframe embedding capability to embed a map at a given address that
  12. Google Maps can recognize, or to make a link to Google Map.
  13. To install and use:
  14. - Upload/unzip to your Drupal 8 /modules directory (or /modules/contrib or
  15. whatever).
  16. - Enable the module.
  17. - Add a plain Text field to your content type. You probably should add some
  18. Help text to the field to explain that a one-line address that Google Maps can
  19. recognize needs to be entered, and that the output will be formatted with a
  20. map (or a link or both, depending on how you are using this field).
  21. - On the Manage Display screen, or when adding this field to Views, choose the
  22. provided mapping formatter.
  23. - If desired, click the button to change the field display settings.
  24. Note: There are no field validation steps in this module, and it just uses a
  25. regular Text field rather than defining its own field (this is the "simple" part
  26. of this module). The display settings let you choose the size of the map, the
  27. text for the map link, the map zoom level (applies to both embedded and linked
  28. map), and to turn on/off the various things you can display. That's pretty much
  29. it (remember: simple is in the name!).