felixarntz/theme-boilerplate

<?php
/**
 * Super_Awesome_Theme_Stylesheet class
 *
 * @package Super_Awesome_Theme
 * @license GPL-2.0-or-later
 * @link    https://super-awesome-author.org/themes/super-awesome-theme/
 */

/**
 * Class representing a theme stylesheet.
 *
 * @since 1.0.0
 */
class Super_Awesome_Theme_Stylesheet extends Super_Awesome_Theme_Asset {

    /**
     * Media property name.
     *
     * @since 1.0.0
     */
    const PROP_MEDIA = 'media';

    /**
     * Has RTL property name.
     *
     * @since 1.0.0
     */
    const PROP_HAS_RTL = 'has_rtl';

    /**
     * The media for which this stylesheet has been defined.
     *
     * @since 1.0.0
     * @var string
     */
    protected $media;

    /**
     * Whether the stylesheet has a right-to-left version indicated
     * by a '-rtl' suffix before the file extension.
     *
     * @since 1.0.0
     * @var bool
     */
    protected $has_rtl;

    /**
     * Inline styles to print before or after the main stylesheet.
     *
     * @since 1.0.0
     * @var array
     */
    protected $inline_styles = array();

    /**
     * Registers the asset with WordPress.
     *
     * @since 1.0.0
     */
    public function register() {
        $uri = $this->uri;
        if ( $this->min_uri && $this->use_minified() ) {
            $uri = $this->min_uri;
        }

        wp_register_style( $this->handle, $uri, $this->dependencies, $this->version, $this->media );

        if ( $this->has_rtl ) {
            wp_style_add_data( $this->handle, 'rtl', 'replace' );
        }

        foreach ( $this->inline_styles as $inline_style ) {
            wp_add_inline_style( $this->handle, $inline_style['style'] );
        }

        $this->inline_styles = array();
    }

    /**
     * Enqueues the asset in WordPress.
     *
     * @since 1.0.0
     *
     * @throws Super_Awesome_Theme_Asset_Not_Enqueueable_Exception Thrown when the asset is not registered.
     */
    public function enqueue() {
        if ( ! $this->is_registered() ) {
            throw Super_Awesome_Theme_Asset_Not_Enqueueable_Exception::from_handle( $this->handle );
        }

        /**
         * Filters whether a specific stylesheet should be enqueued.
         *
         * @since 1.0.0
         *
         * @param bool                           $enqueue    Whether or not to enqueue the stylesheet.
         * @param Super_Awesome_Theme_Stylesheet $stylesheet The stylesheet instance to enqueue.
         */
        if ( ! apply_filters( 'super_awesome_theme_enqueue_stylesheet', true, $this ) ) {
            return;
        }

        wp_enqueue_style( $this->handle );
    }

    /**
     * Adds an inline style to print before or after the main stylesheet.
     *
     * @since 1.0.0
     *
     * @param string $style CSS code to be printed. Must not contain the style tags.
     */
    public function add_inline_style( $style ) {
        if ( $this->is_registered() ) {
            wp_add_inline_style( $this->handle, $style );
            return;
        }

        $this->inline_styles[] = array(
            'style' => $style,
        );
    }

    /**
     * Checks whether the asset is registered with WordPress.
     *
     * @since 1.0.0
     *
     * @return bool True if registered, false otherwise.
     */
    public function is_registered() {
        return wp_style_is( $this->handle, 'registered' );
    }

    /**
     * Checks whether the asset is enqueued in WordPress.
     *
     * @since 1.0.0
     *
     * @return bool True if enqueued, false otherwise.
     */
    public function is_enqueued() {
        return wp_style_is( $this->handle, 'enqueued' );
    }

    /**
     * Gets the default asset definition properties to set.
     *
     * @since 1.0.0
     *
     * @return array Default asset definition as $prop => $default_value pairs. Each
     *               key present should have a class property of the same name. Defaults
     *               should be present for every asset property, even if the default
     *               is null.
     */
    protected function get_defaults() {
        $defaults                       = parent::get_defaults();
        $defaults[ self::PROP_MEDIA ]   = 'all';
        $defaults[ self::PROP_HAS_RTL ] = false;

        return $defaults;
    }
}