onlyoffice-nextcloud/lib/TemplateProvider.php

<?php
/**
 *
 * (c) Copyright Ascensio System SIA 2025
 *
 * This program is a free software product.
 * You can redistribute it and/or modify it under the terms of the GNU Affero General Public License
 * (AGPL) version 3 as published by the Free Software Foundation.
 * In accordance with Section 7(a) of the GNU AGPL its Section 15 shall be amended to the effect
 * that Ascensio System SIA expressly excludes the warranty of non-infringement of any third-party rights.
 *
 * This program is distributed WITHOUT ANY WARRANTY;
 * without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * For details, see the GNU AGPL at: http://www.gnu.org/licenses/agpl-3.0.html
 *
 * You can contact Ascensio System SIA at 20A-12 Ernesta Birznieka-Upisha street, Riga, Latvia, EU, LV-1050.
 *
 * The interactive user interfaces in modified source and object code versions of the Program
 * must display Appropriate Legal Notices, as required under Section 5 of the GNU AGPL version 3.
 *
 * Pursuant to Section 7(b) of the License you must retain the original Product logo when distributing the program.
 * Pursuant to Section 7(e) we decline to grant you any rights under trademark law for use of our trademarks.
 *
 * All the Product's GUI elements, including illustrations and icon sets, as well as technical
 * writing content are licensed under the terms of the Creative Commons Attribution-ShareAlike 4.0 International.
 * See the License terms at http://creativecommons.org/licenses/by-sa/4.0/legalcode
 *
 */

namespace OCA\Onlyoffice;

use OCP\Files\File;
use OCP\Files\Template\ICustomTemplateProvider;
use OCP\Files\Template\Template;
use OCP\IURLGenerator;

class TemplateProvider implements ICustomTemplateProvider {

    /**
     * Application name
     *
     * @var string
     */
    private $appName;

    /**
     * Url generator service
     *
     * @var IURLGenerator
     */
    private $urlGenerator;

    /**
     * @param string $AppName - application name
     * @param IURLGenerator $urlGenerator - url generator service
     */
    public function __construct($AppName, IURLGenerator $urlGenerator) {
        $this->appName = $AppName;
        $this->urlGenerator = $urlGenerator;
    }

    /**
     * Return a list of additional templates that the template provider is offering
     *
     * @param string $template - mimetype of the template
     *
     * @return array
     */
    public function getCustomTemplates($mimetype) : array {
        $templates = [];

        $templateFiles = TemplateManager::getGlobalTemplates($mimetype);

        foreach ($templateFiles as $templateFile) {
            $template = new Template(
                TemplateProvider::class,
                $templateFile->getId(),
                $templateFile
            );

            $template->setCustomPreviewUrl($this->urlGenerator->linkToRouteAbsolute($this->appName . ".template.preview", ["fileId" => $templateFile->getId()]));

            array_push($templates, $template);
        }

        return $templates;
    }

    /**
     * Return the file for a given template id
     *
     * @param string $templateId - identifier of the template
     *
     * @return File
     */
    public function getCustomTemplate($templateId) : File {
        return TemplateManager::getTemplate($templateId);
    }
}