A comprehensive WordPress plugin that connects host families with students/individuals seeking room and board arrangements. Built with modern PHP, AI-powered matching, and integrated payment processing.

Room2Exchange is a full-featured matching platform that facilitates connections between:

• Host Families: Offering room and board in exchange for help with household tasks
• Students/Seekers: Looking for accommodation while providing assistance to families

• ChatGPT Integration: Intelligent compatibility analysis using OpenAI GPT-4o
• Smart Algorithms: Considers location, preferences, skills, and lifestyle compatibility
• Compatibility Scoring: Detailed match scores with explanations

• Dual User Types: Separate onboarding flows for hosts and students
• Custom User Roles: WordPress integration with custom capabilities
• Profile Management: Comprehensive profile systems for both user types

• Private Messaging: Secure messaging between matched users
• Real-time Notifications: Email and in-app notifications
• Message History: Complete conversation tracking
• Admin Oversight: Full admin visibility of all communications

• Stripe Integration: Secure payment processing for background checks
• Background Check Services: Integration ready for Checkr API
• Invoice Generation: Automated billing and receipts
• Webhook Support: Real-time payment status updates

• Responsive Design: Mobile-first approach with Tailwind CSS styling
• Multi-step Forms: Beautiful onboarding experience
• Interactive Dashboards: Comprehensive user dashboards
• Admin Panel: Full-featured WordPress admin integration

• WordPress 5.0+
• PHP 7.4+
• MySQL 5.7+
• SSL Certificate (required for payments)

1. Download the plugin files
2. Upload to /wp-content/plugins/room2exchange/
3. Activate through WordPress admin
4. Configure API keys in Settings
5. Create your first host family or student profile

# Clone or download the plugin
cd /path/to/wordpress/wp-content/plugins/
# Upload room2exchange folder
# Activate in WordPress admin

1. Get API key from OpenRouter
2. Add to Room2Exchange Settings
3. Choose model (GPT-4o recommended)

1. Create account at Stripe
2. Get Secret and Publishable keys
3. Configure webhook endpoint
4. Add keys to plugin settings

• Background check integration
• Currently placeholder for future development

The plugin automatically creates these pages:

• /host-onboarding/ - Host family registration
• /student-onboarding/ - Student registration
• /host-dashboard/ - Host family dashboard
• /student-dashboard/ - Student dashboard

room2exchange/
├── room2exchange.php          # Main plugin file
├── includes/                  # Core functionality
│   ├── class-database.php     # Database operations
│   ├── class-user-roles.php   # User management
│   ├── class-matching-engine.php # AI matching
│   ├── class-payment-handler.php # Stripe integration
│   └── class-messaging-system.php # Communications
├── admin/                     # Admin interface
│   ├── class-admin.php        # Admin functionality
│   ├── admin-dashboard.php    # Admin dashboard
│   └── settings.php           # Settings page
├── public/                    # Frontend functionality
│   └── class-public.php       # Public-facing features
├── templates/                 # Page templates
│   ├── host-onboarding-form.php
│   ├── student-onboarding-form.php
│   ├── host-dashboard.php
│   └── student-dashboard.php
└── assets/                    # Static assets
    ├── css/                   # Stylesheets
    └── js/                    # JavaScript files

• r2e_matches - Match relationships and status
• r2e_messages - Private messaging system
• r2e_background_checks - Background check records
• r2e_user_preferences - User profile data

• Custom user roles: r2e_host_family, r2e_student
• Custom capabilities for access control
• WordPress user meta for basic information

1. Visit /host-onboarding/
2. Complete 4-step registration:
   • Basic Information
   • Location Details
   • Accommodation Description
   • Family Preferences
3. Automatic redirect to dashboard

• Matches: View compatible students
• Messages: Communicate with potential matches
• Profile: Update family information
• Background Check: Request verification services
• Settings: Account preferences

1. Visit /student-onboarding/
2. Complete 4-step registration:
   • Basic Information
   • Education Background
   • Preferences & Skills
   • Personal Details
3. Automatic redirect to dashboard

• Host Families: Browse compatible families
• Messages: Communicate with hosts
• Profile: Update personal information
• Settings: Account preferences

• User management (hosts and students)
• Match oversight and statistics
• Message monitoring
• Payment tracking
• System configuration

• View all user profiles
• Monitor match success rates
• Access all private messages
• Export user data
• Configure API integrations

The AI matching system can be customized through:

• Model selection (GPT-4o, GPT-3.5, Claude)
• Minimum match score thresholds
• Maximum matches per user
• Custom matching criteria

• Built with modern CSS variables
• Tailwind CSS integration
• Responsive design patterns
• Dark mode support ready

// Customize matching criteria
add_filter('r2e_matching_criteria', 'custom_matching_logic');

// Modify user registration
add_action('r2e_user_registered', 'custom_registration_handler');

// Custom email notifications
add_filter('r2e_notification_email', 'custom_email_template');

• Nonce verification for all forms
• SQL injection prevention
• XSS protection
• Capability-based access control

• User data encryption
• Secure API key storage
• GDPR compliance ready
• Data retention policies

• PCI DSS compliant (via Stripe)
• Secure webhook verification
• Encrypted payment data
• Fraud protection

• Verify OpenAI API key is configured
• Check API key permissions
• Ensure sufficient API credits

• Confirm Stripe keys are correct
• Verify webhook endpoint is accessible
• Check SSL certificate validity

• Enable WordPress debug logging
• Check PHP error logs
• Verify nonce validation

// Add to wp-config.php for debugging
define('R2E_DEBUG', true);
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

• Database query optimization
• AJAX-powered interfaces
• Lazy loading for large datasets
• Caching-friendly architecture

• WordPress-optimized hosting
• PHP 8.0+ for best performance
• MySQL 8.0+ recommended
• SSL certificate required

• Semantic versioning (1.0.0)
• Database migration system
• Backward compatibility
• Automatic updates ready

• Regular database cleanup
• API key rotation
• Security updates
• Performance monitoring

1. Clone repository
2. Install WordPress locally
3. Configure development environment
4. Set up API keys for testing

• WordPress Coding Standards
• PHP 7.4+ compatibility
• Modern JavaScript (ES6+)
• Responsive CSS practices

This plugin is licensed under the GPL v2 or later.

Jeremiah Castillo
Company: Kre8ivTech, LLC
Website: https://www.kre8ivtech.com

For support and questions:

• Email: info@kre8ivtech.com
• Website: Kre8ivTech Support

• Checkr API integration for background checks
• Advanced search and filtering
• Mobile app companion
• Multi-language support

• Video calling integration
• Calendar scheduling system
• Review and rating system
• Advanced analytics dashboard

• Multi-tenant support
• White-label solutions
• API for third-party integrations
• Machine learning improvements

• User registration trends
• Match success rates
• Message activity
• Payment processing stats
• Geographic distribution

• CSV export for all data types
• User profile exports
• Match history reports
• Financial transaction reports

• English (US) - Complete
• Translation ready
• RTL support prepared

1. Use WordPress translation tools
2. Text domain: room2exchange
3. POT file generation ready
4. Community translations welcome

Room2Exchange - Connecting families and students through intelligent matching and secure communication.

Built with ❤️ by Kre8ivTech, LLC