Triển khai trên Vercel

Chúng tôi đã phát hành gói @waline/vercel làm gói máy chủ, và triển khai trên Vercel cũng là cách chúng tôi khuyên dùng nhất.

Cách triển khai

Vercel

1. Nhấn nút màu xanh ở trên, trình duyệt sẽ chuyển bạn đến Vercel để triển khai bằng mẫu Waline.

   Note

   Nếu bạn chưa đăng nhập, chúng tôi khuyên bạn nên đăng nhập bằng GitHub.

2. Nhập tên dự án Vercel của bạn rồi nhấn Create.

   

   Create Project

3. Kho lưu trữ có tên bạn vừa nhập sẽ được Vercel tạo và khởi tạo tự động dựa trên mẫu ví dụ của Waline.

   

   new project

   Sau một hoặc hai phút, Vercel sẽ hoàn tất việc triển khai. Nhấn nút Go to Dashboard để chuyển đến bảng điều khiển ứng dụng của bạn.

   

   dashboard

Tạo cơ sở dữ liệu

1. Nhấn Storage ở trên cùng để vào trang dịch vụ lưu trữ, chọn Create Database. Trong Marketplace Database Providers, chọn Neon, rồi nhấn Continue.

   

   storage

2. Bạn sẽ được yêu cầu tạo tài khoản Neon. Chọn Accept and Create. Tiếp theo, chọn cấu hình gói cơ sở dữ liệu, bao gồm khu vực và hạn mức. Bạn có thể giữ mặc định và nhấn Continue.

   

   neon

3. Đặt tên cơ sở dữ liệu. Bạn có thể giữ mặc định và nhấn Continue.

   

   neon

4. Bây giờ cơ sở dữ liệu đã xuất hiện trong Storage. Nhấn vào đó và chọn Open in Neon để chuyển sang Neon. Trong Neon, chọn SQL Editor ở bên trái, dán câu lệnh SQL từ waline.pgsql vào trình soạn thảo, rồi nhấn Run để tạo các bảng.

   

   neon

   

   neon

5. Sau một lúc, bạn sẽ thấy thông báo thành công. Quay lại Vercel, nhấn Deployments, rồi nhấn Redeploy trên lần triển khai mới nhất để cấu hình cơ sở dữ liệu mới có hiệu lực.

   

   redeploy success

6. Vercel sẽ chuyển về Overview và bắt đầu triển khai. Khi STATUS trở thành Ready, nhấn Visit để mở trang đã triển khai. URL này chính là địa chỉ máy chủ của bạn.

   

   visit

Gán tên miền

1. Nhấn Settings - Domains để vào trang cài đặt tên miền.

2. Nhập tên miền bạn muốn gán và nhấn nút Add.

   

   Add domain

3. Thêm một bản ghi CNAME mới trong máy chủ dịch vụ tên miền của bạn.

   Type	Name	Value
   CNAME	example	cname.vercel-dns.com

4. Sau khi có hiệu lực, bạn có thể dùng tên miền của mình để truy cập Waline. 🎉

   • Hệ thống bình luận: example.your-domain.com
   • Bảng điều khiển quản trị: example.your-domain.com/ui

   

   success

Nhúng bằng HTML

Thiết lập như sau trong trang web của bạn:

1. Nhập kiểu dáng của Waline từ https://unpkg.com/@waline/client@v3/dist/waline.css.
2. Tạo thẻ <script> sử dụng init() từ https://unpkg.com/@waline/client@v3/dist/waline.js, và truyền các tùy chọn bắt buộc el và serverURL.
   • el là phần tử dùng để hiển thị Waline. Nó có thể là chuỗi chọn CSS hoặc một HTMLElement.
   • serverURL là địa chỉ máy chủ bạn đã lấy ở bước trước.

<head>
  <!-- ... -->
  <link rel="stylesheet" href="https://unpkg.com/@waline/client@v3/dist/waline.css" />
  <!-- ... -->
</head>
<body>
  <!-- ... -->
  <div id="waline"></div>
  <script type="module">
    import { init } from 'https://unpkg.com/@waline/client@v3/dist/waline.js';

    init({
      el: '#waline',
      serverURL: 'https://your-domain.vercel.app',
    });
  </script>
</body>

Quản trị bình luận

1. Sau khi triển khai, truy cập <serverURL>/ui/register để đăng ký. Người dùng đăng ký đầu tiên sẽ trở thành quản trị viên.
2. Sau khi đăng nhập, quản trị viên có thể quản lý bình luận: chỉnh sửa, đánh dấu hoặc xóa.
3. Người dùng cũng có thể đăng ký qua khung bình luận. Sau khi đăng nhập, họ sẽ được chuyển đến trang hồ sơ của mình.