WP Manifestindependent plugin directory
manifest / content / wordpress-coverage-plugin

Map Coverage Plugin with Region Cards

Advanced WordPress plugin for coverage area management with interactive maps

by Khudiyev · github.com/difteriya/wordpress-coverage-plugin

★ 1stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/difteriya/wordpress-coverage-plugin/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/difteriya/wordpress-coverage-plugin ↗

Map Coverage Plugin

Creator: Khudiyev
Version: 1.1.0
Website: xudiyev.com

Advanced WordPress plugin to create and manage coverage areas with interactive maps and intelligent address search functionality in Azerbaijani language.

Features

🗺️ Interactive Coverage Management

  • Custom post type coverage_area for admin-managed coverage items
  • Admin meta box with OpenLayers map to draw Points, Polygons and Circles
  • City taxonomy for organizing coverage areas by location
  • Advanced address management with street names and house numbers

🔍 Smart Frontend Search

  • Frontend shortcode [map_coverage] - displays full map with search functionality
  • Frontend shortcode [map_coverage_search] - displays search form only with redirect capability
  • Intelligent autocomplete for street addresses from database
  • House number dropdown showing available numbers from coverage data
  • Real-time search filtering and suggestions

⚙️ Admin Features

  • Settings page for contact us page configuration
  • Repeatable UI for adding streets and house numbers
  • Color-coded coverage areas with custom styling
  • Modern gradient UI with glass morphism effects

🎨 Visual Display Options

  • Card-based region display with featured images
  • Responsive grid layouts (1-4 columns)
  • Professional card styling with hover effects
  • City-based filtering for region cards
  • Configurable excerpt display

🎨 Elementor Integration

  • Three separate specialized widgets: Map, Search, Region Cards
  • Custom widget category "Əhatə Xəritəsi" for easy access
  • Individual widget controls for maximum flexibility
  • Live preview functionality in Elementor editor
  • Advanced styling controls and responsive design
  • Typography and color customization options

🌐 Localization

  • Fully translated to Azerbaijani language
  • User-friendly error messages with contact page integration
  • Professional UI with modern design patterns

Installation

  1. Copy the map-coverage-plugin folder into wp-content/plugins/
  2. Activate the plugin in the WordPress admin
  3. Configure contact page in Coverage Areas → Settings
  4. Create coverage areas in Coverage Areas → Add New
  5. Add cities in Coverage Areas → Cities
  6. Use shortcodes [map_coverage] or [map_coverage_search] on frontend

Usage

Admin Setup

  1. Add Cities: Go to Coverage Areas → Cities and create city categories
  2. Create Coverage Areas:
    • Add new coverage area with title
    • Assign to a city category
    • Draw geometry on the map (points, polygons, circles)
    • Add street addresses with house numbers using the repeatable interface
    • Set custom colors and properties

Frontend Implementation

// Full map with search functionality
[map_coverage]

// Search form only (redirects to coverage page)
[map_coverage_search]
// Alternative name for search form
[coverage_search]

// Search form with custom redirect
[coverage_search redirect_page="/custom-page"]

// Region cards display (3 columns by default)
[coverage_cards]
// Alternative name for region cards
[coverage_region_cards]

// Region cards with custom options
[coverage_region_cards columns="4" city="baki" show_excerpt="true"]

Elementor Widgets (NEW in v1.1.0)

  • Available in Elementor panel under "Əhatə Xəritəsi" category
  • Three Separate Widgets:
    1. "Əhatə Xəritəsi" - Interactive map with customizable height and search controls
    2. "Əhatə Axtarışı" - Standalone search form with redirect functionality
    3. "Rayon Kartları" - Region cards with advanced layout and styling options
  • Individual widget controls for specialized functionality
  • Advanced styling options including typography, colors, spacing
  • Clickable featured images with hover effects
  • Live preview in Elementor editor

Technical Features

🔧 Advanced Functionality

  • AJAX-powered street autocomplete with debounced search
  • Database-driven house number suggestions
  • Responsive grid layouts with mobile optimization
  • Modern CSS with gradient backgrounds and glass morphism
  • Cross-browser compatible autocomplete functionality

🛡️ Security & Performance

  • Sanitized inputs and secure data handling
  • Optimized database queries
  • Proper WordPress hooks and actions
  • Nonce verification for admin operations

🎯 User Experience

  • Real-time address validation
  • Intelligent error messages with contact links
  • Smooth animations and transitions
  • Professional dropdown styling with hover effects
  • Mobile-first responsive design

Address Management

Each coverage area supports sophisticated address management:

  • Streets: Add multiple street names per coverage area
  • House Numbers: Specify exact house numbers for each street
  • Autocomplete: Frontend shows intelligent suggestions from database
  • Validation: System checks if address exists in coverage data
  • Error Handling: Professional error messages with contact page links

Styling & Design

  • Modern gradient backgrounds with customizable colors
  • Glass morphism effects with backdrop blur
  • Professional dropdown styling with dark text on light background
  • Purple hover effects with smooth slide animations
  • Custom scrollbar styling for better UX
  • Fully responsive design for all screen sizes

Changelog

Version 1.1.0 (November 12, 2025)

Major Elementor Enhancement Update

✨ New Features:

  • Three Separate Elementor Widgets: Split into specialized Map, Search, and Cards widgets
  • Custom Widget Category: All widgets organized under "Əhatə Xəritəsi" category
  • Clickable Featured Images: Region cards now support clickable images with hover effects
  • Advanced Widget Controls: Individual styling and functionality controls for each widget
  • Enhanced Column Support: Region cards now support 1-5 column layouts
  • Live Preview: Real-time widget preview in Elementor editor

🔧 Improvements:

  • Widget Architecture: Modular widget system for better performance and flexibility
  • Enhanced Styling Controls: Typography, colors, spacing, and shadow controls
  • Image Controls: Customizable image heights, border radius, and hover effects
  • Better UX: Improved hover animations and visual feedback
  • Code Organization: Separated widget classes into individual files

🎨 Design Enhancements:

  • Professional Hover Effects: Smooth image scaling and overlay effects
  • Enhanced CSS: Additional styling for 5-column grid layout
  • Responsive Design: Better mobile optimization for all widgets

Version 1.0.0 (Initial Release)

  • Interactive coverage area management with OpenLayers
  • Custom post type with city taxonomy
  • Smart address autocomplete functionality
  • Region cards display with featured images
  • Full Azerbaijani translation
  • Basic Elementor integration

Next Steps / Improvements

  • Add server-side REST endpoints for large data sets
  • Provide import/export for GeoJSON files
  • Add bulk address import functionality
  • Enhanced analytics and reporting features
  • Multi-language support expansion

Developed by Khudiyev
For support and updates, visit: xudiyev.com