Content Management Examples

Create New Post

curl -X POST "https://yoursite.com/wp-json/corenexis/v1/posts" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My New Blog Post",
    "content": "This is the content of my new blog post with HTML formatting.",
    "status": "publish",
    "categories": [1, 5],
    "tags": ["wordpress", "api", "tutorial"],
    "featured_image": 123,
    "excerpt": "A brief summary of the post content."
  }'

Update Post with SEO Meta

// Update post SEO metadata
async function updatePostSEO(postId, seoData) {
  try {
    const response = await wp.apiRequest(`/posts/${postId}/meta`, 'POST', {
      meta_title: seoData.title,
      meta_description: seoData.description,
      meta_keywords: seoData.keywords,
      slug: seoData.slug,
      og_title: seoData.ogTitle,
      og_description: seoData.ogDescription,
      og_image: seoData.ogImage,
      robots_index: seoData.robotsIndex ? "1" : "0",
      robots_follow: seoData.robotsFollow ? "1" : "0",
      custom_fields: {
        custom_field_1: seoData.customField1,
        featured_color: seoData.featuredColor,
        external_link: seoData.externalLink
      }
    });
    
    if (response.success) {
      console.log('Post SEO updated successfully!');
      console.log('Post title:', response.data.title);
      console.log('New slug:', response.data.slug);
      console.log('SEO title:', response.data.meta_title);
    }
    
    return response;
  } catch (error) {
    console.error('Failed to update post SEO:', error);
    throw error;
  }
}

// Example usage
updatePostSEO(123, {
  title: "Complete WordPress REST API Guide - 2024",
  description: "Learn how to use WordPress REST API with JWT authentication for complete site control.",
  keywords: "wordpress, rest api, jwt, authentication, tutorial",
  slug: "wordpress-rest-api-guide-2024",
  ogTitle: "WordPress REST API Complete Guide",
  ogDescription: "Master WordPress REST API development",
  ogImage: "https://yoursite.com/wp-content/uploads/api-guide.jpg",
  robotsIndex: true,
  robotsFollow: true,
  customField1: "Featured Tutorial",
  featuredColor: "#fe5940",
  externalLink: "https://github.com/corenexis/wp-api-examples"
});

Bulk Content Operations

def bulk_update_posts_category(wp_api, old_category_id, new_category_id):
    """Move all posts from one category to another"""
    try:
        # Get all posts in the old category
        posts_response = wp_api.api_request('/posts', 'GET', {
            'categories': old_category_id,
            'per_page': 100,
            'status': 'publish'
        })
        
        if posts_response['success']:
            posts = posts_response['data']
            print(f"📊 Found {len(posts)} posts to update")
            
            updated_count = 0
            for post in posts:
                # Remove old category and add new category
                current_categories = post.get('categories', [])
                if old_category_id in current_categories:
                    current_categories.remove(old_category_id)
                if new_category_id not in current_categories:
                    current_categories.append(new_category_id)
                
                # Update the post
                update_response = wp_api.api_request(f'/posts/{post["id"]}', 'PUT', {
                    'categories': current_categories
                })
                
                if update_response['success']:
                    updated_count += 1
                    print(f"Updated post: {post['title']['rendered']}")
                else:
                    print(f"Failed to update post: {post['title']['rendered']}")
            
            print(f"Successfully updated {updated_count} posts")
            return updated_count
        else:
            print("Failed to fetch posts")
            return 0
            
    except Exception as e:
        print(f"Bulk update failed: {e}")
        return 0

def create_posts_from_csv(wp_api, csv_file_path):
    """Create multiple posts from CSV file"""
    import csv
    
    try:
        with open(csv_file_path, 'r', encoding='utf-8') as file:
            reader = csv.DictReader(file)
            created_count = 0
            
            for row in reader:
                post_data = {
                    'title': row['title'],
                    'content': row['content'],
                    'status': row.get('status', 'draft'),
                    'excerpt': row.get('excerpt', ''),
                    'categories': [int(cat.strip()) for cat in row.get('categories', '').split(',') if cat.strip()],
                    'tags': [tag.strip() for tag in row.get('tags', '').split(',') if tag.strip()]
                }
                
                # Create the post
                response = wp_api.api_request('/posts', 'POST', post_data)
                
                if response['success']:
                    created_count += 1
                    post_id = response['data']['id']
                    print(f"Created post: {post_data['title']} (ID: {post_id})")
                    
                    # Add SEO meta if provided
                    if row.get('meta_title') or row.get('meta_description'):
                        meta_data = {}
                        if row.get('meta_title'):
                            meta_data['meta_title'] = row['meta_title']
                        if row.get('meta_description'):
                            meta_data['meta_description'] = row['meta_description']
                        if row.get('slug'):
                            meta_data['slug'] = row['slug']
                        
                        meta_response = wp_api.api_request(f'/posts/{post_id}/meta', 'POST', meta_data)
                        if meta_response['success']:
                            print(f"  Added SEO meta for post {post_id}")
                else:
                    print(f"Failed to create post: {post_data['title']}")
            
            print(f"Successfully created {created_count} posts from CSV")
            return created_count
            
    except Exception as e:
        print(f"CSV import failed: {e}")
        return 0

# Usage examples
if __name__ == "__main__":
    wp = WordPressAPI('https://yoursite.com')
    wp.login('admin', 'password')
    
    # Move all posts from category 5 to category 8
    bulk_update_posts_category(wp, 5, 8)
    
    # Create posts from CSV file
    create_posts_from_csv(wp, 'posts_to_import.csv')

User Management Examples

Create New User

curl -X POST "https://yoursite.com/wp-json/corenexis/v1/users" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "newuser123",
    "email": "[email protected]",
    "password": "SecurePassword123!",
    "first_name": "John",
    "last_name": "Doe",
    "role": "editor",
    "display_name": "John Doe",
    "description": "Content editor and blogger",
    "send_notification": true
  }'

User Management Functions

class UserManager {
  constructor(wpAPI) {
    this.wp = wpAPI;
  }
  
  async createUser(userData) {
    try {
      const response = await this.wp.apiRequest('/users', 'POST', userData);
      
      if (response.success) {
        console.log('User created successfully!');
        console.log('User ID:', response.data.id);
        console.log('Email:', response.data.email);
        console.log('Role:', response.data.role);
        return response.data;
      }
    } catch (error) {
      console.error('Failed to create user:', error);
      throw error;
    }
  }
  
  async updateUserRole(userId, newRole) {
    try {
      const response = await this.wp.apiRequest(`/users/${userId}`, 'PUT', {
        role: newRole
      });
      
      if (response.success) {
        console.log(`User ${userId} role updated to ${newRole}`);
        return response.data;
      }
    } catch (error) {
      console.error('Failed to update user role:', error);
      throw error;
    }
  }
  
  async getUsersByRole(role) {
    try {
      const response = await this.wp.apiRequest('/users', 'GET', {
        role: role,
        per_page: 100
      });
      
      if (response.success) {
        console.log(`Found ${response.data.length} users with role: ${role}`);
        return response.data;
      }
    } catch (error) {
      console.error('Failed to fetch users:', error);
      throw error;
    }
  }
  
  async checkUserExists(identifier) {
    try {
      const response = await this.wp.apiRequest('/users/check', 'POST', {
        identifier: identifier // can be username or email
      });
      
      if (response.success) {
        console.log('User exists:', response.data.exists);
        if (response.data.exists) {
          console.log('Email:', response.data.user.email);
          console.log('Role:', response.data.user.role);
        }
        return response.data;
      }
    } catch (error) {
      console.error('Failed to check user:', error);
      throw error;
    }
  }
  
  async bulkUpdateUsers(userIds, updateData) {
    console.log(`Updating ${userIds.length} users...`);
    const results = [];
    
    for (const userId of userIds) {
      try {
        const response = await this.wp.apiRequest(`/users/${userId}`, 'PUT', updateData);
        if (response.success) {
          console.log(`Updated user ${userId}`);
          results.push({ userId, success: true, data: response.data });
        }
      } catch (error) {
        console.error(`Failed to update user ${userId}:`, error);
        results.push({ userId, success: false, error: error.message });
      }
    }
    
    const successCount = results.filter(r => r.success).length;
    console.log(`Successfully updated ${successCount}/${userIds.length} users`);
    return results;
  }
}

// Usage Example
const userManager = new UserManager(wp);

// Create a new editor
userManager.createUser({
  username: 'editor123',
  email: '[email protected]',
  password: 'SecurePass123!',
  first_name: 'Jane',
  last_name: 'Editor',
  role: 'editor',
  display_name: 'Jane Editor'
});

// Get all subscribers
userManager.getUsersByRole('subscriber').then(subscribers => {
  console.log('Subscribers:', subscribers);
});

// Check if user exists
userManager.checkUserExists('[email protected]');

Plugin Management Examples

List All Plugins

curl -X GET "https://yoursite.com/wp-json/corenexis/v1/plugins" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Install and Activate Plugin

# Install plugin from WordPress repository
curl -X POST "https://yoursite.com/wp-json/corenexis/v1/plugins/install" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "contact-form-7"
  }'

# Activate the installed plugin
curl -X POST "https://yoursite.com/wp-json/corenexis/v1/plugins/activate" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plugin": "contact-form-7/wp-contact-form-7.php"
  }'

Plugin Management Class

class PluginManager:
    def __init__(self, wp_api):
        self.wp = wp_api
    
    def list_plugins(self):
        """Get list of all plugins with their status"""
        try:
            response = self.wp.api_request('/plugins', 'GET')
            
            if response['success']:
                plugins = response['data']
                print(f"📊 Found {len(plugins)} plugins:")
                
                active_count = 0
                inactive_count = 0
                
                for plugin in plugins:
                    status = "Active" if plugin['active'] else "⚪ Inactive"
                    print(f"  {status} - {plugin['name']} v{plugin['version']}")
                    
                    if plugin['active']:
                        active_count += 1
                    else:
                        inactive_count += 1
                
                print(f"\n📈 Summary: {active_count} active, {inactive_count} inactive")
                return plugins
            else:
                print("Failed to fetch plugins")
                return []
                
        except Exception as e:
            print(f"Error listing plugins: {e}")
            return []
    
    def install_plugin(self, slug):
        """Install plugin from WordPress repository"""
        try:
            print(f"Installing plugin: {slug}")
            response = self.wp.api_request('/plugins/install', 'POST', {
                'slug': slug
            })
            
            if response['success']:
                print(f"Plugin {slug} installed successfully!")
                plugin_info = response['data']
                print(f"Plugin: {plugin_info['name']}")
                print(f"Version: {plugin_info['version']}")
                print(f"Author: {plugin_info['author']}")
                return plugin_info
            else:
                print(f"Failed to install plugin {slug}: {response['message']}")
                return None
                
        except Exception as e:
            print(f"Error installing plugin {slug}: {e}")
            return None
    
    def activate_plugin(self, plugin_file):
        """Activate an installed plugin"""
        try:
            print(f"Activating plugin: {plugin_file}")
            response = self.wp.api_request('/plugins/activate', 'POST', {
                'plugin': plugin_file
            })
            
            if response['success']:
                print(f"Plugin {plugin_file} activated successfully!")
                return True
            else:
                print(f"Failed to activate plugin {plugin_file}: {response['message']}")
                return False
                
        except Exception as e:
            print(f"Error activating plugin {plugin_file}: {e}")
            return False
    
    def deactivate_plugin(self, plugin_file):
        """Deactivate an active plugin"""
        try:
            print(f" Deactivating plugin: {plugin_file}")
            response = self.wp.api_request('/plugins/deactivate', 'POST', {
                'plugin': plugin_file
            })
            
            if response['success']:
                print(f"Plugin {plugin_file} deactivated successfully!")
                return True
            else:
                print(f"Failed to deactivate plugin {plugin_file}: {response['message']}")
                return False
                
        except Exception as e:
            print(f"Error deactivating plugin {plugin_file}: {e}")
            return False
    
    def delete_plugin(self, plugin_file):
        """DELETE PLUGIN PERMANENTLY - USE WITH EXTREME CAUTION"""
        print("  WARNING: This will permanently delete the plugin files!")
        print(f"  Plugin to delete: {plugin_file}")
        
        # Extra confirmation for safety
        confirmation = input("  Type 'DELETE' to confirm plugin deletion: ")
        if confirmation != 'DELETE':
            print("Plugin deletion cancelled for safety")
            return False
        
        try:
            print(f" Deleting plugin: {plugin_file}")
            response = self.wp.api_request('/plugins/delete', 'POST', {
                'plugin': plugin_file
            })
            
            if response['success']:
                print(f"Plugin {plugin_file} deleted permanently!")
                print("  Remember: This action cannot be undone!")
                return True
            else:
                print(f"Failed to delete plugin {plugin_file}: {response['message']}")
                return False
                
        except Exception as e:
            print(f"Error deleting plugin {plugin_file}: {e}")
            return False
    
    def install_and_activate(self, slug):
        """Install and activate plugin in one operation"""
        # First install the plugin
        plugin_info = self.install_plugin(slug)
        if not plugin_info:
            return False
        
        # Find the main plugin file (usually slug/slug.php)
        plugin_file = f"{slug}/{slug}.php"
        
        # Activate the plugin
        return self.activate_plugin(plugin_file)
    
    def bulk_plugin_operations(self, operations):
        """Perform multiple plugin operations"""
        results = []
        
        for operation in operations:
            action = operation['action']
            plugin = operation.get('plugin', operation.get('slug'))
            
            try:
                if action == 'install':
                    result = self.install_plugin(plugin)
                    results.append({'action': action, 'plugin': plugin, 'success': bool(result)})
                elif action == 'activate':
                    result = self.activate_plugin(plugin)
                    results.append({'action': action, 'plugin': plugin, 'success': result})
                elif action == 'deactivate':
                    result = self.deactivate_plugin(plugin)
                    results.append({'action': action, 'plugin': plugin, 'success': result})
                elif action == 'delete':
                    result = self.delete_plugin(plugin)
                    results.append({'action': action, 'plugin': plugin, 'success': result})
                else:
                    print(f" Unknown action: {action}")
                    results.append({'action': action, 'plugin': plugin, 'success': False})
                    
            except Exception as e:
                print(f"Error with {action} on {plugin}: {e}")
                results.append({'action': action, 'plugin': plugin, 'success': False, 'error': str(e)})
        
        # Summary
        successful = len([r for r in results if r['success']])
        print(f"\n Bulk operations complete: {successful}/{len(results)} successful")
        
        return results

# Usage Examples
if __name__ == "__main__":
    wp = WordPressAPI('https://yoursite.com')
    wp.login('admin', 'password')
    
    plugin_manager = PluginManager(wp)
    
    # List all plugins
    plugins = plugin_manager.list_plugins()
    
    # Install and activate a plugin
    plugin_manager.install_and_activate('contact-form-7')
    
    # Bulk operations
    operations = [
        {'action': 'install', 'slug': 'yoast-seo'},
        {'action': 'install', 'slug': 'jetpack'},
        {'action': 'activate', 'plugin': 'yoast-seo/wp-seo.php'},
        {'action': 'activate', 'plugin': 'jetpack/jetpack.php'}
    ]
    
    plugin_manager.bulk_plugin_operations(operations)