Umbra-Bookshelf/umbra-bookshelf/includes/library/class-umbra-library-install.php

<?php
// Copyright 2026 Umbra Tools (umbratools.com)
// SPDX-License-Identifier: GPL-2.0-or-later

/**
 * Installation and Database Setup
 *
 * @package Umbra_Bookshelf_Helper
 */

if (!defined('ABSPATH')) {
    exit;
}

class Umbra_Bookshelf_Helper_Install {
    /**
     * Activate plugin
     */
    public static function activate() {
        self::create_tables();
        self::create_roles();
        flush_rewrite_rules();
    }

    /**
     * Deactivate plugin
     */
    public static function deactivate() {
        self::remove_roles();
        wp_clear_scheduled_hook('bd_bookshelf_goodreads_refresh');
        wp_clear_scheduled_hook('bd_bookshelf_amazon_scrape');
        flush_rewrite_rules();
    }

    /**
     * Create database tables
     *
     * {prefix}bd_books and {prefix}bd_series are NOT created here. Those two
     * table names are owned by the catalogue module (Umbra_Database), whose
     * schema is canonical. This module previously created them with a
     * different column set, so activating both plugins meant one silently
     * created the table and the other read it against the wrong shape.
     *
     * Existing library-shaped installations are reconciled by
     * Umbra_Schema_Migration, which runs before this method.
     *
     * @see \Umbra_Schema_Migration::maybe_migrate()
     */
    public static function create_tables() {
        global $wpdb;
        $charset_collate = $wpdb->get_charset_collate();

        $tables = array(
            "CREATE TABLE IF NOT EXISTS {$wpdb->prefix}bd_book_meta (
                id BIGINT(20) NOT NULL AUTO_INCREMENT PRIMARY KEY,
                book_id BIGINT(20) NOT NULL,
                language_code VARCHAR(5) NOT NULL,
                title VARCHAR(255),
                blurb TEXT,
                preview_excerpt TEXT,
                pull_quotes JSON,
                UNIQUE KEY book_language (book_id, language_code)
            ) $charset_collate;",

            "CREATE TABLE IF NOT EXISTS {$wpdb->prefix}bd_pen_names (
                id BIGINT(20) NOT NULL AUTO_INCREMENT PRIMARY KEY,
                pen_name VARCHAR(255) NOT NULL,
                notes TEXT,
                active TINYINT(1) DEFAULT 1,
                created_at DATETIME DEFAULT CURRENT_TIMESTAMP
            ) $charset_collate;",

            "CREATE TABLE IF NOT EXISTS {$wpdb->prefix}bd_reviews (
                id BIGINT(20) NOT NULL AUTO_INCREMENT PRIMARY KEY,
                book_id BIGINT(20) NOT NULL,
                comment_text TEXT,
                synopsis TEXT,
                source_name VARCHAR(255) NOT NULL,
                source_url VARCHAR(500),
                display_order INT(11) DEFAULT 0,
                KEY book_id (book_id)
            ) $charset_collate;",

            "CREATE TABLE IF NOT EXISTS {$wpdb->prefix}bd_ratings (
                id BIGINT(20) NOT NULL AUTO_INCREMENT PRIMARY KEY,
                book_id BIGINT(20) NOT NULL,
                source VARCHAR(20) NOT NULL,
                rating DECIMAL(3,2),
                review_count INT(11),
                last_updated DATETIME DEFAULT CURRENT_TIMESTAMP,
                UNIQUE KEY book_source (book_id, source)
            ) $charset_collate;",

            "CREATE TABLE IF NOT EXISTS {$wpdb->prefix}bd_review_shortlinks (
                id BIGINT(20) NOT NULL AUTO_INCREMENT PRIMARY KEY,
                book_id BIGINT(20) NOT NULL,
                site_code VARCHAR(5) NOT NULL,
                slug VARCHAR(20) NOT NULL UNIQUE,
                destination_url VARCHAR(500),
                status VARCHAR(20) DEFAULT 'pending',
                created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
                activated_at DATETIME
            ) $charset_collate;",
        );

        require_once ABSPATH . 'wp-admin/includes/upgrade.php';

        foreach ($tables as $table) {
            dbDelta($table);
        }

        self::install_sample_data();
    }

    /**
     * Install sample data
     */
    private static function install_sample_data() {
        global $wpdb;

        // Add default pen name
        $pen_names_table = $wpdb->prefix . 'bd_pen_names';
        $exists = $wpdb->get_var("SELECT COUNT(*) FROM {$pen_names_table}");

        if ($exists == 0) {
            $wpdb->insert($pen_names_table, array(
                'pen_name'   => 'B.D. Murphy',
                'notes'      => 'Primary author name',
                'active'     => 1,
                'created_at' => current_time('mysql'),
            ));
        }

        // Set default Goodreads ID
        update_option('bdm_goodreads_author_id', '30469651');
    }

    /**
     * Create roles
     */
    private static function create_roles() {
        add_role('book_manager', esc_html__('Book Manager', 'umbra-bookshelf'), array(
            'read'                   => true,
            'edit_books'             => true,
            'edit_others_books'      => true,
            'publish_books'          => true,
            'read_private_posts'     => true,
            'edit_posts'             => true,
            'edit_others_posts'      => true,
            'publish_posts'          => true,
            'upload_files'           => true,
        ));
    }

    /**
     * Remove roles
     */
    private static function remove_roles() {
        remove_role('book_manager');
    }
}