37cfb2f244
Additive per-step Pipeline Settings page. Reuses the existing model_select picker + versioned prompt registry; no migration. QA APPROVE for eea4968; CI green. Agent-Session: pipeline-settings-m1-merge
113 lines
4.6 KiB
PHP
113 lines
4.6 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* phpcs:ignore WordPress.Files.FileName.InvalidClassFileName -- class naming convention differs from WordPress standard
|
|
*
|
|
* Registers the Pipeline Settings wp-admin submenu page and its assets.
|
|
*
|
|
* What: Adds a "Pipeline" submenu under the PRAutoBlogger parent menu so
|
|
* operators can configure per-step model, system instructions, agent
|
|
* prompts, and parameters for every LLM stage in one place. This
|
|
* page is ADDITIVE in M1 — the existing Settings sections remain
|
|
* unchanged and both surfaces edit the same wp_options / prompts
|
|
* table. Decomposition of redundant tabs is M2.
|
|
* Who calls it: PRAutoBlogger::register_admin_hooks() via add_action
|
|
* ('admin_menu', ..., 13) and ('admin_enqueue_scripts', ...).
|
|
* Dependencies: PRAutoBlogger_Pipeline_Settings_Save_Handler (save),
|
|
* PRAutoBlogger_Pipeline_Settings_Renderer (render).
|
|
*
|
|
* @see admin/class-pipeline-settings-renderer.php — Step rail + panel HTML.
|
|
* @see admin/class-pipeline-settings-save-handler.php — nonce + save logic.
|
|
* @see admin/class-admin-page.php — Parent menu registration (priority 10).
|
|
* @see ARCHITECTURE.md — Admin pages table.
|
|
* @see INFORMATION-ARCHITECTURE.md — Admin page slug registry.
|
|
*/
|
|
class PRAutoBlogger_Pipeline_Settings_Page {
|
|
|
|
/** wp-admin page slug. */
|
|
public const PAGE_SLUG = 'prautoblogger-pipeline';
|
|
|
|
/** Nonce action for saving prompt edits on this page. */
|
|
public const NONCE_ACTION = 'prautoblogger_pipeline_save';
|
|
|
|
/** Nonce field name posted with the save form. */
|
|
public const NONCE_FIELD = 'prautoblogger_pipeline_nonce';
|
|
|
|
/**
|
|
* Register the Pipeline submenu page under the PRAutoBlogger parent menu.
|
|
*
|
|
* Priority 13 — after board (11), dossier (12). The parent slug must be
|
|
* registered at priority 10 by PRAutoBlogger_Admin_Page::on_register_menu()
|
|
* before any submenu can be attached.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function on_register_menu(): void {
|
|
add_submenu_page(
|
|
'prautoblogger-settings',
|
|
__( 'Pipeline Settings', 'prautoblogger' ),
|
|
__( 'Pipeline', 'prautoblogger' ),
|
|
'manage_options',
|
|
self::PAGE_SLUG,
|
|
array( $this, 'render_page' )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Enqueue CSS / JS required by the Pipeline Settings page.
|
|
*
|
|
* Reuses the existing admin + model-picker asset pairs; adds a small
|
|
* pipeline-specific stylesheet and script.
|
|
*
|
|
* @param string $hook_suffix Current admin page hook suffix.
|
|
* @return void
|
|
*/
|
|
public function on_enqueue_assets( string $hook_suffix ): void {
|
|
if ( 'prautoblogger_page_' . self::PAGE_SLUG !== $hook_suffix ) {
|
|
return;
|
|
}
|
|
|
|
wp_enqueue_style( 'prautoblogger-admin', PRAUTOBLOGGER_PLUGIN_URL . 'assets/css/admin.css', array(), PRAUTOBLOGGER_VERSION );
|
|
wp_enqueue_style( 'prautoblogger-model-picker', PRAUTOBLOGGER_PLUGIN_URL . 'assets/css/model-picker.css', array( 'prautoblogger-admin' ), PRAUTOBLOGGER_VERSION );
|
|
wp_enqueue_style( 'prautoblogger-pipeline', PRAUTOBLOGGER_PLUGIN_URL . 'assets/css/pipeline-settings.css', array( 'prautoblogger-admin' ), PRAUTOBLOGGER_VERSION );
|
|
|
|
wp_enqueue_script( 'prautoblogger-admin', PRAUTOBLOGGER_PLUGIN_URL . 'assets/js/admin.js', array( 'jquery' ), PRAUTOBLOGGER_VERSION, true );
|
|
wp_enqueue_script( 'prautoblogger-model-picker', PRAUTOBLOGGER_PLUGIN_URL . 'assets/js/model-picker.js', array( 'jquery', 'prautoblogger-admin' ), PRAUTOBLOGGER_VERSION, true );
|
|
wp_enqueue_script( 'prautoblogger-pipeline', PRAUTOBLOGGER_PLUGIN_URL . 'assets/js/pipeline-settings.js', array( 'jquery', 'prautoblogger-admin' ), PRAUTOBLOGGER_VERSION, true );
|
|
|
|
wp_localize_script(
|
|
'prautoblogger-admin',
|
|
'prautobloggerAdmin',
|
|
array(
|
|
'ajaxUrl' => admin_url( 'admin-ajax.php' ),
|
|
'adminUrl' => admin_url(),
|
|
'siteUrl' => home_url( '/' ),
|
|
'modelsNonce' => wp_create_nonce( 'prautoblogger_get_models' ),
|
|
'imageModels' => PRAutoBlogger_Settings_Fields_Extended::get_image_models(),
|
|
)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Render the Pipeline Settings page.
|
|
*
|
|
* Capability check first; then delegate to the save handler (processes
|
|
* POST before output starts) and the renderer (assembles view data and
|
|
* includes the template).
|
|
*
|
|
* @return void
|
|
*/
|
|
public function render_page(): void {
|
|
if ( ! current_user_can( 'manage_options' ) ) {
|
|
wp_die( esc_html__( 'You do not have permission to access this page.', 'prautoblogger' ) );
|
|
}
|
|
|
|
// Process any pending save before output begins.
|
|
$save_result = PRAutoBlogger_Pipeline_Settings_Save_Handler::maybe_process_save();
|
|
|
|
$renderer = new PRAutoBlogger_Pipeline_Settings_Renderer();
|
|
$renderer->render( $save_result );
|
|
}
|
|
}
|