Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
72 changes: 72 additions & 0 deletions partner_geolocation_map/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
# Smart Geolocation for Contact Forms

![Beta](https://img.shields.io/badge/maturity-Beta-yellow.png) ![License](https://img.shields.io/badge/licence-LGPL--3-blue.png) [![GitHub](https://img.shields.io/badge/github-GitHubRepo-lightgray.png?logo=github)](https://github.com/Burnaviour/devtoolschool/tree/18.0/partner_geolocation_map)

🚀 **Just Launched: Supercharge Your Contact Forms with Smart Geolocation!**

An open-source Odoo module that enhances address inputs by making them **smarter** and **more efficient** with geolocation features! 🗺️

## What It Does:
✅ **Search & Save Locations:** Users can quickly search for any location and save it for future use.
✅ **Auto-Fill Magic:** Selecting a saved location auto-populates address fields (city, state, ZIP, etc.).
✅ **Drag & Discover:** Drag the map pointer anywhere, and the address fields update in real-time!

## Table of Contents
- [Usage](#usage)
- [Example of JSON Fields](#example-of-json-fields)
- [Demo](#demo)
- [Bug Tracker](#bug-tracker)
- [Credits](#credits)

## Usage

To integrate the Smart Geolocation module:

1. Navigate to the **Contacts** module in Odoo.
2. Use the address input field enhanced with geolocation.
3. Select a location to auto-populate the address fields.
4. Drag the map pin for precise adjustments.

## Example of JSON Fields

This module stores geolocation data in JSON format for better flexibility. Example field:

```xml
<field name="coordinates" widget="partner_geolocation_map"/>
```

## Demo
Try out the Smart Geolocation module now! Check out our **Demo Video**




https://github.com/user-attachments/assets/4df15688-524d-44f5-8457-7ff09fa42f1c



## Bug Tracker

Bugs are tracked on [GitHub Issues](https://github.com/Burnaviour/devtoolschool/issues). If you find an issue, please report it by providing a detailed description.

## Credits

### Authors

- Muhammad Muzafar

### Contributors

- Muhammad Muzafar
- Manuel Vinent Guilarte

### Maintainers

This module is actively maintained. You are welcome to contribute!

For any inquiries, reach out to us:

📧 **Email:** [burnaviour7890@gmail.com](mailto:burnaviour7890@gmail.com)

🔗 **LinkedIn:** [Muhammad Muzafar](https://www.linkedin.com/in/muhammad-muzafar-78147b213/)