关于apostrophe-email模块发送新用户账户详情与激活邮件的技术问询

首先明确：默认情况下apostrophe-email模块并没有内置管理员代创建用户后自动发送账户详情/激活邮件的功能——这个模块的核心设计是支持密码重置这类用户主动触发的流程，而非管理员创建用户的被动通知场景。不过你完全可以通过扩展Apostrophe的模块逻辑来实现这个需求，下面是具体的实现思路：

实现步骤建议 #

1. 扩展apostrophe-users模块的创建钩子 #

我们需要在管理员创建新用户的流程结束后，触发邮件发送逻辑。可以通过重写apostrophe-users模块的afterInsert钩子来实现：

在你的项目的lib/modules/apostrophe-users/index.js文件中，添加以下代码：

module.exports = {
  construct: function(self, options) {
    // 保存原有的afterInsert方法，避免覆盖默认逻辑
    const originalAfterInsert = self.afterInsert;
    
    self.afterInsert = async function(req, user) {
      // 先执行模块原本的afterInsert逻辑
      await originalAfterInsert(req, user);
      
      // 仅当操作的用户是管理员时发送邮件
      if (req.user && req.user.isAdmin) {
        // 生成临时密码（如果创建用户时没设置的话）
        const tempPassword = user.password ? null : self.apos.utils.generateId(8);
        let updatedUser = user;
        
        // 如果生成了临时密码，需要加密后更新用户文档
        if (tempPassword) {
          const hashedPassword = await self.apos.users.hashPassword(tempPassword);
          updatedUser = await self.apos.users.update(req, user._id, {
            password: hashedPassword
          });
        }
        
        // 调用apostrophe-email发送邮件
        try {
          await self.apos.modules['apostrophe-email'].send(req, {
            template: 'new-user-account', // 自定义模板名
            from: 'your-admin@example.com', // 发件人邮箱
            to: user.email,
            subject: '你的新账户已创建',
            data: {
              username: user.title, // 假设用户的用户名存在title字段
              email: user.email,
              tempPassword: tempPassword,
              // 如果需要激活流程，可以在这里传入激活令牌
              activationToken: updatedUser.activationToken
            }
          });
        } catch (err) {
          self.apos.utils.error('发送新用户邮件失败:', err);
        }
      }
    };
  }
};

2. 创建自定义邮件模板 #

在lib/modules/apostrophe-email/views目录下创建new-user-account.html模板文件，内容示例如下：

<p>您好 {{ username }}，</p>
<p>管理员已为您创建了账户，账户详情如下：</p>
<ul>
  <li>邮箱：{{ email }}</li>
  {{#if tempPassword}}
  <li>临时密码：{{ tempPassword }}</li>
  {{/if}}
</ul>
{{#if activationToken}}
<p>请点击下方链接激活您的账户：</p>
<p><a href="{{ apos.prefix }}/activate-account?token={{ activationToken }}">激活账户</a></p>
{{/if}}
<p>感谢您的使用！</p>

3. 可选：添加账户激活流程 #

如果需要用户激活账户才能登录，可以在创建用户时生成激活令牌：

• 在apostrophe-users模块的beforeInsert钩子中，生成唯一令牌和过期时间：

self.beforeInsert = async function(req, user) {
  await originalBeforeInsert(req, user);
  if (req.user && req.user.isAdmin) {
    user.activationToken = self.apos.utils.generateId(20);
    user.activationTokenExpires = Date.now() + 24 * 60 * 60 * 1000; // 24小时过期
    user.isActive = false; // 默认未激活
  }
};

• 然后创建一个自定义模块（比如apostrophe-account-activation），添加路由处理激活请求：

module.exports = {
  construct: function(self, options) {
    self.route('get', 'activate', async function(req, res) {
      const token = req.query.token;
      if (!token) {
        return res.send('无效的激活链接');
      }
      const user = await self.apos.users.find(req, {
        activationToken: token,
        activationTokenExpires: { $gt: Date.now() }
      }).toObject();
      if (!user) {
        return res.send('激活链接已过期或无效');
      }
      // 更新用户状态为已激活
      await self.apos.users.update(req, user._id, {
        isActive: true,
        activationToken: null,
        activationTokenExpires: null
      });
      res.send('账户激活成功，请登录！');
    });
  }
};

额外注意事项 #

• 确保你已经在项目的app.js中正确配置了apostrophe-email的SMTP参数，比如：

modules: {
  'apostrophe-email': {
    options: {
      host: 'smtp.example.com',
      port: 587,
      secure: false,
      auth: {
        user: 'your-email@example.com',
        pass: 'your-email-password'
      }
    }
  }
}

• 如果你的用户系统有自定义字段，记得调整模板和代码中的变量名，匹配你的用户文档结构。

内容的提问来源于stack exchange，提问作者D Ramirez