apex-wordpress-poster 0.1.1

A simple package to post HTML content with images to WordPress

WordPress Poster Package

A simple Python package to post HTML content with images to WordPress via the REST API.

Features

• ✅ Upload images from URLs to WordPress media library
• ✅ Replace image URLs in HTML with WordPress media URLs
• ✅ Post HTML content to WordPress
• ✅ Automatic title extraction from HTML
• ✅ Comprehensive error handling

Installation

From Source

pip install -e .

Build and Install

python setup.py sdist bdist_wheel
pip install dist/wordpress_poster-1.0.0.tar.gz

Usage

from wordpress_poster import post_to_wordpress

# Post with images
result = post_to_wordpress(
    wordpress_url="https://yoursite.com",
    wordpress_username="your_username",
    wordpress_password="your_app_password",
    html_content="<h1>My Post</h1><p>Content here</p>",
    image_links=[
        "https://example.com/image1.jpg",
        "https://example.com/image2.png"
    ],
    title="My Blog Post",  # Optional, will extract from HTML if not provided
    status="publish"  # Optional, default is "publish"
)

post_id, post_link, upload_info = result

if post_id:
    print(f"Post created! ID: {post_id}, Link: {post_link}")
    print(f"Uploaded images: {upload_info['uploaded_images']}")
else:
    print("Failed to create post")

Parameters

• wordpress_url (str, required): Your WordPress site URL (e.g., "https://yoursite.com")
• wordpress_username (str, required): WordPress username
• wordpress_password (str, required): WordPress application password (not regular password)
• html_content (str, required): HTML content to post
• image_links (list, optional): List of image URLs to download and upload
• title (str, optional): Post title (will extract from <h1> tag if not provided)
• status (str, optional): Post status (default: "publish")

Returns

Returns a tuple: (post_id, post_link, upload_info)

• post_id: WordPress post ID (None if failed)
• post_link: URL to the published post (None if failed)
• upload_info: Dictionary containing:
  • uploaded_images: Dict mapping original image URLs to WordPress media URLs
  • failed_images: List of image URLs that failed to upload

WordPress Setup

1. Enable REST API in WordPress (usually enabled by default)
2. Create an Application Password:
   • Go to Users → Your Profile
   • Scroll to "Application Passwords"
   • Create a new application password
   • Use this password (not your regular WordPress password)

Notes

• The function automatically sets WP_USE_COOKIE_AUTH="false" as an environment variable
• Images are downloaded, uploaded one by one, and then replaced in the HTML content
• The HTML content is wrapped in <!-- wp:html --> blocks to preserve formatting

Requirements

• Python 3.7+
• requests >= 2.31.0