aboutsummaryrefslogtreecommitdiffstats
path: root/lib/public/Files/Template/Template.php
blob: 7f01c2afa48fef910c7e82dd4ad4d71b9b0b754c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
<?php

declare(strict_types=1);

/**
 * SPDX-FileCopyrightText: 2021 Nextcloud GmbH and Nextcloud contributors
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */
namespace OCP\Files\Template;

use OCP\Files\File;

/**
 * @since 21.0.0
 */
final class Template implements \JsonSerializable {
	/** @var string */
	private $templateType;
	/** @var string */
	private $templateId;
	/** @var File */
	private $file;
	/** @var bool */
	private $hasPreview = false;
	/** @var string|null */
	private $previewUrl = null;
	/** @var list<Field> */
	private $fields = [];

	/**
	 * @since 21.0.0
	 */
	public function __construct(string $templateType, string $templateId, File $file) {
		$this->templateType = $templateType;
		$this->templateId = $templateId;
		$this->file = $file;
	}

	/**
	 * @since 21.0.0
	 */
	public function setCustomPreviewUrl(string $previewUrl): void {
		$this->previewUrl = $previewUrl;
	}

	/**
	 * @since 21.0.0
	 */
	public function setHasPreview(bool $hasPreview): void {
		$this->hasPreview = $hasPreview;
	}

	/**
	 * @param list<Field> $fields
	 * @since 30.0.0
	 */
	public function setFields(array $fields): void {
		$this->fields = $fields;
	}

	/**
	 * @return array{
	 *     templateType: string,
	 *     templateId: string,
	 *     basename: string,
	 *     etag: string,
	 *     fileid: int,
	 *     filename: string,
	 *     lastmod: int,
	 *     mime: string,
	 *     size: int|float,
	 *     type: string,
	 *     hasPreview: bool,
	 *     previewUrl: ?string,
	 *     fields: list<array{
	 *         index: string,
	 *         type: string,
	 *         alias: ?string,
	 *         tag: ?string,
	 *         id: ?int,
	 *     	   content?: string,
	 *         checked?: bool,
	 *     }>,
	 * }
	 * @since 21.0.0
	 */
	public function jsonSerialize(): array {
		return [
			'templateType' => $this->templateType,
			'templateId' => $this->templateId,
			'basename' => $this->file->getName(),
			'etag' => $this->file->getEtag(),
			'fileid' => $this->file->getId(),
			'filename' => $this->templateId,
			'lastmod' => $this->file->getMTime(),
			'mime' => $this->file->getMimetype(),
			'size' => $this->file->getSize(),
			'type' => $this->file->getType(),
			'hasPreview' => $this->hasPreview,
			'previewUrl' => $this->previewUrl,
			'fields' => array_map(static fn (Field $field) => $field->jsonSerialize(), $this->fields),
		];
	}
}