Skip to main content

WordPress Maintenance Tasks

This documentation covers the maintenance tasks available for WordPress content management operations. These tasks are accessible through the maintenance tasks UI at /maintenance_tasks.

Available Tasks​

TaskTypeDescription
TaxonomyRemapTaskSingle operationRemap or delete a single taxonomy (tag/category)
BulkTaxonomyRemapTaskCSV batchProcess multiple taxonomy operations from CSV
ExportTaxonomyTaskExportExport tags or categories to CSV
ExportMediaTaskExportExport media library to Excel
ExportArticlesTaskExportExport articles by category to Excel

Task Categories​

Taxonomy Management​

The taxonomy tasks allow you to:

  • Remap posts from one taxonomy to another
  • Delete taxonomies (tags or categories)
  • Perform bulk operations via CSV upload

Data Export​

The export tasks generate downloadable files:

  • CSV for taxonomy lists (tags/categories)
  • Excel for media library and articles with rich formatting

Common Features​

Output Handling​

All export tasks attach their output files to the current user's account. Files are available in the user's files section and include timestamps in the filename.

Multi-Locale Support​

Most tasks support:

  • Single locale operations
  • All-locale exports (where applicable)

The available locales are determined by I18n.available_locales.

Logging​

All tasks use structured logging with contextual information:

logger.info('Starting export', locale: 'en', taxonomy: 'tags')
logger.debug('Processing item', term_id: 123)
logger.info('Export completed', total_items: 500)

Access​

Tasks are available at:

/maintenance_tasks/tasks/Maintenance::Wordpress::[TaskName]

Example:

  • /maintenance_tasks/tasks/Maintenance::Wordpress::ExportTaxonomyTask
  • /maintenance_tasks/tasks/Maintenance::Wordpress::BulkTaxonomyRemapTask