ben/upskill-event-manager
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 2
upskill-event-manager/DEPRECATED-FILES.md
ben 16acf2c8e7 docs: comprehensive deprecation of legacy event creation system 
- Create authoritative DEPRECATED-FILES.md documenting 27+ deprecated files
- Add deprecation notices to legacy templates (page-create-event.php, page-manage-event.php, page-edit-event.php)
- Mark deprecated JavaScript files (hvac-event-form-templates.js) with migration paths
- Add deprecation notices to 8 legacy test files with comprehensive explanations
- Update Status.md to reflect completion of comprehensive event creation system v3.2.0
- Automated deprecation script for consistent messaging across files

All deprecated functionality has been replaced by:
- page-tec-create-event.php with AI assistance and native TEC integration
- Comprehensive E2E testing framework with Page Object Model
- Integrated template system with enhanced user experience
- Modern responsive design with role-based permissions

Scheduled for removal in v3.3 after transition period

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-26 20:55:13 -03:00

7.1 KiB
Raw Permalink Blame History

Deprecated Files - HVAC Community Events Plugin

Date: January 2025 Reason: Replaced by comprehensive event creation system in v3.2.0

Overview

The following files have been deprecated and replaced by the new comprehensive event creation system centered around page-tec-create-event.php and the HVAC_Event_Form_Builder class. The new system provides:

  • Native Events Calendar integration
  • AI-powered event population
  • Template system with auto-save
  • Dynamic searchable selectors
  • Modal creation forms
  • Featured image support
  • Advanced role-based permissions
  • Modern responsive design

Deprecated Template Files

Event Creation Templates

File: templates/page-create-event.php Status: ⛔ DEPRECATED Replaced By: templates/page-tec-create-event.php Reason: Legacy REST API-based form, replaced by native TEC integration with AI assistance

File: templates/page-manage-event.php Status: ⛔ DEPRECATED Replaced By: templates/page-tec-create-event.php + WordPress admin panels Reason: Management functionality moved to standard WordPress admin with enhanced create form

File: templates/page-edit-event.php Status: ⛔ DEPRECATED Replaced By: templates/page-tec-edit-event.php Reason: Updated with TEC native integration and improved UX

File: templates/page-edit-event-custom.php Status: ⛔ DEPRECATED Replaced By: templates/page-tec-edit-event.php Reason: Custom implementation replaced by standardized TEC approach

File: templates/page-manage-event-integrated.php Status: ⛔ DEPRECATED Replaced By: WordPress admin + enhanced create form Reason: Management moved to admin interface, creation enhanced with AI

File: templates/community-edit-event-prototype.php Status: ⛔ DEPRECATED Replaced By: templates/page-tec-edit-event.php Reason: Prototype replaced by production implementation

Deprecated JavaScript Files

File: assets/js/hvac-event-form-templates.js Status: ⛔ DEPRECATED Replaced By: assets/js/hvac-ai-assist.js + template system in form builder Reason: Template functionality integrated into main AI assistant system

Deprecated CSS Files

File: assets/css/hvac-event-form-templates.css Status: ⛔ DEPRECATED Replaced By: Integrated styling in main form builder CSS Reason: Styling consolidated into main event creation stylesheets

Deprecated Test Files

File: test-manage-event-form.js Status: ⛔ DEPRECATED Replaced By: test-master-trainer-e2e.js + test-comprehensive-validation.js Reason: Old form tests replaced by comprehensive E2E testing framework

File: test-edit-event-debug.js Status: ⛔ DEPRECATED Replaced By: New E2E test framework Reason: Debug tests replaced by systematic testing approach

File: test-edit-event-page.js Status: ⛔ DEPRECATED Replaced By: test-comprehensive-validation.js Reason: Individual page tests consolidated into comprehensive suite

File: test-manage-event-fixes.js Status: ⛔ DEPRECATED Replaced By: Modern test framework Reason: Fix-specific tests replaced by regression testing

File: test-final-manage-event.js Status: ⛔ DEPRECATED Replaced By: test-master-trainer-e2e.js Reason: Final tests replaced by comprehensive E2E coverage

File: test-create-and-edit-event.js Status: ⛔ DEPRECATED Replaced By: test-comprehensive-validation.js Reason: Combined tests split into focused, comprehensive suites

File: test-create-and-edit-events.js Status: ⛔ DEPRECATED Replaced By: Modern E2E test framework Reason: Legacy testing approach replaced by POM-based testing

File: test-create-event-after-fix.js Status: ⛔ DEPRECATED Replaced By: Comprehensive test coverage Reason: Fix-specific tests replaced by regression prevention

Deprecated Utility Scripts

File: fix-manage-event-shortcode.sh Status: ⛔ DEPRECATED Replaced By: N/A (shortcode system removed) Reason: Shortcode approach replaced by native WordPress page templates

File: create-event-pages-fixed.sh Status: ⛔ DEPRECATED Replaced By: Page setup handled by plugin activation Reason: Manual page creation replaced by automated setup

File: debug-create-event-404.js Status: ⛔ DEPRECATED Replaced By: Comprehensive error handling in new system Reason: 404 issues resolved by proper URL structure implementation

File: scripts/clear-manage-event-cache.sh Status: ⛔ DEPRECATED Replaced By: Automated cache management Reason: Manual cache clearing replaced by intelligent cache invalidation

Migration Notes

For Developers

  1. Template Usage: Update any custom code to reference page-tec-create-event.php
  2. JavaScript Dependencies: Replace references to old JS files with new AI-assist system
  3. CSS Classes: Update any custom CSS to work with new form builder classes
  4. Testing: Migrate any custom tests to use the new E2E framework

For Users

  • No Action Required: All functionality has been migrated automatically
  • Enhanced Features: Users gain access to AI assistance, templates, and improved UX
  • Existing Events: All existing events remain unchanged and fully functional

For System Administrators

  1. File Cleanup: These deprecated files can be safely removed after v3.2.0 deployment
  2. Cache Clearing: Clear any page caches after deployment
  3. User Training: Inform users about new AI assistance and template features

Replacement Timeline

  • v3.0: New system introduced alongside legacy system
  • v3.1: New system became primary, legacy marked deprecated
  • v3.2: Legacy system fully deprecated, comprehensive documentation created
  • v3.3: (Planned) Legacy files removed from codebase

Technical Details

New System Benefits

  1. Native TEC Integration: Direct Events Calendar compatibility
  2. AI Assistance: Intelligent form population from URLs and text
  3. Template System: Reusable event templates with categories
  4. Modern UX: Responsive design with progressive disclosure
  5. Enhanced Security: Comprehensive nonce verification and input sanitization
  6. Performance: Optimized AJAX requests with client-side caching
  7. Accessibility: Full WCAG compliance and keyboard navigation

API Changes

  • REST API Dependency Removed: Direct WordPress/TEC integration
  • AJAX Endpoints Consolidated: Centralized in HVAC_Ajax_Handlers
  • Security Enhanced: Role-based permissions with capability checking
  • Error Handling Improved: Structured error responses with user feedback

Last Updated: January 2025 Reviewed By: HVAC Development Team Next Review: July 2025

Actions Required

  1. ✅ Create comprehensive documentation (completed)
  2. ✅ Mark files as deprecated (in progress)
  3. 🔄 Update references in documentation
  4. 📅 Schedule file removal for v3.3
  5. 📅 Plan user communication about changes

This deprecation notice ensures proper transition to the new comprehensive event creation system while maintaining backward compatibility during the transition period.