Refactor to filter-based architecture

[pfefferle]

Summary

Refactors the plugin to use a filter-based architecture, aligning with the pattern used in wordpress-activitypub.

This makes it easier for other plugins to extend NodeInfo data by hooking into filters rather than modifying core files.

Changes

• Add PSR-4 style autoloader for class loading
• Reorganize files into controller/ and integration/ folders
• Add Nodeinfo namespace to all classes
• Separate integration class for each NodeInfo version (1.0, 1.1, 2.0, 2.1, 2.2)
• NodeInfo endpoint (Nodeinfo\Controller\Nodeinfo) uses filters for all data
• NodeInfo2 endpoint (Nodeinfo\Controller\Nodeinfo2) is self-contained with WordPress defaults
• Schemas updated to match official specs with all enums and constraints
• Add wp-env, phpcs, and phpunit setup with GitHub Actions CI

New Structure

includes/
├── class-autoloader.php           # Nodeinfo\Autoloader
├── functions.php                  # Helper functions
├── controller/
│   ├── class-nodeinfo.php         # Nodeinfo\Controller\Nodeinfo
│   └── class-nodeinfo2.php        # Nodeinfo\Controller\Nodeinfo2
└── integration/
    ├── class-nodeinfo10.php       # Nodeinfo\Integration\Nodeinfo10
    ├── class-nodeinfo11.php       # Nodeinfo\Integration\Nodeinfo11
    ├── class-nodeinfo20.php       # Nodeinfo\Integration\Nodeinfo20
    ├── class-nodeinfo21.php       # Nodeinfo\Integration\Nodeinfo21
    └── class-nodeinfo22.php       # Nodeinfo\Integration\Nodeinfo22

Available Filters

NodeInfo (1.0, 1.1, 2.0, 2.1, 2.2):

• nodeinfo_versions - Registered versions
• nodeinfo_discovery_links - Discovery links (also used for JRD)
• nodeinfo_schema - REST API schema
• nodeinfo_data_software - Software info
• nodeinfo_data_protocols - Protocols array
• nodeinfo_data_services - Services (inbound/outbound)
• nodeinfo_data_usage - Usage statistics
• nodeinfo_data_metadata - Metadata
• nodeinfo_data - Complete response
• nodeinfo_protocols - Shared filter for protocols (2.0+)

NodeInfo2 (1.0):

• nodeinfo2_data_server - Server info
• nodeinfo2_data_protocols - Protocols array
• nodeinfo2_data_services - Services
• nodeinfo2_data_usage - Usage statistics
• nodeinfo2_data_metadata - Metadata
• nodeinfo2_data - Complete response

Schema Updates

All schemas now match the official NodeInfo specifications with:

• Protocol enums (e.g., activitypub, diaspora, nostr for 2.2)
• Service enums (inbound/outbound)
• Integer minimum constraints
• Pattern validation for software name (2.0+)
• Instance field with maxLength constraints (2.2)
• Links to official schema files in docblocks

Example Usage

// Add ActivityPub protocol (for 2.0+)
add_filter( 'nodeinfo_protocols', function( $protocols ) {
    $protocols[] = 'activitypub';
    return $protocols;
} );

Test Plan

• Visit /.well-known/nodeinfo and verify discovery document
• Check /wp-json/nodeinfo/2.2 returns valid NodeInfo 2.2
• Check /wp-json/nodeinfo/2.1 returns valid NodeInfo 2.1
• Check /wp-json/nodeinfo/2.0 returns valid NodeInfo 2.0
• Check /wp-json/nodeinfo/1.1 returns valid NodeInfo 1.1
• Check /wp-json/nodeinfo/1.0 returns valid NodeInfo 1.0
• Check /wp-json/nodeinfo2/1.0 returns valid NodeInfo2
• Verify filters work by adding custom data via nodeinfo_data filter
• Run composer phpcs - should pass
• Run composer phpunit - should pass

[Copilot]

Pull request overview

This PR refactors the NodeInfo plugin to a modern filter-based architecture, enabling better extensibility for other plugins. The major enhancement is adding support for NodeInfo 2.2 and introducing a PSR-4 autoloader with a clean separation of concerns through controller and integration classes.

Key Changes

• Implemented filter-based architecture with separate integration classes for each NodeInfo version (1.0, 1.1, 2.0, 2.1, 2.2)
• Added PSR-4 autoloader and reorganized code structure into controller/ and integration/ folders
• Introduced Site Health checks to verify endpoint accessibility
• Updated schemas to match official NodeInfo specifications with proper enums and validation

Reviewed changes

Copilot reviewed 29 out of 29 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
tests/phpunit/tests/class-test-nodeinfo-endpoint.php	Test suite for NodeInfo endpoints with version discovery tests
tests/phpunit/tests/class-test-nodeinfo2-endpoint.php	Test suite for NodeInfo2 endpoint functionality
tests/phpunit/tests/class-test-functions.php	Tests for helper functions (active users, version masking)
tests/phpunit/bootstrap.php	PHPUnit bootstrap configuration
includes/controller/class-nodeinfo.php	Main NodeInfo REST controller with filter-based data retrieval
includes/controller/class-nodeinfo2.php	NodeInfo2 REST controller implementation
includes/integration/class-nodeinfo10.php through class-nodeinfo22.php	Version-specific integration classes implementing schemas and data providers
includes/functions.php	Helper functions for user activity and version formatting
includes/class-autoloader.php	PSR-4 autoloader following WordPress naming conventions
includes/class-health-check.php	Site Health integration for endpoint verification
includes/class-nodeinfo-endpoint.php	Deprecated wrapper for backwards compatibility
nodeinfo.php	Main plugin file with initialization logic
phpcs.xml	Updated PHP CodeSniffer configuration
phpunit.xml.dist	Updated PHPUnit configuration
composer.json	Updated dependencies and minimum PHP version (7.2)
package.json	Added wp-env and updated scripts
.wp-env.json	WordPress environment configuration for development
.github/workflows/phpunit.yml	CI workflow for PHPUnit tests
.github/workflows/phpcs.yml	CI workflow for code standards
README.md	Comprehensive documentation updates with FAQ and changelog

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 29 out of 29 changed files in this pull request and generated 3 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.