From: Matthias Schmidt <gravatronics@live.com>
Date: Tue, 8 Jun 2021 16:07:22 +0000 (+0200)
Subject: Document `templateDelete` PIP
X-Git-Tag: 5.6.final~230^2~2
X-Git-Url: https://git.stricted.de/?a=commitdiff_plain;h=3bccd391ce7fc572fbf733df9011ead9d5da7887;p=GitHub%2FWoltLab%2Fwoltlab.github.io.git

Document `templateDelete` PIP
---

diff --git a/docs/package/pip.md b/docs/package/pip.md
index 1c998353..6a0fa279 100644
--- a/docs/package/pip.md
+++ b/docs/package/pip.md
@@ -36,6 +36,7 @@ Package Installation Plugins (PIPs) are interfaces to deploy and edit content as
 | [sql](pip/sql.md) | Execute SQL instructions using a MySQL-flavored syntax (also see [database PHP API](database-php-api.md)) |
 | [style](pip/style.md) | Style |
 | [template](pip/template.md) | Frontend templates |
+| [templateDelete](pip/template-delete.md) | Deletes frontend templates installed with [template](pip/template.md) |
 | [templateListener](pip/template-listener.md) | Embed template code into templates without altering the original |
 | [userGroupOption](pip/user-group-option.md) | Permissions for user groups |
 | [userMenu](pip/user-menu.md) | User menu categories and items |
diff --git a/docs/package/pip/template-delete.md b/docs/package/pip/template-delete.md
new file mode 100644
index 00000000..c72b7910
--- /dev/null
+++ b/docs/package/pip/template-delete.md
@@ -0,0 +1,19 @@
+# Template Delete Package Installation Plugin
+
+Deletes frontend templates installed with the [acpTemplate](pip/acp-template.md) package installation plugin.
+
+!!! warning "You cannot delete templates provided by other packages."
+
+
+## Components
+
+Each item is described as a `<template>` element with an optional `application`, which behaves like it does for [acp templates](acp-template.md#application).
+The templates are identified by their name like when adding [template listeners](template-listener.md), i.e. by the file name without the `.tpl` file extension.
+
+## Example
+
+{jinja{ codebox(
+    title="templateDelete.xml",
+    language="xml",
+    filepath="package/pip/templateDelete.xml"
+) }}
diff --git a/mkdocs.yml b/mkdocs.yml
index 0eba921e..d3dd4492 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -98,6 +98,7 @@ nav:
       - 'sql': 'package/pip/sql.md'
       - 'style': 'package/pip/style.md'
       - 'template': 'package/pip/template.md'
+      - 'templateDelete': 'package/pip/template-delete.md'
       - 'templateListener': 'package/pip/template-listener.md'
       - 'userGroupOption': 'package/pip/user-group-option.md'
       - 'userMenu': 'package/pip/user-menu.md'
diff --git a/snippets/package/pip/templateDelete.xml b/snippets/package/pip/templateDelete.xml
new file mode 100644
index 00000000..2cea5686
--- /dev/null
+++ b/snippets/package/pip/templateDelete.xml
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<data xmlns="http://www.woltlab.com" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.woltlab.com http://www.woltlab.com/XSD/2019/templateDelete.xsd">
+	<delete>
+		<template>fouAdd</template>
+		<template application="app">__appAdd</template>
+	</delete>
+</data>