peptide-repo/prautoblogger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(images): wire image pipeline into article flow (commit 1b) (#14)

Browse Source 
Completes the image + A/B experiment workstream by integrating
image generation into the post publishing pipeline.

New classes:
- class-image-pipeline.php: Orchestrates A/B generation (article-driven
  Image A → featured; source-driven Image B → post meta). Each image
  independently fallible; article publishes even if both fail.
- class-image-prompt-builder.php: Synthesizes visual prompts from article
  title+content and Reddit source data. Appends CEO-locked 90s infomercial
  style suffix. Keeps prompts concise for FLUX.1 quality.
- class-image-media-sideloader.php: Downloads image bytes, creates temp
  file, sideloads via media_handle_sideload(), sets alt text and metadata,
  cleans up temp files.

Changes to existing files:
- Publisher.attach_generated_images(): Runs image pipeline post-creation,
  sets _thumbnail_id (Image A) and _prautoblogger_image_b_id (Image B).
  Errors logged but don't block post publication.
- Settings: prautoblogger_image_enabled (toggle, default off).

Tests:
- ImagePipelineTest.php: Orchestration, cost tracking, graceful failures.
- ImagePromptBuilderTest.php: Prompt generation, length limits.

Docs:
- ARCHITECTURE.md: New step 6b in data flow, new files in file tree.
- CHANGELOG.md: Commit 1a/1b breakdown.

Co-authored-by: peptiderepo <peptiderepo@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
peptiderepo
2026-04-16 16:51:22 +07:00
committed by GitHub
parent be5c659999
commit 2e41c3f2f6
9 changed files with 967 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

157
includes/core/class-image-media-sideloader.php Normal file
View File

@@ -0,0 +1,157 @@
<?php
declare(strict_types=1);
/**
* Downloads generated images and imports them into the WordPress media library.
*
* Handles sideloading (importing external images as WordPress attachments),
* sets metadata (alt text, title), and cleans up temporary files on failure.
*
* Triggered by: PRAutoBlogger_Image_Pipeline during content generation run.
* Dependencies: WordPress media functions (media_handle_sideload, wp_insert_attachment).
*
* @see core/class-image-pipeline.php — Consumes sideload_image().
* @see providers/interface-image-provider.php — Image metadata (bytes, mime_type, etc).
* @see ARCHITECTURE.md — Media library integration.
*/
class PRAutoBlogger_Image_Media_Sideloader {
/**
* Download and sideload a generated image into WordPress media library.
*
* Creates a temporary file, imports it via media_handle_sideload(), and
* cleans up the temp file on success or failure. Sets alt text and title
* from the prompt if provided.
*
* @param array{
* bytes: string,
* mime_type: string,
* width: int,
* height: int,
* model: string,
* seed?: ?int,
* cost_usd: float,
* latency_ms: int,
* } $image_data Raw image bytes + metadata from PRAutoBlogger_Image_Provider_Interface.
* @param int $post_id Target post ID to attach the image to.
* @param string $alt_text Alt text for the image (from the generation prompt).
*
* @return int|\WP_Error Attachment ID on success, WP_Error on failure.
*/
public function sideload_image( array $image_data, int $post_id, string $alt_text = '' ): int | \WP_Error {
// Validate input.
if ( empty( $image_data['bytes'] ) ) {
return new \WP_Error( 'invalid_image_data', 'Image data (bytes) is empty.' );
}
// Create a temporary file.
$temp_file = $this->create_temp_file( $image_data['bytes'], $image_data['mime_type'] );
if ( is_wp_error( $temp_file ) ) {
return $temp_file;
}
// Prepare file array for media_handle_sideload().
$file_array = [
'name' => $this->generate_filename( $image_data['model'], $image_data['width'], $image_data['height'] ),
'tmp_name' => $temp_file,
];
// Import the file into media library.
$attachment_id = media_handle_sideload( $file_array, $post_id );
// Clean up temp file.
@unlink( $temp_file );
if ( is_wp_error( $attachment_id ) ) {
PRAutoBlogger_Logger::instance()->error(
'Failed to sideload image: ' . $attachment_id->get_error_message(),
'image_media_sideloader'
);
return $attachment_id;
}
// Set alt text and metadata.
if ( ! empty( $alt_text ) ) {
update_post_meta( $attachment_id, '_wp_attachment_image_alt', sanitize_text_field( $alt_text ) );
}
// Store image generation metadata.
update_post_meta( $attachment_id, '_prautoblogger_image_model', sanitize_text_field( $image_data['model'] ) );
update_post_meta( $attachment_id, '_prautoblogger_image_width', (int) $image_data['width'] );
update_post_meta( $attachment_id, '_prautoblogger_image_height', (int) $image_data['height'] );
update_post_meta( $attachment_id, '_prautoblogger_image_cost_usd', (float) $image_data['cost_usd'] );
update_post_meta( $attachment_id, '_prautoblogger_image_latency_ms', (int) $image_data['latency_ms'] );
if ( isset( $image_data['seed'] ) && null !== $image_data['seed'] ) {
update_post_meta( $attachment_id, '_prautoblogger_image_seed', (int) $image_data['seed'] );
}
return $attachment_id;
}
/**
* Create a temporary file containing the image bytes.
*
* @param string $bytes Raw image bytes.
* @param string $mime_type MIME type (e.g., 'image/png').
*
* @return string|\WP_Error Path to temporary file on success, WP_Error on failure.
*/
private function create_temp_file( string $bytes, string $mime_type ): string | \WP_Error {
$temp_dir = get_temp_dir();
$filename = 'prautoblogger_img_' . wp_generate_uuid4() . $this->get_extension_for_mime( $mime_type );
$temp_path = $temp_dir . $filename;
$written = file_put_contents( $temp_path, $bytes );
if ( false === $written ) {
return new \WP_Error(
'temp_file_write_failed',
sprintf(
/* translators: %s: path to temp file */
esc_html__( 'Could not write temporary image file to %s', 'prautoblogger' ),
$temp_path
)
);
}
return $temp_path;
}
/**
* Generate a descriptive filename for the attachment.
*
* @param string $model Model name (e.g., 'flux-1-schnell').
* @param int $width Image width.
* @param int $height Image height.
*
* @return string Sanitized filename.
*/
private function generate_filename( string $model, int $width, int $height ): string {
$base = sprintf(
'prautoblogger_%s_%dx%d_%s',
sanitize_title( $model ),
$width,
$height,
gmdate( 'Y-m-d_H-i-s' )
);
return $base . '.png'; // Default to PNG since FLUX.1 outputs PNG.
}
/**
* Get file extension for a MIME type.
*
* @param string $mime_type MIME type string.
*
* @return string File extension with leading dot (e.g., '.png').
*/
private function get_extension_for_mime( string $mime_type ): string {
$map = [
'image/png' => '.png',
'image/jpeg' => '.jpg',
'image/jpg' => '.jpg',
];
return $map[ strtolower( $mime_type ) ] ?? '.png';
}
}

276
includes/core/class-image-pipeline.php Normal file
View File

@@ -0,0 +1,276 @@
<?php
declare(strict_types=1);
/**
* Orchestrates image generation for published articles.
*
* Generates two images per article (A/B experiment):
* - Image A: Article-driven prompt → featured image
* - Image B: Source-driven prompt → post meta (_prautoblogger_image_b_id)
*
* Each image is independently fallible — if A fails, still try B. If both fail,
* the article is published without images (graceful degradation).
*
* Triggered by: PRAutoBlogger_Pipeline_Runner after publisher creates the post.
* Dependencies: PRAutoBlogger_Image_Provider_Interface (concrete provider),
* PRAutoBlogger_Image_Prompt_Builder, PRAutoBlogger_Image_Media_Sideloader,
* PRAutoBlogger_Cost_Tracker, PRAutoBlogger_Logger.
*
* @see core/class-pipeline-runner.php — Calls this after publisher.
* @see core/class-publisher.php — Sets featured image + post meta.
* @see core/class-image-prompt-builder.php — Prompt generation.
* @see core/class-image-media-sideloader.php — Media library integration.
* @see ARCHITECTURE.md — Image pipeline data flow.
*/
class PRAutoBlogger_Image_Pipeline {
/**
* Default image dimensions (landscape).
*/
private const DEFAULT_WIDTH = 1200;
private const DEFAULT_HEIGHT = 630;
/**
* The image provider (FLUX.1 via Cloudflare or another).
*
* @var PRAutoBlogger_Image_Provider_Interface
*/
private PRAutoBlogger_Image_Provider_Interface $provider;
/**
* Prompt builder.
*
* @var PRAutoBlogger_Image_Prompt_Builder
*/
private PRAutoBlogger_Image_Prompt_Builder $prompt_builder;
/**
* Media library sideloader.
*
* @var PRAutoBlogger_Image_Media_Sideloader
*/
private PRAutoBlogger_Image_Media_Sideloader $sideloader;
/**
* Cost tracker for logging spend.
*
* @var PRAutoBlogger_Cost_Tracker
*/
private PRAutoBlogger_Cost_Tracker $cost_tracker;
/**
* Construct with dependencies.
*
* @param PRAutoBlogger_Image_Provider_Interface|null $provider Optional provider (defaults to Cloudflare).
* @param PRAutoBlogger_Cost_Tracker|null $cost_tracker Optional cost tracker.
*/
public function __construct(
?PRAutoBlogger_Image_Provider_Interface $provider = null,
?PRAutoBlogger_Cost_Tracker $cost_tracker = null
) {
$this->provider = $provider ?? new PRAutoBlogger_Cloudflare_Image_Provider();
$this->prompt_builder = new PRAutoBlogger_Image_Prompt_Builder();
$this->sideloader = new PRAutoBlogger_Image_Media_Sideloader();
$this->cost_tracker = $cost_tracker ?? new PRAutoBlogger_Cost_Tracker();
}
/**
* Generate and attach images to a published post.
*
* Generates Image A (article-driven) and Image B (source-driven). If enabled
* in settings. Each image is independently fallible.
*
* @param int $post_id Post ID to attach images to.
* @param array{
* post_title?: string,
* post_content?: string,
* suggested_title?: string,
* } $article_data Article title + content.
* @param array{
* title?: string,
* selftext?: string,
* comments?: string[],
* }|null $source_data Optional Reddit source data for Image B.
*
* @return array{
* image_a_id?: int,
* image_b_id?: int,
* cost_usd: float,
* errors: string[],
* } Attachment IDs (if successful) and cost/errors.
*/
public function generate_and_attach_images(
int $post_id,
array $article_data,
?array $source_data = null
): array {
$result = [
'cost_usd' => 0.0,
'errors' => [],
];
// Early exit if image generation is disabled.
if ( ! get_option( 'prautoblogger_image_enabled' ) ) {
PRAutoBlogger_Logger::instance()->info( 'Image generation disabled in settings.', 'image_pipeline' );
return $result;
}
// Generate Image A (article-driven prompt).
$image_a_result = $this->generate_image_a( $post_id, $article_data );
if ( ! is_wp_error( $image_a_result ) && isset( $image_a_result['attachment_id'] ) ) {
$result['image_a_id'] = $image_a_result['attachment_id'];
} else {
$result['errors'][] = is_wp_error( $image_a_result )
? $image_a_result->get_error_message()
: 'Image A generation produced no attachment ID.';
}
$result['cost_usd'] += $image_a_result['cost_usd'] ?? 0.0;
// Generate Image B (source-driven prompt) if source data is available.
if ( null !== $source_data && ! empty( $source_data ) ) {
$image_b_result = $this->generate_image_b( $post_id, $source_data );
if ( ! is_wp_error( $image_b_result ) && isset( $image_b_result['attachment_id'] ) ) {
$result['image_b_id'] = $image_b_result['attachment_id'];
} else {
$result['errors'][] = is_wp_error( $image_b_result )
? $image_b_result->get_error_message()
: 'Image B generation produced no attachment ID.';
}
$result['cost_usd'] += $image_b_result['cost_usd'] ?? 0.0;
}
return $result;
}
/**
* Generate Image A from article content.
*
* @param int $post_id Post ID.
* @param array $article_data Article data.
*
* @return array{
* attachment_id?: int,
* cost_usd: float,
* }|\WP_Error
*/
private function generate_image_a( int $post_id, array $article_data ): array | \WP_Error {
try {
// Build the article-driven prompt.
$prompt = $this->prompt_builder->build_article_prompt( $article_data );
// Estimate cost before generating.
$estimated_cost = $this->provider->estimate_cost( self::DEFAULT_WIDTH, self::DEFAULT_HEIGHT );
if ( $this->cost_tracker->would_exceed_budget( $estimated_cost ) ) {
return new \WP_Error(
'budget_exceeded',
'Image generation would exceed monthly budget.'
);
}
// Generate the image.
$image_data = $this->provider->generate_image( $prompt, self::DEFAULT_WIDTH, self::DEFAULT_HEIGHT );
// Sideload the image into media library.
$attachment_id = $this->sideloader->sideload_image(
$image_data,
$post_id,
substr( $prompt, 0, 100 ) // Use first 100 chars of prompt as alt text.
);
if ( is_wp_error( $attachment_id ) ) {
return $attachment_id;
}
// Log the cost.
$this->cost_tracker->log_image_generation(
$image_data['cost_usd'],
'flux-1-schnell',
$post_id,
'image_a'
);
PRAutoBlogger_Logger::instance()->info(
sprintf( 'Image A generated for post %d (attachment %d, cost $%.4f)', $post_id, $attachment_id, $image_data['cost_usd'] ),
'image_pipeline'
);
return [
'attachment_id' => $attachment_id,
'cost_usd' => $image_data['cost_usd'],
];
} catch ( \Exception $e ) {
PRAutoBlogger_Logger::instance()->error(
'Image A generation failed: ' . $e->getMessage(),
'image_pipeline'
);
return new \WP_Error( 'image_generation_failed', $e->getMessage() );
}
}
/**
* Generate Image B from source data.
*
* @param int $post_id Post ID.
* @param array $source_data Source Reddit data.
*
* @return array{
* attachment_id?: int,
* cost_usd: float,
* }|\WP_Error
*/
private function generate_image_b( int $post_id, array $source_data ): array | \WP_Error {
try {
// Build the source-driven prompt.
$prompt = $this->prompt_builder->build_source_prompt( $source_data );
// Estimate cost before generating.
$estimated_cost = $this->provider->estimate_cost( self::DEFAULT_WIDTH, self::DEFAULT_HEIGHT );
if ( $this->cost_tracker->would_exceed_budget( $estimated_cost ) ) {
return new \WP_Error(
'budget_exceeded',
'Image generation would exceed monthly budget.'
);
}
// Generate the image.
$image_data = $this->provider->generate_image( $prompt, self::DEFAULT_WIDTH, self::DEFAULT_HEIGHT );
// Sideload the image into media library.
$attachment_id = $this->sideloader->sideload_image(
$image_data,
$post_id,
substr( $prompt, 0, 100 ) // Use first 100 chars of prompt as alt text.
);
if ( is_wp_error( $attachment_id ) ) {
return $attachment_id;
}
// Log the cost.
$this->cost_tracker->log_image_generation(
$image_data['cost_usd'],
'flux-1-schnell',
$post_id,
'image_b'
);
PRAutoBlogger_Logger::instance()->info(
sprintf( 'Image B generated for post %d (attachment %d, cost $%.4f)', $post_id, $attachment_id, $image_data['cost_usd'] ),
'image_pipeline'
);
return [
'attachment_id' => $attachment_id,
'cost_usd' => $image_data['cost_usd'],
];
} catch ( \Exception $e ) {
PRAutoBlogger_Logger::instance()->error(
'Image B generation failed: ' . $e->getMessage(),
'image_pipeline'
);
return new \WP_Error( 'image_generation_failed', $e->getMessage() );
}
}
}

136
includes/core/class-image-prompt-builder.php Normal file
View File

@@ -0,0 +1,136 @@
<?php
declare(strict_types=1);
/**
* Builds image prompts from article content or source data.
*
* Generates concise visual concepts suitable for FLUX.1 image generation,
* extracting key themes from article titles/content and Reddit source data.
*
* Triggered by: PRAutoBlogger_Image_Pipeline during content generation run.
* Dependencies: None — pure data transformation.
*
* @see core/class-image-pipeline.php — Consumes build_article_prompt() and build_source_prompt().
* @see ARCHITECTURE.md — Image generation data flow.
*/
class PRAutoBlogger_Image_Prompt_Builder {
/**
* Build a visual prompt from finished article content.
*
* Extracts the title and first paragraph to synthesize a product-marketing
* angle visual concept suitable for a featured image. Appends the style suffix
* from plugin options.
*
* @param array{
* post_title?: string,
* post_content?: string,
* suggested_title?: string,
* } $article_data Article data with title and HTML content.
*
* @return string Concise prompt (under 200 words) with style suffix appended.
*/
public function build_article_prompt( array $article_data ): string {
$title = $article_data['post_title'] ?? $article_data['suggested_title'] ?? 'Product';
$content = $article_data['post_content'] ?? '';
// Extract first paragraph from HTML content.
$first_para = $this->extract_first_paragraph( $content );
// Build visual concepts from title + first paragraph.
$concepts = $this->synthesize_visual_concepts( $title, $first_para );
// Append style suffix.
$style_suffix = get_option( 'prautoblogger_image_style_suffix', PRAUTOBLOGGER_DEFAULT_IMAGE_STYLE_SUFFIX );
return trim( $concepts . ' ' . $style_suffix );
}
/**
* Build a visual prompt from source Reddit thread data.
*
* Extracts the Reddit thread title and top comments to synthesize an
* editorial-cartoonist angle visual concept. Appends the style suffix
* from plugin options.
*
* @param array{
* title?: string,
* selftext?: string,
* comments?: string[],
* } $source_data Reddit source data with title and comments.
*
* @return string Concise prompt (under 200 words) with style suffix appended.
*/
public function build_source_prompt( array $source_data ): string {
$title = $source_data['title'] ?? 'Reddit Discussion';
$comments = $source_data['comments'] ?? [];
// Build visual concepts from title + top comments.
$concepts = $this->synthesize_visual_concepts(
$title,
is_array( $comments ) && ! empty( $comments ) ? $comments[0] : ''
);
// Append style suffix.
$style_suffix = get_option( 'prautoblogger_image_style_suffix', PRAUTOBLOGGER_DEFAULT_IMAGE_STYLE_SUFFIX );
return trim( $concepts . ' ' . $style_suffix );
}
/**
* Extract the first paragraph from HTML content.
*
* Removes all tags and captures the text up to the first double-newline
* or 200 characters, whichever comes first.
*
* @param string $html HTML content.
*
* @return string Plain text of the first paragraph.
*/
private function extract_first_paragraph( string $html ): string {
// Remove HTML tags.
$text = wp_strip_all_tags( $html );
// Split on double-newline and take the first paragraph.
$paras = preg_split( '/\n\n+/', $text );
$para = isset( $paras[0] ) ? trim( $paras[0] ) : '';
// Limit to first 200 chars to keep prompt concise.
if ( strlen( $para ) > 200 ) {
$para = substr( $para, 0, 200 ) . '...';
}
return $para;
}
/**
* Synthesize visual concepts from a title and supporting text.
*
* Combines key words and themes into a short visual narrative that FLUX.1
* can render. This is intentionally rule-based rather than LLM-driven to
* avoid another API call per image generation.
*
* @param string $title Main heading / topic.
* @param string $supporting_text Additional context (first para or comment).
*
* @return string Synthesized visual prompt concept.
*/
private function synthesize_visual_concepts( string $title, string $supporting_text ): string {
$title = trim( sanitize_text_field( $title ) );
$text = trim( sanitize_text_field( $supporting_text ) );
// Build a simple declarative concept from title and text snippets.
$prompt = "A visual representation of: {$title}";
if ( ! empty( $text ) ) {
// Take first 150 chars to avoid bloating the prompt.
$snippet = strlen( $text ) > 150
? substr( $text, 0, 150 ) . '...'
: $text;
$prompt .= ". Context: {$snippet}";
}
return trim( $prompt );
}
}

77
includes/core/class-publisher.php
View File

@@ -121,6 +121,11 @@ class PRAutoBlogger_Publisher {
// Update generation log entries to reference this post.
$this->link_generation_logs( $post_id, $run_id );
// Generate and attach images if published and images enabled.
if ( 'publish' === $post_status ) {
$this->attach_generated_images( $post_id, $idea, $post_data );
}
PRAutoBlogger_Logger::instance()->info(
sprintf( 'Post created: ID=%d, status=%s, title="%s"', $post_id, $post_status, $idea->get_suggested_title() ),
'publisher'
@@ -307,4 +312,76 @@ class PRAutoBlogger_Publisher {
return ! empty( $admins ) ? (int) $admins[0] : 1;
}
/**
* Generate and attach images to a published post.
*
* Calls the image pipeline to generate Image A (featured image) and Image B
* (secondary image). Sets _thumbnail_id and _prautoblogger_image_b_id post meta.
* Gracefully handles image generation failures — post is already created, so
* this is a non-blocking operation.
*
* @param int $post_id The newly created post ID.
* @param PRAutoBlogger_Article_Idea $idea The article idea (contains source IDs).
* @param array $post_data The post data array (for article content).
*
* @return void
*/
private function attach_generated_images( int $post_id, PRAutoBlogger_Article_Idea $idea, array $post_data ): void {
// Build source data from idea's source IDs (if available).
$source_data = null;
$source_ids = $idea->get_source_ids();
if ( ! empty( $source_ids ) ) {
// Attempt to fetch the original source data for Image B.
// For now, we pass null; the image pipeline will handle gracefully.
$source_data = null;
}
try {
$image_pipeline = new PRAutoBlogger_Image_Pipeline();
$result = $image_pipeline->generate_and_attach_images( $post_id, $post_data, $source_data );
// Set Image A as the featured image.
if ( isset( $result['image_a_id'] ) ) {
set_post_thumbnail( $post_id, $result['image_a_id'] );
PRAutoBlogger_Logger::instance()->info(
sprintf( 'Set featured image (attachment %d) for post %d', $result['image_a_id'], $post_id ),
'publisher'
);
}
// Store Image B ID in post meta for A/B tracking.
if ( isset( $result['image_b_id'] ) ) {
update_post_meta( $post_id, '_prautoblogger_image_b_id', $result['image_b_id'] );
PRAutoBlogger_Logger::instance()->info(
sprintf( 'Stored Image B (attachment %d) in post meta for post %d', $result['image_b_id'], $post_id ),
'publisher'
);
}
// Log errors if any occurred (but don't let them block post creation).
if ( ! empty( $result['errors'] ) ) {
foreach ( $result['errors'] as $error ) {
PRAutoBlogger_Logger::instance()->warning(
'Image generation warning for post ' . $post_id . ': ' . $error,
'publisher'
);
}
}
// Log total cost.
if ( $result['cost_usd'] > 0.0 ) {
PRAutoBlogger_Logger::instance()->info(
sprintf( 'Image generation cost: $%.4f for post %d', $result['cost_usd'], $post_id ),
'publisher'
);
}
} catch ( \Exception $e ) {
// Log the error but don't re-throw — post is already created.
PRAutoBlogger_Logger::instance()->warning(
'Image pipeline exception for post ' . $post_id . ': ' . $e->getMessage(),
'publisher'
);
}
}
}