Send readme to admin

scripts/_common.sh

@@ -58,3 +58,57 @@ _ynh_enable_backports() {
 #=================================================
 # FUTURE OFFICIAL HELPERS
 #=================================================
+
+# Send an email to inform the administrator
+#
+# usage: ynh_send_readme_to_admin app_message [recipients]
+# | arg: app_message - The message to send to the administrator.
+# | arg: recipients - The recipients of this email. Use spaces to separate multiples recipients. - default: root
+#	example: "root admin@domain"
+#	If you give the name of a YunoHost user, ynh_send_readme_to_admin will find its email adress for you
+#	example: "root admin@domain user1 user2"
+ynh_send_readme_to_admin() {
+	local app_message="${1:-...No specific information...}"
+	local recipients="${2:-root}"
+
+	# Retrieve the email of users
+	find_mails () {
+		local list_mails="$1"
+		local mail
+		local recipients=" "
+		# Read each mail in argument
+		for mail in $list_mails
+		do
+			# Keep root or a real email address as it is
+			if [ "$mail" = "root" ] || echo "$mail" | grep --quiet "@"
+			then
+				recipients="$recipients $mail"
+			else
+				# But replace an user name without a domain after by its email
+				if mail=$(ynh_user_get_info "$mail" "mail" 2> /dev/null)
+				then
+					recipients="$recipients $mail"
+				fi
+			fi
+		done
+		echo "$recipients"
+	}
+	recipients=$(find_mails "$recipients")
+
+	local mail_subject="☁️🆈🅽🅷☁️: \`$app\` was just installed!"
+
+	local mail_message="This is an automated message from your beloved YunoHost server.
+Specific information for the application $app.
+$app_message"
+
+	# Define binary to use for mail command
+	if [ -e /usr/bin/bsd-mailx ]
+	then
+		local mail_bin=/usr/bin/bsd-mailx
+	else
+		local mail_bin=/usr/bin/mail.mailutils
+	fi
+
+	# Send the email to the recipients
+	echo "$mail_message" | $mail_bin -a "Content-Type: text/plain; charset=UTF-8" -s "$mail_subject" "$recipients"
+}

scripts/install

@@ -228,6 +228,30 @@ ynh_script_progression --message="Reloading NGINX web server..." --weight=1
 
 ynh_systemd_action --service_name=nginx --action=reload
 
+#=================================================
+# SEND README TO ADMIN
+#=================================================
+ynh_script_progression --message="Sending Readme to admin..." --weight=1
+
+message="
+Please navigate to https://$domain$path_url to subscribe as administrator on $app!
+You'll receive an email on the adress you'll give there. Please click on the link inside.
+
+If you want to customize Fider (e.g use OAuth with Github), please edit $final_path/custom_fider_env (it might not exist yet).
+Don't forget to *export* the variables in this file, just like in a bash script:
+
+export OAUTH_GITHUB_SECRET=<your github secret>
+export OAUTH_GITHUB_CLIENTID=<your github client id>
+
+You'll find the documentation here for OAuth: https://fider.io/docs/configuring-oauth.
+
+
+Are you facing an issue, want to improve this app or say thank you?
+Please open a new issue in this project: https://github.com/YunoHost-Apps/fider_ynh
+"
+
+ynh_send_readme_to_admin "$message"
+
 #=================================================
 # END OF SCRIPT
 #=================================================