[general]
name=Sudan Data Loader
qgisMinimumVersion=3.0
description=A comprehensive Sudan GIS toolkit for loading, visualizing, and analyzing administrative boundary data
version=2.3.4
author=Osman Ibrahim
email=osmangeomatics93@gmail.com

about=A full-featured QGIS plugin for Sudan administrative data management and analysis.

    === PHASE 1: Quick Wins ===
    - Settings/Configuration Dialog with QSettings persistence
    - Layer Selection Dialog with checkboxes and remember selection
    - Quick Labeling Tools (English, Arabic, P-Codes)
    - Style Preset Switcher (Default, Satellite-Friendly, Grayscale, Humanitarian)
    - Data Info Panel showing version, feature counts, CRS, extent

    === PHASE 2: Core Features ===
    - Search/Filter Panel with autocomplete (English & Arabic)
    - Quick Navigation Bookmarks for all 18 states + custom bookmarks
    - Statistics Panel with area calculations and CSV export
    - Attribute Query Builder with visual interface
    - Basemap Integration (OSM, Satellite, Humanitarian, CartoDB)
    - Report Generation (HTML/PDF) - Summary and State Profiles

    === PHASE 3: Advanced Features ===
    - Export Features to GeoPackage, Shapefile, GeoJSON, KML, CSV, DXF
    - Sketching/Drawing Tools (Points, Lines, Polygons)
    - Processing Tools (Clip by State, Buffer, Dissolve, Intersection)
    - Data Validation Checker (Geometry, Topology, Attributes)

    === External Data Sources ===
    - HDX (Humanitarian Data Exchange) Integration
    - Browse and download Sudan humanitarian datasets
    - Health facilities, roads, education, conflict data
    - Direct layer loading from HDX

    - ACLED (Armed Conflict Location & Event Data) Integration
    - Real-time conflict event tracking for Sudan
    - Filter by date range, event type, region
    - Styled visualization with categorized symbols
    - Event statistics and detailed information

    Data layers included:
    - Admin 0: Country boundary
    - Admin 1: States (18)
    - Admin 2: Localities
    - Administrative lines
    - Administrative points

tracker=https://github.com/Osman-Geomatics93/sudan_data_loader/issues
repository=https://github.com/Osman-Geomatics93/sudan_data_loader

changelog=2.3.4 - ACLED API Working
    - Fix ACLED API endpoint URL (now uses /api/acled/read)
    - OAuth authentication working correctly
    - Added debug logging for troubleshooting
    - Note: Free accounts can only access data older than 12 months

    2.3.3 - ACLED Credentials Clarification
    - Clarify that ACLED uses account email/password (not separate API key)
    - Update Settings dialog labels for clarity
    - Improve instructions in API Keys tab
    - Better status messages in ACLED browser

    2.3.2 - ACLED API Fix
    - Update to new ACLED OAuth-based API endpoint
    - Fix API connection issues (old endpoint deprecated)
    - Implement OAuth token authentication flow
    - Add Bearer token authorization
    - Improved error messages for authentication failures
    - Note: ACLED now requires registration for all API access

    2.3.1 - ACLED API Key Settings
    - Add API Keys tab to Settings dialog
    - Configure ACLED email and API key for full data access
    - Show/hide API key toggle with password masking
    - Auto-load credentials when opening ACLED browser
    - API connection status indicator in ACLED header
    - Link to ACLED registration page

    2.3.0 - ACLED Conflict Data Integration
    - ACLED browser dialog for Sudan conflict events
    - Filter by date range (quick presets + custom)
    - Filter by event type (Battles, Violence, Explosions, Riots, Protests)
    - Filter by state/region
    - Event statistics panel with fatality counts
    - Event details view with full information
    - Categorized symbol styling by event type
    - Color-coded visualization
    - Organized External Data Sources menu

    2.2.0 - Welcome Wizard & UX Improvements
    - Welcome Wizard for first-time users with guided setup
    - HDX category filtering - filter by Health, Education, etc.
    - Real-time text search filtering for datasets
    - Clear filters button
    - Improved layer loading stability

    2.1.0 - HDX Humanitarian Data Integration
    - HDX browser dialog for Sudan humanitarian datasets
    - Featured datasets: Health, Education, Roads, Conflict, POIs
    - Search HDX for additional datasets
    - Download and auto-load layers to QGIS
    - Support for GeoJSON, Shapefile, GeoPackage, KML, CSV

    2.0.0 - Major Feature Release
    === New Features ===
    - Settings dialog with persistent configuration
    - Layer selection dialog with remember option
    - Quick labeling tools (English/Arabic/P-Codes)
    - Style preset switcher (4 themes)
    - Data info dock panel
    - Search panel with autocomplete
    - Bookmarks panel (18 states + custom)
    - Statistics panel with area calculations
    - Query builder dialog
    - Basemap integration (7 basemap options)
    - Report generation (HTML/PDF)
    - Export dialog (6 formats)
    - Sketching toolbar
    - Processing tools integration
    - Data validation checker

    === Improvements ===
    - Modular architecture with separate packages
    - Improved menu organization with submenus
    - Toolbar with quick access buttons
    - Better error handling

    1.0.1 - Bug fixes and stability improvements
    1.0.0 - Initial release

tags=sudan,administrative,boundaries,geopackage,vector,africa,download,search,bookmarks,statistics,export,labeling,basemap,validation,processing,sketching,hdx,humanitarian,health,education,acled,conflict,crisis

homepage=https://github.com/Osman-Geomatics93/sudan_data_loader
category=Vector
icon=icon.png
experimental=False
deprecated=False
server=False
hasProcessingProvider=no
license=GPLv3
