nodemetalist 2.0.x-dev

# Node Meta List Module - Release Notes

## Version 2.0.0 - Released April 1, 2026

### Overview
This release introduces significant enhancements to the Node Meta List module, improving usability, code quality, and providing comprehensive test coverage.

### New Features

#### 1. Quick Configure Link
- Added configure link to module info file (`nodemetalist.info.yml`)
- Allows administrators to quickly access settings from the Modules admin page
- Eliminates the need to navigate through admin menus to configure content types

#### 2. Edit Button in Metadata Table
- Added "Edit" column to the metadata listing table
- Provides direct links to node edit forms for each row
- Allows administrators to quickly edit node metadata without leaving the listing page
- Edit links respect node access permissions - only visible to users with edit permission

### Improvements

#### Code Quality
- **Fixed array key mapping** - Row data keys now match header keys exactly:
- `title` → `node_title`
- `bundle` → `content_type`
- Ensures proper column alignment in tables

- **Improved column alignment** - Initialize all row keys to prevent missing column issues
- **Enhanced link rendering** - Uses `link_generator` service for proper HTML generation

#### Documentation
- Completely rewrote `README.md` with comprehensive documentation including:
- Clear module overview and features
- Installation and setup instructions
- Step-by-step usage guide
- Permission and route documentation
- Module structure visualization
- Known limitations and planned improvements
- Development and testing instructions
- Code quality notes and known issues

### Testing

#### New Test Suites
Added comprehensive test coverage with three types of tests:

**Unit Tests** (`tests/src/Unit/Form/SettingsFormTest.php`)
- Form ID generation
- Configuration management
- Form structure validation
- Default value handling
- Form submission

**Kernel Tests** (`tests/src/Kernel/NodeMetaListControllerKernelTest.php`)
- Controller instantiation
- Configuration loading
- Entity query functionality
- Service availability
- Node creation and retrieval

**Functional Tests** (`tests/src/Functional/NodeMetaListControllerTest.php`)
- Settings form access
- Data listing page access
- Table rendering validation
- Access control verification
- Permission-based restrictions

**Test Documentation** (`tests/README.md`)
- Test structure overview
- Instructions for running tests
- Test coverage summary

### Bug Fixes

#### Fixed Issues
1. **Array key mismatch** - Table columns now properly align with their headers
2. **Render errors** - Fixed URL rendering in table cells using proper link generation
3. **Missing values** - All column values are now initialized, preventing display issues

### Known Issues

#### Current Limitations
- **Pagination** - Pager markup is present but not fully functional; all nodes loaded into memory
- **Performance** - Large datasets may cause performance issues due to in-memory loading
- **Filtering** - Results cannot be filtered by content type on the listing page
- **Code style** - Minor style issues in SettingsForm.php (spacing around `if` statements)

### Planned Improvements for Future Releases

- [ ] Implement proper pagination with query limits
- [ ] Add export functionality (CSV/Excel)
- [ ] Add filtering by content type on listing page
- [ ] Add sortable column headers
- [ ] Optimize query performance for large datasets
- [ ] Add batch processing support
- [ ] Integrate with Views module

### System Requirements

- **Drupal Core:** 8.x, 9.x, 10.x, 11.x
- **PHP:** 7.4 or higher
- **Dependencies:** Metatag module

### Backward Compatibility

This release maintains full backward compatibility with version 1.0.0. No configuration changes or database migrations are required.

### Installation & Upgrade

```bash
# Update module code
git pull origin main

# Clear Drupal caches
drush cr

# No database updates required
```

### Migration Guide

No migration steps required. The module will work as-is with existing configurations.

### Contributors

- Code review and refactoring
- Documentation improvements
- Test suite implementation
- Bug fixes and enhancements

### Support

For issues, questions, or feature requests, please visit the project issue queue:
[Node Meta List Issue Queue](https://www.drupal.org/project/issues/nodemetalist)

### License

GNU General Public License v2.0 or later

---

## Version 1.0.0 - Original Release

Initial release of the Node Meta List module with core functionality:
- Settings form for content type selection
- Metadata listing table display
- Metatag module integration
- Basic admin interface