From 2ed9fbd65b53f01b8612536f3369a560e5481c68 Mon Sep 17 00:00:00 2001
From: eric_G <46165813+ericgaspar@users.noreply.github.com>
Date: Sun, 8 Oct 2023 18:24:47 +0200
Subject: [PATCH] Mail (#139)

* fix mail

* Auto-update README

* Update .env.example

* Update .env.example

* Update .env.example

* Update .env.example

* Update .env.example

---------

Co-authored-by: yunohost-bot <yunohost@yunohost.org>
---
 README.md         |  1 -
 README_fr.md      |  1 -
 conf/.env.example | 29 ++++++++++++++++++-----------
 manifest.toml     |  1 +
 4 files changed, 19 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index dab8782..60dbd71 100644
--- a/README.md
+++ b/README.md
@@ -43,7 +43,6 @@ BookStack is an opinionated wiki system that provides a pleasant and simple out
 * Official user documentation: <https://www.bookstackapp.com/docs/user/>
 * Official admin documentation: <https://www.bookstackapp.com/docs/admin/>
 * Upstream app code repository: <https://github.com/BookStackApp/BookStack>
-* YunoHost documentation for this app: <https://yunohost.org/app_bookstack>
 * Report a bug: <https://github.com/YunoHost-Apps/bookstack_ynh/issues>
 
 ## Developer info
diff --git a/README_fr.md b/README_fr.md
index 7fcf640..3d85783 100644
--- a/README_fr.md
+++ b/README_fr.md
@@ -41,7 +41,6 @@ BookStack est un système wiki simple prête à l'emploi. Les nouveaux utilisate
 * Documentation officielle utilisateur : <https://www.bookstackapp.com/docs/user/>
 * Documentation officielle de l’admin : <https://www.bookstackapp.com/docs/admin/>
 * Dépôt de code officiel de l’app : <https://github.com/BookStackApp/BookStack>
-* Documentation YunoHost pour cette app : <https://yunohost.org/app_bookstack>
 * Signaler un bug : <https://github.com/YunoHost-Apps/bookstack_ynh/issues>
 
 ## Informations pour les développeurs
diff --git a/conf/.env.example b/conf/.env.example
index f98ee6e..48aac0b 100644
--- a/conf/.env.example
+++ b/conf/.env.example
@@ -16,9 +16,17 @@ APP_ENV=production
 APP_DEBUG=false
 
 # Application key
+# Used for encryption where needed.
+# Run `php artisan key:generate` to generate a valid key.
 APP_KEY=SomeRandomString
 
 # Application URL
+# This must be the root URL that you want to host BookStack on.
+# All URLs in BookStack will be generated using this value
+# to ensure URLs generated are consistent and secure.
+# If you change this in the future you may need to run a command
+# to update stored URLs in the database. Command example:
+# php artisan bookstack:update-url https://old.example.com https://new.example.com
 APP_URL=__APP_URL_DOMAIN__
 
 # Application default language
@@ -41,20 +49,19 @@ DB_PASSWORD=__DB_PWD__
 FILE_UPLOAD_SIZE_LIMIT=100
 
 # Mail system to use
-MAIL_DRIVER=smtp
+# Can be 'smtp' or 'sendmail'
+MAIL_DRIVER=sendmail
 
-# Mail sender details
+MAIL_DRIVER=sendmail
+
+# The "from" email address for outgoing email
+MAIL_FROM=noreply@__DOMAIN__ 
+
+# The "from" name used for outgoing email
 MAIL_FROM_NAME=BookStack
-MAIL_FROM=bookstack@__DOMAIN__
 
-# SMTP mail options
-# These settings can be checked using the "Send a Test Email"
-# feature found in the "Settings > Maintenance" area of the system.
-MAIL_HOST=localhost
-MAIL_PORT=25
-MAIL_USERNAME=bookstack
-MAIL_PASSWORD=null
-MAIL_ENCRYPTION=null
+# The command to use for calling sendmail
+MAIL_SENDMAIL_COMMAND="/usr/sbin/sendmail -bs"
 
 # General auth
 AUTH_METHOD=ldap
diff --git a/manifest.toml b/manifest.toml
index 69dd0f7..5ef8cfb 100644
--- a/manifest.toml
+++ b/manifest.toml
@@ -62,6 +62,7 @@ ram.runtime = "50M"
         autoupdate.strategy = "latest_github_tag"
 
     [resources.system_user]
+    allow_email = true
 
     [resources.install_dir]