From bd3a73646fb324f964fa9cfeac993b0b453bb2ae Mon Sep 17 00:00:00 2001
From: Laurent Destailleur <eldy@destailleur.fr>
Date: Thu, 24 Aug 2023 15:18:24 +0200
Subject: [PATCH] Fix lost files in custom

---
 htdocs/custom/.gitignore |  4 ++++
 htdocs/custom/README.md  | 27 +++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 htdocs/custom/.gitignore
 create mode 100644 htdocs/custom/README.md

diff --git a/htdocs/custom/.gitignore b/htdocs/custom/.gitignore
new file mode 100644
index 00000000000..9420e8c61eb
--- /dev/null
+++ b/htdocs/custom/.gitignore
@@ -0,0 +1,4 @@
+/*
+!.gitignore
+!README.md
+!index.html
diff --git a/htdocs/custom/README.md b/htdocs/custom/README.md
new file mode 100644
index 00000000000..2fc3067f204
--- /dev/null
+++ b/htdocs/custom/README.md
@@ -0,0 +1,27 @@
+# DOLIBARR ERP & CRM custom directory for external modules
+
+This directory is dedicated to store external modules.
+To use it, just copy here the directory of the module into this directory.
+
+Note: On linux or MAC systems, it is better to unzip/store the external module directory into
+a different place than this directory and just adding a symbolic link here to the htdocs directory
+of the module.
+
+For example on Linux OS: Get the module from the command
+
+`mkdir ~/git; cd ~/git`
+
+`git clone https://git.framasoft.org/p/newmodule/newmodule.git`
+
+Then create the symbolic link
+
+`ln -fs ~/git/newmodule/htdocs /path_to_dolibarr/htdocs/custom/newmodule`
+
+WARNING !!!
+Check also that the /custom directory is active by adding into dolibarr `conf/conf.php` file the following
+two lines, so dolibarr will also scan /custom directory to find external external modules:
+
+```php
+$dolibarr_main_url_root_alt='/custom';
+$dolibarr_main_document_root_alt='/path_to_dolibarr/htdocs/custom/';
+```