# Changelog

All notable changes to the LDAP Departments Sync module will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.0] - 2025-11-07

### Added
- Initial stable release of LDAP Departments Sync module
- LDAP server and query configuration with dynamic dropdowns
- Hierarchical group organization based on LDAP attributes
- Dynamic attribute mapping system for flexible field configuration
- User reference mapping with DN to Drupal User resolution
- Automatic search attribute detection from LDAP server configuration
- Comprehensive cron validation to prevent execution with incomplete configurations
- Administrative interface with management buttons for LDAP queries
- Extensive logging and error handling throughout the synchronization process
- Support for both manual and automatic synchronization via cron

### Features
- **LDAP Integration**: Full integration with `ldap_servers` and `ldap_query` modules
- **Dynamic Configuration**: AJAX-powered form with real-time updates based on selections
- **Hierarchical Groups**: Automatic parent-child relationship mapping from LDAP data
- **User Reference Mapping**: Convert LDAP DNs to Drupal User references automatically
- **Flexible Mapping**: Support for both simple text and user reference field mappings
- **Validation**: Comprehensive configuration validation before cron execution
- **Management Tools**: Direct links to edit LDAP queries
- **Error Recovery**: Robust error handling with detailed logging for troubleshooting

### Technical Details
- **Drupal Version**: Compatible with Drupal 11
- **Dependencies**: group, ldap_servers
- **Architecture**: Service-based with dependency injection
- **Configuration**: YAML-based with dynamic form interface
- **Security**: Defensive coding practices with proper input validation

### Configuration
- LDAP server selection with status verification
- Query selection filtered by server with real-time updates
- Dynamic attribute mapping with type-specific processing
- Hierarchical organization with parent/child attribute configuration
- User reference mapping with automatic search attribute detection

[1.0.0]: https://github.com/your-repo/ldap_departments_sync/releases/tag/v1.0.0