Skip to content

difteriya/Wordpress-coverage-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Advanced WordPress plugin for coverage area management with interactive maps

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published