Merge pull request #2509 from bluewave-labs/feat/email-settings-transport-display

feat: display transport settings

client/src/Components/TextLink/index.jsx

@@ -5,7 +5,7 @@ import PropTypes from "prop-types";
 import { useTheme } from "@emotion/react";
 import { Link as RouterLink } from "react-router-dom";
 
-const TextLink = ({ text, linkText, href }) => {
+const TextLink = ({ text, linkText, href, target = "_self" }) => {
 	const theme = useTheme();
 
 	return (
@@ -18,6 +18,7 @@ const TextLink = ({ text, linkText, href }) => {
 				color="accent"
 				to={href}
 				component={RouterLink}
+				target={target}
 			>
 				{linkText}
 			</Link>
@@ -29,6 +30,7 @@ TextLink.propTypes = {
 	text: PropTypes.string,
 	linkText: PropTypes.string,
 	href: PropTypes.string,
+	target: PropTypes.string,
 };
 
 export default TextLink;

client/src/Pages/Settings/SettingsEmail.jsx

@@ -4,6 +4,8 @@ import ConfigBox from "../../Components/ConfigBox";
 import TextInput from "../../Components/Inputs/TextInput";
 import Button from "@mui/material/Button";
 import Stack from "@mui/material/Stack";
+import { Switch } from "@mui/material";
+import TextLink from "../../Components/TextLink";
 // Utils
 import { useTheme } from "@emotion/react";
 import { PropTypes } from "prop-types";
@@ -12,7 +14,6 @@ import { useTranslation } from "react-i18next";
 import { PasswordEndAdornment } from "../../Components/Inputs/TextInput/Adornments";
 import { useSendTestEmail } from "../../Hooks/useSendTestEmail";
 import { createToast } from "../../Utils/toastUtils";
-import { Switch } from "@mui/material";
 
 const SettingsEmail = ({
 	isAdmin,
@@ -239,6 +240,46 @@ const SettingsEmail = ({
 								/>
 							</Box>
 						))}
+
+						<TextLink
+							text={t("settingsEmailTransportLinkDescription")}
+							linkText={t("settingsEmailTransportLinkText")}
+							href="https://nodemailer.com/smtp"
+							target="_blank"
+						/>
+						<Box
+							component={"pre"}
+							sx={{
+								fontFamily: "monospace",
+								p: 2,
+								borderRadius: 1,
+								overflow: "auto",
+							}}
+						>
+							<code>
+								{JSON.stringify(
+									{
+										host: systemEmailHost,
+										port: systemEmailPort,
+										secure: systemEmailSecure,
+										auth: {
+											user: systemEmailUser || systemEmailAddress,
+											pass: "<your_password>",
+										},
+										name: systemEmailConnectionHost || "localhost",
+										pool: systemEmailPool,
+										tls: {
+											rejectUnauthorized: systemEmailRejectUnauthorized,
+											ignoreTLS: systemEmailIgnoreTLS,
+											requireTLS: systemEmailRequireTLS,
+											servername: systemEmailTLSServername,
+										},
+									},
+									null,
+									2
+								)}
+							</code>
+						</Box>
 					</Box>
 
 					<Box>

client/src/locales/en.json

@@ -448,6 +448,8 @@
 	"settingsEmailPassword": "Email password - Password for authentication",
 	"settingsEmailUser": "Email user - Username for authentication, overrides email address if specified",
 	"settingsEmailFieldResetLabel": "Password is set. Click Reset to change it.",
+	"settingsEmailTransportLinkDescription": "This builds an SMTP transport for NodeMailer",
+	"settingsEmailTransportLinkText": "See specifications here",
 	"state": "State",
 	"statusBreadCrumbsStatusPages": "Status Pages",
 	"statusBreadCrumbsDetails": "Details",