dsifford/academic-bloggers-toolkit

<?php
/**
 * Plugin Name: Academic Blogger's Toolkit
 * Plugin URI: https://github.com/dsifford/academic-bloggers-toolkit/
 * Description: A plugin extending the functionality of WordPress for academic blogging
 * Version: {{VERSION}}
 * Author: Derek P Sifford
 * Author URI: https://github.com/dsifford
 * License: GPL3 or later.
 * License URI: https://www.gnu.org/licenses/gpl-3.0.html
 * Text Domain: academic-bloggers-toolkit
 * Domain Path: /languages
 *
 * @package ABT
 */

declare(strict_types=1);

namespace ABT;

defined( 'ABSPATH' ) || exit;

define(
    'ABT_ACTIONS',
    [
        'SET_CITATION_STYLE' => 'abt-form-set-citation-style',
    ]
);
define( 'ABT_NONCE', 'abt_nonce' );
define( 'ABT_OPTIONS_KEY', 'abt_options' );
define( 'ABT_ROOT_PATH', __DIR__ );
define( 'ABT_ROOT_URI', plugins_url( '', __FILE__ ) );
define( 'ABT_VERSION', '{{VERSION}}' );

use function ABT\Utils\register_script;

/**
 * Load plugin translations.
 */
function plugin_textdomain() {
    load_plugin_textdomain( 'academic-bloggers-toolkit', false, basename( ABT_ROOT_PATH ) . '/languages' );
}
add_action( 'plugins_loaded', __NAMESPACE__ . '\plugin_textdomain' );

/**
 * Cleans up options during uninstall.
 */
function uninstall() {
    delete_option( ABT_OPTIONS_KEY );
}
register_uninstall_hook( __FILE__, __NAMESPACE__ . '\uninstall' );

/**
 * Refactors the defined plugin options.
 *
 * @link https://app.quicktype.io?share=E2qRt1Cg3TR6qmHbXDcY
 */
function refactor_options() {
    $options = get_option( ABT_OPTIONS_KEY );
    if ( version_compare( ABT_VERSION, $options['VERSION'] ?? '0', '>' ) ) {
        $new_options = [
            'VERSION'        => ABT_VERSION,
            'citation_style' => [
                'kind'  => $options['citation_style']['kind'] ?? 'predefined',
                'label' => $options['citation_style']['label'] ?? 'American Medical Association',
                'value' => $options['citation_style']['value'] ?? 'american-medical-association',
            ],
        ];
        update_option( ABT_OPTIONS_KEY, $new_options );
    }
}
add_action( 'admin_init', __NAMESPACE__ . '\refactor_options' );

/**
 * Adds link on the plugin page to the options page.
 *
 * @param string[] $links array of links.
 */
function add_options_link( array $links ): array {
    $url  = admin_url( 'options-general.php?page=abt-options' );
    $text = __( 'Plugin Settings', 'academic-bloggers-toolkit' );
    return array_merge( $links, [ "<a href='$url'>$text</a>" ] );
}
add_filter( 'plugin_action_links_' . plugin_basename( __FILE__ ), __NAMESPACE__ . '\add_options_link' );

/**
 * Adds donation link to the plugin meta.
 *
 * @param mixed[] $links The array having default links for the plugin.
 * @param string  $file  The name of the plugin file.
 */
function add_donate_link( array $links, string $file ): array {
    if ( plugin_basename( __FILE__ ) === $file ) {
        $links[] = sprintf(
            '&hearts; <a href="%s">%s</a>',
            'https://donorbox.org/academic-bloggers-toolkit',
            __( 'Donate', 'academic-bloggers-toolkit' )
        );
    }
    return $links;
}
add_filter( 'plugin_row_meta', __NAMESPACE__ . '\add_donate_link', 10, 2 );

/**
 * Registers all scripts/styles used by this plugin.
 */
function register_scripts() {
    //
    // Editor.
    //
    register_script( 'editor-stores' );
    register_script(
        'editor-blocks',
        [
            'abt-editor-stores',
        ]
    );
    register_script(
        'editor-formats',
        [
            'abt-editor-stores',
        ]
    );
    register_script(
        'editor',
        [
            'abt-editor-blocks',
            'abt-editor-formats',
            'abt-editor-stores',
        ]
    );

    //
    // Options Page.
    //
    register_script( 'options-page' );

    //
    // Frontend.
    //
    register_script( 'frontend' );

    //
    // Vendor.
    //
    wp_register_script(
        'citeproc',
        ABT_ROOT_URI . '/vendor/citeproc.js',
        [],
        filemtime( ABT_ROOT_PATH . '/vendor/citeproc.js' ),
        true
    );

    //
    // Third party.
    //
    wp_register_script(
        'codepen',
        '//assets.codepen.io/assets/embed/ei.js',
        [],
        ABT_VERSION,
        true
    );
}
add_action( 'wp_loaded', __NAMESPACE__ . '\register_scripts' );

/**
 * Adds an ajax nonce to pages that require it.
 */
function ajax_nonce() {
    ?>
    <script type="text/javascript">
        window._abt_nonce = '<?php echo esc_html( wp_create_nonce( 'abt-ajax' ) ); ?>'
    </script>
    <?php
}
add_action( 'admin_head-post-new.php', __NAMESPACE__ . '\ajax_nonce' );
add_action( 'admin_head-post.php', __NAMESPACE__ . '\ajax_nonce' );
add_action( 'admin_head-settings_page_abt-options', __NAMESPACE__ . '\ajax_nonce' );

require_once __DIR__ . '/php/utils.php';
require_once __DIR__ . '/php/endpoints.php';

if ( is_admin() ) {
    require_once __DIR__ . '/php/editor.php';
    require_once __DIR__ . '/php/options.php';
} else {
    require_once __DIR__ . '/php/frontend.php';
}