e9d97b51e2
Backfill psa_*->_pr_* meta (migration 0004 + PubChem fallback); enrich Drug node with {permalink}#drug @id + molecularFormula/Weight/alternateName; rewrite emitter into Yoast schema graph (MedicalWebPage retype + FAQPage, no duplicate nodes).
QA: APPROVE (independent) — qa-reviews/peptide-repo-core/2026-06-13-817690c1b6ec2118ddcf3b8cfe8bc5ea7f3933b3.md
Agent-Session: peptide-schema-backfill v0.6.0 merge
296 lines
9.3 KiB
PHP
296 lines
9.3 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* Registers the peptide custom post type and associated taxonomy.
|
|
*
|
|
* What: Defines peptide CPT with REST support, archive, and meta fields.
|
|
* Who calls it: PR_Core::init() on plugins_loaded.
|
|
* Dependencies: None.
|
|
*
|
|
* Ownership: As of v0.2.0, PR Core owns the `peptide` CPT and `peptide_category` taxonomy
|
|
* (previously PSA v4.5.0). Registration guarded by post_type_exists/taxonomy_exists
|
|
* so deploy order does not matter.
|
|
*
|
|
* @see ARCHITECTURE.md
|
|
* @see CONVENTIONS.md
|
|
*/
|
|
class PR_Core_Peptide_CPT {
|
|
|
|
/** @var string Post type slug (owned by PR Core since v0.2.0; PSA previously registered this). */
|
|
public const POST_TYPE = 'peptide';
|
|
|
|
/** @var string Taxonomy: category (e.g., GLP-1 agonist). */
|
|
public const TAX_CATEGORY = 'peptide_category';
|
|
|
|
/** @var string Capability required for editing peptide data. */
|
|
public const CAPABILITY = 'manage_peptide_content';
|
|
|
|
/**
|
|
* Evidence strength enum values, ordered weakest to strongest.
|
|
*
|
|
* @var string[]
|
|
*/
|
|
public const EVIDENCE_STRENGTHS = [
|
|
'preclinical',
|
|
'case-series',
|
|
'observational',
|
|
'rct-small',
|
|
'rct-large',
|
|
'meta-analysis',
|
|
];
|
|
|
|
/**
|
|
* Editorial review status enum values.
|
|
*
|
|
* @var string[]
|
|
*/
|
|
public const REVIEW_STATUSES = [
|
|
'draft',
|
|
'in-review',
|
|
'published',
|
|
'retired',
|
|
];
|
|
|
|
/**
|
|
* Post-meta field definitions (1:1 with peptide).
|
|
* Key => [ 'type', 'default', 'sanitize_callback', 'show_in_rest' ].
|
|
*
|
|
* @return array<string, array<string, mixed>>
|
|
*/
|
|
public static function get_meta_fields(): array {
|
|
return [
|
|
'display_name' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_text_field',
|
|
],
|
|
'aliases' => [
|
|
'type' => 'string',
|
|
'default' => '[]',
|
|
'sanitize' => [ PR_Core_Schema_Sanitizers::class, 'sanitize_json_array' ],
|
|
],
|
|
'molecular_formula' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_text_field',
|
|
],
|
|
'molecular_weight' => [
|
|
'type' => 'number',
|
|
'default' => 0,
|
|
'sanitize' => 'floatval',
|
|
],
|
|
'cas_number' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_text_field',
|
|
],
|
|
'drugbank_id' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_text_field',
|
|
],
|
|
'chembl_id' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_text_field',
|
|
],
|
|
'evidence_strength' => [
|
|
'type' => 'string',
|
|
'default' => 'preclinical',
|
|
'sanitize' => [ __CLASS__, 'sanitize_evidence_strength' ],
|
|
],
|
|
'editorial_review_status' => [
|
|
'type' => 'string',
|
|
'default' => 'draft',
|
|
'sanitize' => [ __CLASS__, 'sanitize_review_status' ],
|
|
],
|
|
'last_editorial_review_at' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_text_field',
|
|
],
|
|
'medical_editor_id' => [
|
|
'type' => 'integer',
|
|
'default' => 0,
|
|
'sanitize' => 'absint',
|
|
],
|
|
'_pr_last_source_verified' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_text_field',
|
|
],
|
|
'_pr_last_reviewed' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_text_field',
|
|
],
|
|
'_pr_next_review_by' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_text_field',
|
|
],
|
|
'_pr_verification_velocity' => [
|
|
'type' => 'string',
|
|
'default' => 'medium',
|
|
'sanitize' => [ PR_Core_Verification_Sanitizers::class, 'sanitize_velocity' ],
|
|
],
|
|
'_pr_verification_notes' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => 'sanitize_textarea_field',
|
|
],
|
|
'_pr_verification_status' => [
|
|
'type' => 'string',
|
|
'default' => 'current',
|
|
'sanitize' => [ PR_Core_Verification_Sanitizers::class, 'sanitize_status' ],
|
|
],
|
|
// Schema-input meta (v0.6.0): molecular data sourced from PSA psa_* keys via migration 0004.
|
|
'_pr_molecular_formula' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => [ PR_Core_Schema_Sanitizers::class, 'sanitize_molecular_formula' ],
|
|
],
|
|
'_pr_molecular_weight' => [
|
|
'type' => 'string',
|
|
'default' => '',
|
|
'sanitize' => [ PR_Core_Schema_Sanitizers::class, 'sanitize_molecular_weight_string' ],
|
|
],
|
|
'_pr_aliases' => [
|
|
'type' => 'string',
|
|
'default' => '[]',
|
|
'sanitize' => [ PR_Core_Schema_Sanitizers::class, 'sanitize_json_array' ],
|
|
],
|
|
// FAQ items (v0.6.0): [{question, answer}] JSON for FAQPage schema. Populated by CMO content sprint.
|
|
'_pr_faq_items' => [
|
|
'type' => 'string',
|
|
'default' => '[]',
|
|
'sanitize' => [ PR_Core_Schema_Sanitizers::class, 'sanitize_faq_items' ],
|
|
],
|
|
];
|
|
}
|
|
|
|
/**
|
|
* Register WordPress hooks for CPT and taxonomy registration.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function register_hooks(): void {
|
|
add_action( 'init', [ __CLASS__, 'register_peptide_post_type' ] );
|
|
add_action( 'init', [ __CLASS__, 'register_taxonomies' ] );
|
|
add_action( 'init', [ __CLASS__, 'register_meta_fields' ] );
|
|
}
|
|
|
|
/**
|
|
* Register the `peptide` CPT. Guarded with post_type_exists() so deploy order is irrelevant.
|
|
*
|
|
* Side effects: registers CPT with WordPress.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function register_peptide_post_type(): void {
|
|
if ( post_type_exists( self::POST_TYPE ) ) {
|
|
return;
|
|
}
|
|
|
|
$labels = [
|
|
'name' => __( 'Peptides', 'peptide-repo-core' ),
|
|
'singular_name' => __( 'Peptide', 'peptide-repo-core' ),
|
|
'add_new_item' => __( 'Add New Peptide', 'peptide-repo-core' ),
|
|
'edit_item' => __( 'Edit Peptide', 'peptide-repo-core' ),
|
|
'new_item' => __( 'New Peptide', 'peptide-repo-core' ),
|
|
'view_item' => __( 'View Peptide', 'peptide-repo-core' ),
|
|
'search_items' => __( 'Search Peptides', 'peptide-repo-core' ),
|
|
'not_found' => __( 'No peptides found', 'peptide-repo-core' ),
|
|
'not_found_in_trash' => __( 'No peptides found in trash', 'peptide-repo-core' ),
|
|
'all_items' => __( 'All Peptides', 'peptide-repo-core' ),
|
|
'menu_name' => __( 'Peptides', 'peptide-repo-core' ),
|
|
];
|
|
|
|
// Args harmonized superset of PR Core + PSA for 89 existing posts.
|
|
// Supports union, capability/role perms preserved, slugs unchanged.
|
|
$args = [
|
|
'labels' => $labels,
|
|
'public' => true,
|
|
'publicly_queryable' => true,
|
|
'show_ui' => true,
|
|
'show_in_menu' => true,
|
|
'show_in_nav_menus' => true,
|
|
'show_in_rest' => true,
|
|
'rest_base' => 'peptides',
|
|
// Note: 'rest_namespace' is deliberately omitted. Custom namespaces prevent
|
|
// Gutenberg's block editor from loading posts for editing (it fetches the
|
|
// hardcoded wp/v2 REST route). WordPress defaults to wp/v2 — appropriate for
|
|
// this CPT — and keeps the REST endpoint at /wp-json/wp/v2/peptides/.
|
|
'menu_position' => 25,
|
|
'menu_icon' => 'dashicons-database',
|
|
'capability_type' => 'post',
|
|
'map_meta_cap' => true,
|
|
'hierarchical' => false,
|
|
'has_archive' => true,
|
|
'rewrite' => [ 'slug' => 'peptides', 'with_front' => false ],
|
|
'supports' => [ 'title', 'editor', 'thumbnail', 'excerpt', 'revisions', 'custom-fields' ],
|
|
];
|
|
register_post_type( self::POST_TYPE, $args );
|
|
}
|
|
|
|
/**
|
|
* Register the `peptide_category` taxonomy. Guarded with taxonomy_exists().
|
|
*
|
|
* Side effects: registers taxonomy with WordPress.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function register_taxonomies(): void {
|
|
if ( taxonomy_exists( self::TAX_CATEGORY ) ) {
|
|
return;
|
|
}
|
|
|
|
register_taxonomy( self::TAX_CATEGORY, self::POST_TYPE, [
|
|
'labels' => [
|
|
'name' => __( 'Peptide Categories', 'peptide-repo-core' ),
|
|
'singular_name' => __( 'Peptide Category', 'peptide-repo-core' ),
|
|
],
|
|
'public' => true,
|
|
'publicly_queryable' => true,
|
|
'show_in_rest' => true,
|
|
'show_ui' => true,
|
|
'show_admin_column' => true,
|
|
'hierarchical' => true,
|
|
'rewrite' => [ 'slug' => 'peptide-category', 'with_front' => false ],
|
|
] );
|
|
}
|
|
|
|
/**
|
|
* Register post-meta fields. Auth gated on manage_peptide_content.
|
|
*
|
|
* @return void
|
|
*/
|
|
public static function register_meta_fields(): void {
|
|
foreach ( self::get_meta_fields() as $key => $config ) {
|
|
register_post_meta( self::POST_TYPE, $key, [
|
|
'type' => $config['type'],
|
|
'single' => true,
|
|
'default' => $config['default'],
|
|
'show_in_rest' => true,
|
|
'sanitize_callback' => $config['sanitize'],
|
|
'auth_callback' => static function () {
|
|
return current_user_can( self::CAPABILITY );
|
|
},
|
|
] );
|
|
}
|
|
}
|
|
|
|
/** Sanitize evidence_strength to allowed enum values. */
|
|
public static function sanitize_evidence_strength( $value ): string {
|
|
$value = sanitize_text_field( (string) $value );
|
|
return in_array( $value, self::EVIDENCE_STRENGTHS, true ) ? $value : 'preclinical';
|
|
}
|
|
|
|
/** Sanitize editorial_review_status to allowed enum values. */
|
|
public static function sanitize_review_status( $value ): string {
|
|
$value = sanitize_text_field( (string) $value );
|
|
return in_array( $value, self::REVIEW_STATUSES, true ) ? $value : 'draft';
|
|
}
|
|
}
|