# yaymail/trunk/src/TemplateLibrary/TemplateLibraryService.php

YayMail – WooCommerce Email Customizer, version trunk. 157 lines.

- Page: https://pluginprobe.com/plugins/yaymail/trunk/code/src/TemplateLibrary/TemplateLibraryService.php
- Raw: https://pluginprobe.com/plugins/yaymail/trunk/raw/src/TemplateLibrary/TemplateLibraryService.php
- Modified: 2026-08-23T09:24:58+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/yaymail/trunk/code/src/TemplateLibrary/TemplateLibraryService.php#L10-L20`.

```php
<?php

namespace YayMail\TemplateLibrary;

use YayMail\Abstracts\BaseTemplate;
use YayMail\Models\LibraryTemplateModel;
use YayMail\Utils\SingletonTrait;

/**
 * Service responsible for registering and exposing code-defined email templates
 * for the Template Library feature.
 */
class TemplateLibraryService {
    use SingletonTrait;

    /**
     * @var BaseTemplate[]
     */
    protected $templates = [];

    /**
     * Constructor.
     *
     * @return void
     */
    protected function __construct() {
    }

    /**
     * Programmatically register a template class.
     *
     * @param BaseTemplate $template Template instance.
     *
     * @return void
     */
    public function register( BaseTemplate $template ) {
        if ( ! $template instanceof BaseTemplate ) {
            return;
        }

        if ( in_array( $template, $this->templates, true ) ) {
            return;
        }

        $template_key = $template->get_id();

        $this->templates[ $template_key ] = $template;
    }

    /**
     * Get list of template summaries for given email type
     *
     * @param string $email_type YayMail email/template name. Example: 'new_order'.
     *
     * @return array[]
     */
    public function get_list( $email_type ) {
        $results = [];

        foreach ( $this->templates as $template ) {
            if ( $template->get_email_type() !== $email_type ) {
                continue;
            }

            $results[] = $template->get_template_data();
        }

        usort(
            $results,
            function( $a, $b ) {
                $date_a = strtotime( (string) ( $a['modified_date'] ?? '' ) );
                $date_b = strtotime( (string) ( $b['modified_date'] ?? '' ) );
                $date_a = false === $date_a ? 0 : (int) $date_a;
                $date_b = false === $date_b ? 0 : (int) $date_b;
                $day_a  = $date_a > 0 ? date( 'Y-m-d', $date_a ) : '';
                $day_b  = $date_b > 0 ? date( 'Y-m-d', $date_b ) : '';

                if ( $day_a === $day_b ) {
                    return strnatcasecmp( (string) ( $a['name'] ?? '' ), (string) ( $b['name'] ?? '' ) );
                }

                return strcmp( $day_b, $day_a );
            }
        );

        return $results;
    }

    /**
     * Built-in + user-saved templates for the library modal.
     * Order: saved (newest first via DB query), then builtin (newest update first, then name).
     *
     * @param string $email_type Email type slug.
     *
     * @return array[]
     */
    public function get_merged_list( $email_type ) {
        $builtin = $this->get_list( $email_type );

        $saved = LibraryTemplateModel::list_by_email_type( $email_type );

        $saved = array_map(
            function( $template ) {
                $template['source'] = 'saved';
                return $template;
            },
            $saved
        );

        return array_merge( $saved, $builtin );
    }

    /**
     * Email types eligible for scope "all" bulk save.
     * Uses registered YayMail emails (same pool as editable customizer emails).
     *
     * @return string[]
     */
    public function get_supported_email_types_for_library() {
        $types = [];

        if ( ! function_exists( 'yaymail_get_emails' ) ) {
            return $types;
        }

        foreach ( yaymail_get_emails() as $email ) {
            $template_id = $email->get_id();
            if ( ! self::is_library_bulk_email_type( $template_id ) ) {
                continue;
            }
            $types[] = $template_id;
        }

        return $types;
    }

    /**
     * @param string|null $template_id Template id.
     *
     * @return bool
     */
    private static function is_library_bulk_email_type( $template_id ) {
        if ( empty( $template_id ) || ! is_string( $template_id ) ) {
            return false;
        }

        if ( 0 === strpos( $template_id, 'pattern_' ) ) {
            return false;
        }

        if ( 0 === strpos( $template_id, 'wp-core-' ) ) {
            return false;
        }

        return true;
    }
}
```