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

Initial commit: PRAutoBlogger v0.1.0 with frontend posts widget

Browse Source
This commit is contained in:
Terence Ong
2026-04-10 23:33:42 +07:00
parent 68c6f67bcf
commit 88d674d679
65 changed files with 2178 additions and 1084 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
includes/providers/class-instagram-provider.php
View File

@@ -12,16 +12,16 @@ declare(strict_types=1);
*
* @see interface-source-provider.php — Interface this class implements.
*/
class Autoblogger_Instagram_Provider implements Autoblogger_Source_Provider_Interface {
class PRAutoBlogger_Instagram_Provider implements PRAutoBlogger_Source_Provider_Interface {
/**
* @param array<string, mixed> $config
* @return Autoblogger_Source_Data[]
* @return PRAutoBlogger_Source_Data[]
* @throws \RuntimeException Always — not yet implemented.
*/
public function collect_data( array $config ): array {
throw new \RuntimeException(
__( 'Instagram source provider is not yet implemented. Remove "instagram" from enabled sources.', 'autoblogger' )
__( 'Instagram source provider is not yet implemented. Remove "instagram" from enabled sources.', 'prautoblogger' )
);
}

16
includes/providers/class-openrouter-pricing.php
View File

@@ -7,13 +7,13 @@ declare(strict_types=1);
* Manages pricing tables, model lists, and cost estimation. Decoupled from
* the request logic for easy updates and testing.
*
* Triggered by: Autoblogger_OpenRouter_Provider calls pricing methods.
* Triggered by: PRAutoBlogger_OpenRouter_Provider calls pricing methods.
* Dependencies: None — pure data + calculation, no external calls by default.
*
* @see providers/class-openrouter-provider.php — Instantiates this class.
* @see ARCHITECTURE.md — Model selection flow.
*/
class Autoblogger_OpenRouter_Pricing {
class PRAutoBlogger_OpenRouter_Pricing {
/**
* Known model pricing (per million tokens, in USD).
@@ -41,7 +41,7 @@ class Autoblogger_OpenRouter_Pricing {
* @return array<int, array{id: string, name: string, context_length: int, pricing: array{prompt: float, completion: float}}>
*/
public function get_available_models(): array {
$cached = get_transient( 'autoblogger_openrouter_models' );
$cached = get_transient( 'prautoblogger_openrouter_models' );
if ( false !== $cached && is_array( $cached ) ) {
return $cached;
}
@@ -62,7 +62,7 @@ class Autoblogger_OpenRouter_Pricing {
);
if ( is_wp_error( $response ) || 200 !== wp_remote_retrieve_response_code( $response ) ) {
Autoblogger_Logger::instance()->warning( 'Failed to fetch OpenRouter models list.', 'openrouter' );
PRAutoBlogger_Logger::instance()->warning( 'Failed to fetch OpenRouter models list.', 'openrouter' );
return [];
}
@@ -83,7 +83,7 @@ class Autoblogger_OpenRouter_Pricing {
}
}
set_transient( 'autoblogger_openrouter_models', $models, DAY_IN_SECONDS );
set_transient( 'prautoblogger_openrouter_models', $models, DAY_IN_SECONDS );
return $models;
}
@@ -114,7 +114,7 @@ class Autoblogger_OpenRouter_Pricing {
if ( null === $pricing ) {
// Unknown model — use a conservative estimate.
Autoblogger_Logger::instance()->warning( "Unknown model pricing for '{$model}'. Using conservative estimate.", 'openrouter' );
PRAutoBlogger_Logger::instance()->warning( "Unknown model pricing for '{$model}'. Using conservative estimate.", 'openrouter' );
$pricing = [ 'prompt' => 10.0, 'completion' => 30.0 ];
}
@@ -128,10 +128,10 @@ class Autoblogger_OpenRouter_Pricing {
* @return string Decrypted API key, or empty string if not set.
*/
private function get_api_key(): string {
$encrypted = get_option( 'autoblogger_openrouter_api_key', '' );
$encrypted = get_option( 'prautoblogger_openrouter_api_key', '' );
if ( '' === $encrypted ) {
return '';
}
return Autoblogger_Encryption::decrypt( $encrypted );
return PRAutoBlogger_Encryption::decrypt( $encrypted );
}
}

44
includes/providers/class-openrouter-provider.php
View File

@@ -9,14 +9,14 @@ declare(strict_types=1);
* separate provider integrations.
*
* Triggered by: Content_Analyzer, Content_Generator, Chief_Editor, Metrics_Collector.
* Dependencies: Autoblogger_Encryption (for API key decryption), wp_remote_post(), Autoblogger_OpenRouter_Pricing.
* Dependencies: PRAutoBlogger_Encryption (for API key decryption), wp_remote_post(), PRAutoBlogger_OpenRouter_Pricing.
*
* @see interface-llm-provider.php — Interface this class implements.
* @see class-openrouter-pricing.php — Pricing and model list lookups.
* @see class-cost-tracker.php — Called after every request to log token usage.
* @see ARCHITECTURE.md — Data flow diagram showing where this fits.
*/
class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interface {
class PRAutoBlogger_OpenRouter_Provider implements PRAutoBlogger_LLM_Provider_Interface {
private const API_BASE_URL = 'https://openrouter.ai/api/v1';
@@ -51,7 +51,7 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
$api_key = $this->get_api_key();
if ( '' === $api_key ) {
throw new \RuntimeException(
__( 'OpenRouter API key is not configured. Go to AutoBlogger → Settings.', 'autoblogger' )
__( 'OpenRouter API key is not configured. Go to PRAutoBlogger → Settings.', 'prautoblogger' )
);
}
@@ -72,16 +72,16 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
$last_error = '';
for ( $attempt = 1; $attempt <= AUTOBLOGGER_MAX_RETRIES; $attempt++ ) {
for ( $attempt = 1; $attempt <= PRAUTOBLOGGER_MAX_RETRIES; $attempt++ ) {
$response = wp_remote_post(
self::API_BASE_URL . '/chat/completions',
[
'timeout' => AUTOBLOGGER_API_TIMEOUT_SECONDS,
'timeout' => PRAUTOBLOGGER_API_TIMEOUT_SECONDS,
'headers' => [
'Authorization' => 'Bearer ' . $api_key,
'Content-Type' => 'application/json',
'HTTP-Referer' => home_url(),
'X-Title' => 'AutoBlogger WordPress Plugin',
'X-Title' => 'PRAutoBlogger WordPress Plugin',
],
'body' => wp_json_encode( $body ),
]
@@ -89,13 +89,13 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
if ( is_wp_error( $response ) ) {
$last_error = $response->get_error_message();
Autoblogger_Logger::instance()->warning(
sprintf( 'OpenRouter request failed (attempt %d/%d): %s', $attempt, AUTOBLOGGER_MAX_RETRIES, $last_error ),
PRAutoBlogger_Logger::instance()->warning(
sprintf( 'OpenRouter request failed (attempt %d/%d): %s', $attempt, PRAUTOBLOGGER_MAX_RETRIES, $last_error ),
'openrouter'
);
if ( $attempt < AUTOBLOGGER_MAX_RETRIES ) {
$delay = AUTOBLOGGER_RETRY_BASE_DELAY_SECONDS * pow( 2, $attempt - 1 );
if ( $attempt < PRAUTOBLOGGER_MAX_RETRIES ) {
$delay = PRAUTOBLOGGER_RETRY_BASE_DELAY_SECONDS * pow( 2, $attempt - 1 );
sleep( (int) $delay );
}
continue;
@@ -108,17 +108,17 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
// Rate limited or server error — retry.
if ( $status_code >= 429 || $status_code >= 500 ) {
$last_error = sprintf( 'HTTP %d: %s', $status_code, $body_raw );
Autoblogger_Logger::instance()->warning(
sprintf( 'OpenRouter HTTP %d (attempt %d/%d): %s', $status_code, $attempt, AUTOBLOGGER_MAX_RETRIES, substr( $body_raw, 0, 500 ) ),
PRAutoBlogger_Logger::instance()->warning(
sprintf( 'OpenRouter HTTP %d (attempt %d/%d): %s', $status_code, $attempt, PRAUTOBLOGGER_MAX_RETRIES, substr( $body_raw, 0, 500 ) ),
'openrouter'
);
if ( $attempt < AUTOBLOGGER_MAX_RETRIES ) {
if ( $attempt < PRAUTOBLOGGER_MAX_RETRIES ) {
// Respect Retry-After header if present.
$retry_after = wp_remote_retrieve_header( $response, 'retry-after' );
$delay = $retry_after
? min( (int) $retry_after, 60 )
: AUTOBLOGGER_RETRY_BASE_DELAY_SECONDS * pow( 2, $attempt - 1 );
: PRAUTOBLOGGER_RETRY_BASE_DELAY_SECONDS * pow( 2, $attempt - 1 );
sleep( (int) $delay );
}
continue;
@@ -132,7 +132,7 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
throw new \RuntimeException(
sprintf(
/* translators: %d: HTTP status code, %s: error message */
__( 'OpenRouter API error (HTTP %1$d): %2$s', 'autoblogger' ),
__( 'OpenRouter API error (HTTP %1$d): %2$s', 'prautoblogger' ),
$status_code,
$error_msg
)
@@ -142,7 +142,7 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
// Success — parse response.
if ( ! isset( $data['choices'][0]['message']['content'] ) ) {
throw new \RuntimeException(
__( 'OpenRouter returned unexpected response format.', 'autoblogger' )
__( 'OpenRouter returned unexpected response format.', 'prautoblogger' )
);
}
@@ -162,8 +162,8 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
throw new \RuntimeException(
sprintf(
/* translators: %d: max retries, %s: last error message */
__( 'OpenRouter API failed after %1$d attempts. Last error: %2$s', 'autoblogger' ),
AUTOBLOGGER_MAX_RETRIES,
__( 'OpenRouter API failed after %1$d attempts. Last error: %2$s', 'prautoblogger' ),
PRAUTOBLOGGER_MAX_RETRIES,
$last_error
)
);
@@ -179,7 +179,7 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
* @return array<int, array{id: string, name: string, context_length: int, pricing: array{prompt: float, completion: float}}>
*/
public function get_available_models(): array {
$pricing = new Autoblogger_OpenRouter_Pricing();
$pricing = new PRAutoBlogger_OpenRouter_Pricing();
return $pricing->get_available_models();
}
@@ -195,7 +195,7 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
* @return float Estimated cost in USD.
*/
public function estimate_cost( string $model, int $prompt_tokens, int $completion_tokens ): float {
$pricing = new Autoblogger_OpenRouter_Pricing();
$pricing = new PRAutoBlogger_OpenRouter_Pricing();
return $pricing->estimate_cost( $model, $prompt_tokens, $completion_tokens );
}
@@ -244,10 +244,10 @@ class Autoblogger_OpenRouter_Provider implements Autoblogger_LLM_Provider_Interf
* @return string Decrypted API key, or empty string if not set.
*/
private function get_api_key(): string {
$encrypted = get_option( 'autoblogger_openrouter_api_key', '' );
$encrypted = get_option( 'prautoblogger_openrouter_api_key', '' );
if ( '' === $encrypted ) {
return '';
}
return Autoblogger_Encryption::decrypt( $encrypted );
return PRAutoBlogger_Encryption::decrypt( $encrypted );
}
}

30
includes/providers/class-reddit-api-client.php
View File

@@ -7,17 +7,17 @@ declare(strict_types=1);
* Encapsulates OAuth2 token management, rate limit tracking, and HTTP methods
* for the Reddit API. Decoupled from collection logic for testability.
*
* Triggered by: Autoblogger_Reddit_Provider calls fetch methods here.
* Dependencies: Autoblogger_Encryption (for client secret), wp_remote_post/get().
* Triggered by: PRAutoBlogger_Reddit_Provider calls fetch methods here.
* Dependencies: PRAutoBlogger_Encryption (for client secret), wp_remote_post/get().
*
* @see providers/class-reddit-provider.php — Instantiates this class.
* @see ARCHITECTURE.md — External API integrations table.
*/
class Autoblogger_Reddit_API_Client {
class PRAutoBlogger_Reddit_API_Client {
private const AUTH_URL = 'https://www.reddit.com/api/v1/access_token';
private const API_BASE = 'https://oauth.reddit.com';
private const USER_AGENT = 'AutoBlogger/0.1.0 (WordPress Plugin)';
private const USER_AGENT = 'PRAutoBlogger/0.1.0 (WordPress Plugin)';
/**
* Get an OAuth2 access token, using cached transient if available.
@@ -32,15 +32,15 @@ class Autoblogger_Reddit_API_Client {
*/
public function get_access_token( bool $force_refresh = false ): string {
if ( ! $force_refresh ) {
$cached = get_transient( 'autoblogger_reddit_token' );
$cached = get_transient( 'prautoblogger_reddit_token' );
if ( false !== $cached && is_string( $cached ) ) {
return $cached;
}
}
$client_id = get_option( 'autoblogger_reddit_client_id', '' );
$client_secret = Autoblogger_Encryption::decrypt(
get_option( 'autoblogger_reddit_client_secret', '' )
$client_id = get_option( 'prautoblogger_reddit_client_id', '' );
$client_secret = PRAutoBlogger_Encryption::decrypt(
get_option( 'prautoblogger_reddit_client_secret', '' )
);
if ( '' === $client_id || '' === $client_secret ) {
@@ -63,25 +63,25 @@ class Autoblogger_Reddit_API_Client {
);
if ( is_wp_error( $response ) ) {
Autoblogger_Logger::instance()->error( 'Reddit OAuth failed: ' . $response->get_error_message(), 'reddit' );
PRAutoBlogger_Logger::instance()->error( 'Reddit OAuth failed: ' . $response->get_error_message(), 'reddit' );
return '';
}
if ( 200 !== wp_remote_retrieve_response_code( $response ) ) {
Autoblogger_Logger::instance()->error( 'Reddit OAuth HTTP ' . wp_remote_retrieve_response_code( $response ), 'reddit' );
PRAutoBlogger_Logger::instance()->error( 'Reddit OAuth HTTP ' . wp_remote_retrieve_response_code( $response ), 'reddit' );
return '';
}
$data = json_decode( wp_remote_retrieve_body( $response ), true );
if ( ! isset( $data['access_token'] ) ) {
Autoblogger_Logger::instance()->error( 'Reddit OAuth response missing access_token.', 'reddit' );
PRAutoBlogger_Logger::instance()->error( 'Reddit OAuth response missing access_token.', 'reddit' );
return '';
}
$token = $data['access_token'];
$expires = isset( $data['expires_in'] ) ? (int) $data['expires_in'] - 60 : 3540;
set_transient( 'autoblogger_reddit_token', $token, $expires );
set_transient( 'prautoblogger_reddit_token', $token, $expires );
return $token;
}
@@ -179,7 +179,7 @@ class Autoblogger_Reddit_API_Client {
);
if ( is_wp_error( $response ) ) {
Autoblogger_Logger::instance()->error( 'Reddit API GET failed: ' . $response->get_error_message(), 'reddit' );
PRAutoBlogger_Logger::instance()->error( 'Reddit API GET failed: ' . $response->get_error_message(), 'reddit' );
return null;
}
@@ -189,7 +189,7 @@ class Autoblogger_Reddit_API_Client {
$rate_reset = wp_remote_retrieve_header( $response, 'x-ratelimit-reset' );
if ( '' !== $rate_remaining ) {
set_transient( 'autoblogger_reddit_rate_limit', [
set_transient( 'prautoblogger_reddit_rate_limit', [
'remaining' => (int) $rate_remaining,
'limit' => (int) $rate_limit + (int) $rate_remaining,
'resets_at' => gmdate( 'Y-m-d H:i:s', time() + (int) $rate_reset ),
@@ -198,7 +198,7 @@ class Autoblogger_Reddit_API_Client {
$status_code = wp_remote_retrieve_response_code( $response );
if ( 200 !== $status_code ) {
Autoblogger_Logger::instance()->error( sprintf( 'Reddit API HTTP %d: %s', $status_code, substr( wp_remote_retrieve_body( $response ), 0, 300 ) ), 'reddit' );
PRAutoBlogger_Logger::instance()->error( sprintf( 'Reddit API HTTP %d: %s', $status_code, substr( wp_remote_retrieve_body( $response ), 0, 300 ) ), 'reddit' );
return null;
}

22
includes/providers/class-reddit-provider.php
View File

@@ -9,14 +9,14 @@ declare(strict_types=1);
* storing them in the ab_source_data table.
*
* Triggered by: Source_Collector calls collect_data() on each enabled provider.
* Dependencies: Autoblogger_Reddit_API_Client (for HTTP calls and auth).
* Dependencies: PRAutoBlogger_Reddit_API_Client (for HTTP calls and auth).
*
* @see interface-source-provider.php — Interface this class implements.
* @see providers/class-reddit-api-client.php — HTTP client for Reddit API.
* @see core/class-source-collector.php — Orchestrates collection from all providers.
* @see ARCHITECTURE.md — External API integrations table.
*/
class Autoblogger_Reddit_Provider implements Autoblogger_Source_Provider_Interface {
class PRAutoBlogger_Reddit_Provider implements PRAutoBlogger_Source_Provider_Interface {
/**
* Collect posts and comments from configured subreddits.
@@ -34,16 +34,16 @@ class Autoblogger_Reddit_Provider implements Autoblogger_Source_Provider_Interfa
* comments_per_post?: int,
* } $config Collection configuration.
*
* @return Autoblogger_Source_Data[]
* @return PRAutoBlogger_Source_Data[]
*
* @throws \RuntimeException On authentication failure or API error.
*/
public function collect_data( array $config ): array {
$api_client = new Autoblogger_Reddit_API_Client();
$api_client = new PRAutoBlogger_Reddit_API_Client();
$token = $api_client->get_access_token();
if ( '' === $token ) {
throw new \RuntimeException(
__( 'Reddit authentication failed. Check client ID and secret in settings.', 'autoblogger' )
__( 'Reddit authentication failed. Check client ID and secret in settings.', 'prautoblogger' )
);
}
@@ -62,7 +62,7 @@ class Autoblogger_Reddit_Provider implements Autoblogger_Source_Provider_Interfa
$posts = $api_client->fetch_posts( $token, $subreddit, $limit, $time_filter );
foreach ( $posts as $post ) {
$collected[] = new Autoblogger_Source_Data( [
$collected[] = new PRAutoBlogger_Source_Data( [
'source_type' => 'reddit',
'source_id' => 't3_' . $post['id'],
'subreddit' => $subreddit,
@@ -92,7 +92,7 @@ class Autoblogger_Reddit_Provider implements Autoblogger_Source_Provider_Interfa
);
foreach ( $comments as $comment ) {
$collected[] = new Autoblogger_Source_Data( [
$collected[] = new PRAutoBlogger_Source_Data( [
'source_type' => 'reddit',
'source_id' => 't1_' . $comment['id'],
'subreddit' => $subreddit,
@@ -115,7 +115,7 @@ class Autoblogger_Reddit_Provider implements Autoblogger_Source_Provider_Interfa
}
} catch ( \Exception $e ) {
// Log but continue with other subreddits.
Autoblogger_Logger::instance()->error(
PRAutoBlogger_Logger::instance()->error(
sprintf( 'Reddit: Failed to collect from r/%s: %s', $subreddit, $e->getMessage() ),
'reddit'
);
@@ -140,7 +140,7 @@ class Autoblogger_Reddit_Provider implements Autoblogger_Source_Provider_Interfa
* @return bool
*/
public function validate_credentials(): bool {
$api_client = new Autoblogger_Reddit_API_Client();
$api_client = new PRAutoBlogger_Reddit_API_Client();
$token = $api_client->get_access_token( true );
return '' !== $token;
}
@@ -153,7 +153,7 @@ class Autoblogger_Reddit_Provider implements Autoblogger_Source_Provider_Interfa
public function get_rate_limit_status(): array {
// Reddit rate limits are tracked per-response via headers.
// We store the last seen values in a transient.
$status = get_transient( 'autoblogger_reddit_rate_limit' );
$status = get_transient( 'prautoblogger_reddit_rate_limit' );
if ( is_array( $status ) ) {
return $status;
}
@@ -171,7 +171,7 @@ class Autoblogger_Reddit_Provider implements Autoblogger_Source_Provider_Interfa
* @return string[]
*/
private function get_configured_subreddits(): array {
$json = get_option( 'autoblogger_target_subreddits', '[]' );
$json = get_option( 'prautoblogger_target_subreddits', '[]' );
$list = json_decode( $json, true );
return is_array( $list ) ? $list : [];
}

6
includes/providers/class-tiktok-provider.php
View File

@@ -13,16 +13,16 @@ declare(strict_types=1);
* @see interface-source-provider.php — Interface this class implements.
* @see ARCHITECTURE.md — Planned source providers.
*/
class Autoblogger_Tiktok_Provider implements Autoblogger_Source_Provider_Interface {
class PRAutoBlogger_Tiktok_Provider implements PRAutoBlogger_Source_Provider_Interface {
/**
* @param array<string, mixed> $config
* @return Autoblogger_Source_Data[]
* @return PRAutoBlogger_Source_Data[]
* @throws \RuntimeException Always — not yet implemented.
*/
public function collect_data( array $config ): array {
throw new \RuntimeException(
__( 'TikTok source provider is not yet implemented. Remove "tiktok" from enabled sources.', 'autoblogger' )
__( 'TikTok source provider is not yet implemented. Remove "tiktok" from enabled sources.', 'prautoblogger' )
);
}

6
includes/providers/class-youtube-provider.php
View File

@@ -12,16 +12,16 @@ declare(strict_types=1);
*
* @see interface-source-provider.php — Interface this class implements.
*/
class Autoblogger_Youtube_Provider implements Autoblogger_Source_Provider_Interface {
class PRAutoBlogger_Youtube_Provider implements PRAutoBlogger_Source_Provider_Interface {
/**
* @param array<string, mixed> $config
* @return Autoblogger_Source_Data[]
* @return PRAutoBlogger_Source_Data[]
* @throws \RuntimeException Always — not yet implemented.
*/
public function collect_data( array $config ): array {
throw new \RuntimeException(
__( 'YouTube source provider is not yet implemented. Remove "youtube" from enabled sources.', 'autoblogger' )
__( 'YouTube source provider is not yet implemented. Remove "youtube" from enabled sources.', 'prautoblogger' )
);
}

2
includes/providers/interface-llm-provider.php
View File

@@ -11,7 +11,7 @@ declare(strict_types=1);
* @see CONVENTIONS.md — "How To: Add a New LLM Provider".
* @see ARCHITECTURE.md — External API integrations table.
*/
interface Autoblogger_LLM_Provider_Interface {
interface PRAutoBlogger_LLM_Provider_Interface {
/**
* Send a chat completion request to the LLM.

4
includes/providers/interface-source-provider.php
View File

@@ -11,7 +11,7 @@ declare(strict_types=1);
* @see core/class-source-collector.php — Orchestrates collection from all providers.
* @see CONVENTIONS.md — "How To: Add a New Source Provider".
*/
interface Autoblogger_Source_Provider_Interface {
interface PRAutoBlogger_Source_Provider_Interface {
/**
* Collect posts/comments from this social platform.
@@ -23,7 +23,7 @@ interface Autoblogger_Source_Provider_Interface {
* keywords?: string[],
* } $config Source-specific configuration.
*
* @return Autoblogger_Source_Data[] Array of collected data objects.
* @return PRAutoBlogger_Source_Data[] Array of collected data objects.
*
* @throws \RuntimeException On API error after retries exhausted.
*/