Sobelz Map Selector

The Sobelz Map plugin allows users to select locations on a map and integrates with the WooCommerce checkout page.
By selecting a location by the user, the fields related to the location are filled.

Features

• Accurate location selection on the map.
• Integration with WooCommerce checkout fields.
• The appearance of the map can be adjusted:
  • Customize search box and button text.
  • Change map and button color.
  • Change map icons.
  • Personalize field IDs for a tailored experience.
  • Show or hide the map on the payment page.

Configuration

1. Navigate to ‘Map Selector’ in the WordPress admin menu.
2. Adjust the plugin settings, including map color, submit button color, and other options.
3. Customize the map appearance and behavior to suit your needs.

Support

For support and inquiries, please contact us at [email protected].

License

Sobelz Map Plugin is licensed under the GPLv2 or later license.

Contributing

Contributions are welcome! Feel free to submit issues or pull requests.

Third Party Services

The map display and functionality in this plugin are powered by a compressed React file that utilizes the Nominatim API and Tile URL from OpenStreetMap.

Nominatim API

The Nominatim API is employed to retrieve geographic information about places, including latitude and longitude. The plugin uses the following URL to make requests to the Nominatim API:

• Nominatim API Endpoint: Nominatim API

This URL specifies that the response should be in JSON format, and the language is set to Persian (fa).

The response from the Nominatim API is utilized to initialize the map.

Default Map Location

The default location of the map is set to Iran. The tile images for the map are retrieved using the following URL:

• OpenStreetMap Tile URL: OpenStreetMap Tiles

Here, the {z} parameter specifies the zoom level, {x} specifies the x-coordinate of the map center, and {y} specifies the y-coordinate.

User Interaction

Users can resize the map by dragging the edges.

External Service Documentation

Please note that this plugin relies on the Nominatim API, Tile URL and OpenStreetMap services. It is important for users to be aware of the third-party service usage.

• OpenStreetMap Terms of Use
• Tile URL Usage Policy
• Nominatim API Usage Policy

By using this plugin, you agree to comply with the terms of use and policies of the external services mentioned above.

Source Code

• Github

Q: Is this plugin compatible with the latest version of WordPress?
A: Yes, the plugin is tested and compatible with WordPress version 6.4.

1.0.0

• Initial release.

1. Upload the sobelz-map folder to the /wp-content/plugins/ directory.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. Visit the ‘Map Selector Settings’ page in the WordPress admin to configure the plugin.

Note: If the map is not displayed on the checkout page for you after installing the plugin, please replace the existing content on the checkout page with the shortcode [woocommerce_checkout].