Overview

MAM GeoFilters is a plugin in the Mobile App Manager (MAM) Suite that enables app users to select and switch between cities or neighborhoods from a button on the top navigation header of the mobile app. This feature dynamically filters listings and content based on the user’s selected city, providing a localized experience.

Administrators can manage which cities (and optional neighborhoods) appear in the list, toggle visibility, and define default map coordinates directly in the WordPress Admin settings page.

⚙️ 1. Requirements

• WordPress 6.0 or higher
• PHP 7.4+
• MAM Main plugin (version 1.0.0 or later)
• Optional:
  • GeoDirectory or compatible directory plugin (for automatic city extraction)
  • GeoIP Detection (for automatic user city lookup)

📦 2. Installation

Option A – Auto-installed via MAM Suite Updater

1. Go to WP Admin → Mobile App Manager → Software.
2. Click Install next to MAM GeoFilters.
3. Wait for installation to complete, then click Activate.

Option B – Manual Upload

1. Download the plugin ZIP (mam-geofilters.zip).
2. From your WordPress dashboard, go to Plugins → Add New → Upload Plugin.
3. Select the ZIP file and click Install Now.
4. Once installed, click Activate Plugin.

🧭 3. Accessing the Settings Page

Once activated, navigate to:
WP Admin → Mobile App Manager → Settings → GeoFilters

You’ll see a tab titled “Manage Cities.”
This is where you add, edit, or hide cities available to users in the mobile app.

🏙️ 4. Managing Cities

The Manage Cities screen displays a table of all cities currently configured in your app.

Adding a New City

1. Scroll to the bottom of the list.
2. Enter the following:
   • Name: The city name as it should appear in the app (e.g., “Chicago, IL”).
   • Latitude / Longitude: Center point for this city’s map view.
   • Active: Check this box to make the city visible in the app.
3. Click Save Changes.

💡 Tip: Latitude and longitude can be copied from Google Maps by right-clicking the desired point and selecting “Copy coordinates.”

Editing or Hiding Cities

• Edit: Update the name, coordinates, or status directly in the table.
• Hide: Uncheck the “Active” box and click Save Changes. Hidden cities remain stored in WordPress but are not shown in the app.

🏘️ 5. Managing Neighborhoods (Optional)

1. In the Manage Cities screen, click Select City → Neighborhood View.
2. Add or edit neighborhoods for that city (name, lat/lon, active checkbox).
3. Save your changes.

These appear beneath each city as nested filters in the mobile app.

🌍 6. App Integration

Once configured, the GeoFilters data is automatically sent to the mobile app via your existing MAM JSON feed.

In the Mobile App:

• A location selector button appears at the top of the app header.
• Tapping this opens a city list (and optional neighborhoods).
• When the user selects a city:
  • The app reloads the home and listings screens for that region.
  • The setting persists between sessions.

📱 No extra configuration is needed in the app code—GeoFilters integrates automatically through the existing data endpoints.

🧩 7. Optional Features

🧰 8. Troubleshooting

🧩 9. Uninstalling

1. Go to Plugins → Installed Plugins.
2. Find MAM GeoFilters and click Deactivate.
3. Then click Delete.

This removes the plugin files but leaves stored city data in the database in case you reinstall later.

🏁 Summary