From 75e327c7ec4ed6a4ee7a482e84ccfe7c87d3c859 Mon Sep 17 00:00:00 2001
From: Israel Cefrin <israel.cefrin@gmail.com>
Date: Wed, 18 Mar 2026 12:20:06 -0400
Subject: [PATCH] Add language information to plugin XML requirements

Updated the XML requirements for plugins to include available languages.
It partially fulfills the task in the following issue: https://github.com/pkp/pkp-lib/issues/12466

It has been discussed and worked during PKP Virtual Sprint 2026.
It should be merge only after the PR's in the original issue have been completed and merge as well.
---
 dev/plugin-guide/en/release.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/dev/plugin-guide/en/release.md b/dev/plugin-guide/en/release.md
index 7804985b1812..1dc760d98770 100644
--- a/dev/plugin-guide/en/release.md
+++ b/dev/plugin-guide/en/release.md
@@ -50,7 +50,7 @@ pkp-plugin release pluginName --newversion 1.0.0.0
 
 When you have prepared your release package and made it publicly available, open a pull request on our [plugin gallery repository](https://github.com/pkp/plugin-gallery/) that adds your plugin to the XML file.
 
-Your plugin's XML must provide a title, description, contact details, and information on each release package.
+Your plugin's XML must provide a title, description, contact details, and information, including available languages, on each release package.
 
 ```xml
 <!-- The product should match the directory name of the plugin. -->
@@ -100,6 +100,14 @@ Your plugin's XML must provide a title, description, contact details, and inform
     </compatibility>
     <certification type="official"/>
     <description>Initial release.</description>
+
+    <!-- Languages available to the plugin -->
+    <locales>
+        <locale>en</subset>
+        <locale>fr</subset>
+        <locale>es</subset>
+        <!-- ... other languages to be added as translations are completed -->
+    </locales>
   </release>
 </plugin>
 ```