added Gitea support

Author: Pasquale Pizzuti

README.md

@@ -129,6 +129,7 @@ or the relevant branch in the Plugin's GitHub repository, as per the table below
     * [SourceViewVC](docs/CONFIGURING.SourceViewVC.md)
     * [SourceSVN](docs/CONFIGURING.SourceSVN.md)
     * [SourceVisualSVNServer](docs/CONFIGURING.SourceVisualSVNServer.md)
+    * [SourceGitea](SourceGitea/README.md)
 
 9. Once configured, click the "Return to Repository" link and click either
    the "Import Everything" or "Import Newest Data" button to perform initial

SourceGitea/LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2024 Pasquale Pizzuti
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+

SourceGitea/README.md

@@ -0,0 +1,25 @@
+## One time Mantis source integration setup
+
+ - Copy the source integration plugins into mantis "plugins/" subdirectory
+ - Install required plugins with Mantis plugin admin page
+ - Get the "API Key" (like 'abcdeb8129a4451a35f47881') from the Source Integration plugin "manage_config_page"
+   http://mantis.server.intra/plugin.php?page=Source/manage_config_page
+
+## Gitea setup
+
+ - Login with an Owner (or Administrator) of a Project, go to *Settings -> Webhooks* and
+   add a Gitea hook with Mantis URL and Mantis Source Integration plugin "API Key":
+   `http://mantis.server.intra/plugin.php?page=Source/checkin&api_key=abcdeb8129a4451a35f47881`
+ - Go to your user *Settings -> Applications -> Manage Access Tokens* and create a token. You will need it as "hub_app_secret" in Mantis configuration.
+
+## Mantis repository setup
+
+ - In Mantis administration, create a repository with a unique name and of type "Gitea".
+ - URL field is not used by the plugin.
+ - Gitea config fields are:
+  - hub_root: root url of the Gitea webserver, required to access Web API
+  - hub_ownerid: name of the Gitea repository owner, can be an organization or an user.
+  - hub_repoid: name of the Gitea repository.
+  - hub_app_secret: the "Private token" of a user.
+  - master_branch: use '*' or a list of branches to track
+