# Members — ระบบสมาชิก

> ปลั๊กอิน Members ทางการ — ให้ผู้เข้าชมสมัครสมาชิก ยืนยันอีเมล เข้าสู่ระบบ ลืมรหัสผ่าน เปลี่ยนรหัสผ่าน มีหน้าบัญชีของฉัน บล็อกเมนูสมาชิก และซ่อนส่วนของหน้าไว้ให้เฉพาะสมาชิก

ที่มา: https://anasaki.live/docs/store/plugin-members

ปลั๊กอิน **Members** (`members`) ทำให้เว็บมีบัญชีของผู้เข้าชม แยกจากผู้ใช้หลังบ้าน — ใช้ทำคอร์สออนไลน์ ชุมชน เนื้อหาเฉพาะสมาชิก หรือให้ลูกค้าดูข้อมูลของตัวเอง

ต้องใช้ Anasaki Studio 2.2.2 ขึ้นไป

## หน้าพร้อมใช้

| หน้า | ทำอะไร |
| --- | --- |
| `/members/register` | สมัครสมาชิก (ชื่อ อีเมล รหัสผ่านอย่างน้อย 8 ตัว) |
| `/members/login` | เข้าสู่ระบบ |
| `/members/forgot` | ขอลิงก์ตั้งรหัสผ่านใหม่ทางอีเมล (ใช้ได้ 1 ชั่วโมง) |
| `/members/reset` | ตั้งรหัสผ่านใหม่จากลิงก์ในอีเมล |
| `/members/account` | บัญชีของฉัน: แก้ชื่อ เปลี่ยนรหัสผ่าน ดูสถานะการยืนยัน และออกจากระบบ |

## อีเมลยืนยันและอีเมลตั้งรหัสใหม่ (1.4)

- ส่งผ่าน **คิวงานเบื้องหลัง** — กดสมัครแล้วหน้าเว็บตอบทันที ไม่ต้องรอเซิร์ฟเวอร์อีเมล อีเมลออกภายในไม่กี่วินาที ถ้าเซิร์ฟเวอร์อีเมลขัดข้อง ระบบลองส่งใหม่เอง (เว้นระยะเพิ่มขึ้น สูงสุด 6 ครั้ง) ดูคิวได้ที่ **โค้ดของเว็บไซต์ → งานเบื้องหลัง**
- สมัครเสร็จ ฟอร์มเปลี่ยนเป็น **ตรวจอีเมลของคุณ** บอกอีเมลที่ส่งไป มีปุ่ม **ส่งลิงก์อีกครั้ง** (ทุก 60 วินาที) และปุ่ม **เข้าสู่ระบบ**
- เข้าสู่ระบบด้วยบัญชีที่ยังไม่ยืนยัน ระบบบอกเหตุผล ส่งลิงก์ใหม่ให้เอง (ไม่เกินทุก 10 นาที) และมีปุ่ม **ส่งลิงก์ยืนยันอีกครั้ง**
- สมาชิกที่สมัครตอนเว็บยังไม่ต้องยืนยันอีเมล (เช่น ยังไม่ได้ตั้ง SMTP) เข้าใช้ต่อได้แม้เปิดอีเมลภายหลัง
- หน้า **สมาชิก** ในหลังบ้านมีปุ่ม **ยืนยันให้** สำหรับสมาชิกที่ไม่ได้รับอีเมล
- **1.4.1** — อีเมลมีชื่อเว็บ ปุ่มใหญ่ และลิงก์สำรอง · กดลิงก์ยืนยันแล้ว **เข้าสู่ระบบให้ทันที** และพาไปหน้า &#34;หลังเข้าสู่ระบบ&#34; · ลิงก์ตั้งรหัสใหม่ที่ใช้แล้วหรือหมดอายุ บอกทันทีที่เปิดพร้อมปุ่ม **ขอลิงก์ใหม่** และหน้าตั้งรหัสใหม่มีช่องยืนยันรหัสผ่าน

## เปลี่ยนรหัสผ่าน (1.3)

หน้า **บัญชีของฉัน** มีฟอร์ม **เปลี่ยนรหัสผ่าน**: ใส่รหัสผ่านปัจจุบัน แล้วใส่รหัสผ่านใหม่ (อย่างน้อย 8 ตัว) สองครั้ง

- เครื่องที่ใช้อยู่ยังเข้าสู่ระบบต่อ ส่วนเครื่องอื่นทุกเครื่องถูกออกจากระบบทันที
- ใส่รหัสผ่านปัจจุบันผิด 10 ครั้งใน 15 นาที ระงับการลองชั่วคราว
- จำรหัสผ่านปัจจุบันไม่ได้ ใช้ลิงก์ **ตั้งรหัสผ่านใหม่ทางอีเมล** ใต้ฟอร์ม

แอปที่ส่งสมาชิกมาที่หน้านี้ใส่ `?next=/path` ได้ หน้าบัญชีจะมีลิงก์ **← กลับ** ไปที่ path นั้น (เฉพาะ path ในเว็บเดียวกัน)

ใส่ลิงก์หน้าเหล่านี้ในเมนูของเว็บ หรือวางบล็อก **เมนูสมาชิก** ที่หัวเว็บ — ก่อนเข้าสู่ระบบแสดง **เข้าสู่ระบบ / สมัครสมาชิก** หลังเข้าสู่ระบบแสดงชื่อของสมาชิก

## การตั้งค่า

| ค่า | ความหมาย |
| --- | --- |
| ต้องยืนยันอีเมลก่อนเข้าสู่ระบบ | ส่งลิงก์ยืนยัน (ใช้ได้ 48 ชั่วโมง) — ต้องตั้งค่า **อีเมล** ของเว็บก่อน |
| รับเฉพาะอีเมลโดเมน | เช่น `company.co.th` สำหรับเว็บภายในองค์กร |
| จำการเข้าสู่ระบบ (วัน) | อายุคุกกี้ (1–365, ค่าเริ่มต้น 30) |
| หลังเข้าสู่ระบบไปที่ | path ในเว็บ เช่น `/members-area` (ค่าเริ่มต้น บัญชีของฉัน) |
| หลังยืนยันอีเมลไปที่ | path ในเว็บ (ค่าเริ่มต้น หน้ายืนยันพร้อมปุ่มเข้าสู่ระบบ) |

> [!NOTE]
> **1.1** — ถ้าเว็บยังส่งอีเมลไม่ได้ (ยังไม่ตั้ง SMTP) สมาชิกใหม่เข้าสู่ระบบได้ทันทีโดยไม่ต้องยืนยันอีเมล และหน้าแอดมินมีประกาศให้ไปตั้งค่าอีเมล
>
> **1.3** — ระหว่างนั้นหน้า **ลืมรหัสผ่าน** จะบอกตรง ๆ ว่าเว็บยังส่งอีเมลไม่ได้ ให้ติดต่อผู้ดูแลเว็บ (แทนที่จะบอกว่าส่งลิงก์แล้ว) หลังสมัครเสร็จ ฟอร์มสมัครจะถูกแทนด้วยปุ่ม **เข้าสู่ระบบ**

## เนื้อหาเฉพาะสมาชิก

ในหน้าออกแบบ เลือกเลเยอร์หรือเฟรม แล้วตั้ง **เงื่อนไข → แสดงเมื่อ**:

| เงื่อนไข | แสดงเมื่อ |
| --- | --- |
| `visitor.is.member` | สมาชิกที่เข้าสู่ระบบ |
| `visitor.is.verified` | สมาชิกที่ยืนยันอีเมลแล้ว |
| `!visitor` | ผู้เข้าชมที่ยังไม่เข้าสู่ระบบ (เช่น กล่องชวนสมัคร) |

ระบบตรวจเงื่อนไขฝั่งเซิร์ฟเวอร์ ส่วนที่ซ่อนไม่ถูกส่งไปที่เบราว์เซอร์เลย และใช้ `{{visitor.name}}` แสดงชื่อสมาชิกในข้อความได้

## จัดการสมาชิก

หน้า **สมาชิก** (เมนูนักพัฒนา → หน้าของปลั๊กอิน) ค้นหาด้วยอีเมลหรือชื่อ ดูวันเข้าสู่ระบบล่าสุด **ระงับ** (ออกจากระบบทุกเครื่องทันที) หรือ **เปิดใช้** และ **ส่งออก CSV** (ไม่มีรหัสผ่าน)

## ความปลอดภัย

- รหัสผ่านเก็บแบบ bcrypt ส่วน session และลิงก์ในอีเมลเก็บเฉพาะค่า hash
- คุกกี้ HttpOnly, SameSite=Lax (และ Secure บน https)
- ใส่รหัสผิด 10 ครั้งใน 15 นาที ระงับการลองชั่วคราว
- ฟอร์มส่งข้อมูลเป็น JSON เท่านั้น เว็บอื่นจึงส่งฟอร์มแทนผู้ใช้ไม่ได้ (CSRF)

> [!WARNING]
> เว็บหนึ่งมีตัวระบุผู้เข้าชม (`site.visitor`) ได้ตัวเดียว ถ้า Site Code หรือปลั๊กอินอื่นมีอยู่แล้ว จะเปิดใช้ Members ไม่ได้ จนกว่าจะเอาตัวเดิมออก

## สำหรับนักพัฒนา

```ts
site.on('members.registered', (m) => log.info('new member', m.email));
site.route('GET /members-area/data', { access: ['group:member'] }, ({ visitor }) => ({ hello: visitor.name }));
site.filter('members.mail', (msg, { kind }) => ({ ...msg, subject: '[My site] ' + msg.subject }));
```
