From dbdcb2248d5ae4e5e3f90c720309b205ce599cbb Mon Sep 17 00:00:00 2001 From: Pierrick Le Gall Date: Sun, 5 Jul 2026 15:48:39 +0200 Subject: [PATCH] first set of changes proposed by @GravisTechGregB to work with Gitlab --- Use-a-source-code-manager-for-your-extension.md | 17 ++++++++++------- 1 file changed, 10 insertions(+), 7 deletions(-) diff --git a/Use-a-source-code-manager-for-your-extension.md b/Use-a-source-code-manager-for-your-extension.md index 6a552f9..ba2ebd8 100644 --- a/Use-a-source-code-manager-for-your-extension.md +++ b/Use-a-source-code-manager-for-your-extension.md @@ -13,15 +13,18 @@ Go to [your page](http://piwigo.org/ext/my.php) and select your plugin, then click on the SCM icon ![](http://piwigo.org/ext/template/images/scm.png). -Select Git or SVN and change the URL, don't change the other fields. You -must give the root URL of your repo: +Select Git or SVN and set the **URL** to the root URL of your repository: -- example on Github `https://github.com/Piwigo/ContactForm` -- example on Piwigo.org SVN - `http://piwigo.org/svn/extensions/ContactForm` +- example on Github `https://github.com/Piwigo/ContactForm` +- example on GitLab: `https://gitlab.com/yourname/ContactForm` +- example on Piwigo.org SVN `http://piwigo.org/svn/extensions/ContactForm` -Validate. You should see the correct Github/SVN information in the -bottom block, if not, double check the form. +For **GitHub** and **Piwigo.org SVN** you can leave the remaining fields at their defaults. For **GitLab** (or another generic Git host), check the two archive fields, because GitLab names its tag archives differently: + +- **Archive root directory** — the destination folder name PEM should use, i.e. your plugin's ID (e.g. `ContactForm`). This field accepts letters, digits and underscores only. PEM strips the wrapper folder GitLab puts inside the downloaded archive (e.g. `ContactForm-v1.0/`) and uses this value instead. It **must** match your plugin's install-folder ID. +- **Archive name** — the filename pattern of the archive to download, with `%` standing in for the version number. If your tags are prefixed with `v` (e.g. `v1.0`), this must be `ContactForm-v%.zip` so the `v` lines up with the tag. + +Validate. You should see the correct GitHub / GitLab / SVN information in the bottom block; if not, double check the form — especially the two fields above. #### Release a new revision from your SCM