Skip to content

Latest commit

 

History

History
67 lines (55 loc) · 2.15 KB

instructions.md

File metadata and controls

67 lines (55 loc) · 2.15 KB

Implementation Instructions

Follow these steps in order to implement the WordPress to Markdown Exporter plugin.

1. Basic Plugin Setup

  1. Create the main plugin file with required WordPress headers
  2. Set up the plugin activation/deactivation hooks
  3. Create the basic plugin class with singleton pattern
  4. Add admin menu registration

2. Admin Interface Setup

  1. Create the admin page class
  2. Create the admin page view template
  3. Add CSS for admin styling
  4. Register admin assets (CSS/JS)

3. Post Type Handling

  1. Create function to get available post types
  2. Add post type dropdown to admin interface
  3. Create function to fetch all posts of selected type

4. File System Setup

  1. Create uploads directory structure
  2. Implement WordPress filesystem API checks
  3. Create file handling class for zip operations
  4. Add functions for cleaning up old files

5. Conversion Logic

  1. Create HTML to Markdown converter class
  2. Implement content cleaning (remove embeds, comments)
  3. Add block content handling
  4. Create filename generation with date prefix option

6. Export Process

  1. Create main export handler class
  2. Implement batch processing for posts
  3. Add progress tracking
  4. Create log generation for success/failures
  5. Implement zip file creation

7. File Management

  1. Create function to list existing exports
  2. Add download link generation
  3. Implement cleanup functionality
  4. Add file size and date display

8. Security & Error Handling

  1. Add capability checks
  2. Implement nonce verification
  3. Add error handling and messages
  4. Add timeout prevention for large exports

9. Testing & Cleanup

  1. Test with different post types
  2. Test with large number of posts
  3. Verify file permissions
  4. Test cleanup functionality

Notes

  • Follow WordPress coding standards
  • Use meaningful function and variable names
  • Add comments for complex operations
  • Each class should be in its own file
  • Use WordPress built-in functions where possible

Order of Implementation

Start with basic plugin setup and work through each section in order. Each section builds on the previous ones. Don't move to the next section until current section is working correctly.